From 5904c896aaadaf8bddf57db8d849cd72a1c66f01 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 24 Apr 2009 21:47:40 +0200
Subject: [PATCH 001/368] Lower gtkmm requirements to match Debian/Lenny
 (grmmm-2.4<=2.12)

@joel: is this ok? if you'd actually need a more recent gtkmm, we handle it similar as with gdl-lum...
---
 configure.ac | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/configure.ac b/configure.ac
index e08e3d83f..d69749882 100644
--- a/configure.ac
+++ b/configure.ac
@@ -142,7 +142,7 @@ PKG_CHECK_MODULES(LUMIERA_COMMON_LIBS, [sigc++-2.0 >= 2.0.17])
 
 PKG_CHECK_MODULES(LUMIERA_GUI, [
     gtk+-2.0 >= 2.8
-    gtkmm-2.4 >= 2.14
+    gtkmm-2.4 >= 2.12
     cairomm-1.0 >= 0.6.0
     librsvg-2.0 >= 2.18.1
     gavl >= 0.2.5

From 3ae3e36f3f24f7323e48e3b26ee8d6aeb9f33c16 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 16 Oct 2008 20:31:02 +0200
Subject: [PATCH 002/368] @Joel: a simple convenience wrapper for gavl_time_t

---
 src/lib/lumitime.cpp                         |  7 ++-
 src/lib/lumitime.hpp                         | 54 +++++++++++++-------
 tests/components/proc/asset/makecliptest.cpp |  2 +-
 3 files changed, 39 insertions(+), 24 deletions(-)

diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index 9590b6c3a..d9e849a49 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -1,5 +1,5 @@
 /*
-  Time  -  unified representation of a time point, including conversion functions
+  Time  -  convenience wrapper for working with gavl_time in C++
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -28,10 +28,9 @@
 namespace lumiera
   {
 
-   // TODO: dummy values; should be adjusted when switching to the real time implementation provided by the backend
   
-   const Time Time::MAX = +std::numeric_limits<long>::max();
-   const Time Time::MIN = -std::numeric_limits<long>::max();
+   const Time Time::MAX = +std::numeric_limits<int64_t>::max();
+   const Time Time::MIN = -std::numeric_limits<int64_t>::max();
 
 
 } // namespace lumiera
diff --git a/src/lib/lumitime.hpp b/src/lib/lumitime.hpp
index 33b5bb4c3..5bc60c044 100644
--- a/src/lib/lumitime.hpp
+++ b/src/lib/lumitime.hpp
@@ -1,5 +1,5 @@
 /*
-  LUMITIME.hpp  -  unified representation of a time point, including conversion functions
+  LUMITIME.hpp  -  convenience wrapper for working with gavl_time in C++
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -26,35 +26,51 @@
 
 #include <boost/operators.hpp>
 
+extern "C" {
+#include <gavl/gavltime.h>
+}
 
-namespace lumiera
-  {
+namespace lumiera {
 
 
   /**
-   * denotes a temporal position (time point), based on timeline start.
+   * C++ convenience wrapper representing a time value, which could denote
+   * a temporal position (time point) relative to an (implicit) timeline zero
+   * point, or it could represent a time interval.
    * 
-   * @todo currently (9/07) this is a dummy implementation to find out
-   *       what interface the Proc layer needs. Cehteh has already written
-   *       elaborate timehandling functions in the backend and the goal
-   *       is for class Time to be just a thin wrapper!
+   * @note this is currently (10/08) an experimental implementation to ease
+   *       the time handling within C++ code. It is advisable not to use it
+   *       on external interfaces (use gavl_time_t there please).
    */
-  class Time : boost::totally_ordered<Time>
+  class Time 
+    : boost::additive<Time,
+      boost::multipliable<Time, int64_t,
+      boost::totally_ordered<Time> > >
     {
-      long dummy;
+      gavl_time_t t_;
+      
     public:
-      Time(long dum=0) : dummy(dum) {}
-      operator long () { return dummy; }
-      
-      bool operator<  (const Time& ot)  const { return dummy <  ot.dummy; }
-      bool operator== (const Time& ot)  const { return dummy == ot.dummy; }
-      
       static const Time MAX ; 
       static const Time MIN ;
+      
+      Time(gavl_time_t val=0) : t_(val) {}
+      operator gavl_time_t () { return t_; }
+      
+      
+      // Supporting additive
+      Time& operator+= (Time const& tx)  { t_ += tx.t_; return *this; }
+      Time& operator-= (Time const& tx)  { t_ -= tx.t_; return *this; }
+      
+      // Supporting multiplication with integral factor
+      Time& operator*= (int64_t fact)    { t_ *= fact;  return *this; }
+       
+      // Supporting totally_ordered
+      friend bool operator<  (Time const& t1, Time const& t2)  { return t1.t_ <  t2.t_; }
+      friend bool operator== (Time const& t1, Time const& t2)  { return t1.t_ == t2.t_; }
     };
-    
   
-
-   
+  
+  
+  
 } // namespace lumiera
 #endif
diff --git a/tests/components/proc/asset/makecliptest.cpp b/tests/components/proc/asset/makecliptest.cpp
index 0dc4365cc..0da91b126 100644
--- a/tests/components/proc/asset/makecliptest.cpp
+++ b/tests/components/proc/asset/makecliptest.cpp
@@ -61,7 +61,7 @@ namespace asset {
             PM cm = cc->getMedia();
             
             ASSERT (cm);
-            ASSERT (0 < cc->getLength());
+            ASSERT (Time(0) < cc->getLength());
             ASSERT (cm->ident.category.hasKind (VIDEO));
             ASSERT (cm->getFilename() == mm->getFilename());
 TODO ("implement Processing Pattern!!!");   

From 0e4df5611a3b40b7d51453174873aab95c4ee59a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 16 Oct 2008 22:02:13 +0200
Subject: [PATCH 003/368] time wrapper minimal test coverage

---
 src/lib/lumitime.cpp                     |   7 +-
 src/lib/lumitime.hpp                     |  24 ++++-
 src/proc/mobject/session/clip.cpp        |   2 +-
 src/proc/mobject/session/locatingpin.hpp |   2 +-
 tests/40components.tests                 |   5 +
 tests/common/timewrappertest.cpp         | 129 +++++++++++++++++++++++
 6 files changed, 160 insertions(+), 9 deletions(-)
 create mode 100644 tests/common/timewrappertest.cpp

diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index d9e849a49..867477c5f 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -25,12 +25,11 @@
 #include <limits>
 
 
-namespace lumiera
-  {
+namespace lumiera {
 
   
-   const Time Time::MAX = +std::numeric_limits<int64_t>::max();
-   const Time Time::MIN = -std::numeric_limits<int64_t>::max();
+   const Time Time::MAX ( +std::numeric_limits<int64_t>::max() );
+   const Time Time::MIN ( -std::numeric_limits<int64_t>::max() );
 
 
 } // namespace lumiera
diff --git a/src/lib/lumitime.hpp b/src/lib/lumitime.hpp
index 5bc60c044..da0d58ee7 100644
--- a/src/lib/lumitime.hpp
+++ b/src/lib/lumitime.hpp
@@ -38,14 +38,28 @@ namespace lumiera {
    * a temporal position (time point) relative to an (implicit) timeline zero
    * point, or it could represent a time interval.
    * 
+   * This wrapper is deliberately kept rather limited as not to be completely
+   * interchangeable with and integral type. The rationale is that time values
+   * should be kept separate and tagged as time values. The following is supported:
+   * - conversions from / to gavl_time_t (which is effectively a int64_t)
+   * - additions and subtractions of time values
+   * - multiplication with an integral factor
+   * - comparisons between time values and gavl_time_t values
+   * 
+   * @todo consider the possible extensions
+   *       - parsing and pretty printing
+   *       - quantising of floating point values
+   *       - conversion to boost::rational
+   *       - define a Framerate type
+   * 
    * @note this is currently (10/08) an experimental implementation to ease
    *       the time handling within C++ code. It is advisable not to use it
    *       on external interfaces (use gavl_time_t there please).
    */
   class Time 
     : boost::additive<Time,
-      boost::multipliable<Time, int64_t,
-      boost::totally_ordered<Time> > >
+      boost::totally_ordered<Time,
+      boost::totally_ordered<Time, gavl_time_t> > >
     {
       gavl_time_t t_;
       
@@ -53,7 +67,8 @@ namespace lumiera {
       static const Time MAX ; 
       static const Time MIN ;
       
-      Time(gavl_time_t val=0) : t_(val) {}
+      explicit Time (gavl_time_t val=0) : t_(val) {}
+      
       operator gavl_time_t () { return t_; }
       
       
@@ -66,7 +81,10 @@ namespace lumiera {
        
       // Supporting totally_ordered
       friend bool operator<  (Time const& t1, Time const& t2)  { return t1.t_ <  t2.t_; }
+      friend bool operator<  (Time const& t1, gavl_time_t t2)  { return t1.t_ <  t2   ; }
+      friend bool operator>  (Time const& t1, gavl_time_t t2)  { return t1.t_ >  t2   ; }
       friend bool operator== (Time const& t1, Time const& t2)  { return t1.t_ == t2.t_; }
+      friend bool operator== (Time const& t1, gavl_time_t t2)  { return t1.t_ == t2   ; }
     };
   
   
diff --git a/src/proc/mobject/session/clip.cpp b/src/proc/mobject/session/clip.cpp
index ce0e87a9f..78655283f 100644
--- a/src/proc/mobject/session/clip.cpp
+++ b/src/proc/mobject/session/clip.cpp
@@ -51,7 +51,7 @@ namespace mobject
     Clip::isValid ()  const
     {
       TODO ("check consistency of clip length def, implies accessing the underlying media def");
-      return length > 0;
+      return length > Time(0);
     }
     
     
diff --git a/src/proc/mobject/session/locatingpin.hpp b/src/proc/mobject/session/locatingpin.hpp
index 799255589..27074e0cd 100644
--- a/src/proc/mobject/session/locatingpin.hpp
+++ b/src/proc/mobject/session/locatingpin.hpp
@@ -104,7 +104,7 @@ namespace mobject
         /* Factory functions for adding LocatingPins */
         
         FixedLocation&    operator() (Time start, Track track=0);
-        RelativeLocation& operator() (PMO refObj, Time offset=0);
+        RelativeLocation& operator() (PMO refObj, Time offset=Time(0));   //////////TODO: warning, just a dummy placeholder for now!!
         
         LocatingPin (const LocatingPin&);
         LocatingPin& operator= (const LocatingPin&);
diff --git a/tests/40components.tests b/tests/40components.tests
index d05bea6f9..f5383bbc5 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -356,6 +356,11 @@ return: 0
 END
 
 
+TEST "Time Wrapper" TimeWrapper_test <<END
+return: 0
+END
+
+
 TEST "TestOption_test" TestOption_test <<END
 out: Testing invocation with cmdline: ...
 out: --> Testgroup=ALL
diff --git a/tests/common/timewrappertest.cpp b/tests/common/timewrappertest.cpp
new file mode 100644
index 000000000..0a96ab7aa
--- /dev/null
+++ b/tests/common/timewrappertest.cpp
@@ -0,0 +1,129 @@
+/*
+  TimeWrapper(Test)  -  working with gavl_time_t values in C++...
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "common/test/run.hpp"
+
+#include "common/util.hpp"
+#include <boost/lexical_cast.hpp>
+
+using boost::lexical_cast;
+using util::isnil;
+
+
+#include "common/lumitime.hpp"
+
+
+
+namespace lumiera {
+  namespace test {
+    
+    
+    /********************************************
+     * @test sanity of the C++ time wrapper.
+     */
+    class TimeWrapper_test : public Test
+      {
+        virtual void
+        run (Arg arg) 
+          {
+            int64_t refval= isnil(arg)?  1 : lexical_cast<int64_t> (arg[1]);
+            
+            Time ref (refval);
+            
+            checkBasics (ref);
+            checkComparisons (ref);
+          } 
+        
+        
+        void
+        checkBasics (Time const& ref)
+          {
+            Time zero;
+            Time one (1);
+            Time max (Time::MAX);
+            Time min (Time::MIN);
+            
+            Time val (ref);
+            
+            val += Time(2);
+            val *= 2;
+            ASSERT (zero == (val - 2*(ref + Time(2))) );
+            
+            val = ref;
+            ASSERT (zero == (val - ref));
+          }
+        
+        
+        void
+        checkComparisons (Time const& ref)
+          {
+            Time zero;
+            Time max (Time::MAX);
+            Time min (Time::MIN);
+            
+            ASSERT (zero == Time(0));
+            ASSERT (min < zero);
+            ASSERT (max > zero);
+            
+            Time val (ref);
+            ASSERT ( (val == ref) );
+            ASSERT (!(val != ref) );
+            ASSERT ( (val >= ref) );
+            ASSERT ( (val <= ref) );
+            ASSERT (!(val <  ref) );
+            ASSERT (!(val >  ref) );
+            
+            val += Time(2);
+            ASSERT (!(val == ref) );
+            ASSERT ( (val != ref) );
+            ASSERT ( (val >= ref) );
+            ASSERT (!(val <= ref) );
+            ASSERT (!(val <  ref) );
+            ASSERT ( (val >  ref) );
+            
+            gavl_time_t gat(val);
+            ASSERT (!(gat == ref) );
+            ASSERT ( (gat != ref) );
+            ASSERT ( (gat >= ref) );
+            ASSERT (!(gat <= ref) );
+            ASSERT (!(gat <  ref) );
+            ASSERT ( (gat >  ref) );
+            
+            ASSERT ( (val == gat) );
+            ASSERT (!(val != gat) );
+            ASSERT ( (val >= gat) );
+            ASSERT ( (val <= gat) );
+            ASSERT (!(val <  gat) );
+            ASSERT (!(val >  gat) );
+          }
+      };
+    
+    
+    /** Register this test class... */
+    LAUNCHER (TimeWrapper_test, "unit common");
+    
+    
+    
+  } // namespace test
+
+} // namespace lumiera

From 0d3ebb016e43ea7e9834c1e09169218e2df44572 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Dec 2008 04:14:49 +0100
Subject: [PATCH 004/368] adapt TimeWrapperTest to the new lib directory layout
 (shared lib build)

---
 tests/{common => lib}/timewrappertest.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
 rename tests/{common => lib}/timewrappertest.cpp (97%)

diff --git a/tests/common/timewrappertest.cpp b/tests/lib/timewrappertest.cpp
similarity index 97%
rename from tests/common/timewrappertest.cpp
rename to tests/lib/timewrappertest.cpp
index 0a96ab7aa..c27ed6f9b 100644
--- a/tests/common/timewrappertest.cpp
+++ b/tests/lib/timewrappertest.cpp
@@ -21,16 +21,16 @@
 * *****************************************************/
 
 
-#include "common/test/run.hpp"
+#include "lib/test/run.hpp"
 
-#include "common/util.hpp"
+#include "lib/util.hpp"
 #include <boost/lexical_cast.hpp>
 
 using boost::lexical_cast;
 using util::isnil;
 
 
-#include "common/lumitime.hpp"
+#include "lib/lumitime.hpp"
 
 
 

From 4d200b298b3f4f6203fc282c3b01aaea7d0da4ba Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 24 Apr 2009 23:30:13 +0200
Subject: [PATCH 005/368] some preliminary notes regarding session
 Proc-Session/GUI interface

---
 wiki/renderengine.html | 27 +++++++++++++++++++++++----
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index cdc7d9ac7..c858f092b 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1394,9 +1394,10 @@ Thus, the Proc-Layer exposes (one or several) facade interfaces for the GUI to u
 <pre>special LayerSeparationInterface which serves the main purpose to load the GuiStarterPlugin, thus bringing up the Lumiera GTK UI at application start.
 </pre>
 </div>
-<div title="GuiIntegration" modifier="Ichthyostega" modified="200901300207" created="200812050532" tags="overview" changecount="2">
+<div title="GuiIntegration" modifier="Ichthyostega" modified="200904242106" created="200812050532" tags="overview" changecount="3">
 <pre>Considering how to interface to and integrate with the GUI Layer. Running the GUI is //optional,// but it requires to be [[started up|GuiStart]], installing the necessary LayerSeparationInterfaces. As an example how to integrate the GUI with the lower layers, in 1/2009 we created an PlayerDummy, which &quot;pulls&quot; dummy frames from the (not yet existing) engine and displays them within an XV viewer widget.
-</pre>
+
+Probably the most important aspect regarding the GUI integration is how to get [[access to and operate on the Session|SessionInterface]]. More specifically, this includes [[referring to individual objects|MObjectRef]].</pre>
 </div>
 <div title="GuiNotificationFacade" modifier="Ichthyostega" created="200902080659" tags="spec" changecount="1">
 <pre>LayerSeparationInterface provided by the GUI.
@@ -1918,6 +1919,18 @@ The general idea is, that each facade interface actually provides access to a sp
 * {{red{and what else?}}}
 </pre>
 </div>
+<div title="MObjectRef" modifier="Ichthyostega" modified="200904242128" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="5">
+<pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
+
+{{red{WIP}}}
+
+!Two models
+* simple table index. Consequently will need a garbage collection to deal with deleted objects. This model has two flavours
+** using an generation id to tag the index handle, keep an translation table on each gc, mapping old indices to new ones and throw an exception when encountering an outdated handle
+** keep track of all index handles to rewrite them on gc
+* handles are refcounting smart pointers. This solution is C++ specific, albeit more elegant and minimalistic. As all important interfaces should be accessible via C bindings, we'd need to use a replacement mechanism on the LayerSeparationInterfaces, which could be mapped to or handled by an C++ smart-ptr.
+</pre>
+</div>
 <div title="MObjects" modifier="Ichthyostega" modified="200810180118" created="200706190636" tags="overview" changecount="10">
 <pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects|MObject]] being:
 * audio/video clips
@@ -3402,6 +3415,12 @@ The Session object is a singleton &amp;mdash; actually it is a »~PImpl«-Facade
 * a collection of ''global Pipes''
 * the ''Fixture'' with a possibility to [[(re)build it|PlanningBuildFixture]]</pre>
 </div>
+<div title="SessionInterface" modifier="Ichthyostega" modified="200904242109" created="200904242108" tags="SessionLogic GuiIntegration design draft discuss" changecount="2">
+<pre>{{red{WIP}}}</pre>
+</div>
+<div title="SessionLogic" modifier="Ichthyostega" modified="200904242111" created="200904242110" tags="overview" changecount="2">
+<pre>!Design and handling of the Session</pre>
+</div>
 <div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design" changecount="29">
 <pre>&lt;&lt;&lt;
 {{red{WARNING: Naming is currently being discussed (11/08)}}}
@@ -4974,7 +4993,7 @@ Matters are quite different for the placement of a Track within the tree of trac
 * obviously, one wants the __edit function__ used to create such an overlapping placement&amp;nbsp; also to create an [[transition|TransitionsHandling]] between the overlapping objects. Meaning this edit function will automatically create an transition processor object and provide it with a placement such as to attach it to the region of overlap.
 </pre>
 </div>
-<div title="TrackPipeEDL" modifier="Ichthyostega" modified="200801062328" created="200711300405" tags="design discuss def decision Builder" changecount="26">
+<div title="TrackPipeEDL" modifier="Ichthyostega" modified="200904242058" created="200711300405" tags="design discuss def decision Builder" changecount="27">
 <pre>''towards a definition of »Track«''. We don't want to tie ourself to some naive and overly simplistic definition, just because it is convenient. For classical (analogue) media, tracks are physical entities dictated by the nature of the process by which the media works. Especially, Tape machines have read/writing heads, which creates fixed tracks to which to route the signals. This is a practical geometric necessity. For digital media, there is no such necessity. We are bound primarily by the editor's habits of working.
 
 !!!Assessment of Properties
@@ -4982,7 +5001,7 @@ Media are used as Clips (contiguous chunks), they are a compound of several elem
 * a media stream may be sent to one of several possible output destinations (image or sound, subgroup busses, MIDI instruments)
 * for any given output destination there may be variations in the //way of connecting// (overlay mode and layer, pan position, MIDI channel)
 * besides, we often just want to stash away some clip without using it, e.g. as an alternative or for later referral
-This is to say we have //several degrees of freedom// within this organisational grid. It's not because some sound is located on this track that he will be sent to a given output, but the clip is located on this track //and// is connected to that output //and// &amp;mdash; supposed we have full-periphonic surround sound &amp;mdash; it is located 60° to the right and 30°. Combined with the (always contiguous) temporal dimension, this discrete grid is thus extruded to form something like discrete Tracks.
+This is to say we have //several degrees of freedom// within this organisational grid. Just because some sound is located on this track doesn't mean he will be sent to a given output, rather the clip is located on this track //and// is connected to that output //and// &amp;mdash; supposed we have full-periphonic surround sound &amp;mdash; it is located 60° to the right and with 30° elevation. Combined with the (always contiguous) temporal dimension, this discrete grid is thus extruded to form something like discrete Tracks.
 
 !!!do we really need Tracks?
 Starting with the assumption &quot;everything is just connected processing nodes&quot;, Tracks may seem superfluous. The problem with this approach is: it doesn't scale well. While it is fine to be able to connect clips and effects as we see fit (indeed, we want to build such a system), it is clearly not feasible to wire every clip manually to the output ports or add a panner effect to each and every audio sample. Because while editing, most of the time things are done in a fairly regular and systematic manner. Preferably we use the tracks as //preconfigured group setup// and just //place media onto them;// any such [[Placement]] can do the necessary wiring semi-automatic (rule-based).

From 00ef811850cf0f66194c4131df49dcc70a951091 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 26 Apr 2009 01:19:14 +0200
Subject: [PATCH 006/368] planning...

---
 wiki/renderengine.html | 61 ++++++++++++++++++++++++++++++++++++------
 1 file changed, 53 insertions(+), 8 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index c858f092b..bfaf190c6 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1466,7 +1466,7 @@ Besides routing to a global pipe, wiring plugs can also connect to the source po
 Finally, this example shows an ''automation'' data set controlling some parameter of an effect contained in one of the global pipes. From the effect's POV, the automation is simply a ParamProvider, i.e a function yielding a scalar value over time. The automation data set may be implemented as a bézier curve, or by a mathematical function (e.g. sine or fractal pseudo random) or by some captured and interpolated data values. Interestingly, in this example the automation data set has been placed relatively to the meta clip (albeit on another track), thus it will follow and adjust when the latter is moved.
 </pre>
 </div>
-<div title="ImplementationDetails" modifier="Ichthyostega" modified="200902080723" created="200708080322" tags="overview" changecount="31">
+<div title="ImplementationDetails" modifier="Ichthyostega" modified="200904252305" created="200708080322" tags="overview" changecount="33">
 <pre>This wiki page is the entry point to detail notes covering some technical decisions, details and problems encountered in the course of the implementation of the Lumiera Renderengine, the Builder and the related parts.
 
 * [[Packages, Interfaces and Namespaces|InterfaceNamespaces]]
@@ -1488,6 +1488,7 @@ Finally, this example shows an ''automation'' data set controlling some paramete
 * the relation of [[Project, Timelines and Sequences|TimelineSequences]]
 * how to [[start the GUI|GuiStart]] and how to [[communicate|GuiCommunication]]
 * build the first LayerSeparationInterfaces
+* decide on SessionInterface and create [[Session datastructure layout|SessionDataMem]]
 </pre>
 </div>
 <div title="ImplementationGuidelines" modifier="Ichthyostega" modified="200711210542" created="200711210531" tags="discuss draft" changecount="7">
@@ -1919,16 +1920,18 @@ The general idea is, that each facade interface actually provides access to a sp
 * {{red{and what else?}}}
 </pre>
 </div>
-<div title="MObjectRef" modifier="Ichthyostega" modified="200904242128" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="5">
+<div title="MObjectRef" modifier="Ichthyostega" modified="200904252227" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="7">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
 
 {{red{WIP}}}
 
 !Two models
-* simple table index. Consequently will need a garbage collection to deal with deleted objects. This model has two flavours
-** using an generation id to tag the index handle, keep an translation table on each gc, mapping old indices to new ones and throw an exception when encountering an outdated handle
+For the implementation of the object references, as linked to the memory management in general, there seem to be the following approaches
+* the handle is a simple table index. Consequently will need a garbage collection to deal with deleted objects. This model has several flavours
+** using an generation ID to tag the index handle, keep an translation table on each gc, mapping old indices to new ones and raise an error when encountering an outdated handle
+** use a specific datastructure which allows the handles to remain valid in case of cleanup/reorganisation. (Hashtable or similar)
 ** keep track of all index handles to rewrite them on gc
-* handles are refcounting smart pointers. This solution is C++ specific, albeit more elegant and minimalistic. As all important interfaces should be accessible via C bindings, we'd need to use a replacement mechanism on the LayerSeparationInterfaces, which could be mapped to or handled by an C++ smart-ptr.
+* handles are refcounting smart pointers. This solution is C++ specific, albeit more elegant and minimalistic. As all important interfaces should be accessible via C bindings, we'd need to use a replacement mechanism on the LayerSeparationInterfaces, which could be mapped to or handled by an C++ smart-ptr. (We did similar for the PlayerDummy design study)
 </pre>
 </div>
 <div title="MObjects" modifier="Ichthyostega" modified="200810180118" created="200706190636" tags="overview" changecount="10">
@@ -2869,6 +2872,38 @@ We need a way of addressing existing [[pipes|Pipe]]. Besides, as the Pipes and T
 !!postprocessing
 &lt;&lt;task&gt;&gt;sort and group the assembled list of [[wiring requests|WiringRequest]] by pipes
 
+&lt;&lt;tasksum end&gt;&gt;
+</pre>
+</div>
+<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200904252308" created="200904252258" tags="impl SessionLogic draft" changecount="2">
+<pre>//This page is a scrapbook for working out the implementation of the [[Session Datastructure in Memory|SessionDataMem]]//
+This is a difficult untertaking, because there are several dependencies (most of which aren't fully designed yet as of 5/09)
+* the GUI uses an adapted version of the HighLevelModel; these datastructures are intended to be backed by the Session
+* of course, the structure of the HighLevelModel itself creates constraints on the session's data handling
+* the persistent SessionStorage depends on the requirements of the session in memory
+* the (currently as of 1/09 just half-way designed) [[Builder]] relies heavily on the data within the session.
+
+!!!requirements
+* can discover and ennumerate the structure
+* can ennumerate the contents (objects) of a specific scope
+* provide [[references|MObjectRef]] on these query/discovery operations
+
+!!!invariants
+* memory management consistency
+* support ongoing render processes
+* {{red{TODO: hrmpf}}}
+
+&lt;&lt;tasksum start&gt;&gt;
+&lt;&lt;taskadder below&gt;&gt;
+&lt;&lt;task &gt;&gt; define the general structure of operations
+&lt;&lt;task &gt;&gt; specify the editing operations
+
+!Interface
+&lt;&lt;task&gt;&gt;evaluate models for the [[reference problem|MObjectRef]]
+
+!Datastructure
+&lt;&lt;task&gt;&gt;investigate the best granularity for object collections
+
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
@@ -3405,7 +3440,7 @@ Rendering can be seen as a passive service available to the Backend, which remai
 <div title="STypeManager" modifier="Ichthyostega" created="200809220230" changecount="1">
 <pre>A facility allowing the Proc-Layer to work with abstracted [[media stream types|StreamType]], linking (abstract or opaque) [[type tags|StreamTypeDescriptor]] to an [[library|MediaImplLib]], which provides functionality for acutally dealing with data of this media stream type. Thus, the stream type manager is a kind of registry of all the external libraries which can be bridged and accessed by Lumiera (for working with media data, that is). The most basic set of libraries is instelled here automatically at application start, most notably the [[GAVL]] library for working with uncompressed video and audio data. //Later on, when plugins will introduce further external libraries, these need to be registered here too.//</pre>
 </div>
-<div title="Session" modifier="Ichthyostega" modified="200712100526" created="200712100525" tags="def" changecount="3">
+<div title="Session" modifier="Ichthyostega" modified="200904252215" created="200712100525" tags="def SessionLogic" changecount="4">
 <pre>The Session contains all informations, state and objects to be edited by the User. From a users view, the Session is synonymous to the //current Project//. It can be saved and loaded. The individual Objects within the Session, i.e. Clips, Media, Effects, are contained in one (or several) collections within the Session, which we call [[EDL (Edit Decision List)|EDL]]. &amp;rarr; [[Session design overview|SessionOverview]]
 
 !Session structure
@@ -3415,11 +3450,21 @@ The Session object is a singleton &amp;mdash; actually it is a »~PImpl«-Facade
 * a collection of ''global Pipes''
 * the ''Fixture'' with a possibility to [[(re)build it|PlanningBuildFixture]]</pre>
 </div>
+<div title="SessionDataMem" modifier="Ichthyostega" created="200904252303" tags="impl design SessionLogic draft" changecount="1">
+<pre>The Layout of the Session datastructure in memory is bound by several dependencies: GUI, HighLevelModel, SessionStorage, [[Builder]].
+Currently as of 5/09, this is an ongoing [[implementation and planning effort|PlanningSessionInMem]]</pre>
+</div>
 <div title="SessionInterface" modifier="Ichthyostega" modified="200904242109" created="200904242108" tags="SessionLogic GuiIntegration design draft discuss" changecount="2">
 <pre>{{red{WIP}}}</pre>
 </div>
-<div title="SessionLogic" modifier="Ichthyostega" modified="200904242111" created="200904242110" tags="overview" changecount="2">
-<pre>!Design and handling of the Session</pre>
+<div title="SessionLogic" modifier="Ichthyostega" modified="200904252317" created="200904242110" tags="overview" changecount="10">
+<pre>The Session contains all informations, state and objects to be edited by the User (&amp;rarr;[[def|Session]]).
+As such, the SessionInterface is the main entrance point to Proc-Layer functionality, both for the primary EditingOperations and for playback/rendering processes.
+
+Currently (as of 5/09), Ichthyo is [[targeting|PlanningSessionInMem]] a first preliminary implementation of the [[Session in Memory|SessionDataMem]]
+
+!Design and handling of Objects within the Session
+Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. They behave like //instances// of a given object, and at the same time define the &quot;non-substancial&quot; properties of the object, like its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render proceeses within the engine, but also to external parts within the GUI and in plugins.</pre>
 </div>
 <div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design" changecount="29">
 <pre>&lt;&lt;&lt;

From 7e51947c617a349440e1d9f747b774f057bcbfa9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 1 May 2009 02:17:23 +0200
Subject: [PATCH 007/368] investigating the handle based solution in more
 detail

---
 wiki/renderengine.html | 23 +++++++++++++----------
 1 file changed, 13 insertions(+), 10 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index bfaf190c6..dc449ea39 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1121,9 +1121,9 @@ The main tool used to implement this separation is the [[Builder Pattern|http://
 Another pertinent theme is to make the basic building blocks simpler, while on the other hand gaining much more flexibility for combining these building blocks. For example we try to unfold any &quot;internal-multi&quot; effects into separate instances (e.g. the possibility of having an arbitrary number of single masks at any point of the pipeline instead of having one special masking facility encompassing multiple sub-masks. Similarly, we treat the Objects in the EDL in a more uniform manner and gain the possibility to [[place|Placement]] them in various ways.
 </pre>
 </div>
-<div title="DisplayFacade" modifier="Ichthyostega" created="200902080703" tags="spec" changecount="1">
+<div title="DisplayFacade" modifier="Ichthyostega" modified="200904302316" created="200902080703" tags="spec" changecount="2">
 <pre>LayerSeparationInterface provided by the GUI.
-Access point especially for the playback. A render- or playback process uses the DisplayFacade to push media date up to the GUI for display within a viewer widget of full-screen display. This can be thought off as a callback mechanism. In order to use the DisplayFacade, client code needs a DisplayerSlot (handle), which needs to be set up by the UI first and will be provided when starting the render or playback process.
+Access point especially for the playback. A render- or playback process uses the DisplayFacade to push media data up to the GUI for display within a viewer widget of full-screen display. This can be thought off as a callback mechanism. In order to use the DisplayFacade, client code needs a DisplayerSlot (handle), which needs to be set up by the UI first and will be provided when starting the render or playback process.
 </pre>
 </div>
 <div title="DisplayService" modifier="Ichthyostega" created="200902080711" tags="def" changecount="1">
@@ -1855,8 +1855,8 @@ From experiences with other middle scale projects, I prefer having the test code
 [img[Example: Interfaces/Namespaces of the ~Session-Subsystems|uml/fig130053.png]]
 </pre>
 </div>
-<div title="LayerSeparationInterface" modifier="Ichthyostega" created="200902080635" tags="def" changecount="1">
-<pre>A major //business interfaces// &amp;mdash; used by the layers for interfacing to each other; also to be invoked externally by scripts.
+<div title="LayerSeparationInterface" modifier="Ichthyostega" modified="200904302314" created="200902080635" tags="def" changecount="2">
+<pre>A major //business interface// &amp;mdash; used by the layers for interfacing to each other; also to be invoked externally by scripts.
 &amp;rarr; [[overfiew and technical details|LayerSeparationInterfaces]]
 </pre>
 </div>
@@ -1920,18 +1920,21 @@ The general idea is, that each facade interface actually provides access to a sp
 * {{red{and what else?}}}
 </pre>
 </div>
-<div title="MObjectRef" modifier="Ichthyostega" modified="200904252227" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="7">
+<div title="MObjectRef" modifier="Ichthyostega" modified="200905010010" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="10">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
 
 {{red{WIP}}}
 
 !Two models
 For the implementation of the object references, as linked to the memory management in general, there seem to be the following approaches
-* the handle is a simple table index. Consequently will need a garbage collection to deal with deleted objects. This model has several flavours
-** using an generation ID to tag the index handle, keep an translation table on each gc, mapping old indices to new ones and raise an error when encountering an outdated handle
-** use a specific datastructure which allows the handles to remain valid in case of cleanup/reorganisation. (Hashtable or similar)
-** keep track of all index handles to rewrite them on gc
-* handles are refcounting smart pointers. This solution is C++ specific, albeit more elegant and minimalistic. As all important interfaces should be accessible via C bindings, we'd need to use a replacement mechanism on the LayerSeparationInterfaces, which could be mapped to or handled by an C++ smart-ptr. (We did similar for the PlayerDummy design study)
+* the handle is a simple table index. Consequently we'll need a garbage collection to deal with deleted objects. This model has several flavours
+** using an generation ID to tag the index handle, keep an translation table on each GC, mapping old indices to new ones and raise an error when encountering an outdated handle
+** use a specific datastructure allowing the handles to remain valid in case of cleanup/reorganisation. (Hashtable or similar)
+** keep track of all index handles and rewrite them on GC
+* handles are refcounting smart pointers. This solution is C++ specific, albeit more elegant and minimalistic. As all the main interfaces should be accessible via C bindings, we'd need to use a replacement mechanism on the LayerSeparationInterfaces, which could be mapped to or handled by an C++ smart-ptr. (We used a similar approach for the PlayerDummy design study)
+
+Obviously, the second approach has quite some appeal &amp;mdash; but, in order to use it, we'd have to mitigate its drawbacks: it bears the danger of creating a second separate code path for C language based clients, presumably receiving lesser care, maintenance and stress testing. The mentioned solution worked out earlier this year for the player mockup (1/2009) tries at least partially to integrate the C functionality, as the actual implementation is derived from the C struct used as handle, thus allowing to use the same pointers for both kinds of interface, and in turn by doing the de-allocation by a call through the C dtor function, which is installed as deleter function with the boost::smart_ptr used as base class of the handle. Conceptually, the interface on this handle is related to the actual implementation refered to by the handle (handle == smart_ptr) as if the latter was a subclass of the former. But on the level of the implementation, there is no inheritance relation between the handle and the referent, and especially this allows to define the handle's interface in terms of abstract interface types usable on the client side, while the referent's interface operates on the types of the service implementation. Thus, the drawback of using a C language interface is turned into the advantage of completely separating implementation and client.
+
 </pre>
 </div>
 <div title="MObjects" modifier="Ichthyostega" modified="200810180118" created="200706190636" tags="overview" changecount="10">

From 9b3ca200e7dfc6c5847feb01a4204e6113198a56 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 9 May 2009 03:08:38 +0200
Subject: [PATCH 008/368] considering new facilities for referring to
 placements

---
 src/lib/p.hpp                                 |  8 +-
 src/proc/mobject/placement-index.hpp          | 62 +++++++++++++++
 src/proc/mobject/placement-ref.hpp            | 62 +++++++++++++++
 src/proc/mobject/placement.hpp                | 18 ++---
 tests/43session.tests                         |  8 ++
 tests/components/Makefile.am                  |  4 +-
 ...basictest.cpp => placement-basic-test.cpp} |  0
 .../proc/mobject/placement-index-test.cpp     | 76 +++++++++++++++++++
 .../proc/mobject/placement-ref-test.cpp       | 75 ++++++++++++++++++
 wiki/renderengine.html                        | 40 ++++++++--
 10 files changed, 333 insertions(+), 20 deletions(-)
 create mode 100644 src/proc/mobject/placement-index.hpp
 create mode 100644 src/proc/mobject/placement-ref.hpp
 rename tests/components/proc/mobject/{placementbasictest.cpp => placement-basic-test.cpp} (100%)
 create mode 100644 tests/components/proc/mobject/placement-index-test.cpp
 create mode 100644 tests/components/proc/mobject/placement-ref-test.cpp

diff --git a/src/lib/p.hpp b/src/lib/p.hpp
index 0a1deb5fc..5f72fd2b0 100644
--- a/src/lib/p.hpp
+++ b/src/lib/p.hpp
@@ -1,5 +1,5 @@
 /*
-  P.hpp  -  customized shared_ptr with ordering and type relationships
+  P.hpp  -  customised shared_ptr with ordering and type relationships
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,19 +21,19 @@
 */
 
 /** @file p.hpp
- ** customized refcounting smart pointer.
+ ** Customised refcounting smart pointer.
  ** Template derived from std::tr1::shared_ptr adding total ordering and 
  ** type relationships implemented by forwarding to the pointees. In all other
  ** respects, it should behave exactly as shared_ptr and is able to cooperate
  ** and share ownership with other shared_ptr instantiations.
  ** 
  ** By default different instantiations of shared_ptr are completely unrelated types,
- ** even if using inherintance related type parameters for instantiation: a shared_ptr<Media>
+ ** even if using inheritance related type parameters for instantiation: a shared_ptr<Media>
  ** isn't some kind-of shared_ptr<Asset> -- we need to do an explicit static_ptr_cast. Another
  ** common problem is the definition of equality and ordering relations for shared_ptr: 
  ** equality is based on the equality of the managed pointers, while ordering is built upon
  ** the ref count. While generally this may be a good compromise, in our case it hinders treating
- ** the smart ptrs within the application almost as if they were the objects themselfs and proved
+ ** the smart ptrs within the application almost as if they were the objects themselves and proved
  ** an obstacle for writing generic helper functions.
  **
  ** the P template resolves these problems by implementing the ordering operators in terms of
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
new file mode 100644
index 000000000..2df8be57e
--- /dev/null
+++ b/src/proc/mobject/placement-index.hpp
@@ -0,0 +1,62 @@
+/*
+  PLACEMENT-INDEX.hpp  -  tracking individual Placements and their relations
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file placement-ref.hpp 
+ **
+ ** @see Placement
+ ** @see PlacementRef_test
+ **
+ */
+
+
+
+#ifndef MOBJECT_PLACEMENT__REF_H
+#define MOBJECT_PLACEMENT__REF_H
+
+//#include "pre.hpp"
+//#include "proc/mobject/session/locatingpin.hpp"
+//#include "proc/asset/pipe.hpp"
+
+//#include <tr1/memory>
+
+
+namespace mobject {
+
+//  using std::tr1::shared_ptr;
+
+  
+  
+  /**
+   */
+  class PlacementRef
+    {
+    };
+  
+  
+  
+  
+  
+
+
+} // namespace mobject
+#endif
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
new file mode 100644
index 000000000..7e04514d7
--- /dev/null
+++ b/src/proc/mobject/placement-ref.hpp
@@ -0,0 +1,62 @@
+/*
+  PLACEMENT-REF.hpp  -  generic reference to an individual placement added to the session
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file placement-ref.hpp 
+ **
+ ** @see Placement
+ ** @see PlacementRef_test
+ **
+ */
+
+
+
+#ifndef MOBJECT_PLACEMENT__REF_H
+#define MOBJECT_PLACEMENT__REF_H
+
+//#include "pre.hpp"
+//#include "proc/mobject/session/locatingpin.hpp"
+//#include "proc/asset/pipe.hpp"
+
+//#include <tr1/memory>
+
+
+namespace mobject {
+
+//  using std::tr1::shared_ptr;
+
+  
+  
+  /**
+   */
+  class PlacementRef
+    {
+    };
+  
+  
+  
+  
+  
+
+
+} // namespace mobject
+#endif
diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp
index df71f0d75..a68f3dbce 100644
--- a/src/proc/mobject/placement.hpp
+++ b/src/proc/mobject/placement.hpp
@@ -36,7 +36,7 @@
  **
  ** Besides being a handle, Placements define the logical position where some MObject is
  ** supposed to be located within the EDL or Fixture. The way in which this placing happens
- ** is controlled and parametrized by a collection (chain) of LocatingPin objects. By adding
+ ** is controlled and parametrised by a collection (chain) of LocatingPin objects. By adding
  ** to this chain, the position of the MObject is increasingly constrained. The simplest
  ** case of such constraining is to add a FixedLocation, thus placing the MObject at one
  ** absolute position (time, track).
@@ -44,7 +44,7 @@
  ** Placements are templated on the type of the actual MObject they refer to, so, sometimes
  ** we rather use a Placement<Clip> to be able to use the more specific methods of the
  ** session::Clip interface. But <i>please note the following detail:</i> this type
- ** labeling and downcasting is the <i>only</i> difference between these subclasses, 
+ ** labelling and downcasting is the <i>only</i> difference between these subclasses, 
  ** besides that, they can be replaced literally by one another (slicing is accepted).
  **
  ** @see ExplicitPlacement
@@ -64,14 +64,14 @@
 #include <tr1/memory>
 
 
-namespace mobject
-  {
+namespace mobject {
+  
   namespace session{ class MObjectFactory; }
-
+  
   class ExplicitPlacement;
   
   using std::tr1::shared_ptr;
-
+  
   
   
   /**
@@ -88,8 +88,8 @@ namespace mobject
       typedef lumiera::Time Time;
       typedef asset::shared_ptr<asset::Pipe> Pipe;
       
-
-
+      
+      
     public:
       /** smart pointer: accessing the MObject, 
        *  which is subject to placement.
@@ -107,7 +107,7 @@ namespace mobject
       
       virtual ~Placement() {};
       
-
+      
       
       /** interface for defining the kind of placement
        *  to employ, and for controling any additional
diff --git a/tests/43session.tests b/tests/43session.tests
index 887cbdf4c..b72392b8b 100644
--- a/tests/43session.tests
+++ b/tests/43session.tests
@@ -29,6 +29,14 @@ PLANNED "PlacementBasic_test" PlacementBasic_test <<END
 END
 
 
+PLANNED "PlacementIndex_test" PlacementIndex_test <<END
+END
+
+
+PLANNED "PlacementRef_test" PlacementRef_test <<END
+END
+
+
 PLANNED "RebuildFixture_test" RebuildFixture_test <<END
 END
 
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index d6229ea43..cf61adbf4 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -52,7 +52,9 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildsegmenttest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/controller/rendersegmenttest.cpp	\
-	$(testcomponents_srcdir)/proc/mobject/placementbasictest.cpp		\
+	$(testcomponents_srcdir)/proc/mobject/placement-basic-test.cpp		\
+	$(testcomponents_srcdir)/proc/mobject/placement-index-test.cpp		\
+	$(testcomponents_srcdir)/proc/mobject/placement-ref-test.cpp		\
 	$(testcomponents_srcdir)/proc/mobject/session/addcliptest.cpp		\
 	$(testcomponents_srcdir)/proc/mobject/session/deletecliptest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/session/rebuildfixturetest.cpp	\
diff --git a/tests/components/proc/mobject/placementbasictest.cpp b/tests/components/proc/mobject/placement-basic-test.cpp
similarity index 100%
rename from tests/components/proc/mobject/placementbasictest.cpp
rename to tests/components/proc/mobject/placement-basic-test.cpp
diff --git a/tests/components/proc/mobject/placement-index-test.cpp b/tests/components/proc/mobject/placement-index-test.cpp
new file mode 100644
index 000000000..64fe5370c
--- /dev/null
+++ b/tests/components/proc/mobject/placement-index-test.cpp
@@ -0,0 +1,76 @@
+/*
+  PlacementIndex(Test)  -  facility keeping track of Placements within the Session
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+//#include <iostream>
+
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+//using std::cout;
+
+
+namespace mobject {
+namespace session {
+namespace test    {
+      
+  using asset::VIDEO;
+  
+  
+  
+  /***************************************************************************
+   * @test basic behaviour of the index mechanism used to keep track of
+   *       individual Placements as added to the current Session..
+   * @see  mobject::Placement
+   * @see  mobject::MObject#create
+   * @see  mobject::Placement#addPlacement
+   * @see  mobject::Placement#resolve
+   */
+  class PlacementIndex_test : public Test
+    {
+      typedef shared_ptr<asset::Media> PM;
+      typedef shared_ptr<asset::Clip> PCA;
+      
+      virtual void
+      run (Arg) 
+        {
+          /////////////////////////////////TODO
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (PlacementIndex_test, "unit session");
+      
+      
+}}} // namespace mobject::session::test
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
new file mode 100644
index 000000000..20e38cede
--- /dev/null
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -0,0 +1,75 @@
+/*
+  PlacementRef(Test)  -  generic reference to a Placement within the Session
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+//#include <iostream>
+
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+//using std::cout;
+
+
+namespace mobject {
+namespace session {
+namespace test    {
+      
+  using asset::VIDEO;
+  
+  
+  
+  /***************************************************************************
+   * @test properties and behaviour of the reference-mechanism for Placements.
+   * @see  mobject::Placement
+   * @see  mobject::MObject#create
+   * @see  mobject::Placement#addPlacement
+   * @see  mobject::Placement#resolve
+   */
+  class PlacementRef_test : public Test
+    {
+      typedef shared_ptr<asset::Media> PM;
+      typedef shared_ptr<asset::Clip> PCA;
+      
+      virtual void
+      run (Arg) 
+        {
+          /////////////////////////////////TODO
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (PlacementRef_test, "unit session");
+      
+      
+}}} // namespace mobject::session::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index dc449ea39..c99e9b671 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1920,10 +1920,17 @@ The general idea is, that each facade interface actually provides access to a sp
 * {{red{and what else?}}}
 </pre>
 </div>
-<div title="MObjectRef" modifier="Ichthyostega" modified="200905010010" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="10">
+<div title="MObjectRef" modifier="Ichthyostega" modified="200905090026" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="16">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
+Moreover [[MObject instances|MObject]] have a 2-level structure: the core object holds just the properties in a strict sense, i.e. the properties which the object //owns.// Any properties due to putting the object into a specific context, i.e. all relation properties are represented as [[Placement]] of the object. Thus, a reference to a specific ~MObject //instance,// actually denotes a specific Placement of this object into the Session.
 
-{{red{WIP}}}
+!Requirements
+* just the reference allone is sufficient to access the placement //and//&amp;nbsp; the core object.
+* the reference needs to be valid even after internal restructuring in the object store.
+* there must be a way to pass these references through serialisation/deserialisation
+* we need a plain-C representation of the reference, which ideally should be incorporated into the complete implementation
+* references should either be integrated into memory management, or at least it should be possible to detect dangling references
+* it should be possible to make handling of the references completely transparent, if the implementation language supports doing so.
 
 !Two models
 For the implementation of the object references, as linked to the memory management in general, there seem to be the following approaches
@@ -1935,6 +1942,11 @@ For the implementation of the object references, as linked to the memory managem
 
 Obviously, the second approach has quite some appeal &amp;mdash; but, in order to use it, we'd have to mitigate its drawbacks: it bears the danger of creating a second separate code path for C language based clients, presumably receiving lesser care, maintenance and stress testing. The mentioned solution worked out earlier this year for the player mockup (1/2009) tries at least partially to integrate the C functionality, as the actual implementation is derived from the C struct used as handle, thus allowing to use the same pointers for both kinds of interface, and in turn by doing the de-allocation by a call through the C dtor function, which is installed as deleter function with the boost::smart_ptr used as base class of the handle. Conceptually, the interface on this handle is related to the actual implementation refered to by the handle (handle == smart_ptr) as if the latter was a subclass of the former. But on the level of the implementation, there is no inheritance relation between the handle and the referent, and especially this allows to define the handle's interface in terms of abstract interface types usable on the client side, while the referent's interface operates on the types of the service implementation. Thus, the drawback of using a C language interface is turned into the advantage of completely separating implementation and client.
 
+!Implementation concept
+Presumably, none of the both models is usable as-is; rather we try to reconstruct the viable properties of both, starting out with the more elegant second model. Thus, basically the ''reference is a smart-ptr'' referring to the core object. Additionally, it incorporates a ''systematic ID denoting the location of the placement''. This ID without the smart-ptr part is used for the C-implementation, making the full handle implementation a shortcut for an access sequence, which first querries the placement from the Session, followed by dereferencing the placement to get at the core object. Thus, the implementation builds upon another abstraction, the &amp;rarr; PlacementRef, which in turn assumes for an index within the implementation of the [[session datastructure|SessionDataMem]] to track and retrieve the actual Placement.
+
+
+{{red{WIP}}}
 </pre>
 </div>
 <div title="MObjects" modifier="Ichthyostega" modified="200810180118" created="200706190636" tags="overview" changecount="10">
@@ -2739,12 +2751,16 @@ there is not much you can do directly with a pipe asset. It is an point of refer
 Pipes are integrated with the [[management of defaults|DefaultsManagement]]. For example, any pipe uses implicitly some [[processing pattern|ProcPatt]] &amp;mdash; it may default to the empty pattern. This feature enables to apply some standard wiring to the pipes (e.g a fader for audio, similar to the classic mixing consoles). This //is // a global property of the pipe, but &amp;mdash; contrary to the stream type &amp;mdash; this pattern may be switched
 </pre>
 </div>
-<div title="Placement" modifier="Ichthyostega" modified="200805260156" created="200706220306" tags="def" changecount="8">
+<div title="Placement" modifier="Ichthyostega" modified="200905090045" created="200706220306" tags="def" changecount="9">
 <pre>A Placement represents a //relation:// it is always linked to a //Subject// (this being a [[Media Object|MObject]]) and has the meaning to //place// this Subject in some manner, either relatively to other Media Objects, or by some Constraint or simply absolute at (time, output). The latter case is especially important for the build process and thus represented by a special [[Sub-Interface ExplicitPlacement|ExplicitPlacement]]. Besides this simple cases, Placements can also express more specific kinds of &quot;locating&quot; an object, like placing a sound source at a pan position or placing a video clip at a given layer (above or below another video clip)
 
 So basically placements represent a query interface: you can allways ask the placement to find out about the position of the related object in terms of (time, output), and &amp;mdash; depending on the specific object and situation &amp;mdash; also about these additional [[placement derived dimensions|PlacementDerivedDimension]] like sound pan or layer order or similar things which also fit into the general concept of &quot;placing&quot; an object.
 
-The fact of being placed in the [[Session|SessionOverview]]/[[EDL]]is constitutive for all sorts of [[MObject]]s, without Placement they make no sense. Thus &amp;mdash; technically &amp;mdash; Placements act as ''smart pointers''. Of course, there are several kinds of Placements and they are templated on the type of MObject they are refering to. Placements can be //aggregated// to increasingly constrain the resulting &quot;location&quot; of the refered ~MObject. See &amp;rarr; [[handling of Placements|PlacementHandling]] for more details</pre>
+The fact of being placed in the [[Session|SessionOverview]]/[[EDL]]is constitutive for all sorts of [[MObject]]s, without Placement they make no sense. Thus &amp;mdash; technically &amp;mdash; Placements act as ''smart pointers''. Of course, there are several kinds of Placements and they are templated on the type of MObject they are refering to. Placements can be //aggregated// to increasingly constrain the resulting &quot;location&quot; of the refered ~MObject. See &amp;rarr; [[handling of Placements|PlacementHandling]] for more details
+
+!Placements as instance
+Effectively, the placement of a given MObject into the Session acts as setting up an concrete instance of this object. This way, placements exhibit a dual nature. When viewed on themselves, like any reference or smart-pointer they behave like values. But, by adding a placement to the session, we again create a unique distinguishable entity with reference semantics: there could be multiple placements of the same object but with varying placement properties. Such a placement-bound-into-the-session is denoted by an generic placement-ID or (as we call it) &amp;rarr; PlacementRef; behind the scenes there is a PlacementIndex keeping track of those &quot;instances&quot; &amp;mdash; allowing us to hand out the PlacementRef (which is just an opaque id) to client code outside the Proc-Layer and generally use it as an shorthand, behaving as if it was an MObject instance
+</pre>
 </div>
 <div title="PlacementDerivedDimension" modifier="Ichthyostega" modified="200805260223" created="200805260219" tags="def spec" changecount="3">
 <pre>For any [[media object|MObject]] within the session, we can allways at least query the time (reference/start) point and the output destination from the [[Placement]], by which the object is being handled. But the simple act of placing an object in some way, can &amp;mdash; depending on the context &amp;mdash; create additional degrees of freedom. To list some important examples:
@@ -2784,6 +2800,16 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
+<div title="PlacementIndex" modifier="Ichthyostega" created="200905090053" tags="SessionLogic spec impl draft" changecount="1">
+<pre>An implementation facility used to keep track of individual Placements and their relations.
+Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
+
+</pre>
+</div>
+<div title="PlacementRef" modifier="Ichthyostega" created="200905090032" tags="def spec draft" changecount="1">
+<pre>A generic reference mechanism for Placements, as added to the current session.
+While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object.</pre>
+</div>
 <div title="PlanningBuildFixture" modifier="Ichthyostega" modified="200801061937" created="200712100445" tags="impl Builder draft" changecount="11">
 <pre>//This page is a scrapbook for working out the implementation of how to (re)build the [[Fixture]]//
 Structurally, (re)building the Fixture rather belongs to [[Session]]/[[EDLs|EDL]], but it is implemented very similar to the render engine build process: by treating all ~MObjects found in the various ~EDLs with a common [[visiting tool|VisitorUse]], this tool collects a simplified view with everyting made explicit, which can be pulled of as Fixture, i.e. (special kind of) EDL
@@ -3453,9 +3479,11 @@ The Session object is a singleton &amp;mdash; actually it is a »~PImpl«-Facade
 * a collection of ''global Pipes''
 * the ''Fixture'' with a possibility to [[(re)build it|PlanningBuildFixture]]</pre>
 </div>
-<div title="SessionDataMem" modifier="Ichthyostega" created="200904252303" tags="impl design SessionLogic draft" changecount="1">
+<div title="SessionDataMem" modifier="Ichthyostega" modified="200905082325" created="200904252303" tags="impl design SessionLogic draft" changecount="2">
 <pre>The Layout of the Session datastructure in memory is bound by several dependencies: GUI, HighLevelModel, SessionStorage, [[Builder]].
-Currently as of 5/09, this is an ongoing [[implementation and planning effort|PlanningSessionInMem]]</pre>
+Currently as of 5/09, this is an ongoing [[implementation and planning effort|PlanningSessionInMem]]
+
+{{red{TODO...}}}</pre>
 </div>
 <div title="SessionInterface" modifier="Ichthyostega" modified="200904242109" created="200904242108" tags="SessionLogic GuiIntegration design draft discuss" changecount="2">
 <pre>{{red{WIP}}}</pre>

From 8f8831c8b3c4906c171237efeb21ab93d335c354 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 9 May 2009 17:32:29 +0200
Subject: [PATCH 009/368] planning index structure..

---
 src/lib/accesscasted.hpp             |  4 ++--
 src/lib/variant.hpp                  | 12 ++++++------
 src/lib/wrapperptr.hpp               |  6 +++---
 src/proc/mobject/placement-index.hpp | 12 ++++++------
 src/proc/mobject/placement-ref.hpp   | 10 +++++++++-
 tests/lib/factoryspecialtest.cpp     |  4 ++--
 wiki/renderengine.html               | 25 ++++++++++++++++++++++---
 7 files changed, 50 insertions(+), 23 deletions(-)

diff --git a/src/lib/accesscasted.hpp b/src/lib/accesscasted.hpp
index 58f2e2dbc..b6832f37f 100644
--- a/src/lib/accesscasted.hpp
+++ b/src/lib/accesscasted.hpp
@@ -27,10 +27,10 @@
  ** and the target type (type we need within the usage context). 
  ** When instantiating AcessCasted<TAR>, we get a template static function
  ** \c AcessCasted<TAR>::access<SRC>(SRC& elm), but the actual implementation
- ** is choosed using boost::type_traits. If no viable implementatino can be
+ ** is chosen using boost::type_traits. If no viable implementation can be
  ** selected, \c EmptyVal<TAR>::create() is invoked instead, which by default
  ** creates a NULL value or similar by using the no-argument ctor of the
- ** type TAR. Alternatively, you may define an specialisation fo EmptyVal,
+ ** type TAR. Alternatively, you may define an specialisation of EmptyVal,
  ** e.g. throwing an exception instead of creating a NULL value. 
  ** 
  ** @see lumiera::WrapperPtr usage example to access a variant record
diff --git a/src/lib/variant.hpp b/src/lib/variant.hpp
index 15002b7f8..3f9cea028 100644
--- a/src/lib/variant.hpp
+++ b/src/lib/variant.hpp
@@ -24,7 +24,7 @@
 /** @file variant.hpp
  ** This file defines a simple alternative to boost::variant.
  ** It pulls in fewer headers and has a shorter code path, but also
- ** doesn't deal with alignement issues and is <b>not threadsafe</b>. 
+ ** doesn't deal with alignment issues and is <b>not threadsafe</b>. 
  ** 
  ** Values can be stored using \c operator= . In order to access the value
  ** stored in lumiera::Variant, you additionally need to define a "functor" 
@@ -58,7 +58,7 @@ namespace lumiera {
     
     /**
      * internal helper used to build a variant storage wrapper.
-     * Parametrized with a collection of types, it provides functionality
+     * Parametrised with a collection of types, it provides functionality
      * to copy a value of one of these types into an internal buffer, while
      * remembering which of these types was used to place this copy.
      * The value can be later on extracted using a visitation like mechanism,
@@ -214,10 +214,10 @@ namespace lumiera {
    * This utility class is similar to boost::variant and indeed was implemented
    * (5/08) in an effort to replace the latter in a draft solution for the problem
    * of typesafe access to the correct wrapper class from within some builder tool.
-   * Well -- after finisihng this "exercise" I must admit that it is not really
+   * Well -- after finishing this "exercise" I must admit that it is not really
    * much more simple than what boost::variant does internally. At least we are
    * pulling in fewer headers and the actual code path is shorter compared with
-   * boost::variant, at the price of beeing not so generic, not caring for
+   * boost::variant, at the price of being not so generic, not caring for
    * alignment issues within the buffer and being <b>not threadsafe</b>
    * 
    * @param TYPES   collection of possible types to be stored in this variant object
@@ -234,8 +234,8 @@ namespace lumiera {
       typedef typename Holder::Deleter Deleter;
       
       
-      /** storage: buffer holding either and "empty" marker,
-       *  or one of the configured pointer to wrapper types */ 
+      /** storage: buffer holding either an "empty" marker,
+       *  or an instance of one of the configured payload types */ 
       typename Holder::Storage holder_;
       
       
diff --git a/src/lib/wrapperptr.hpp b/src/lib/wrapperptr.hpp
index c9b8bcd70..db168cba1 100644
--- a/src/lib/wrapperptr.hpp
+++ b/src/lib/wrapperptr.hpp
@@ -51,9 +51,9 @@ namespace lumiera {
    * with the possible hierarchy-base classes used within this application.
    * Thus, when passing in an arbitrary smart-ptr, the best fitting smart-ptr
    * type pointing to the corresponding base class is selected for internal storage.
-   * Later on, stored values can be retrieved either utilitzing static or dynamic casts;
-   * error reporting is similar to the bahaviour of dynamic_cast<T>: when retrieving
-   * a pointer, in case of mismatch NULL is returned.
+   * Later on, stored values can be retrieved either utilising static or dynamic casts;
+   * error reporting is similar to the behaviour of dynamic_cast<T>: when retrieving
+   * a pointer, NULL is returned in case of mismatch.
    */
   typedef lumiera::Variant<WrapperTypes, util::AccessCasted> WrapperPtr;
   
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 2df8be57e..86904591c 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -21,17 +21,17 @@
 */
 
 
-/** @file placement-ref.hpp 
+/** @file placement-index.hpp 
  **
- ** @see Placement
- ** @see PlacementRef_test
+ ** @see PlacementRef
+ ** @see PlacementIndex_test
  **
  */
 
 
 
-#ifndef MOBJECT_PLACEMENT__REF_H
-#define MOBJECT_PLACEMENT__REF_H
+#ifndef MOBJECT_PLACEMENT_INDEX_H
+#define MOBJECT_PLACEMENT_INDEX_H
 
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
@@ -48,7 +48,7 @@ namespace mobject {
   
   /**
    */
-  class PlacementRef
+  class PlacementIndex
     {
     };
   
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index 7e04514d7..a2035ea14 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -43,13 +43,21 @@
 namespace mobject {
 
 //  using std::tr1::shared_ptr;
-
+  
   
   
   /**
    */
   class PlacementRef
     {
+      /**
+       * 
+       */
+      class ID
+        {
+        };
+      
+      
     };
   
   
diff --git a/tests/lib/factoryspecialtest.cpp b/tests/lib/factoryspecialtest.cpp
index 6850f057a..26fda9084 100644
--- a/tests/lib/factoryspecialtest.cpp
+++ b/tests/lib/factoryspecialtest.cpp
@@ -188,8 +188,8 @@ namespace lumiera
     
     /*******************************************************************
      * testing the more advanced Factory variants and possibilities.
-     * We use several customized Factory subclasses supporting custom
-     * allocation, placement allocation, private construcors and
+     * We use several customised Factory subclasses supporting custom
+     * allocation, placement allocation, private constructors and
      * the PIpmpl design pattern. All creating smart pointers.
      */
     class Factory_special_test : public Test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index c99e9b671..0316aaf8d 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -2800,15 +2800,34 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
-<div title="PlacementIndex" modifier="Ichthyostega" created="200905090053" tags="SessionLogic spec impl draft" changecount="1">
+<div title="PlacementIndex" modifier="Ichthyostega" modified="200905091529" created="200905090053" tags="SessionLogic spec impl draft" changecount="3">
 <pre>An implementation facility used to keep track of individual Placements and their relations.
 Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
 
+!questions {{red{WIP}}}
+What implementation approach to take for the index. This of course largely depends on the usage pattern, which in turn is not-yet existant. To start with, we need a preliminary implementation!
+
+Using a ''flat hashtable'' would allow to access a Placement denoted by ID in O(1). This way we could get the Placement, but nothing more. So, additionally we'd have to set up an data record holding additional information:
+* the scope containing this placement
+* especially the path &quot;up&quot; from this scope, which is used for resolving any queries
+* relations to other placements
+
+Alternatively, we could try to use a ''structure based index''. Following this idea, we could try to avoid the mntioned description record by folding any of the contained informations into the surrounding datastructure:
+* the scope would be obvious from the index, resp. from the path used to resolve this index
+* any other informations, especially the relations, would be folded into the placement
+* this way, the &quot;index&quot; could be reduced to being the session datastructure itself.
+
 </pre>
 </div>
-<div title="PlacementRef" modifier="Ichthyostega" created="200905090032" tags="def spec draft" changecount="1">
+<div title="PlacementRef" modifier="Ichthyostega" modified="200905091516" created="200905090032" tags="def spec draft" changecount="2">
 <pre>A generic reference mechanism for Placements, as added to the current session.
-While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object.</pre>
+While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object.
+
+!questions {{red{WIP}}}
+Currently (5/09) ichthyo is in doubt what implementation to use best. It is clear that the PlacementRef needs to incorporate as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, the design decision boils down to the question how to implement the ID tag.
+* a flat random hash, e.g. using a {{{LUID}}}?
+* a structure based index, which also denotes the position in the (tree like) datastructure (Sequences within the session)?
+</pre>
 </div>
 <div title="PlanningBuildFixture" modifier="Ichthyostega" modified="200801061937" created="200712100445" tags="impl Builder draft" changecount="11">
 <pre>//This page is a scrapbook for working out the implementation of how to (re)build the [[Fixture]]//

From b5a1e75bb759778c9f886e1ff313619f8462abb8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 11 May 2009 03:27:08 +0200
Subject: [PATCH 010/368] considering which operations to support on the index

---
 wiki/renderengine.html | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 0316aaf8d..e394e1b4b 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -2800,7 +2800,7 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
-<div title="PlacementIndex" modifier="Ichthyostega" modified="200905091529" created="200905090053" tags="SessionLogic spec impl draft" changecount="3">
+<div title="PlacementIndex" modifier="Ichthyostega" modified="200905110126" created="200905090053" tags="SessionLogic spec impl draft" changecount="6">
 <pre>An implementation facility used to keep track of individual Placements and their relations.
 Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
 
@@ -2817,6 +2817,19 @@ Alternatively, we could try to use a ''structure based index''. Following this i
 * any other informations, especially the relations, would be folded into the placement
 * this way, the &quot;index&quot; could be reduced to being the session datastructure itself.
 
+
+!supported operations {{red{WIP}}}
+The placement index is utilized by editing operations, by executing the build process and besides these core operations it allows resolving PlacementRef objects (which possibly may have crossed layer boundaries). From these use cases we derive the following main operations to support:
+* find the actual [[Placement]] object for a given ID
+* find the scope a given placement resides in. More specifically, find the placement defining this scope
+* find (any/all) other placements referring to a given placement
+* add a new placement to a scope given as parameter
+* remove a placement from index
+
+//does a placement need to know it's own ID?// Obviously, there needs to be a way to find out the ID for a given placement, especially in the following situations:
+* for most of the operations above, when querying some additional informations from index for a given placement
+* to create a PlacementRef (this is a variant of the &quot;shared ptr from this&quot;-problem)
+On second sight, this problem seems to be quite nasty, because either we have to keep a second indext table for the reversed lookup (memory address -&gt; ID), or have to tie the placement by a backlink when adding it to the index/session datastructure, or (at least) it forces us to store a copy of the ID //within// the placement itself. The last possibility seems to create the least impact; but implementing it this way effectively gears the implementation towards a hashtable based approach.
 </pre>
 </div>
 <div title="PlacementRef" modifier="Ichthyostega" modified="200905091516" created="200905090032" tags="def spec draft" changecount="2">

From b32c3f5898b65feadc609f7b3b64179d75778634 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 12 May 2009 05:49:37 +0200
Subject: [PATCH 011/368] defining the concept of a placement scope

---
 wiki/renderengine.html | 23 ++++++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index e394e1b4b..507807e87 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -579,7 +579,7 @@ For every Asset we generate a __Ident tuple__ and a long ID (hash) derived from
 <div title="AssetManager" modifier="Ichthyostega" created="200709200300" changecount="1">
 <pre>The Asset Manager provides an Interface to some internal Database holding all Assets in the current Session and System state. It may be a real Database at some point (and for the moment it's a Hashtable). Each [[Asset]] is registered automatically with the Asset Manager; it can be queried either by it's //identification tuple// or by it's unique ID.</pre>
 </div>
-<div title="AttachedPlacementProblem" modifier="Ichthyostega" modified="200808140050" created="200801111305" tags="impl draft dynamic" changecount="13">
+<div title="AttachedPlacementProblem" modifier="Ichthyostega" modified="200905120332" created="200801111305" tags="SessionLogic impl draft dynamic" changecount="14">
 <pre>Placing an MObject relatively to another object such that it should be handled as //attached//&amp;nbsp; to the latter results in several design and implementation challenges. Actually, such an attachment creates a cluster of objects. The typical use case is that of an effect attached to a clip or processing pipe.
 * attachment is not a globally fixed relation between objects, rather, it typically exists only for some limited time span (e.g. the duration of the basic clip the effect is attached to)
 * the order of attachment is important and the attached placement may create a fork in the signal flow, so we need a way for specifying reproducibly how the resulting wiring should be
@@ -2800,7 +2800,7 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
-<div title="PlacementIndex" modifier="Ichthyostega" modified="200905110126" created="200905090053" tags="SessionLogic spec impl draft" changecount="6">
+<div title="PlacementIndex" modifier="Ichthyostega" modified="200905120331" created="200905090053" tags="SessionLogic spec impl draft" changecount="8">
 <pre>An implementation facility used to keep track of individual Placements and their relations.
 Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
 
@@ -2821,7 +2821,7 @@ Alternatively, we could try to use a ''structure based index''. Following this i
 !supported operations {{red{WIP}}}
 The placement index is utilized by editing operations, by executing the build process and besides these core operations it allows resolving PlacementRef objects (which possibly may have crossed layer boundaries). From these use cases we derive the following main operations to support:
 * find the actual [[Placement]] object for a given ID
-* find the scope a given placement resides in. More specifically, find the placement defining this scope
+* find the //scope//&amp;nbsp; a given placement resides in. More specifically, find the [[placement defining this scope|PlacementScope]]
 * find (any/all) other placements referring to a given placement
 * add a new placement to a scope given as parameter
 * remove a placement from index
@@ -2842,6 +2842,23 @@ Currently (5/09) ichthyo is in doubt what implementation to use best. It is clea
 * a structure based index, which also denotes the position in the (tree like) datastructure (Sequences within the session)?
 </pre>
 </div>
+<div title="PlacementScope" modifier="Ichthyostega" modified="200905120348" created="200905120304" tags="SessionLogic spec draft" changecount="4">
+<pre>MObjects are attached into the [[Session]] by adding a [[Placement]]. Because this especially includes the case of //grouping or container objects,// e.g. tracks or [[meta-clips|VirtualClip]], any placement may optionally define and root a scope, and every placement is at least contained in one encompassing scope &amp;mdash; of course with the exception of the absolute top level, which can be thought off as being contained in a scope of handling rules.
+
+Thus, while the [[sequences (former called EDL)|EDL]] act as generic container holding a pile of placments, actually there is a more fine grained structure based on the nesting of the tracks, which especially in Lumiera's HighLevelModel belong to the sequence (they aren't a property of the top level timeline as one might expect). Building upon these observations, we actually require each addition of a placement to specify a scope. The implementation of this tie-to-scope is provided by the same mechanism as utilized for relative placements, i.e. an directional placement relation.
+
+!Kinds of scopes
+There is only a limited number of situations constituting a scope
+* conceptually, the very top level is a scope of general rules (but it is hard-wired, not implemented as placement) {{red{really?}}}
+* similarily, the link binding a [[Sequence|EDL]] into either a (top-level) timeline or as virtual media into a VirtualClip is rather special.
+* each sequence has at least one (manadtory) top-level placement holding its root track
+* tracks may contain nested sub tracks.
+* clips and (track-level) effects likewise are associated with an enclosing track.
+* an important special case of relative placement is when an object is [[attached|AttachedPlacementProblem]] to another leading object, like e.g. an effect modifying a clip
+
+In any case, adding a placement to a scope is to be implemented such as to ensure the presence of a suitable LocatingPin, serving to tie the placement into the scope. This LocatingPin in turn will manage a relation to the scope-defining placement, and by doing so, it will insert the relation information into the [[index|PlacementIndex]]. The remaining problem for the implementation is to find a suitable factory function to set up the mentioned pin.
+</pre>
+</div>
 <div title="PlanningBuildFixture" modifier="Ichthyostega" modified="200801061937" created="200712100445" tags="impl Builder draft" changecount="11">
 <pre>//This page is a scrapbook for working out the implementation of how to (re)build the [[Fixture]]//
 Structurally, (re)building the Fixture rather belongs to [[Session]]/[[EDLs|EDL]], but it is implemented very similar to the render engine build process: by treating all ~MObjects found in the various ~EDLs with a common [[visiting tool|VisitorUse]], this tool collects a simplified view with everyting made explicit, which can be pulled of as Fixture, i.e. (special kind of) EDL

From 7abada72fdaa442f26dd4cd856e25f88ff889c5f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 13 May 2009 03:46:08 +0200
Subject: [PATCH 012/368] a bit of API brainstorming

---
 src/proc/asset.hpp                   |  2 +-
 src/proc/mobject/placement-index.hpp | 30 +++++++++++++++++++++++++++-
 src/proc/mobject/placement-ref.hpp   |  5 +++++
 wiki/renderengine.html               |  9 +++++----
 4 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/src/proc/asset.hpp b/src/proc/asset.hpp
index 0186289fd..3e6ce5ce4 100644
--- a/src/proc/asset.hpp
+++ b/src/proc/asset.hpp
@@ -335,7 +335,7 @@ namespace asset {
       : boost::is_base_of<Asset, A>      {}; 
     
     
-    /** convienient for debugging */
+    /** convenient for debugging */
     inline string str (const PcAsset& a) 
     {
       if (a)
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 86904591c..4a5e5a110 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -36,13 +36,16 @@
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
 //#include "proc/asset/pipe.hpp"
+#include "proc/mobject/placement-ref.hpp"
 
 //#include <tr1/memory>
+#include <vector>
 
 
 namespace mobject {
 
 //  using std::tr1::shared_ptr;
+  using std::vector;
 
   
   
@@ -50,8 +53,33 @@ namespace mobject {
    */
   class PlacementIndex
     {
+      public:
+        typedef Placement<MObject> PlacementMO;
+        typedef PlacementRef PRef;
+        typedef PRef::ID ID;
+        
+        PlacementMO& find (ID)  const;
+        
+        template<class MO>
+        Placement<MO>& find (PRef::IDp<MO>)  const;
+        
+        PlacementMO& getScope (PlacementMO&)  const;
+        PlacementMO& getScope (ID)            const;
+        
+        vector<PRef> getReferrers (ID)        const;
+        
+        
+        /** diagnostic: number of indexed entries */
+        size_t size()  const;
+        
+        
+        /* == mutating operations == */
+        
+        ID   insert (PlacementMO& newObj, PlacementMO& targetScope);
+        bool remove (PlacementMO&);
+        bool remove (ID);
     };
-  
+  ////////////////TODO currently just fleshing  out the API; probably have to splitt off an impl.class
   
   
   
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index a2035ea14..ea86f1beb 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -57,6 +57,11 @@ namespace mobject {
         {
         };
       
+      template<class MO>
+      class IDp : public ID
+        {
+        };
+      
       
     };
   
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 507807e87..bb775265a 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1913,12 +1913,13 @@ The general idea is, that each facade interface actually provides access to a sp
 * {{{RelativeLocation}}} is used to atach the MObject to some other anchor MObject
 * //additional constraints, placement objectives, range restrictions, pattern rules will follow...//</pre>
 </div>
-<div title="MObject" modifier="Ichthyostega" modified="200710092343" created="200706220312" tags="def classes" changecount="2">
+<div title="MObject" modifier="Ichthyostega" modified="200905130114" created="200706220312" tags="def classes" changecount="3">
 <pre>All sorts of &quot;things&quot; to be placed and manipulated by the user in the EDL. This interface abstracts the details and just supposes
 * the media object has a duration
 * it is allways //placed// in some manner, i.e. it is allways accessed via a [[Placement]]
 * {{red{and what else?}}}
-</pre>
+
+&amp;rarr; overview [[MObject class hierarchy|MObjects]]</pre>
 </div>
 <div title="MObjectRef" modifier="Ichthyostega" modified="200905090026" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="16">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
@@ -1949,8 +1950,8 @@ Presumably, none of the both models is usable as-is; rather we try to reconstruc
 {{red{WIP}}}
 </pre>
 </div>
-<div title="MObjects" modifier="Ichthyostega" modified="200810180118" created="200706190636" tags="overview" changecount="10">
-<pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects|MObject]] being:
+<div title="MObjects" modifier="Ichthyostega" modified="200905130116" created="200706190636" tags="overview" changecount="15">
+<pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects |MObject]](&amp;rarr; def) being:
 * audio/video clips
 * effects and plugins
 * special facilities like mask and projector

From e8588b735c98a8458be1b55688d37e50aa089a92 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Odin=20H=C3=B8rthe=20Omdal?= <odin@bekk.(none)>
Date: Thu, 12 Feb 2009 02:36:52 +0100
Subject: [PATCH 013/368] test: test.sh imported from newest nobug

nobug commit d2d0b769fb7ed3d7174671cde2ef02a64b987397
---
 tests/test.sh | 112 +++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 93 insertions(+), 19 deletions(-)

diff --git a/tests/test.sh b/tests/test.sh
index 31c92da5b..7c2ca1427 100755
--- a/tests/test.sh
+++ b/tests/test.sh
@@ -1,4 +1,4 @@
-#!/bin/bash 
+#!/bin/bash
 #  Copyright (C)         Lumiera.org
 #    2007 - 2008,        Christian Thaeter <ct@pipapo.org>
 #
@@ -26,18 +26,34 @@
 #   stop testing on the first failure
 
 export LC_ALL=C
+NOBUG_LOGREGEX='^\(\*\*[0-9]*\*\* \)\?[0-9]\{10,\}: \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):'
 
 arg0="$0"
 srcdir="$(dirname "$arg0")"
 
-ulimit -S -t 2 -v 524288
+ulimit -S -t 5 -v 524288
 valgrind=""
 if [ "$VALGRINDFLAGS" = 'DISABLE' ]; then
     echo "valgrind explicit disabled"
 else
     if [ "$(which valgrind)" ]; then
-        valgrind="$(which valgrind) --leak-check=yes --show-reachable=yes -q $VALGRINDFLAGS"
-	ulimit -S -t 10
+	ulimit -S -t 20
+        if [[ -x 'vgsuppression' ]]; then
+            if [[ 'vgsuppression' -nt 'vgsuppression.supp' ]]; then
+                echo 'generating valgrind supression file'
+
+                if [[ -x ".libs/vgsuppression" ]]; then
+                    ./libtool --mode=execute valgrind --leak-check=yes --show-reachable=yes -q --gen-suppressions=all vgsuppression 2>&1 \
+                        | sed '/^\(==\)\|\(\*\*\)[0-9]*\(==\)\|\(\*\*\)/d;' >vgsuppression.supp
+                else
+                    valgrind --leak-check=yes --show-reachable=yes -q --gen-suppressions=all ./vgsuppression 2>&1 \
+                        | sed '/^\(==\)\|\(\*\*\)[0-9]*\(==\)\|\(\*\*\)/d;' >vgsuppression.supp
+                fi
+            fi
+            valgrind="$(which valgrind) --leak-check=yes --show-reachable=no --suppressions=vgsuppression.supp -q $VALGRINDFLAGS"
+        else
+            valgrind="$(which valgrind) --leak-check=yes --show-reachable=no -q $VALGRINDFLAGS"
+        fi
     else
         echo "no valgrind found, go without it"
     fi
@@ -50,6 +66,7 @@ TESTCNT=0
 SKIPCNT=0
 FAILCNT=0
 
+
 # the old testlog if existing will be used to check for previous test states
 if test -f ,testlog; then
     mv ,testlog ,testlog.pre
@@ -59,6 +76,40 @@ fi
 
 date >,testlog
 
+function compare_regex() # rxfile plainfile
+{
+    local regex
+    local line
+    local miss
+    local lineno=1
+    local regexno=1
+    {
+        IFS='' read -u 3 -r regex || return 0
+        IFS='' read -u 4 -r line || { echo "no output"; return 1; }
+        while true; do
+            if [[ $line =~ $regex ]]; then
+                IFS='' read -u 4 -r line ||
+                if IFS='' read -u 3 -r regex; then
+                    echo "premature end in output, expecting: '$regex':$regexno"
+                    return 1
+                else
+                    return 0
+                fi
+                : $((++lineno))
+                miss=0
+            else
+                if [[ $((++miss)) -gt 1 ]]; then
+                    echo -e "'$line':$lineno\ndoes not match\n'$regex':$regexno"
+                    return 1
+                fi
+                IFS='' read -u 3 -r regex || { echo "more output than expected: '$line':$lineno"; return 1; }
+                : $((++regexno))
+            fi
+        done
+    } 3<"$1" 4<"$2"
+}
+
+
 function TEST()
 {
         name="$1"
@@ -69,7 +120,11 @@ function TEST()
 
 	while read -r line; do
             cmd="${line%%:*}"
-            arg="${line#*: }"
+            arg="${line#*:}"
+            arg="${arg:1}"
+            if [[ ! "$arg" ]]; then
+                arg='^$'
+            fi
             expect_return=0
 
             case $cmd in
@@ -85,6 +140,9 @@ function TEST()
             'return')
                 expect_return="$arg"
                 ;;
+            '#'*|'')
+                :
+                ;;
             *)
                 echo "UNKOWN TEST COMMAND '$cmd'" 1>&2
                 exit
@@ -128,36 +186,45 @@ function TEST()
             ((fails+=1))
 
         else
+
             if test -f ,send_stdin; then
-                cat ,send_stdin | $valgrind $TESTBIN "$@" 2>,stderr >,stdout
+                env $TESTBIN_PREFIX $TESTBIN "$@" <,send_stdin 2>,stderr >,stdout
             else
-                $valgrind $TESTBIN "$@" 2>,stderr >,stdout
+                env $TESTBIN_PREFIX $TESTBIN "$@" 2>,stderr >,stdout
             fi &>/dev/null
             return=$?
 
             if test -f ,expect_stdout; then
-                if ! cmp ,expect_stdout ,stdout &>/dev/null; then
+                grep -v "$NOBUG_LOGREGEX" <,stdout >,tmp
+                if ! compare_regex ,expect_stdout ,tmp >>,cmptmp; then
                     echo "unexpected data on stdout" >>,testtmp
-                    grep -v ': \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):' <,stdout >,tmp
-                    diff -ua ,expect_stdout ,tmp >>,testtmp
-                    rm ,tmp
+                    cat ,cmptmp >>,testtmp
                     ((fails+=1))
                 fi
+                rm ,tmp ,cmptmp
             fi
 
             if test -f ,expect_stderr; then
-                if ! cmp ,expect_stderr ,stderr &>/dev/null; then
+                grep -v "$NOBUG_LOGREGEX" <,stderr >,tmp
+                    cat ,tmp >>,testtmp
+                if ! compare_regex ,expect_stderr ,tmp >>,cmptmp; then
                     echo "unexpected data on stderr" >>,testtmp
-                    grep -v ': \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):' <,stderr >,tmp
-                    diff -ua ,expect_stderr ,tmp >>,testtmp
-                    rm ,tmp
+                    cat ,cmptmp >>,testtmp
                     ((fails+=1))
                 fi
+                rm ,tmp ,cmptmp
             fi
 
-            if test "$expect_return" != "$return"; then
-                echo "unexpected return value $return" >>,testtmp
-                ((fails+=1))
+            if [[ "${expect_return:0:1}" = '!' ]]; then
+                if [[ "${expect_return#\!}" = "$return" ]]; then
+                    echo "unexpected return value $return, expected $expect_return" >>,testtmp
+                    ((fails+=1))
+                fi
+            else
+                if [[ "${expect_return}" != "$return" ]]; then
+                    echo "unexpected return value $return, expected $expect_return" >>,testtmp
+                    ((fails+=1))
+                fi
             fi
         fi
 
@@ -224,7 +291,14 @@ function TESTING()
 {
     echo
     echo "$1"
-    TESTBIN=$2
+    echo -e "\n#### $1" >>,testlog
+
+    if [[ -x ".libs/$2" ]]; then
+        TESTBIN_PREFIX="./libtool --mode=execute $valgrind"
+    else
+        TESTBIN_PREFIX="$valgrind"
+    fi
+    TESTBIN="$2"
 }
 
 TESTSUITES="${TESTSUITES}${1:+${TESTSUITES:+,}$1}"

From 0c89dbaa629dc33ef6e36545a67cc57bf2f9577a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Odin=20H=C3=B8rthe=20Omdal?= <odin@bekk.(none)>
Date: Thu, 12 Feb 2009 02:38:58 +0100
Subject: [PATCH 014/368] test: Regexed 00-40, just escaping; no fancy stuff

---
 tests/15list.tests             |  14 +-
 tests/15locking.tests          |   2 +-
 tests/20config_lowlevel.tests  |   6 +-
 tests/22config_highlevel.tests |  10 +-
 tests/31plugin.tests           |  10 +-
 tests/40components.tests       | 481 ++++++++++++++++-----------------
 6 files changed, 253 insertions(+), 270 deletions(-)

diff --git a/tests/15list.tests b/tests/15list.tests
index e04044f27..1e6558e49 100644
--- a/tests/15list.tests
+++ b/tests/15list.tests
@@ -2,31 +2,22 @@ TESTING "Linked Lists" ./test-llist
 
 TEST "init nodes" basic <<END
 out: 1
-out: 1
 END
 
 TEST "insert nodes" nodeinsert <<END
 out: 0
-out: 0
 out: 1
 out: 0
 out: 1
-out: 1
-out: 1
-out: 1
 out: 3
 END
 
 TEST "remaining predicates" predicates <<END
 out: 1
-out: 1
-out: 0
-out: 0
-out: 1
-out: 1
 out: 0
 out: 1
 out: 0
+out: 1
 out: 0
 END
 
@@ -34,14 +25,11 @@ TEST "unlink" unlink <<END
 out: node4 node3 node2 node1 .
 out: node1 node4 .
 out: 1
-out: 1
-out: 1
 END
 
 TEST "whiles" whiles <<END
 out: node4 node3 node2 node1 .
 out: .
-out: .
 END
 
 TEST "llist_relocate" relocate <<END
diff --git a/tests/15locking.tests b/tests/15locking.tests
index 3420f3fa1..061a2da56 100644
--- a/tests/15locking.tests
+++ b/tests/15locking.tests
@@ -19,7 +19,7 @@ END
 
 
 TEST "chained mutex section" chainedmutexsection <<END
-out: outer mutex locked section
+out: ^outer mutex locked section
 out: inner but not outer mutex locked section
 END
 
diff --git a/tests/20config_lowlevel.tests b/tests/20config_lowlevel.tests
index bcc8e71e3..920abb46c 100644
--- a/tests/20config_lowlevel.tests
+++ b/tests/20config_lowlevel.tests
@@ -55,10 +55,10 @@ out: item->line = '	 #comment bla'
 END
 
 TEST "check content of configitem with section" configitem_simple_content_check $'[ key.foo suffix.bar ] ' << END
-out: item->line = '[ key.foo suffix.bar ] '
+out: item->line = '\[ key\.foo suffix.bar \] '
 out: item->key_size = '7'
-out: item->key = 'key.foo suffix.bar ] '
-out: item->delim = ' suffix.bar ] '
+out: item->key = 'key.foo suffix.bar \] '
+out: item->delim = ' suffix.bar \] '
 END
 
 TEST "check content of configitem with directive (without argument)" configitem_simple_content_check $'\t @directive  ' << END
diff --git a/tests/22config_highlevel.tests b/tests/22config_highlevel.tests
index c43baaefe..ac5a90a30 100644
--- a/tests/22config_highlevel.tests
+++ b/tests/22config_highlevel.tests
@@ -209,18 +209,16 @@ out: ' baz barf gnarf first second'
 END
 
 TEST "wordlist add same word" wordlist_add 'foo.bar' 'baz barf gnarf' same same << END
-out: ' baz barf gnarf same'
-out: ' baz barf gnarf same'
+out: ^' baz barf gnarf same'$
 END
 
 TEST "wordlist add to empty list" wordlist_add 'foo.bar' '' first second << END
-out: ' first'
-out: ' first second'
+out: ^' first'$
+out: ^' first second'$
 END
 
 TEST "wordlist add to empty list, same" wordlist_add 'foo.bar' '' same same << END
-out: ' same'
-out: ' same'
+out: ^' same'$
 END
 
 
diff --git a/tests/31plugin.tests b/tests/31plugin.tests
index 46844f754..6181c224b 100644
--- a/tests/31plugin.tests
+++ b/tests/31plugin.tests
@@ -2,7 +2,7 @@ TESTING "testing plugins" ./test-interfaces
 
 
 TEST "discovering plugins, missing path" plugin_discover <<END
-out: found plugin: (null)
+out: found plugin: \(null\)
 return: 0
 END
 
@@ -10,12 +10,12 @@ export LUMIERA_PLUGIN_PATH=.libs
 export LUMIERA_CONFIG_PATH=./
 
 TEST "discovering plugins" plugin_discover <<END
-out: found plugin: .libs/examplepluginc.lum
+out: found plugin: \.libs/examplepluginc.lum
 return: 0
 END
 
 TEST "plugin unloading" plugin_unload <<END
-out: plugin unload: (nil)
+out: plugin unload: \(nil\)
 return: 0
 END
 
@@ -28,8 +28,8 @@ return: 0
 END
 
 TEST "C plugin test, nested" plugin_examplepluginc_nested <<END
-out: config path is: ./
-out: plugin path is: .libs
+out: config path is: \./
+out: plugin path is: \.libs
 out: Hallo Welt!
 out: Hello World!
 out: Bye World!
diff --git a/tests/40components.tests b/tests/40components.tests
index d05bea6f9..1ce98d957 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -3,9 +3,7 @@ TESTING "Component Test Suite: common and basic components" ./test-lib --group=c
 
 
 TEST "Hello test" HelloWorld_test 3 <<END
-out: This is how the world ends...
-out: This is how the world ends...
-out: This is how the world ends...
+out: ^This is how the world ends\.\.\.$
 return: 0
 END
 
@@ -21,35 +19,35 @@ END
 
 
 TEST "CmdlineWrapper_test" CmdlineWrapper_test <<END
-out: wrapping cmdline:...
+out: wrapping cmdline:\.\.\.
 out: -->
 out: wrapping cmdline:
-out: 	 ...
+out: 	 \.\.\.
 out: -->
 out: wrapping cmdline:spam...
-out: 0|spam|
+out: 0\|spam\|
 out: -->spam
 out: wrapping cmdline:
 out: spam...
-out: 0|spam|
+out: 0\|spam\|
 out: -->spam
 out: wrapping cmdline:eat more spam...
-out: 0|eat|
-out: 1|more|
-out: 2|spam|
+out: 0\|eat\|
+out: 1\|more\|
+out: 2\|spam\|
 out: -->eat more spam
-out: wrapping cmdline: oo _O()O_  ä + €...
-out: 0|oo|
-out: 1|_O()O_|
-out: 2|ä|
-out: 3|+|
-out: 4|€|
-out: -->oo _O()O_ ä + €
+out: wrapping cmdline: oo _O\(\)O_  ä \+ €...
+out: 0\|oo\|
+out: 1\|_O\(\)O_\|
+out: 2\|ä\|
+out: 3\|\+\|
+out: 4\|€\|
+out: -->oo _O\(\)O_ ä \+ €
 out: wrapping cmdline:Ω	ooΩ	oΩo	Ωoo...
-out: 0|Ω|
-out: 1|ooΩ|
-out: 2|oΩo|
-out: 3|Ωoo|
+out: 0\|Ω\|
+out: 1\|ooΩ\|
+out: 2\|oΩo\|
+out: 3\|Ωoo\|
 out: -->Ω ooΩ oΩo Ωoo
 out: Standard Cmdlineformat:one  two
 END
@@ -62,98 +60,98 @@ out: Conf2	:-<2>-
 out: Conf3	:-<3>-
 out: Conf4	:-<2>-<4>-
 out: AllFlags	:-<1>-<2>-<3>-<4>-
-out: __________________________
-out: __________________________ check_flags()
+out: __________________________$
+out: __________________________ check_flags\(\)
 out: Flags1	:-<2>-<4>-
 out: Flags2	:-<2>-<4>-
 out: SimpleConfig_defined_by_Typelist	:-<1>-
 out: AnotherConfig_defined_by_Typelist	:-<1>-<2>-<3>-<4>-
-out: __________________________
-out: __________________________ check_instantiation()
-out: defined Conf0? ---> 0
-out: defined Conf1? ---> 1
-out: defined Conf2? ---> 1
-out: defined Conf3? ---> 1
-out: defined Conf4? ---> 1
-out: defined Trash? ---> 0
-out: __________________________
-out: __________________________ check_filter()
+out: __________________________$
+out: __________________________ check_instantiation\(\)
+out: defined Conf0\? ---> 0
+out: defined Conf1\? ---> 1
+out: defined Conf2\? ---> 1
+out: defined Conf3\? ---> 1
+out: defined Conf4\? ---> 1
+out: defined Trash\? ---> 0
+out: __________________________$
+out: __________________________ check_filter\(\)
 out: SomeFlagsets	:
-out: 	+---<1>-<3>-+
-out: 	+---<2>-<4>-+-
+out: 	\+---<1>-<3>-\+
+out: 	\+---<2>-<4>-\+-
 out: Configs_defined_by_Flagsets	:
-out: 	+-Conf-[-<1>-<3>-]
-out: 	+-Conf-[-<2>-<4>-]-
+out: 	\+-Conf-\[-<1>-<3>-\]
+out: 	\+-Conf-\[-<2>-<4>-\]-
 out: Filter_possible_Configs	:
-out: 	+-Conf-[-<2>-<4>-]-
+out: 	\+-Conf-\[-<2>-<4>-\]-
 out: AllFlagCombinations	:
-out: 	+---<1>-<2>-<3>-<4>-<·>-+
-out: 	+---<1>-<2>-<3>-<·>-+
-out: 	+---<1>-<2>-<4>-<·>-+
-out: 	+---<1>-<2>-<·>-+
-out: 	+---<1>-<3>-<4>-<·>-+
-out: 	+---<1>-<3>-<·>-+
-out: 	+---<1>-<4>-<·>-+
-out: 	+---<1>-<·>-+
-out: 	+---<2>-<3>-<4>-<·>-+
-out: 	+---<2>-<3>-<·>-+
-out: 	+---<2>-<4>-<·>-+
-out: 	+---<2>-<·>-+
-out: 	+---<3>-<4>-<·>-+
-out: 	+---<3>-<·>-+
-out: 	+---<4>-<·>-+
-out: 	+---<·>-+-
+out: 	\+---<1>-<2>-<3>-<4>-<·>-\+
+out: 	\+---<1>-<2>-<3>-<·>-\+
+out: 	\+---<1>-<2>-<4>-<·>-\+
+out: 	\+---<1>-<2>-<·>-\+
+out: 	\+---<1>-<3>-<4>-<·>-\+
+out: 	\+---<1>-<3>-<·>-\+
+out: 	\+---<1>-<4>-<·>-\+
+out: 	\+---<1>-<·>-\+
+out: 	\+---<2>-<3>-<4>-<·>-\+
+out: 	\+---<2>-<3>-<·>-\+
+out: 	\+---<2>-<4>-<·>-\+
+out: 	\+---<2>-<·>-\+
+out: 	\+---<3>-<4>-<·>-\+
+out: 	\+---<3>-<·>-\+
+out: 	\+---<4>-<·>-\+
+out: 	\+---<·>-\+-
 out: ListAllConfigs	:
-out: 	+-Conf-[-<1>-<2>-<3>-<4>-]
-out: 	+-Conf-[-<1>-<2>-<3>-]
-out: 	+-Conf-[-<1>-<2>-<4>-]
-out: 	+-Conf-[-<1>-<2>-]
-out: 	+-Conf-[-<1>-<3>-<4>-]
-out: 	+-Conf-[-<1>-<3>-]
-out: 	+-Conf-[-<1>-<4>-]
-out: 	+-Conf-[-<1>-]
-out: 	+-Conf-[-<2>-<3>-<4>-]
-out: 	+-Conf-[-<2>-<3>-]
-out: 	+-Conf-[-<2>-<4>-]
-out: 	+-Conf-[-<2>-]
-out: 	+-Conf-[-<3>-<4>-]
-out: 	+-Conf-[-<3>-]
-out: 	+-Conf-[-<4>-]
-out: 	+-Conf-[-]-
+out: 	\+-Conf-\[-<1>-<2>-<3>-<4>-\]
+out: 	\+-Conf-\[-<1>-<2>-<3>-\]
+out: 	\+-Conf-\[-<1>-<2>-<4>-\]
+out: 	\+-Conf-\[-<1>-<2>-\]
+out: 	\+-Conf-\[-<1>-<3>-<4>-\]
+out: 	\+-Conf-\[-<1>-<3>-\]
+out: 	\+-Conf-\[-<1>-<4>-\]
+out: 	\+-Conf-\[-<1>-\]
+out: 	\+-Conf-\[-<2>-<3>-<4>-\]
+out: 	\+-Conf-\[-<2>-<3>-\]
+out: 	\+-Conf-\[-<2>-<4>-\]
+out: 	\+-Conf-\[-<2>-\]
+out: 	\+-Conf-\[-<3>-<4>-\]
+out: 	\+-Conf-\[-<3>-\]
+out: 	\+-Conf-\[-<4>-\]
+out: 	\+-Conf-\[-\]-
 out: Filter_all_possible_Configs	:
-out: 	+-Conf-[-<1>-]
-out: 	+-Conf-[-<2>-<3>-]
-out: 	+-Conf-[-<2>-<4>-]
-out: 	+-Conf-[-<2>-]
-out: 	+-Conf-[-<3>-]-
-out: __________________________
-out: __________________________ check_FlagInfo()
+out: 	\+-Conf-\[-<1>-\]
+out: 	\+-Conf-\[-<2>-<3>-\]
+out: 	\+-Conf-\[-<2>-<4>-\]
+out: 	\+-Conf-\[-<2>-\]
+out: 	\+-Conf-\[-<3>-\]-
+out: __________________________$
+out: __________________________ check_FlagInfo\(\)
 out: Flags1	:-<1>-<3>-
 out: max bit    : 3
 out: binary code: 10
 out: SomeConfigs	:
-out: 	+-Conf-[-<1>-<3>-]
-out: 	+-Conf-[-<2>-<4>-]-
-out: max bit in [SomeConfigs] : 4
+out: 	\+-Conf-\[-<1>-<3>-\]
+out: 	\+-Conf-\[-<2>-<4>-\]-
+out: max bit in \[SomeConfigs\] : 4
 out: TestVisitor application:
-out: visit(code=10) -->
-out: 	+-Conf-[-<1>-<3>-]-
-out: visit(code=20) -->
-out: 	+-Conf-[-<2>-<4>-]-
-out: __________________________
-out: __________________________ check_ConfigSelector()
+out: visit\(code=10\) -->
+out: 	\+-Conf-\[-<1>-<3>-\]-
+out: visit\(code=20\) -->
+out: 	\+-Conf-\[-<2>-<4>-\]-
+out: __________________________$
+out: __________________________ check_ConfigSelector\(\)
 out: Possible_Configs	:
-out: 	+-Conf-[-<1>-]
-out: 	+-Conf-[-<2>-<3>-]
-out: 	+-Conf-[-<2>-<4>-]
-out: 	+-Conf-[-<2>-]
-out: 	+-Conf-[-<3>-]-
-out:  Flag-code = 2 ConfigSelector() ---> 1010
-out:  Flag-code = 12 ConfigSelector() ---> 1023
-out:  Flag-code = 20 ConfigSelector() ---> 1024
-out:  Flag-code = 4 ConfigSelector() ---> 1020
-out:  Flag-code = 8 ConfigSelector() ---> 1030
-out: LUMIERA_ERROR_INVALID:invalid input or parameters (ConfigSelector: No preconfigured factory for config-bits=10111).
+out: 	\+-Conf-\[-<1>-\]
+out: 	\+-Conf-\[-<2>-<3>-\]
+out: 	\+-Conf-\[-<2>-<4>-\]
+out: 	\+-Conf-\[-<2>-\]
+out: 	\+-Conf-\[-<3>-\]-
+out:  Flag-code = 2 ConfigSelector\(\) ---> 1010
+out:  Flag-code = 12 ConfigSelector\(\) ---> 1023
+out:  Flag-code = 20 ConfigSelector\(\) ---> 1024
+out:  Flag-code = 4 ConfigSelector\(\) ---> 1020
+out:  Flag-code = 8 ConfigSelector\(\) ---> 1030
+out: LUMIERA_ERROR_INVALID:invalid input or parameters \(ConfigSelector: No preconfigured factory for config-bits=10111\)\.
 return: 0
 END
 
@@ -164,54 +162,54 @@ END
 
 
 TEST "ExceptionError_test" ExceptionError_test <<END
-out: caught: LUMIERA_ERROR_LIFE_AND_UNIVERSE:and everything? (don't panic)...the answer is: 42
+out: caught: LUMIERA_ERROR_LIFE_AND_UNIVERSE:and everything\? \(don't panic\)...the answer is: 42
 out: caught lumiera::Error: LUMIERA_ERROR_DERIVED:convoluted exception
-out: caught error::Logic: LUMIERA_ERROR_FATAL:floundered (test-2).
-out: caught error::Invalid: LUMIERA_ERROR_INVALID:invalid input or parameters (test-3).
-out: caught lumiera::Error: LUMIERA_ERROR_EXTERNAL:failure in external service (test-4).
+out: caught error::Logic: LUMIERA_ERROR_FATAL:floundered \(test-2\).
+out: caught error::Invalid: LUMIERA_ERROR_INVALID:invalid input or parameters \(test-3\).
+out: caught lumiera::Error: LUMIERA_ERROR_EXTERNAL:failure in external service \(test-4\).
 out: caught std::runtime_error: test-5
-out: caught std::exception. (unspecific)
-out: intermediate handler caught: LUMIERA_ERROR_EXTERNAL:failure in external service (test-7).....will rethrow as error::State
-out: caught lumiera::Error: LUMIERA_ERROR_STATE:unforeseen state -- caused by: LUMIERA_ERROR_EXTERNAL:failure in external service (test-7).
-out: intermediate handler caught: LUMIERA_ERROR_EXTERNAL:failure in external service (test-8).....will rethrow as error::State
-out: 2nd intermediate handler caught: LUMIERA_ERROR_STATE:unforeseen state -- caused by: LUMIERA_ERROR_EXTERNAL:failure in external service (test-8).....will rethrow as error::Config
-out: caught lumiera::Error: LUMIERA_ERROR_CONFIG:misconfiguration -- caused by: LUMIERA_ERROR_EXTERNAL:failure in external service (test-8).
+out: caught std::exception. \(unspecific\)
+out: intermediate handler caught: LUMIERA_ERROR_EXTERNAL:failure in external service \(test-7\).....will rethrow as error::State
+out: caught lumiera::Error: LUMIERA_ERROR_STATE:unforeseen state -- caused by: LUMIERA_ERROR_EXTERNAL:failure in external service \(test-7\).
+out: intermediate handler caught: LUMIERA_ERROR_EXTERNAL:failure in external service \(test-8\).....will rethrow as error::State
+out: 2nd intermediate handler caught: LUMIERA_ERROR_STATE:unforeseen state -- caused by: LUMIERA_ERROR_EXTERNAL:failure in external service \(test-8\).....will rethrow as error::Config
+out: caught lumiera::Error: LUMIERA_ERROR_CONFIG:misconfiguration -- caused by: LUMIERA_ERROR_EXTERNAL:failure in external service \(test-8\).
 END
 
 
 TEST "Factory_test" Factory_test 5  <<END
-out: ctor TargetObj(5) successful
+out: ctor TargetObj\(5\) successful
 out: now the smart-ptr has refcount=3
-out: .....TargetObj(5): data="*****", array[5]={0,1,2,3,4,}
-out: dtor ~TargetObj(5) successful
+out: .....TargetObj\(5\): data="\*\*\*\*\*", array\[5\]=\{0,1,2,3,4,\}
+out: dtor ~TargetObj\(5\) successful
 END
 
 
 TEST "Factory_special_test" Factory_special_test 5  <<END
 out: checkPlacement--------
-out: ctor TargetObj(5) successful
+out: ctor TargetObj\(5\) successful
 out: created 3 shared_ptrs to Object placed in static buffer.
-out: .....TargetObj(5): data="*****", array[5]={0,1,2,3,4,}
-out: dtor ~TargetObj(5) successful
-out: ctor TargetObj(6) successful
+out: .....TargetObj\(5\): data="\*\*\*\*\*", array\[5\]=\{0,1,2,3,4,\}
+out: dtor ~TargetObj\(5\) successful
+out: ctor TargetObj\(6\) successful
 out: created 4 shared_ptrs to Object placed in static buffer.
-out: dtor ~TargetObj(6) successful
+out: dtor ~TargetObj\(6\) successful
 out: checkPrivate--------
-out: ctor TargetObj(5) successful
+out: ctor TargetObj\(5\) successful
 out: created 3 shared_ptrs to paranoid Object.
-out: .....TargetObj(5): data="*****", array[5]={0,1,2,3,4,}
-out: dtor ~TargetObj(5) successful
+out: .....TargetObj\(5\): data="\*\*\*\*\*", array\[5\]=\{0,1,2,3,4,\}
+out: dtor ~TargetObj\(5\) successful
 out: checkMalloc--------
-out: ctor TargetObj(7) successful
+out: ctor TargetObj\(7\) successful
 out: created auto_ptr to malloc-ed Object.
-out: .....TargetObj(7): data="*******", array[7]={0,1,2,3,4,5,6,}
-out: dtor ~TargetObj(7) successful
+out: .....TargetObj\(7\): data="\*\*\*\*\*\*\*", array\[7\]=\{0,1,2,3,4,5,6,\}
+out: dtor ~TargetObj\(7\) successful
 out: checkPImpl--------
-out: ctor TargetObj(12) successful
+out: ctor TargetObj\(12\) successful
 out: created auto_ptr to Interface Object.
-out: .....ImplObj::funky() called
-out: .....TargetObj(12): data="************", array[12]={0,1,2,3,4,5,6,7,8,9,10,11,}
-out: dtor ~TargetObj(12) successful
+out: .....ImplObj::funky\(\) called
+out: .....TargetObj\(12\): data="\*\*\*\*\*\*\*\*\*\*\*\*", array\[12\]=\{0,1,2,3,4,5,6,7,8,9,10,11,\}
+out: dtor ~TargetObj\(12\) successful
 END
 
 
@@ -221,16 +219,16 @@ END
 
 
 TEST "RemoveFromSet_test" RemoveFromSet_test <<END
-out: removed  nothing  ---> [ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ]
-out: removed 0 ---> [ 1, 2, 3, 4, 5, 6, 7, 8, 9, ]
-out: removed 9 ---> [ 0, 1, 2, 3, 4, 5, 6, 7, 8, ]
-out: removed 5 ---> [ 0, 1, 2, 3, 4, 6, 7, 8, 9, ]
-out: removed 0   2   4   6   8   ---> [ 1, 3, 5, 7, 9, ]
-out: removed   1   3   5   7   9 ---> [ 0, 2, 4, 6, 8, ]
-out: removed 0 1 2 3 4 5 6 7 8 9 ---> [ ]
-out: removed 0 1 2 3 4 5 6 7 8   ---> [ 9, ]
-out: removed   1 2 3 4 5 6 7 8 9 ---> [ 0, ]
-out: removed 0 1 2 3 4   6 7 8 9 ---> [ 5, ]
+out: removed  nothing  ---> \[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
+out: removed 0 ---> \[ 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
+out: removed 9 ---> \[ 0, 1, 2, 3, 4, 5, 6, 7, 8, \]
+out: removed 5 ---> \[ 0, 1, 2, 3, 4, 6, 7, 8, 9, \]
+out: removed 0   2   4   6   8   ---> \[ 1, 3, 5, 7, 9, \]
+out: removed   1   3   5   7   9 ---> \[ 0, 2, 4, 6, 8, \]
+out: removed 0 1 2 3 4 5 6 7 8 9 ---> \[ \]
+out: removed 0 1 2 3 4 5 6 7 8   ---> \[ 9, \]
+out: removed   1 2 3 4 5 6 7 8 9 ---> \[ 0, \]
+out: removed 0 1 2 3 4   6 7 8 9 ---> \[ 5, \]
 END
 
 
@@ -241,7 +239,7 @@ out: 'trailing Withespace
 out:        	' --> 'trailing_Withespace'
 out: 'with    a  	 lot
 out:   of Whitespace' --> 'with_a_lot_of_Whitespace'
-out: 'with"much (punctuation)[]!' --> 'withmuch_(punctuation)'
+out: 'with"much \(punctuation\)\[\]!' --> 'withmuch_\(punctuation\)'
 out: '§&Ω%€  leading garbage' --> 'leading_garbage'
 out: 'mixed    Ω   garbage' --> 'mixed_garbage'
 out: 'Bääääh!!' --> 'Bh'
@@ -250,24 +248,24 @@ END
 
 
 TEST "SingletonSubclass_test" SingletonSubclass_test 13 <<END
-out: using the Singleton should create TargetObj(13)...
-out: ctor TargetObj(13) successful
+out: using the Singleton should create TargetObj\(13\)...
+out: ctor TargetObj\(13\) successful
 out: calling a non-static method on the Singleton-Implementation
-out: .....TargetObj(13): data="*************", array[13]={0,1,2,3,4,5,6,7,8,9,10,11,12,}
-out: dtor ~TargetObj(13) successful
+out: .....TargetObj\(13\): data="\*\*\*\*\*\*\*\*\*\*\*\*\*", array\[13\]=\{0,1,2,3,4,5,6,7,8,9,10,11,12,\}
+out: dtor ~TargetObj\(13\) successful
 END
 
 
 TEST "SingletonTestMock_test" SingletonTestMock_test <<END
-out: TestSingletonO::doIt() call=1
-out: TestSingletonO::doIt() call=2
-out: Mock_1::doIt() call=1
-out: Mock_1::doIt() call=2
-out: Mock_1::doIt() call=3
-out: Mock_1::doIt() call=4
-out: Mock_1::doIt() call=5
-out: Mock_2::doIt() call=1
-out: TestSingletonO::doIt() call=3
+out: TestSingletonO::doIt\(\) call=1
+out: TestSingletonO::doIt\(\) call=2
+out: Mock_1::doIt\(\) call=1
+out: Mock_1::doIt\(\) call=2
+out: Mock_1::doIt\(\) call=3
+out: Mock_1::doIt\(\) call=4
+out: Mock_1::doIt\(\) call=5
+out: Mock_2::doIt\(\) call=1
+out: TestSingletonO::doIt\(\) call=3
 END
 
 
@@ -279,19 +277,19 @@ END
 
 TEST "ScopedHolderTransfer_test" ScopedHolderTransfer_test <<END
 out: checking ScopedHolder<Dummy>...
-out: .
-out: ..install one element at index[0]
-out: .
-out: ..*** resize table to 16 elements
-out: .
-out: .throw some exceptions...
+out: \.$
+out: \.\.install one element at index\[0\]
+out: ^\.$
+out: \.\.\*\*\* resize table to 16 elements
+out: ^\.$
+out: ^\.throw some exceptions...
 out: checking ScopedPtrHolder<Dummy>...
-out: .
-out: ..install one element at index[0]
-out: .
-out: ..*** resize table to 16 elements
-out: .
-out: .throw some exceptions...
+out: ^\.$
+out: ..install one element at index\[0\]
+out: ^\.$
+out: ..\*\*\* resize table to 16 elements
+out: ^\.$
+out: ^\.throw some exceptions...
 END
 
 
@@ -301,16 +299,16 @@ END
 
 
 TEST "Singleton_test" Singleton_test 23 <<END
-out: testing TargetObj(23) as Singleton(statically allocated)
-out: ctor TargetObj(23) successful
+out: testing TargetObj\(23\) as Singleton\(statically allocated\)
+out: ctor TargetObj\(23\) successful
 out: calling a non-static method on the Singleton instance
-out: .....TargetObj(23): data="***********************", array[23]={0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,}
-out: testing TargetObj(24) as Singleton(heap allocated)
-out: ctor TargetObj(24) successful
+out: .....TargetObj\(23\): data="\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*", array\[23\]=\{0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,\}
+out: testing TargetObj\(24\) as Singleton\(heap allocated\)
+out: ctor TargetObj\(24\) successful
 out: calling a non-static method on the Singleton instance
-out: .....TargetObj(24): data="************************", array[24]={0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,}
-out: dtor ~TargetObj(23) successful
-out: dtor ~TargetObj(24) successful
+out: .....TargetObj\(24\): data="\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*", array\[24\]=\{0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,\}
+out: dtor ~TargetObj\(23\) successful
+out: dtor ~TargetObj\(24\) successful
 END
 
 
@@ -406,9 +404,9 @@ out: ctor DoIt<Block< 5> >
 out: ctor DoIt<Block< 3> >
 out: ctor DoIt<Block< 2> >
 out: ctor DoIt<Block< 1> >
-out: Block< 2>::eat(..)
-out: Block< 5>::eat(..)
-out: Block<13>::eat(..)
+out: Block< 2>::eat\(..\)
+out: Block< 5>::eat\(..\)
+out: Block<13>::eat\(..\)
 out: gulp!
 out: dtor DoIt<Block< 1> >
 out: dtor DoIt<Block< 2> >
@@ -435,87 +433,87 @@ out: Append8	:-<1>-<2>-<3>-<222>-
 out: Append9	:-<1>-<2>-<3>-<5>-<6>-<7>-
 out: FilterEven	:-<2>-<6>-
 out: Prefix1	:
-out: 	+---<11>-<22>-+-
+out: 	\+---<11>-<22>-\+-
 out: Prefix2	:
-out: 	+---<101>-<1>-+
-out: 	+---<101>-<2>-+
-out: 	+---<101>-<3>-+-
+out: 	\+---<101>-<1>-\+
+out: 	\+---<101>-<2>-\+
+out: 	\+---<101>-<3>-\+-
 out: Prefix3	:
-out: 	+---<1>-+
-out: 	+---<2>-+
-out: 	+---<3>-+-
+out: 	\+---<1>-\+
+out: 	\+---<2>-\+
+out: 	\+---<3>-\+-
 out: Prefix4	:
-out: 	+---<111>-<1>-<2>-<3>-+
-out: 	+---<111>-<0>-+
-out: 	+---<111>-<5>-<6>-<7>-+-
+out: 	\+---<111>-<1>-<2>-<3>-\+
+out: 	\+---<111>-<0>-\+
+out: 	\+---<111>-<5>-<6>-<7>-\+-
 out: Prefix5	:
-out: 	+---<1>-<2>-<3>-<5>-+
-out: 	+---<1>-<2>-<3>-<6>-+
-out: 	+---<1>-<2>-<3>-<7>-+-
+out: 	\+---<1>-<2>-<3>-<5>-\+
+out: 	\+---<1>-<2>-<3>-<6>-\+
+out: 	\+---<1>-<2>-<3>-<7>-\+-
 out: Prefix6	:
-out: 	+---<1>-<2>-<3>-<1>-<2>-<3>-+
-out: 	+---<1>-<2>-<3>-<0>-+
-out: 	+---<1>-<2>-<3>-<5>-<6>-<7>-+-
+out: 	\+---<1>-<2>-<3>-<1>-<2>-<3>-\+
+out: 	\+---<1>-<2>-<3>-<0>-\+
+out: 	\+---<1>-<2>-<3>-<5>-<6>-<7>-\+-
 out: Dist1	:
-out: 	+---<11>-<1>-+
-out: 	+---<11>-<2>-+
-out: 	+---<11>-<3>-+-
+out: 	\+---<11>-<1>-\+
+out: 	\+---<11>-<2>-\+
+out: 	\+---<11>-<3>-\+-
 out: Dist2	:
-out: 	+---<11>-<0>-+
-out: 	+---<22>-<0>-+
-out: 	+---<33>-<0>-+-
+out: 	\+---<11>-<0>-\+
+out: 	\+---<22>-<0>-\+
+out: 	\+---<33>-<0>-\+-
 out: Dist3	:
-out: 	+---<11>-<1>-+
-out: 	+---<11>-<2>-+
-out: 	+---<11>-<3>-+
-out: 	+---<22>-<1>-+
-out: 	+---<22>-<2>-+
-out: 	+---<22>-<3>-+
-out: 	+---<33>-<1>-+
-out: 	+---<33>-<2>-+
-out: 	+---<33>-<3>-+-
+out: 	\+---<11>-<1>-\+
+out: 	\+---<11>-<2>-\+
+out: 	\+---<11>-<3>-\+
+out: 	\+---<22>-<1>-\+
+out: 	\+---<22>-<2>-\+
+out: 	\+---<22>-<3>-\+
+out: 	\+---<33>-<1>-\+
+out: 	\+---<33>-<2>-\+
+out: 	\+---<33>-<3>-\+-
 out: Dist4	:
-out: 	+---<11>-<1>-<2>-<3>-+
-out: 	+---<11>-<5>-<6>-<7>-+
-out: 	+---<22>-<1>-<2>-<3>-+
-out: 	+---<22>-<5>-<6>-<7>-+
-out: 	+---<33>-<1>-<2>-<3>-+
-out: 	+---<33>-<5>-<6>-<7>-+-
+out: 	\+---<11>-<1>-<2>-<3>-\+
+out: 	\+---<11>-<5>-<6>-<7>-\+
+out: 	\+---<22>-<1>-<2>-<3>-\+
+out: 	\+---<22>-<5>-<6>-<7>-\+
+out: 	\+---<33>-<1>-<2>-<3>-\+
+out: 	\+---<33>-<5>-<6>-<7>-\+-
 out: Down	:-<11>-<10>-<9>-<8>-<7>-<6>-<5>-<4>-<3>-<2>-<1>-<0>-
 out: Combi	:
-out: 	+---<1>-<2>-<3>-<·>-+
-out: 	+---<1>-<2>-<2>-<·>-+
-out: 	+---<1>-<2>-<1>-<·>-+
-out: 	+---<1>-<2>-<0>-<·>-+
-out: 	+---<1>-<1>-<3>-<·>-+
-out: 	+---<1>-<1>-<2>-<·>-+
-out: 	+---<1>-<1>-<1>-<·>-+
-out: 	+---<1>-<1>-<0>-<·>-+
-out: 	+---<1>-<0>-<3>-<·>-+
-out: 	+---<1>-<0>-<2>-<·>-+
-out: 	+---<1>-<0>-<1>-<·>-+
-out: 	+---<1>-<0>-<0>-<·>-+
-out: 	+---<0>-<2>-<3>-<·>-+
-out: 	+---<0>-<2>-<2>-<·>-+
-out: 	+---<0>-<2>-<1>-<·>-+
-out: 	+---<0>-<2>-<0>-<·>-+
-out: 	+---<0>-<1>-<3>-<·>-+
-out: 	+---<0>-<1>-<2>-<·>-+
-out: 	+---<0>-<1>-<1>-<·>-+
-out: 	+---<0>-<1>-<0>-<·>-+
-out: 	+---<0>-<0>-<3>-<·>-+
-out: 	+---<0>-<0>-<2>-<·>-+
-out: 	+---<0>-<0>-<1>-<·>-+
-out: 	+---<0>-<0>-<0>-<·>-+-
+out: 	\+---<1>-<2>-<3>-<·>-\+
+out: 	\+---<1>-<2>-<2>-<·>-\+
+out: 	\+---<1>-<2>-<1>-<·>-\+
+out: 	\+---<1>-<2>-<0>-<·>-\+
+out: 	\+---<1>-<1>-<3>-<·>-\+
+out: 	\+---<1>-<1>-<2>-<·>-\+
+out: 	\+---<1>-<1>-<1>-<·>-\+
+out: 	\+---<1>-<1>-<0>-<·>-\+
+out: 	\+---<1>-<0>-<3>-<·>-\+
+out: 	\+---<1>-<0>-<2>-<·>-\+
+out: 	\+---<1>-<0>-<1>-<·>-\+
+out: 	\+---<1>-<0>-<0>-<·>-\+
+out: 	\+---<0>-<2>-<3>-<·>-\+
+out: 	\+---<0>-<2>-<2>-<·>-\+
+out: 	\+---<0>-<2>-<1>-<·>-\+
+out: 	\+---<0>-<2>-<0>-<·>-\+
+out: 	\+---<0>-<1>-<3>-<·>-\+
+out: 	\+---<0>-<1>-<2>-<·>-\+
+out: 	\+---<0>-<1>-<1>-<·>-\+
+out: 	\+---<0>-<1>-<0>-<·>-\+
+out: 	\+---<0>-<0>-<3>-<·>-\+
+out: 	\+---<0>-<0>-<2>-<·>-\+
+out: 	\+---<0>-<0>-<1>-<·>-\+
+out: 	\+---<0>-<0>-<0>-<·>-\+-
 out: OnOff	:
-out: 	+---<1>-<2>-<3>-<·>-+
-out: 	+---<1>-<2>-<·>-+
-out: 	+---<1>-<3>-<·>-+
-out: 	+---<1>-<·>-+
-out: 	+---<2>-<3>-<·>-+
-out: 	+---<2>-<·>-+
-out: 	+---<3>-<·>-+
-out: 	+---<·>-+-
+out: 	\+---<1>-<2>-<3>-<·>-\+
+out: 	\+---<1>-<2>-<·>-\+
+out: 	\+---<1>-<3>-<·>-\+
+out: 	\+---<1>-<·>-\+
+out: 	\+---<2>-<3>-<·>-\+
+out: 	\+---<2>-<·>-\+
+out: 	\+---<3>-<·>-\+
+out: 	\+---<·>-\+-
 return: 0
 END
 
@@ -546,7 +544,6 @@ out: we-do-everything-for-YOU!
 out: Hello Mr.Future, nice to meet you...
 out: === Babbler masqueraded as Tool meets Leader and Visionary masqueraded as HomoSapiens ===
 out: Hello Boss, nice to meet you...
-out: Hello Boss, nice to meet you...
 out: === Babbler masqueraded as Tool meets Leader and Visionary masqueraded as Leader ===
 out: Hello Boss, nice to meet you...
 return: 0

From bbe2b78c29c9d6aa37cfcf443a337faece4694b5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Odin=20H=C3=B8rthe=20Omdal?= <odin@bekk.(none)>
Date: Thu, 12 Feb 2009 11:49:11 +0100
Subject: [PATCH 015/368] test: Finished regexing the last tests

---
 tests/41asset.tests   |  2 +-
 tests/44builder.tests | 12 +++++-------
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/tests/41asset.tests b/tests/41asset.tests
index b76982317..0af6737c5 100644
--- a/tests/41asset.tests
+++ b/tests/41asset.tests
@@ -4,7 +4,7 @@ TESTING "Component Test Suite: Asset Manager" ./test-components --group=asset
 
 TEST "AssetCategory_test" AssetCategory_test <<END
 out: Category: AUDIO
-out: Category: VIDEO/bin1
+out: Category: VIDEO/bin1$
 out: Category: VIDEO/bin1/subbin
 out: Category: EFFECT/some_kind
 return: 0
diff --git a/tests/44builder.tests b/tests/44builder.tests
index 3ec3bd325..14772e4fe 100644
--- a/tests/44builder.tests
+++ b/tests/44builder.tests
@@ -1,14 +1,12 @@
 TESTING "Component Test Suite: Builder" ./test-components --group=builder
 
 
-
-
 TEST "BuilderTool_test" BuilderTool_test <<END
-out: apply (tool, clip);
-out: Clip on media : Asset(VIDEO:lumi.test-1 v1)
-out: apply (tool, test1);
-out: treat (AbstractMO&);
-out: apply (tool, test2);
+out: apply \(tool, clip\);
+out: Clip on media : Asset\(VIDEO:lumi.test-1 v1\)
+out: apply \(tool, test1\);
+out: treat \(AbstractMO&\);
+out: apply \(tool, test2\);
 out: catch-all-function called...
 END
 

From 0595767736f7d3a6d2b91be942fa63b4cab67df7 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Fri, 15 May 2009 22:11:59 +0200
Subject: [PATCH 016/368] fixed config lowlevel tests

Few tests got broken with the new testsuite and libtool problems to pass
empty strings and tabs around. I just removed tabs and unnecessary
blanks. This makes some tests somewhat less valuable, but works for now.
---
 tests/20config_lowlevel.tests | 37 ++++++++++++++++++-----------------
 1 file changed, 19 insertions(+), 18 deletions(-)

diff --git a/tests/20config_lowlevel.tests b/tests/20config_lowlevel.tests
index 920abb46c..8fe76e895 100644
--- a/tests/20config_lowlevel.tests
+++ b/tests/20config_lowlevel.tests
@@ -10,7 +10,8 @@ TEST "create configitem with empty line" configitem_simple '' <<END
 out: line = ''
 END
 
-TEST "create configitem with blank line" configitem_simple '    ' <<END
+# fails due libtool problems with empty strings 
+PLANNED "create configitem with blank line" configitem_simple '    ' <<END
 out: line = '    '
 END
 
@@ -50,8 +51,8 @@ END
 TEST "check content of configitem with empty line" configitem_simple_content_check $'' << END
 END
 
-TEST "check content of configitem with comment" configitem_simple_content_check $'\t #comment bla' << END
-out: item->line = '	 #comment bla'
+TEST "check content of configitem with comment" configitem_simple_content_check $' #comment bla' << END
+out: item->line = ' #comment bla'
 END
 
 TEST "check content of configitem with section" configitem_simple_content_check $'[ key.foo suffix.bar ] ' << END
@@ -61,31 +62,31 @@ out: item->key = 'key.foo suffix.bar \] '
 out: item->delim = ' suffix.bar \] '
 END
 
-TEST "check content of configitem with directive (without argument)" configitem_simple_content_check $'\t @directive  ' << END
-out: item->line = '	 @directive  '
+TEST "check content of configitem with directive (without argument)" configitem_simple_content_check $' @directive' << END
+out: item->line = ' @directive'
 out: item->key_size = '9'
-out: item->key = '@directive  '
+out: item->key = '@directive'
 END
 
-TEST "check content of configitem with directive (with argument)" configitem_simple_content_check $'\t @directive \targument' << END
-out: item->line = '	 @directive 	argument'
+TEST "check content of configitem with directive (with argument)" configitem_simple_content_check $' @directive argument' << END
+out: item->line = ' @directive argument'
 out: item->key_size = '9'
-out: item->key = '@directive 	argument'
-out: item->delim = '	argument'
+out: item->key = '@directive argument'
+out: item->delim = ' argument'
 END
 
-TEST "check content of configitem with configentry" configitem_simple_content_check $' \t\t key.foo \t\t=\tbar' << END
-out: item->line = ' 		 key.foo 		=	bar'
+TEST "check content of configitem with configentry" configitem_simple_content_check $'key.foo =bar' << END
+out: item->line = 'key.foo =bar'
 out: item->key_size = '7'
-out: item->key = 'key.foo 		=	bar'
-out: item->delim = '=	bar'
+out: item->key = 'key.foo =bar'
+out: item->delim = '=bar'
 END
 
-TEST "check content of configitem with configentry (redirect)" configitem_simple_content_check $' \t\t key.foo \t\t<\tkey.bar' << END
-out: item->line = ' 		 key.foo 		<	key.bar'
+TEST "check content of configitem with configentry (redirect)" configitem_simple_content_check $'key.foo <key.bar' << END
+out: item->line = 'key.foo <key.bar'
 out: item->key_size = '7'
-out: item->key = 'key.foo 		<	key.bar'
-out: item->delim = '<	key.bar'
+out: item->key = 'key.foo <key.bar'
+out: item->delim = '<key.bar'
 END
 
 

From cab776847deba67f4f995e3fc6ccf1f4d2ebc85a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 20 May 2009 02:26:47 +0200
Subject: [PATCH 017/368] spelling and cleanup (to get it compiling)

---
 src/proc/asset.hpp                             | 18 +++++++++---------
 src/proc/mobject/placement-index.hpp           |  2 +-
 .../proc/mobject/placement-index-test.cpp      |  2 --
 .../proc/mobject/placement-ref-test.cpp        |  2 --
 4 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/src/proc/asset.hpp b/src/proc/asset.hpp
index 3e6ce5ce4..04fcac9e1 100644
--- a/src/proc/asset.hpp
+++ b/src/proc/asset.hpp
@@ -216,11 +216,11 @@ namespace asset {
        */
       set<string> groups;
 
-      /** user visible Name-ID. To be localized. */
+      /** user visible Name-ID. To be localised. */
       const string shortDesc;
 
       /** user visible qualification of the thing, unit or concept represented by this asset.
-       *  perferably "in one line". To be localized.  */
+       *  preferably "in one line". To be localised.  */
       const string longDesc;
       
       vector<PAsset> parents;
@@ -232,7 +232,7 @@ namespace asset {
       
     protected:
       /** Asset is a Interface class; usually, objects of 
-       *  concrete subclasses are created via specialized Factories.
+       *  concrete subclasses are created via specialised Factories.
        *  Calling this base ctor causes registration with AssetManager.
        */
       Asset (const Ident& idi);
@@ -240,11 +240,11 @@ namespace asset {
       
       /** release all links to other Asset objects held internally.
        *  The lifecycle of Asset objects is managed by smart pointers
-       *  and the Asset manager. Calling \c release() breaks interconnectons
+       *  and the Asset manager. Calling \c release() breaks interconnections
        *  to other Assets in the central Object network comprising the session.
-       *  It is up to the AssetManager to asure the notification of any other
+       *  It is up to the AssetManager to assure the notification of any other
        *  components that may need to release references to the Asset object
-       *  beeing removed. The rationale is, after releasing all interlinkings,
+       *  being removed. The rationale is, after releasing all interlinking,
        *  when the AssetManager removes its DB entry for this asset, the
        *  smart pointer goes out of scope and triggers cleanup.
        */
@@ -255,7 +255,7 @@ namespace asset {
       virtual void unlink (IDA target);
       
       /** establish a connection between this and the given parent asset,
-       *  denoting we are in some way dependant on the parent. */
+       *  denoting we are in some way dependent on the parent. */
       void defineDependency (PAsset parent);
       void defineDependency (Asset& parent); 
       
@@ -280,7 +280,7 @@ namespace asset {
        */
       const vector<PAsset>& getDependant ()  const { return dependants; }
       
-      /** weather this asset is swithced on and consequently 
+      /** weather this asset is switched on and consequently 
        *  included in the fixture and participates in rendering
        */
       bool isActive ()  const;
@@ -303,7 +303,7 @@ namespace asset {
     
     /** ordering of Assets is based on the ordering
      *  of Ident tuples, which are supposed to be unique.
-     *  By using our customized lumiera::P as smart ptr,
+     *  By using our customised lumiera::P as smart ptr,
      *  comparison on P<Asset> ptrs will be automatically
      *  forwarded to the Asset comparison operators.
      *  @note version info is irrelevant */
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 4a5e5a110..f33f482d0 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -79,7 +79,7 @@ namespace mobject {
         bool remove (PlacementMO&);
         bool remove (ID);
     };
-  ////////////////TODO currently just fleshing  out the API; probably have to splitt off an impl.class
+  ////////////////TODO currently just fleshing  out the API; probably have to split off an impl.class
   
   
   
diff --git a/tests/components/proc/mobject/placement-index-test.cpp b/tests/components/proc/mobject/placement-index-test.cpp
index 64fe5370c..efd345ae9 100644
--- a/tests/components/proc/mobject/placement-index-test.cpp
+++ b/tests/components/proc/mobject/placement-index-test.cpp
@@ -58,8 +58,6 @@ namespace test    {
    */
   class PlacementIndex_test : public Test
     {
-      typedef shared_ptr<asset::Media> PM;
-      typedef shared_ptr<asset::Clip> PCA;
       
       virtual void
       run (Arg) 
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index 20e38cede..4651c169a 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -57,8 +57,6 @@ namespace test    {
    */
   class PlacementRef_test : public Test
     {
-      typedef shared_ptr<asset::Media> PM;
-      typedef shared_ptr<asset::Clip> PCA;
       
       virtual void
       run (Arg) 

From cc66f2b0d095e4f4b528e73cf576493cb7837b6e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 20 May 2009 03:36:12 +0200
Subject: [PATCH 018/368] preliminary placement index impl started.

Basically I need this simple framework to be able to write tests,
which enables me to flesh out the API, which in turn is a
prerequisite for defining the PlacementRef
---
 src/proc/Makefile.am                          |  1 +
 src/proc/asset/media.hpp                      |  3 +-
 src/proc/mobject/placement-index.cpp          | 81 +++++++++++++++++++
 src/proc/mobject/placement-index.hpp          | 73 ++++++++++-------
 src/proc/mobject/placement-ref.hpp            |  1 +
 .../proc/mobject/placement-index-test.cpp     | 33 +++++++-
 6 files changed, 157 insertions(+), 35 deletions(-)
 create mode 100644 src/proc/mobject/placement-index.cpp

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index a79f07183..45de208b0 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -93,6 +93,7 @@ liblumiprocmobject_la_SOURCES =					\
 	$(liblumiprocmobject_la_srcdir)/mobject.cpp		\
 	$(liblumiprocmobject_la_srcdir)/parameter.cpp		\
 	$(liblumiprocmobject_la_srcdir)/paramprovider.cpp	\
+	$(liblumiprocmobject_la_srcdir)/placement-index.cpp	\
 	$(liblumiprocmobject_la_srcdir)/placement.cpp
 
 
diff --git a/src/proc/asset/media.hpp b/src/proc/asset/media.hpp
index b73a619e9..0cff14f7c 100644
--- a/src/proc/asset/media.hpp
+++ b/src/proc/asset/media.hpp
@@ -44,8 +44,7 @@
 
 
 
-namespace asset
-  {
+namespace asset {
   
   class Clip;
   class Media;
diff --git a/src/proc/mobject/placement-index.cpp b/src/proc/mobject/placement-index.cpp
new file mode 100644
index 000000000..03eaba0ba
--- /dev/null
+++ b/src/proc/mobject/placement-index.cpp
@@ -0,0 +1,81 @@
+/*
+  PlacementIndex  -  tracking individual Placements and their relations
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file placement-index.cpp 
+ ** 
+ ** simple hash based implementation. Proof-of-concept
+ ** and for fleshing out the API
+ ** 
+ ** @todo change PlacementIndex into an interface and create a separated implementation class
+ ** @see PlacementRef
+ ** @see PlacementIndex_test
+ **
+ */
+
+
+#include "proc/mobject/placement-index.hpp"
+
+//#include <boost/format.hpp>
+//using boost::str;
+
+namespace mobject {
+
+
+  class PlacementIndex::Table 
+    {
+    public:
+      Table () 
+        { }
+      
+      size_t
+      size()  const
+        {
+          UNIMPLEMENTED ("PlacementIndex datastructure");
+          return 0;
+        }
+        
+    };
+  
+  
+  /** */
+  
+  
+  size_t
+  PlacementIndex::size()  const
+  {
+    return pTab_->size() - 1;
+  }
+
+  
+  
+  /** @internal factory function for creating a placement index for tests.
+   */
+  shared_ptr<PlacementIndex>
+  createPlacementIndex ()
+  {
+    return shared_ptr<PlacementIndex> (new PlacementIndex());
+  }
+  
+
+
+} // namespace mobject
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index f33f482d0..c5d401358 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -36,15 +36,18 @@
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
 //#include "proc/asset/pipe.hpp"
+#include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
 
-//#include <tr1/memory>
+#include <tr1/memory>
+#include <boost/scoped_ptr.hpp>
 #include <vector>
 
 
 namespace mobject {
 
-//  using std::tr1::shared_ptr;
+  using std::tr1::shared_ptr;
+  using boost::scoped_ptr;
   using std::vector;
 
   
@@ -53,37 +56,49 @@ namespace mobject {
    */
   class PlacementIndex
     {
-      public:
-        typedef Placement<MObject> PlacementMO;
-        typedef PlacementRef PRef;
-        typedef PRef::ID ID;
-        
-        PlacementMO& find (ID)  const;
-        
-        template<class MO>
-        Placement<MO>& find (PRef::IDp<MO>)  const;
-        
-        PlacementMO& getScope (PlacementMO&)  const;
-        PlacementMO& getScope (ID)            const;
-        
-        vector<PRef> getReferrers (ID)        const;
-        
-        
-        /** diagnostic: number of indexed entries */
-        size_t size()  const;
-        
-        
-        /* == mutating operations == */
-        
-        ID   insert (PlacementMO& newObj, PlacementMO& targetScope);
-        bool remove (PlacementMO&);
-        bool remove (ID);
+      class Table;
+      
+      scoped_ptr<Table> pTab_;
+      
+    public:
+      typedef Placement<MObject> PlacementMO;
+      typedef PlacementRef PRef;
+      typedef PRef::ID ID;
+      
+      PlacementMO& find (ID)  const;
+      
+      template<class MO>
+      Placement<MO>& find (PRef::IDp<MO>)  const;
+      
+      PlacementMO& getScope (PlacementMO&)  const;
+      PlacementMO& getScope (ID)            const;
+      
+      vector<PRef> getReferrers (ID)        const;
+      
+      
+      /** retrieve the logical root scope */
+      PlacementMO& getRoot()        const;
+      
+      /** diagnostic: number of indexed entries */
+      size_t size()                 const;
+      bool contains (PlacementMO&)  const;
+      
+      
+      /* == mutating operations == */
+      
+      ID   insert (PlacementMO& newObj, PlacementMO& targetScope);
+      bool remove (PlacementMO&);
+      bool remove (ID);
     };
-  ////////////////TODO currently just fleshing  out the API; probably have to split off an impl.class
-  
+  ////////////////TODO currently just fleshing  out the API; probably have to split off an impl.class; but for now a PImpl is sufficient...
   
   
   
+  /** preliminary helper for creating a placement index (instance).
+   *  @todo integrate this into the session and provide an extra factory for tests
+   */
+  shared_ptr<PlacementIndex>
+  createPlacementIndex() ;
 
 
 } // namespace mobject
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index ea86f1beb..eb94005bd 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -50,6 +50,7 @@ namespace mobject {
    */
   class PlacementRef
     {
+    public:
       /**
        * 
        */
diff --git a/tests/components/proc/mobject/placement-index-test.cpp b/tests/components/proc/mobject/placement-index-test.cpp
index efd345ae9..5664a7e6f 100644
--- a/tests/components/proc/mobject/placement-index-test.cpp
+++ b/tests/components/proc/mobject/placement-index-test.cpp
@@ -25,8 +25,9 @@
 //#include "proc/asset/media.hpp"
 //#include "proc/mobject/session.hpp"
 //#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
+#include "proc/mobject/session/testclip.hpp"
 #include "proc/mobject/placement.hpp"
+#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 //#include "lib/util.hpp"
 
@@ -41,10 +42,10 @@ using std::string;
 
 
 namespace mobject {
-namespace session {
 namespace test    {
       
   using asset::VIDEO;
+  using session::test::TestClip;
   
   
   
@@ -58,12 +59,36 @@ namespace test    {
    */
   class PlacementIndex_test : public Test
     {
+      typedef shared_ptr<PlacementIndex> PIdx;
       
       virtual void
       run (Arg) 
         {
+          PIdx index (createPlacementIndex());
+          ASSERT (index);
+          
           /////////////////////////////////TODO
-        } 
+          checkSimpleInsert (index);
+        }
+      
+      void
+      checkSimpleInsert (PIdx index)
+        {
+          PMO clip = TestClip::create();
+//        PMO& root = index->getRoot();
+          
+          ASSERT (0 == index->size());
+//        ASSERT (!index->contains (clip));
+          
+//        index->insert (clip, root);
+          ASSERT (1 == index->size());
+//        ASSERT ( index->contains (clip));
+          
+//        index->remove(clip);
+          ASSERT (0 == index->size());
+//        ASSERT (!index->contains (clip));
+//        ASSERT ( index->contains (root));
+        }
     };
   
   
@@ -71,4 +96,4 @@ namespace test    {
   LAUNCHER (PlacementIndex_test, "unit session");
       
       
-}}} // namespace mobject::session::test
+}} // namespace mobject::test

From 35ebe966b5132b78892d6da0eee8859b2d1234cf Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 21 May 2009 04:06:36 +0200
Subject: [PATCH 019/368] add new kind of MObject (Binding) to express special
 scopes

---
 src/proc/Makefile.am                          |  1 +
 src/proc/mobject/placement-index.cpp          | 18 ++++++-
 src/proc/mobject/placement.hpp                |  2 +-
 src/proc/mobject/session/binding.cpp          | 33 ++++++++++++
 src/proc/mobject/session/binding.hpp          | 52 +++++++++++++++++++
 src/proc/mobject/session/clip.hpp             |  2 +-
 .../proc/mobject/placement-index-test.cpp     | 10 ++--
 wiki/renderengine.html                        | 23 +++++---
 8 files changed, 126 insertions(+), 15 deletions(-)
 create mode 100644 src/proc/mobject/session/binding.cpp
 create mode 100644 src/proc/mobject/session/binding.hpp

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 45de208b0..b1f8a7946 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -145,6 +145,7 @@ liblumiprocmobjectsession_la_SOURCES =					\
 	$(liblumiprocmobjectsession_la_srcdir)/abstractmo.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/allocation.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/auto.cpp			\
+	$(liblumiprocmobjectsession_la_srcdir)/bindingl.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/clip.cpp			\
 	$(liblumiprocmobjectsession_la_srcdir)/compoundclip.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/constraint.cpp		\
diff --git a/src/proc/mobject/placement-index.cpp b/src/proc/mobject/placement-index.cpp
index 03eaba0ba..407994842 100644
--- a/src/proc/mobject/placement-index.cpp
+++ b/src/proc/mobject/placement-index.cpp
@@ -60,12 +60,28 @@ namespace mobject {
   /** */
   
   
+  PlacementIndex::PlacementMO&
+  PlacementIndex::getRoot()  const
+  {
+    UNIMPLEMENTED ("managing the implicit root context within a scope hierarchy");
+  }
+  
+  
   size_t
   PlacementIndex::size()  const
   {
     return pTab_->size() - 1;
   }
-
+  
+  
+  bool
+  PlacementIndex::contains (PlacementMO&)  const
+  {
+    UNIMPLEMENTED ("containment test: is the given Placement known within this index");
+    return false;
+  }
+  
+  
   
   
   /** @internal factory function for creating a placement index for tests.
diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp
index a68f3dbce..6ac85a866 100644
--- a/src/proc/mobject/placement.hpp
+++ b/src/proc/mobject/placement.hpp
@@ -110,7 +110,7 @@ namespace mobject {
       
       
       /** interface for defining the kind of placement
-       *  to employ, and for controling any additional
+       *  to employ, and for controlling any additional
        *  constraints and properties. 
        */
       session::LocatingPin chain;
diff --git a/src/proc/mobject/session/binding.cpp b/src/proc/mobject/session/binding.cpp
new file mode 100644
index 000000000..3bd5c6cc7
--- /dev/null
+++ b/src/proc/mobject/session/binding.cpp
@@ -0,0 +1,33 @@
+/*
+  Binding  -  an association between session entities, constituting a scope
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "proc/mobject/session/binding.hpp"
+
+namespace mobject {
+namespace session {
+  
+  /** */
+  
+
+
+}} // namespace mobject::session
diff --git a/src/proc/mobject/session/binding.hpp b/src/proc/mobject/session/binding.hpp
new file mode 100644
index 000000000..a7883041c
--- /dev/null
+++ b/src/proc/mobject/session/binding.hpp
@@ -0,0 +1,52 @@
+/*
+  BINDING.hpp  -  an association between session entities, constituting a scope
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef MOBJECT_SESSION_BINDING_H
+#define MOBJECT_SESSION_BINDING_H
+
+#include "proc/mobject/session/meta.hpp"
+
+
+
+namespace mobject {
+namespace session {
+  
+  
+  /**
+   * Association of two entities within the Session
+   * deliberately linked together, thereby carrying additional mappings
+   * between properties or facilities within the entities to be linked together.
+   * An example would be the situation when a Sequence is linked either into
+   * a Timeline or MetaClip. Usually, the Placement holding such a Binding
+   * also constitutes a scope containing other nested objects.
+   */
+  class Binding : public Meta
+    {
+    public:
+      
+    };
+
+
+
+}} // namespace mobject::session
+#endif
diff --git a/src/proc/mobject/session/clip.hpp b/src/proc/mobject/session/clip.hpp
index 174a86cbf..362b6fe11 100644
--- a/src/proc/mobject/session/clip.hpp
+++ b/src/proc/mobject/session/clip.hpp
@@ -47,7 +47,7 @@ namespace mobject
      * sequence of media data loaded as Asset into the current Session.
      * As such, it is a virtual (non destructive) cut or edit of the 
      * source material and can be placed into the EDL to be rendered
-     * into the ouput. The actual media type of a clip will be derived
+     * into the output. The actual media type of a clip will be derived
      * at runtime by resolving this reference to the underlying Asset.
      * 
      * @todo define how to denote Time positions /lengths. This is tricky,
diff --git a/tests/components/proc/mobject/placement-index-test.cpp b/tests/components/proc/mobject/placement-index-test.cpp
index 5664a7e6f..fde419d73 100644
--- a/tests/components/proc/mobject/placement-index-test.cpp
+++ b/tests/components/proc/mobject/placement-index-test.cpp
@@ -75,19 +75,19 @@ namespace test    {
       checkSimpleInsert (PIdx index)
         {
           PMO clip = TestClip::create();
-//        PMO& root = index->getRoot();
+          PMO& root = index->getRoot();
           
           ASSERT (0 == index->size());
-//        ASSERT (!index->contains (clip));
+          ASSERT (!index->contains (clip));
           
 //        index->insert (clip, root);
           ASSERT (1 == index->size());
-//        ASSERT ( index->contains (clip));
+          ASSERT ( index->contains (clip));
           
 //        index->remove(clip);
           ASSERT (0 == index->size());
-//        ASSERT (!index->contains (clip));
-//        ASSERT ( index->contains (root));
+          ASSERT (!index->contains (clip));
+          ASSERT ( index->contains (root));
         }
     };
   
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index bb775265a..b6ed85551 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -758,6 +758,15 @@ config.macros.timeline.handler = function(place,macroName,params,wikifier,paramS
 }
 //}}}</pre>
 </div>
+<div title="BindingMO" modifier="Ichthyostega" modified="200905210149" created="200905210144" tags="def design discuss SessionLogic" changecount="2">
+<pre>Sometimes, two entities within the [[Session]] are deliberately associated, and this association has to carry some specific mappings between properties or facilities within the entities to be linked together. When this connection isn't just the [[Placement]] of an object, and isn't just a logical or structural relationship either &amp;mdash; then we create an explicit Binding object to be stored into the session.
+* Connecting a [[Sequence|EDL]] gets connected to a certain [[Timeline]] also establishes a mapping between the possible media stream channels produced by the sequence and the real output slots found within the timeline.
+* similarly, using a sequence within a [[meta-clip|VirtualClip]] requires to remember such a mapping.
+* another example is the root [[scope|PlacementScope]], which (conceptually) is a link between the definition part of the Session and the graph of MObjects, which are the session's contents.
+
+On the implementation side, we use a special kind of MObject, acting as an anchor and providing an unique identity. Like any ~MObject, actually a placement establishes the connection and the scope, and typically constitutes a nested scope (e.g. the scope of all objects //within// the sequence to be bound into a timeline)
+</pre>
+</div>
 <div title="BuildProcess" modifier="Ichthyostega" modified="200805300042" created="200706190658" tags="dynamic Builder" changecount="29">
 <pre>All decisions on //how // the RenderProcess has to be carried out are concentrated in this rather complicated Builder Subsystem. The benefit of this approach is, besides decoupling of subsystems, to keep the actual performance-intensive video processing code as simple and transparent as possible. The price, in terms of increased complexity &amp;mdash; to pay in the Builder &amp;mdash; can be handled by making the Build Process generic to a large degree. Using a Design By Contract approach we can decompose the various decisions into small decision modules without having to trace the actual workings of the Build Process as a whole.
 
@@ -2801,7 +2810,7 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
-<div title="PlacementIndex" modifier="Ichthyostega" modified="200905120331" created="200905090053" tags="SessionLogic spec impl draft" changecount="8">
+<div title="PlacementIndex" modifier="Ichthyostega" modified="200905192358" created="200905090053" tags="SessionLogic spec impl draft" changecount="10">
 <pre>An implementation facility used to keep track of individual Placements and their relations.
 Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
 
@@ -2809,11 +2818,11 @@ Especially, the [[Session]] maintains such an index, allowing to use the (opaque
 What implementation approach to take for the index. This of course largely depends on the usage pattern, which in turn is not-yet existant. To start with, we need a preliminary implementation!
 
 Using a ''flat hashtable'' would allow to access a Placement denoted by ID in O(1). This way we could get the Placement, but nothing more. So, additionally we'd have to set up an data record holding additional information:
-* the scope containing this placement
+* the [[scope|PlacementScope]] containing this placement
 * especially the path &quot;up&quot; from this scope, which is used for resolving any queries
 * relations to other placements
 
-Alternatively, we could try to use a ''structure based index''. Following this idea, we could try to avoid the mntioned description record by folding any of the contained informations into the surrounding datastructure:
+Alternatively, we could try to use a ''structure based index''. Following this idea, we could try to avoid the mentioned description record by folding any of the contained informations into the surrounding datastructure:
 * the scope would be obvious from the index, resp. from the path used to resolve this index
 * any other informations, especially the relations, would be folded into the placement
 * this way, the &quot;index&quot; could be reduced to being the session datastructure itself.
@@ -2833,24 +2842,24 @@ The placement index is utilized by editing operations, by executing the build pr
 On second sight, this problem seems to be quite nasty, because either we have to keep a second indext table for the reversed lookup (memory address -&gt; ID), or have to tie the placement by a backlink when adding it to the index/session datastructure, or (at least) it forces us to store a copy of the ID //within// the placement itself. The last possibility seems to create the least impact; but implementing it this way effectively gears the implementation towards a hashtable based approach.
 </pre>
 </div>
-<div title="PlacementRef" modifier="Ichthyostega" modified="200905091516" created="200905090032" tags="def spec draft" changecount="2">
+<div title="PlacementRef" modifier="Ichthyostega" modified="200905192350" created="200905090032" tags="def spec draft" changecount="3">
 <pre>A generic reference mechanism for Placements, as added to the current session.
 While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object.
 
 !questions {{red{WIP}}}
-Currently (5/09) ichthyo is in doubt what implementation to use best. It is clear that the PlacementRef needs to incorporate as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, the design decision boils down to the question how to implement the ID tag.
+Currently (5/09) ichthyo is in doubt what implementation to use best. It is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, the design decision boils down to the question how to implement the ID tag.
 * a flat random hash, e.g. using a {{{LUID}}}?
 * a structure based index, which also denotes the position in the (tree like) datastructure (Sequences within the session)?
 </pre>
 </div>
-<div title="PlacementScope" modifier="Ichthyostega" modified="200905120348" created="200905120304" tags="SessionLogic spec draft" changecount="4">
+<div title="PlacementScope" modifier="Ichthyostega" modified="200905210132" created="200905120304" tags="SessionLogic spec draft" changecount="5">
 <pre>MObjects are attached into the [[Session]] by adding a [[Placement]]. Because this especially includes the case of //grouping or container objects,// e.g. tracks or [[meta-clips|VirtualClip]], any placement may optionally define and root a scope, and every placement is at least contained in one encompassing scope &amp;mdash; of course with the exception of the absolute top level, which can be thought off as being contained in a scope of handling rules.
 
 Thus, while the [[sequences (former called EDL)|EDL]] act as generic container holding a pile of placments, actually there is a more fine grained structure based on the nesting of the tracks, which especially in Lumiera's HighLevelModel belong to the sequence (they aren't a property of the top level timeline as one might expect). Building upon these observations, we actually require each addition of a placement to specify a scope. The implementation of this tie-to-scope is provided by the same mechanism as utilized for relative placements, i.e. an directional placement relation.
 
 !Kinds of scopes
 There is only a limited number of situations constituting a scope
-* conceptually, the very top level is a scope of general rules (but it is hard-wired, not implemented as placement) {{red{really?}}}
+* conceptually, the very top level is a scope of general rules. It is implemented as {{{Placement&lt;Binding&gt;}}}, where [[the binding|BindingMO]] is a meta-object representing the relation.
 * similarily, the link binding a [[Sequence|EDL]] into either a (top-level) timeline or as virtual media into a VirtualClip is rather special.
 * each sequence has at least one (manadtory) top-level placement holding its root track
 * tracks may contain nested sub tracks.

From 87362a4b0d99349278a6b7020ea1baf92c5277df Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 21 May 2009 20:26:44 +0200
Subject: [PATCH 020/368] WIP draft for a generic hash based and typed id,
 similar to asset::ID

---
 src/proc/mobject/placement-ref.hpp            | 39 +++++++++++++++++++
 .../proc/mobject/placement-ref-test.cpp       |  7 ++++
 2 files changed, 46 insertions(+)

diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index eb94005bd..8bfec1ab2 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -45,6 +45,45 @@ namespace mobject {
 //  using std::tr1::shared_ptr;
   
   
+  /** @todo WIP a generic hash-index, maybe also usable for assets */
+  struct LuidH 
+    {
+      long dummy_;
+    };
+  
+  template<typename T>
+  struct HaID;
+  
+  struct TestA 
+    {
+      LuidH id_;
+      HaID<TestA> const& getID()  const;
+    };
+  struct TestBA : TestA {};
+  struct TestBB : TestA {};
+  
+  template<>
+  struct HaID<TestA> : LuidH
+    {
+      HaID ()                 : LuidH () {}
+      HaID (TestA const& ref) : LuidH (ref.getID()) {}
+    };
+  
+  template<typename T>
+  struct HaID : HaID<TestA>
+    {
+      HaID ()             : HaID<TestA> ()    {}
+      HaID (T const& ref) : HaID<TestA> (ref) {}
+    };
+  
+  inline 
+  HaID<TestA> const&
+  TestA::getID()  const
+  {
+    return *(static_cast<const HaID<TestA>*> (&id_)); 
+  }
+  
+  
   
   /**
    */
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index 4651c169a..d9869e2b0 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -27,6 +27,7 @@
 //#include "proc/mobject/session/edl.hpp"
 //#include "proc/mobject/session/testclip.hpp"
 #include "proc/mobject/placement.hpp"
+#include "proc/mobject/placement-ref.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 //#include "lib/util.hpp"
 
@@ -46,6 +47,12 @@ namespace test    {
       
   using asset::VIDEO;
   
+  /** @todo WIP a generic hash-index, maybe also usable for assets */
+  HaID<TestBB> hahaBB1;
+  
+  TestBA bab;
+  HaID<TestBA> hahaBA1 (bab);
+  ///////////////////////////////TODO (Experimentation)
   
   
   /***************************************************************************

From 0802d969cc7fc0682bb977714f4e6397c406feb2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 22 May 2009 02:15:58 +0200
Subject: [PATCH 021/368] WIP disentangle ID definition from target hierarchy
 by templating it on the base class

---
 src/proc/mobject/placement-ref.hpp            | 61 +++++++++++--------
 .../proc/mobject/placement-ref-test.cpp       |  4 +-
 2 files changed, 38 insertions(+), 27 deletions(-)

diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index 8bfec1ab2..ae0bf4a42 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -51,38 +51,49 @@ namespace mobject {
       long dummy_;
     };
   
-  template<typename T>
+  template<typename T, class BA>
   struct HaID;
   
-  struct TestA 
+  template<class BA>
+  struct HaIndexed
     {
       LuidH id_;
-      HaID<TestA> const& getID()  const;
+      HaID<BA,BA> const& getID()  const;
+    };
+  
+  template<class BA>
+  struct HaID<BA,BA> : LuidH
+    {
+      HaID ()              : LuidH () {}
+      HaID (BA const& ref) : LuidH (ref.getID()) {}
+    };
+  
+  template<typename T, class BA>
+  struct HaID : HaID<BA,BA>
+    {
+      HaID ()             : HaID<BA,BA> ()    {}
+      HaID (T const& ref) : HaID<BA,BA> (ref) {}
+    };
+  
+  template<class BA>
+  inline HaID<BA,BA> const&
+  HaIndexed<BA>::getID()  const
+  {
+    return *(static_cast<const HaID<BA,BA>*> (&id_));
+  }
+
+  
+  struct Base
+    {
+      int ii_;
+    };
+  
+  struct TestA : Base, HaIndexed<TestA>
+    {
     };
   struct TestBA : TestA {};
   struct TestBB : TestA {};
-  
-  template<>
-  struct HaID<TestA> : LuidH
-    {
-      HaID ()                 : LuidH () {}
-      HaID (TestA const& ref) : LuidH (ref.getID()) {}
-    };
-  
-  template<typename T>
-  struct HaID : HaID<TestA>
-    {
-      HaID ()             : HaID<TestA> ()    {}
-      HaID (T const& ref) : HaID<TestA> (ref) {}
-    };
-  
-  inline 
-  HaID<TestA> const&
-  TestA::getID()  const
-  {
-    return *(static_cast<const HaID<TestA>*> (&id_)); 
-  }
-  
+
   
   
   /**
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index d9869e2b0..b2bc57b0d 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -48,10 +48,10 @@ namespace test    {
   using asset::VIDEO;
   
   /** @todo WIP a generic hash-index, maybe also usable for assets */
-  HaID<TestBB> hahaBB1;
+  HaID<TestBB,TestA> hahaBB1;
   
   TestBA bab;
-  HaID<TestBA> hahaBA1 (bab);
+  HaID<TestBA,TestA> hahaBA1 (bab);
   ///////////////////////////////TODO (Experimentation)
   
   

From 020636b90aa7e765953757816108f223c9ae8db9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 22 May 2009 02:40:20 +0200
Subject: [PATCH 022/368] WIP extract the hash ID draft into separate header &
 test

---
 src/lib/ha-id.hpp                             | 126 ++++++++++++++++++
 src/proc/mobject/placement-ref.hpp            |  54 --------
 .../proc/mobject/placement-ref-test.cpp       |  14 +-
 tests/lib/Makefile.am                         |   1 +
 tests/lib/ha-id-test.cpp                      |  73 ++++++++++
 5 files changed, 203 insertions(+), 65 deletions(-)
 create mode 100644 src/lib/ha-id.hpp
 create mode 100644 tests/lib/ha-id-test.cpp

diff --git a/src/lib/ha-id.hpp b/src/lib/ha-id.hpp
new file mode 100644
index 000000000..9230c8810
--- /dev/null
+++ b/src/lib/ha-id.hpp
@@ -0,0 +1,126 @@
+/*
+  HA-ID.hpp  -  generic hash based and hierarchically typed ID
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file ha-id.hpp 
+ **
+ ** @see HaID_test
+ ** @see Placement usage example
+ **
+ */
+
+
+
+#ifndef LIB_HA_ID_H
+#define LIB_HA_ID_H
+
+//#include "pre.hpp"
+//#include "proc/mobject/session/locatingpin.hpp"
+//#include "proc/asset/pipe.hpp"
+
+//#include <tr1/memory>
+
+
+namespace lib {
+
+//  using std::tr1::shared_ptr;
+  
+  
+  /** @todo WIP a generic hash-index, maybe also usable for assets */
+  struct LuidH 
+    {
+      long dummy_;
+    };
+  
+  template<typename T, class BA>
+  struct HaID;
+  
+  template<class BA>
+  struct HaIndexed
+    {
+      LuidH id_;
+      HaID<BA,BA> const& getID()  const;
+    };
+  
+  template<class BA>
+  struct HaID<BA,BA> : LuidH
+    {
+      HaID ()              : LuidH () {}
+      HaID (BA const& ref) : LuidH (ref.getID()) {}
+    };
+  
+  template<typename T, class BA>
+  struct HaID : HaID<BA,BA>
+    {
+      HaID ()             : HaID<BA,BA> ()    {}
+      HaID (T const& ref) : HaID<BA,BA> (ref) {}
+    };
+  
+  template<class BA>
+  inline HaID<BA,BA> const&
+  HaIndexed<BA>::getID()  const
+  {
+    return *(static_cast<const HaID<BA,BA>*> (&id_));
+  }
+
+  
+  struct Base
+    {
+      int ii_;
+    };
+  
+  struct TestA : Base, HaIndexed<TestA>
+    {
+    };
+  struct TestBA : TestA {};
+  struct TestBB : TestA {};
+
+  
+  
+  /**
+   */
+  class PlacementRef
+    {
+    public:
+      /**
+       * 
+       */
+      class ID
+        {
+        };
+      
+      template<class MO>
+      class IDp : public ID
+        {
+        };
+      
+      
+    };
+  
+  
+  
+  
+  
+
+
+} // namespace lib
+#endif
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index ae0bf4a42..ac8773471 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -45,57 +45,6 @@ namespace mobject {
 //  using std::tr1::shared_ptr;
   
   
-  /** @todo WIP a generic hash-index, maybe also usable for assets */
-  struct LuidH 
-    {
-      long dummy_;
-    };
-  
-  template<typename T, class BA>
-  struct HaID;
-  
-  template<class BA>
-  struct HaIndexed
-    {
-      LuidH id_;
-      HaID<BA,BA> const& getID()  const;
-    };
-  
-  template<class BA>
-  struct HaID<BA,BA> : LuidH
-    {
-      HaID ()              : LuidH () {}
-      HaID (BA const& ref) : LuidH (ref.getID()) {}
-    };
-  
-  template<typename T, class BA>
-  struct HaID : HaID<BA,BA>
-    {
-      HaID ()             : HaID<BA,BA> ()    {}
-      HaID (T const& ref) : HaID<BA,BA> (ref) {}
-    };
-  
-  template<class BA>
-  inline HaID<BA,BA> const&
-  HaIndexed<BA>::getID()  const
-  {
-    return *(static_cast<const HaID<BA,BA>*> (&id_));
-  }
-
-  
-  struct Base
-    {
-      int ii_;
-    };
-  
-  struct TestA : Base, HaIndexed<TestA>
-    {
-    };
-  struct TestBA : TestA {};
-  struct TestBB : TestA {};
-
-  
-  
   /**
    */
   class PlacementRef
@@ -119,8 +68,5 @@ namespace mobject {
   
   
   
-  
-
-
 } // namespace mobject
 #endif
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index b2bc57b0d..b5337dec9 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -44,15 +44,7 @@ using std::string;
 namespace mobject {
 namespace session {
 namespace test    {
-      
-  using asset::VIDEO;
   
-  /** @todo WIP a generic hash-index, maybe also usable for assets */
-  HaID<TestBB,TestA> hahaBB1;
-  
-  TestBA bab;
-  HaID<TestBA,TestA> hahaBA1 (bab);
-  ///////////////////////////////TODO (Experimentation)
   
   
   /***************************************************************************
@@ -69,12 +61,12 @@ namespace test    {
       run (Arg) 
         {
           /////////////////////////////////TODO
-        } 
+        }
     };
   
   
   /** Register this test class... */
   LAUNCHER (PlacementRef_test, "unit session");
-      
-      
+  
+  
 }}} // namespace mobject::session::test
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 2c38a2439..1d306ab19 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -42,6 +42,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/exceptionerrortest.cpp		\
 	$(testlib_srcdir)/factoryspecialtest.cpp		\
 	$(testlib_srcdir)/factorytest.cpp			\
+	$(testlib_srcdir)/ha-id-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
 	$(testlib_srcdir)/mainsuite.cpp				\
diff --git a/tests/lib/ha-id-test.cpp b/tests/lib/ha-id-test.cpp
new file mode 100644
index 000000000..d16c3d3ba
--- /dev/null
+++ b/tests/lib/ha-id-test.cpp
@@ -0,0 +1,73 @@
+/*
+  HaID(Test)  -  proof-of-concept test for a hash based and typed ID
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+#include "lib/ha-id.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+//#include <iostream>
+
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+//using std::cout;
+
+
+namespace lib {
+namespace test{
+      
+  /** @todo WIP a generic hash-index, maybe also usable for assets */
+  HaID<TestBB,TestA> hahaBB1;
+  
+  TestBA bab;
+  HaID<TestBA,TestA> hahaBA1 (bab);
+  ///////////////////////////////TODO (Experimentation)
+  
+  
+  /***************************************************************************
+   * @test proof-of-concept test for a generic hash based and typed ID struct.
+   * @see  lib::HaID
+   */
+  class HaID_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          /////////////////////////////////TODO
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (HaID_test, "unit common");
+      
+      
+}} // namespace lib::test

From bac5da777bdc6c6e7a6fedcb6b8be3af802116bb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 22 May 2009 03:41:58 +0200
Subject: [PATCH 023/368] WIP document the concept of the hash ID, get rid of
 the uggly cast

---
 src/lib/ha-id.hpp        | 96 +++++++++++++++++++---------------------
 tests/40components.tests |  5 +++
 tests/lib/ha-id-test.cpp | 53 ++++++++++++++--------
 3 files changed, 84 insertions(+), 70 deletions(-)

diff --git a/src/lib/ha-id.hpp b/src/lib/ha-id.hpp
index 9230c8810..8e56b674d 100644
--- a/src/lib/ha-id.hpp
+++ b/src/lib/ha-id.hpp
@@ -21,7 +21,27 @@
 */
 
 
-/** @file ha-id.hpp 
+/** @file ha-id.hpp
+ ** A template for generating hash based ID tags carrying compile-time type info.
+ ** While the actual storage is assumed to be based on a POD, the type info is crucial
+ ** to circumvent the problems with an "object" base class. Frequently, the need to
+ ** manage some objects in a central facility drives us to rely on a common base class,
+ ** irrespective of an actual common denominator in the semantics of the objects to
+ ** be managed within this collection. Typically this results in this common base class
+ ** being almost worthless as an API or interface, causing lots of type casts when using
+ ** such a common object management facility. Passing additional context or API information
+ ** on a metaprogramming level through the management interface helps avoiding these 
+ ** shortcomings. 
+ ** 
+ ** Here we build an ID facility with the following properties:
+ ** - based on a configurable storage/implementation of the actual hash or index code.
+ ** - tied to a specific hierarchy of objects (template parameter "BA")
+ ** - providing an additional template parameter to pass the desired type info
+ ** - establishing an type hierarchy relation between ID template instances, such that
+ **   the IDs typed to the derived/specialised objects can stand-in for the generic
+ **   ID typed to the base class.
+ ** - providing a Mixin, which allows any hierarchy to use this facility without 
+ **   much code duplication.
  **
  ** @see HaID_test
  ** @see Placement usage example
@@ -33,32 +53,50 @@
 #ifndef LIB_HA_ID_H
 #define LIB_HA_ID_H
 
-//#include "pre.hpp"
-//#include "proc/mobject/session/locatingpin.hpp"
-//#include "proc/asset/pipe.hpp"
+//#include "lib/util.hpp"
 
 //#include <tr1/memory>
+#include <cstdlib>
 
 
 namespace lib {
 
 //  using std::tr1::shared_ptr;
+  using std::rand;
   
   
-  /** @todo WIP a generic hash-index, maybe also usable for assets */
   struct LuidH 
     {
       long dummy_;
+      
+      LuidH() : dummy_(rand()) {}
     };
   
+  /** 
+   * Generic hash based and hierarchically typed ID
+   * @todo WIP maybe also usable for assets?
+   */
   template<typename T, class BA>
   struct HaID;
   
   template<class BA>
   struct HaIndexed
     {
-      LuidH id_;
-      HaID<BA,BA> const& getID()  const;
+      typedef HaID<BA,BA> RootID;
+      RootID id_;
+      
+      RootID const& getID()  const
+        { 
+          return id_; 
+        }
+      void resetID(HaIndexed const& ref)
+        { 
+          this->id_ = ref.getID();
+        }
+      void resetID(RootID const& ref) ///< @todo this mutator should be removed in the final version to keep the actual hash opaque
+        { 
+          this->id_.dummy_ = ref.dummy_;
+        }
     };
   
   template<class BA>
@@ -75,52 +113,8 @@ namespace lib {
       HaID (T const& ref) : HaID<BA,BA> (ref) {}
     };
   
-  template<class BA>
-  inline HaID<BA,BA> const&
-  HaIndexed<BA>::getID()  const
-  {
-    return *(static_cast<const HaID<BA,BA>*> (&id_));
-  }
-
-  
-  struct Base
-    {
-      int ii_;
-    };
-  
-  struct TestA : Base, HaIndexed<TestA>
-    {
-    };
-  struct TestBA : TestA {};
-  struct TestBB : TestA {};
-
-  
-  
-  /**
-   */
-  class PlacementRef
-    {
-    public:
-      /**
-       * 
-       */
-      class ID
-        {
-        };
-      
-      template<class MO>
-      class IDp : public ID
-        {
-        };
-      
-      
-    };
   
   
   
-  
-  
-
-
 } // namespace lib
 #endif
diff --git a/tests/40components.tests b/tests/40components.tests
index d05bea6f9..bad8b8be3 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -215,6 +215,11 @@ out: dtor ~TargetObj(12) successful
 END
 
 
+PLANNED "HaID_test" HaID_test <<END
+return: 0
+END
+
+
 TEST "LifeCycle_test" LifeCycle_test  <<END
 return: 0
 END
diff --git a/tests/lib/ha-id-test.cpp b/tests/lib/ha-id-test.cpp
index d16c3d3ba..3a1478c52 100644
--- a/tests/lib/ha-id-test.cpp
+++ b/tests/lib/ha-id-test.cpp
@@ -22,33 +22,34 @@
 
 
 #include "lib/test/run.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
+
 #include "lib/ha-id.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
-//#include "lib/util.hpp"
 
-//#include <boost/format.hpp>
-//#include <iostream>
+#include <boost/format.hpp>
+#include <iostream>
 
-//using boost::format;
-//using lumiera::Time;
-//using util::contains;
-using std::string;
-//using std::cout;
+using boost::format;
+//using std::string;
+using std::cout;
 
 
 namespace lib {
 namespace test{
-      
-  /** @todo WIP a generic hash-index, maybe also usable for assets */
-  HaID<TestBB,TestA> hahaBB1;
   
-  TestBA bab;
-  HaID<TestBA,TestA> hahaBA1 (bab);
-  ///////////////////////////////TODO (Experimentation)
+  /* ==  a hierarchy of test-dummy objects to use the HaID == */
+  
+  struct Base
+    {
+      int ii_;
+    };
+  
+  struct TestA : Base, HaIndexed<TestA>
+    {
+    };
+  struct TestBA : TestA {};
+  struct TestBB : TestA {};
+  
+  
   
   
   /***************************************************************************
@@ -61,7 +62,21 @@ namespace test{
       virtual void
       run (Arg) 
         {
+          format fmt ("sizeof( %s ) = %d\n");
+          
           /////////////////////////////////TODO
+          HaID<TestBB,TestA> hahaBB1;
+          
+          TestBA bab;
+          bab.resetID(hahaBB1);
+          
+          HaID<TestBA,TestA> hahaBA1 (bab);
+          
+          cout << fmt % "TestBA"     % sizeof(bab);
+          cout << fmt % "ID<TestBA>" % sizeof(hahaBA1);
+          cout << fmt % "ID<TestBB>" % sizeof(hahaBB1);
+          
+          ASSERT (hahaBA1.dummy_ == hahaBB1.dummy_);
         } 
     };
   

From e5d20421906f29ec6e54a78d63fc4999a80bd425 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 23 May 2009 03:43:39 +0200
Subject: [PATCH 024/368] WIP rename and reorganise hash ID, now focussing on
 the Mixin

---
 src/lib/{ha-id.hpp => hash-indexed.hpp}       | 53 ++++++++++---------
 .../{ha-id-test.cpp => hash-indexed-test.cpp} | 14 ++---
 2 files changed, 34 insertions(+), 33 deletions(-)
 rename src/lib/{ha-id.hpp => hash-indexed.hpp} (78%)
 rename tests/lib/{ha-id-test.cpp => hash-indexed-test.cpp} (85%)

diff --git a/src/lib/ha-id.hpp b/src/lib/hash-indexed.hpp
similarity index 78%
rename from src/lib/ha-id.hpp
rename to src/lib/hash-indexed.hpp
index 8e56b674d..f1ee66aee 100644
--- a/src/lib/ha-id.hpp
+++ b/src/lib/hash-indexed.hpp
@@ -43,7 +43,7 @@
  ** - providing a Mixin, which allows any hierarchy to use this facility without 
  **   much code duplication.
  **
- ** @see HaID_test
+ ** @see HashIndexed_test
  ** @see Placement usage example
  **
  */
@@ -72,46 +72,47 @@ namespace lib {
       LuidH() : dummy_(rand()) {}
     };
   
-  /** 
-   * Generic hash based and hierarchically typed ID
-   * @todo WIP maybe also usable for assets?
-   */
-  template<typename T, class BA>
-  struct HaID;
   
   template<class BA>
-  struct HaIndexed
+  struct HashIndexed
     {
-      typedef HaID<BA,BA> RootID;
-      RootID id_;
+      /** 
+       * Generic hash based and hierarchically typed ID
+       * @todo WIP maybe also usable for assets?
+       */
+      template<typename T>
+      struct Id;
+
+      struct ID : LuidH
+        {
+          ID ()              : LuidH () {}
+          ID (BA const& ref) : LuidH (ref.getID()) {}
+        };
       
-      RootID const& getID()  const
+      template<typename T>
+      struct Id : ID
+        {
+          Id ()             : ID ()    {}
+          Id (T const& ref) : ID (ref) {}
+        };
+      
+      ID const& getID()  const
         { 
           return id_; 
         }
-      void resetID(HaIndexed const& ref)
+      void resetID(HashIndexed const& ref)
         { 
           this->id_ = ref.getID();
         }
-      void resetID(RootID const& ref) ///< @todo this mutator should be removed in the final version to keep the actual hash opaque
+      void resetID(ID const& ref) ///< @todo this mutator should be removed in the final version to keep the actual hash opaque
         { 
           this->id_.dummy_ = ref.dummy_;
         }
+      
+    private:
+      ID id_;
     };
   
-  template<class BA>
-  struct HaID<BA,BA> : LuidH
-    {
-      HaID ()              : LuidH () {}
-      HaID (BA const& ref) : LuidH (ref.getID()) {}
-    };
-  
-  template<typename T, class BA>
-  struct HaID : HaID<BA,BA>
-    {
-      HaID ()             : HaID<BA,BA> ()    {}
-      HaID (T const& ref) : HaID<BA,BA> (ref) {}
-    };
   
   
   
diff --git a/tests/lib/ha-id-test.cpp b/tests/lib/hash-indexed-test.cpp
similarity index 85%
rename from tests/lib/ha-id-test.cpp
rename to tests/lib/hash-indexed-test.cpp
index 3a1478c52..ab2d7c5f3 100644
--- a/tests/lib/ha-id-test.cpp
+++ b/tests/lib/hash-indexed-test.cpp
@@ -43,7 +43,7 @@ namespace test{
       int ii_;
     };
   
-  struct TestA : Base, HaIndexed<TestA>
+  struct TestA : Base, HashIndexed<TestA>
     {
     };
   struct TestBA : TestA {};
@@ -65,18 +65,18 @@ namespace test{
           format fmt ("sizeof( %s ) = %d\n");
           
           /////////////////////////////////TODO
-          HaID<TestBB,TestA> hahaBB1;
+          TestA::Id<TestBB> idBB1;
           
           TestBA bab;
-          bab.resetID(hahaBB1);
+          bab.resetID (idBB1);
           
-          HaID<TestBA,TestA> hahaBA1 (bab);
+          TestA::Id<TestBA> idBA1 (bab);
           
           cout << fmt % "TestBA"     % sizeof(bab);
-          cout << fmt % "ID<TestBA>" % sizeof(hahaBA1);
-          cout << fmt % "ID<TestBB>" % sizeof(hahaBB1);
+          cout << fmt % "Id<TestBA>" % sizeof(idBA1);
+          cout << fmt % "Id<TestBB>" % sizeof(idBB1);
           
-          ASSERT (hahaBA1.dummy_ == hahaBB1.dummy_);
+          ASSERT (idBA1.dummy_ == idBB1.dummy_);
         } 
     };
   

From 2bb64a23fa9eac630022d16c9d128932ec486975 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 23 May 2009 05:13:51 +0200
Subject: [PATCH 025/368] augment test, rework access to the hashID, template
 on hash impl

---
 src/lib/hash-indexed.hpp        | 56 +++++++++++++++++++--------------
 tests/40components.tests        |  2 +-
 tests/lib/Makefile.am           |  2 +-
 tests/lib/hash-indexed-test.cpp | 49 ++++++++++++++++-------------
 4 files changed, 63 insertions(+), 46 deletions(-)

diff --git a/src/lib/hash-indexed.hpp b/src/lib/hash-indexed.hpp
index f1ee66aee..bc6d8e25d 100644
--- a/src/lib/hash-indexed.hpp
+++ b/src/lib/hash-indexed.hpp
@@ -1,5 +1,5 @@
 /*
-  HA-ID.hpp  -  generic hash based and hierarchically typed ID
+  HASH-INDEXED.hpp  -  generic hash based and typed ID
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,7 +21,7 @@
 */
 
 
-/** @file ha-id.hpp
+/** @file hash-indexed.hpp
  ** A template for generating hash based ID tags carrying compile-time type info.
  ** While the actual storage is assumed to be based on a POD, the type info is crucial
  ** to circumvent the problems with an "object" base class. Frequently, the need to
@@ -37,9 +37,9 @@
  ** - based on a configurable storage/implementation of the actual hash or index code.
  ** - tied to a specific hierarchy of objects (template parameter "BA")
  ** - providing an additional template parameter to pass the desired type info
- ** - establishing an type hierarchy relation between ID template instances, such that
- **   the IDs typed to the derived/specialised objects can stand-in for the generic
- **   ID typed to the base class.
+ ** - establishing an type hierarchy relation between ID related to the base class
+ **   and the IDs denoting specific subclasses, such that the latter can stand-in
+ **   for the generic ID.
  ** - providing a Mixin, which allows any hierarchy to use this facility without 
  **   much code duplication.
  **
@@ -50,8 +50,8 @@
 
 
 
-#ifndef LIB_HA_ID_H
-#define LIB_HA_ID_H
+#ifndef LIB_HASH_INDEXED_H
+#define LIB_HASH_INDEXED_H
 
 //#include "lib/util.hpp"
 
@@ -73,22 +73,29 @@ namespace lib {
     };
   
   
-  template<class BA>
+  /************************************************************
+   * A Mixin to add a private ID type to the target class,
+   * together with storage to hold an instance of this ID,
+   * getter and setter, and a templated version of the ID type
+   * which can be used to pass on specific subclass type info.
+   */
+  template<class BA, class IMP>
   struct HashIndexed
     {
-      /** 
-       * Generic hash based and hierarchically typed ID
-       * @todo WIP maybe also usable for assets?
+      
+      /**
+       * generic hash based ID, corresponding to the base class BA
        */
-      template<typename T>
-      struct Id;
-
-      struct ID : LuidH
+      struct ID : IMP
         {
-          ID ()              : LuidH () {}
-          ID (BA const& ref) : LuidH (ref.getID()) {}
+          ID ()              : IMP ()            {}
+          ID (BA const& ref) : IMP (ref.getID()) {}
+          ID (IMP const& ir) : IMP (ir)          {}
         };
       
+      /** 
+       * Hash based ID, typed to a specific subclass of BA
+       */
       template<typename T>
       struct Id : ID
         {
@@ -96,18 +103,21 @@ namespace lib {
           Id (T const& ref) : ID (ref) {}
         };
       
-      ID const& getID()  const
+      ID const&
+      getID ()  const
         { 
           return id_; 
         }
-      void resetID(HashIndexed const& ref)
+      
+      void
+      assignID (HashIndexed const& ref)
         { 
           this->id_ = ref.getID();
         }
-      void resetID(ID const& ref) ///< @todo this mutator should be removed in the final version to keep the actual hash opaque
-        { 
-          this->id_.dummy_ = ref.dummy_;
-        }
+      
+    protected:
+      HashIndexed ()                : id_()     {}
+      HashIndexed (IMP const& iref) : id_(iref) {}
       
     private:
       ID id_;
diff --git a/tests/40components.tests b/tests/40components.tests
index bad8b8be3..afa9451e2 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -215,7 +215,7 @@ out: dtor ~TargetObj(12) successful
 END
 
 
-PLANNED "HaID_test" HaID_test <<END
+PLANNED "HashIndexed_test" HashIndexed_test <<END
 return: 0
 END
 
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 1d306ab19..7c9d41276 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -42,7 +42,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/exceptionerrortest.cpp		\
 	$(testlib_srcdir)/factoryspecialtest.cpp		\
 	$(testlib_srcdir)/factorytest.cpp			\
-	$(testlib_srcdir)/ha-id-test.cpp			\
+	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
 	$(testlib_srcdir)/mainsuite.cpp				\
diff --git a/tests/lib/hash-indexed-test.cpp b/tests/lib/hash-indexed-test.cpp
index ab2d7c5f3..43269f77f 100644
--- a/tests/lib/hash-indexed-test.cpp
+++ b/tests/lib/hash-indexed-test.cpp
@@ -1,5 +1,5 @@
 /*
-  HaID(Test)  -  proof-of-concept test for a hash based and typed ID
+  HashIndexed(Test)  -  proof-of-concept test for a hash based and typed ID
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -23,12 +23,12 @@
 
 #include "lib/test/run.hpp"
 
-#include "lib/ha-id.hpp"
+#include "lib/hash-indexed.hpp"
 
-#include <boost/format.hpp>
+//#include <boost/format.hpp>
 #include <iostream>
 
-using boost::format;
+//using boost::format;
 //using std::string;
 using std::cout;
 
@@ -40,49 +40,56 @@ namespace test{
   
   struct Base
     {
-      int ii_;
+      long ii_;
     };
   
-  struct TestA : Base, HashIndexed<TestA>
+  struct TestB : Base, HashIndexed<TestB,LuidH>
     {
+      TestB () {}
+      TestB (ID const& refID) : HashIndexed<TestB,LuidH>(refID) {}
     };
-  struct TestBA : TestA {};
-  struct TestBB : TestA {};
+  struct TestDA : TestB {};
+  struct TestDB : TestB {};
   
   
   
   
   /***************************************************************************
    * @test proof-of-concept test for a generic hash based and typed ID struct.
-   * @see  lib::HaID
+   * @see  lib::HashIndexed::Id
    */
-  class HaID_test : public Test
+  class HashIndexed_test : public Test
     {
       
       virtual void
       run (Arg) 
         {
-          format fmt ("sizeof( %s ) = %d\n");
+          TestB::Id<TestDA> idDA;
           
-          /////////////////////////////////TODO
-          TestA::Id<TestBB> idBB1;
+          TestB bb (idDA);
           
-          TestBA bab;
-          bab.resetID (idBB1);
+          TestB::Id<TestDB> idDB1 ;
+          TestB::Id<TestDB> idDB2 (idDB1);
           
-          TestA::Id<TestBA> idBA1 (bab);
+          ASSERT (sizeof (idDB1)     == sizeof (idDA) );
+          ASSERT (sizeof (TestB::ID) == sizeof (LuidH));
+          ASSERT (sizeof (TestDA)    == sizeof (LuidH) + sizeof (Base));
           
-          cout << fmt % "TestBA"     % sizeof(bab);
-          cout << fmt % "Id<TestBA>" % sizeof(idBA1);
-          cout << fmt % "Id<TestBB>" % sizeof(idBB1);
+          ASSERT (idDA.dummy_  == bb.getID().dummy_);
+          ASSERT (idDB1.dummy_ == idDB2.dummy_);
           
-          ASSERT (idBA1.dummy_ == idBB1.dummy_);
+          TestDA d1;
+          TestDA d2;
+          ASSERT (d1.getID().dummy_ != d2.getID().dummy_);
+          
+          d2 = d1;
+          ASSERT (d1.getID().dummy_ == d2.getID().dummy_);
         } 
     };
   
   
   /** Register this test class... */
-  LAUNCHER (HaID_test, "unit common");
+  LAUNCHER (HashIndexed_test, "unit common");
       
       
 }} // namespace lib::test

From 3b8a85172211deeb0af34a977ed2d1ffcd65912c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 24 May 2009 01:46:00 +0200
Subject: [PATCH 026/368] add equality

---
 src/lib/hash-indexed.hpp        |  3 +++
 tests/lib/hash-indexed-test.cpp | 14 +++++++-------
 2 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/src/lib/hash-indexed.hpp b/src/lib/hash-indexed.hpp
index bc6d8e25d..34d59f500 100644
--- a/src/lib/hash-indexed.hpp
+++ b/src/lib/hash-indexed.hpp
@@ -70,6 +70,9 @@ namespace lib {
       long dummy_;
       
       LuidH() : dummy_(rand()) {}
+          
+      bool operator== (LuidH const& o)  const { return dummy_ == o.dummy_; }
+      bool operator!= (LuidH const& o)  const { return dummy_ != o.dummy_; }
     };
   
   
diff --git a/tests/lib/hash-indexed-test.cpp b/tests/lib/hash-indexed-test.cpp
index 43269f77f..7f6f760c5 100644
--- a/tests/lib/hash-indexed-test.cpp
+++ b/tests/lib/hash-indexed-test.cpp
@@ -36,14 +36,14 @@ using std::cout;
 namespace lib {
 namespace test{
   
-  /* ==  a hierarchy of test-dummy objects to use the HaID == */
+  /* ==  a hierarchy of test-dummy objects to use the HashIndexed::ID == */
   
   struct Base
     {
       long ii_;
     };
   
-  struct TestB : Base, HashIndexed<TestB,LuidH>
+  struct TestB : Base, HashIndexed<TestB,LuidH> ///< Base class to mix in the hash ID facility
     {
       TestB () {}
       TestB (ID const& refID) : HashIndexed<TestB,LuidH>(refID) {}
@@ -75,15 +75,15 @@ namespace test{
           ASSERT (sizeof (TestB::ID) == sizeof (LuidH));
           ASSERT (sizeof (TestDA)    == sizeof (LuidH) + sizeof (Base));
           
-          ASSERT (idDA.dummy_  == bb.getID().dummy_);
-          ASSERT (idDB1.dummy_ == idDB2.dummy_);
+          ASSERT (idDA  == bb.getID() );
+          ASSERT (idDB1 == idDB2 );            // equality handled by the hash impl (here LuidH)
           
           TestDA d1;
           TestDA d2;
-          ASSERT (d1.getID().dummy_ != d2.getID().dummy_);
+          ASSERT (d1.getID() != d2.getID());   // should be different because LUIDs are random
           
-          d2 = d1;
-          ASSERT (d1.getID().dummy_ == d2.getID().dummy_);
+          d2 = d1; 
+          ASSERT (d1.getID() == d2.getID());   // default assignment operator works as expected
         } 
     };
   

From 85a9c99e522bc119268881b01fd693536bedb608 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 24 May 2009 05:14:11 +0200
Subject: [PATCH 027/368] hash ID: add trivial implementation + impl based on
 LUID

---
 src/lib/hash-indexed.hpp        |  98 +++++++++++++++++++++++++------
 src/proc/asset/category.hpp     |  82 +++++++++++++-------------
 src/proc/asset/db.hpp           |  14 ++---
 src/proc/asset/media.hpp        |   4 +-
 tests/40components.tests        |   2 +-
 tests/lib/hash-indexed-test.cpp | 100 ++++++++++++++++++++++++++------
 wiki/renderengine.html          |  29 ++++-----
 7 files changed, 229 insertions(+), 100 deletions(-)

diff --git a/src/lib/hash-indexed.hpp b/src/lib/hash-indexed.hpp
index 34d59f500..ab759ff90 100644
--- a/src/lib/hash-indexed.hpp
+++ b/src/lib/hash-indexed.hpp
@@ -30,7 +30,7 @@
  ** be managed within this collection. Typically this results in this common base class
  ** being almost worthless as an API or interface, causing lots of type casts when using
  ** such a common object management facility. Passing additional context or API information
- ** on a metaprogramming level through the management interface helps avoiding these 
+ ** on a metaprogramming level through the management interface helps avoiding these
  ** shortcomings. 
  ** 
  ** Here we build an ID facility with the following properties:
@@ -41,7 +41,7 @@
  **   and the IDs denoting specific subclasses, such that the latter can stand-in
  **   for the generic ID.
  ** - providing a Mixin, which allows any hierarchy to use this facility without 
- **   much code duplication.
+ **   much code duplication, including an adapter for tr1::unordered_map
  **
  ** @see HashIndexed_test
  ** @see Placement usage example
@@ -53,34 +53,78 @@
 #ifndef LIB_HASH_INDEXED_H
 #define LIB_HASH_INDEXED_H
 
-//#include "lib/util.hpp"
-
-//#include <tr1/memory>
-#include <cstdlib>
+extern "C" {
+#include "lib/luid.h"
+}
+#include <functional>
 
 
 namespace lib {
-
-//  using std::tr1::shared_ptr;
-  using std::rand;
   
+  /** Hash implementations usable for the HashIndexed mixin
+   *  as well as key within tr1::unordered_map */
+  namespace hash {
+    
+    /** 
+     * simple Hash implementation
+     * directly incorporating the hash value.
+     */
+    class Plain
+      {
+        const size_t hash_;
+        
+      public:
+        Plain (size_t val)
+          : hash_(val)
+          { }
+        
+        template<typename TY>
+        Plain (TY const& something)
+          : hash_(hash_value (something))  // ADL
+          { }
+        
+        operator size_t()  const { return hash_; }
+      };
+    
+    /**
+     * Hash implementation based on a lumiera unique object id (LUID)
+     * When invoking the default ctor, a new LUID is generated
+     */
+    class LuidH 
+      {
+        lumiera_uid luid_;
+        
+      public:
+        LuidH ()
+          {
+            lumiera_uid_gen (&luid_);
+            ENSURE (0 < lumiera_uid_hash(&luid_));
+          }
+        
+        typedef lumiera_uid* LUID;
+        
+        operator size_t ()                const { return lumiera_uid_hash ((LUID)&luid_); }
+        bool operator== (LuidH const& o)  const { return lumiera_uid_eq ((LUID)&luid_, (LUID)&o.luid_); }
+        bool operator!= (LuidH const& o)  const { return !operator== (o); }
+        
+        /** for passing to C APIs */
+        LUID get() { return &luid_; }
+      };
+    
+    
+    /* === for use within unordered_map === */
+    size_t hash_value (Plain const& plainHash)  { return plainHash; }
+    size_t hash_value (LuidH const& luid_Hash)  { return luid_Hash; }
+    
+  } // namespace "hash"
   
-  struct LuidH 
-    {
-      long dummy_;
-      
-      LuidH() : dummy_(rand()) {}
-          
-      bool operator== (LuidH const& o)  const { return dummy_ == o.dummy_; }
-      bool operator!= (LuidH const& o)  const { return dummy_ != o.dummy_; }
-    };
   
   
   /************************************************************
    * A Mixin to add a private ID type to the target class,
    * together with storage to hold an instance of this ID,
    * getter and setter, and a templated version of the ID type
-   * which can be used to pass on specific subclass type info.
+   * which can be used to pass specific subclass type info.
    */
   template<class BA, class IMP>
   struct HashIndexed
@@ -106,6 +150,22 @@ namespace lib {
           Id (T const& ref) : ID (ref) {}
         };
       
+      
+      /** enables use of BA objects as keys within tr1::unordered_map */
+      struct UseEmbeddedHash
+        : public std::unary_function<BA, size_t>
+        {
+          size_t operator() (BA const& obj)  const { return obj.getID(); }
+        };
+      
+      /** trivial hash functor using the ID as hash */
+      struct UseHashID
+        : public std::unary_function<ID, size_t>
+        {
+          size_t operator() (ID const& id)  const { return id; }
+        };
+      
+      
       ID const&
       getID ()  const
         { 
diff --git a/src/proc/asset/category.hpp b/src/proc/asset/category.hpp
index 9e0526cc2..c644f2acc 100644
--- a/src/proc/asset/category.hpp
+++ b/src/proc/asset/category.hpp
@@ -30,35 +30,35 @@
 
 
 
-namespace asset
-  {
+namespace asset {
+  
   using std::string;
   using std::ostream;
-
-      /** top-level distinction of different Kinds of Assets.
-       *  For convienience, this classification is slightly denormalized,
-       *  as AUDIO, and VIDEO are both asset::Media objects, EFFECT and CODEC
-       *  are asset::Proc objects, while STRUCT and META refer directly to 
-       *  the corresponding Interfaces asset::Struct and asset::Meta.
-       */
-      enum Kind
-      {
-        AUDIO,
-        VIDEO,
-        EFFECT,
-        CODEC,
-        STRUCT,
-        META
-      };
   
-  /**
+  /** 
+   * top-level distinction of different Kinds of Assets.
+   * For convenience, this classification is slightly denormalised,
+   * as AUDIO, and VIDEO are both asset::Media objects, EFFECT and CODEC
+   * are asset::Proc objects, while STRUCT and META refer directly to 
+   * the corresponding Interfaces asset::Struct and asset::Meta.
+   */
+  enum Kind
+    { AUDIO
+    , VIDEO
+    , EFFECT
+    , CODEC
+    , STRUCT
+    , META
+    };
+  
+  /*************************************
    * Tree like classification of Assets.
-   * By virtue of the Category, Assets can be organized in nested bins (folders).
+   * By virtue of the Category, Assets can be organised in nested bins (folders).
    * This includes the distinction of different kinds of Assets, like Audio, Video, Effects...
    * 
-   * @todo could be far more elaborate. could be a singleton like centralized tree, while
-   *       just holding references to Catetory nodes in the individual Asset. At the moment,
-   *       we use just the most simplistic implementation and handle Category objects 
+   * @todo could be far more elaborate. could be a singleton like centralised tree, while
+   *       just holding references to Category nodes in the individual Asset. At the moment,
+   *       we just use the most simplistic implementation and handle Category objects 
    *       using value semantics.
    */
   class Category
@@ -70,21 +70,22 @@ namespace asset
       string path_;
       
     public:
-      Category (const Kind root, string subfolder ="") 
+      Category (const Kind root, string subfolder ="")
         : kind_(root), path_(subfolder) {};
       
-      bool operator== (const Category& other) const { return kind_== other.kind_ && path_== other.path_; }
-      bool operator!= (const Category& other) const { return kind_!= other.kind_ || path_!= other.path_; }
-        
-      bool hasKind (Kind refKind)     const         { return kind_ == refKind; }
-      bool isWithin (const Category&) const;
-      void setPath (const string & newpath)         { this->path_ = newpath; }
+      bool operator== (Category const& other) const { return kind_== other.kind_ && path_== other.path_; }
+      bool operator!= (Category const& other) const { return kind_!= other.kind_ || path_!= other.path_; }
+      
+      bool hasKind  (Kind refKind)    const         { return kind_ == refKind; }
+      bool isWithin (Category const&) const;
+      void setPath  (string const& newpath)         { this->path_ = newpath; }
       
       
       operator string ()  const;
-
-        
-      friend size_t hash_value (const Category& cat)
+      
+      
+      friend size_t
+      hash_value (Category const& cat)
         {
           size_t hash = 0;
           boost::hash_combine(hash, cat.kind_);
@@ -92,7 +93,8 @@ namespace asset
           return hash;
         }
       
-      int compare (const Category& co)  const
+      int
+      compare (Category const& co)  const
         {
           int res = int(kind_) - int(co.kind_);
           if (0 != res) 
@@ -100,12 +102,12 @@ namespace asset
           else
             return path_.compare (co.path_);
         }
-
+      
     };
-    
-   inline ostream& operator<< (ostream& os, const Category& cago) { return os << string(cago); }
-
-   
-    
+  
+  inline ostream& operator<< (ostream& os, const Category& cago) { return os << string(cago); }
+  
+  
+  
 } // namespace asset
 #endif
diff --git a/src/proc/asset/db.hpp b/src/proc/asset/db.hpp
index c4fa89f00..560e43b6f 100644
--- a/src/proc/asset/db.hpp
+++ b/src/proc/asset/db.hpp
@@ -48,7 +48,7 @@ namespace asset {
   /* ===== hash implementations ===== */
   
   size_t 
-  hash_value (const Asset::Ident& idi)
+  hash_value (Asset::Ident const& idi)
   {
     size_t hash = 0;
     boost::hash_combine(hash, idi.org);
@@ -58,23 +58,23 @@ namespace asset {
   }
   
   size_t
-  hash_value (const Asset& asset)
+  hash_value (Asset const& asset)
   {
     return asset.getID();
   }
   
   
-  /** 
-   * trivial hash functor.
+  /**
+   * trivial hash functor
    * returns any hash value unmodified.
-   * For building a hashtable with keys 
+   * For building a hashtable with keys
    * already containing valid hash values.
    */
-  struct IdentityHash 
+  struct IdentityHash
     : public std::unary_function<size_t, size_t>
     {
       size_t 
-      operator() (size_t val) const   { return val; }
+      operator() (size_t val)  const { return val; }
     };
   
   typedef std::tr1::unordered_map<size_t, PAsset, IdentityHash> IdHashtable;
diff --git a/src/proc/asset/media.hpp b/src/proc/asset/media.hpp
index 0cff14f7c..4273a3f68 100644
--- a/src/proc/asset/media.hpp
+++ b/src/proc/asset/media.hpp
@@ -137,7 +137,7 @@ namespace asset {
   
   
   /** 
-   * Factory specialized for creating Media Asset objects.
+   * Factory specialised for creating Media Asset objects.
    */ 
   class MediaFactory : public lumiera::Factory<asset::Media>
     {
@@ -148,7 +148,7 @@ namespace asset {
       PType operator() (const string& file, const Category& cat);
       PType operator() (const string& file, asset::Kind);
       
-      PType operator() (Asset::Ident& key, const char* file);  ///< convienience overload using C-String
+      PType operator() (Asset::Ident& key, const char* file);  ///< convenience overload using C-String
       PType operator() (const char* file, const Category& cat);
       PType operator() (const char* file, asset::Kind);
       
diff --git a/tests/40components.tests b/tests/40components.tests
index afa9451e2..e55ca3d7d 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -215,7 +215,7 @@ out: dtor ~TargetObj(12) successful
 END
 
 
-PLANNED "HashIndexed_test" HashIndexed_test <<END
+TEST "HashIndexed_test" HashIndexed_test <<END
 return: 0
 END
 
diff --git a/tests/lib/hash-indexed-test.cpp b/tests/lib/hash-indexed-test.cpp
index 7f6f760c5..e5a3e0e77 100644
--- a/tests/lib/hash-indexed-test.cpp
+++ b/tests/lib/hash-indexed-test.cpp
@@ -25,12 +25,7 @@
 
 #include "lib/hash-indexed.hpp"
 
-//#include <boost/format.hpp>
-#include <iostream>
-
-//using boost::format;
-//using std::string;
-using std::cout;
+#include <tr1/unordered_map>
 
 
 namespace lib {
@@ -38,15 +33,20 @@ namespace test{
   
   /* ==  a hierarchy of test-dummy objects to use the HashIndexed::ID == */
   
-  struct Base
+  struct DummyAncestor
     {
-      long ii_;
+      long xyz_;
     };
   
-  struct TestB : Base, HashIndexed<TestB,LuidH> ///< Base class to mix in the hash ID facility
+  struct TestB;                                  ///< Base class to mix in the hash ID facility
+  typedef HashIndexed<TestB, hash::LuidH> Mixin; ///< actual configuration of the mixin
+  
+  struct TestB : DummyAncestor, Mixin
     {
       TestB () {}
-      TestB (ID const& refID) : HashIndexed<TestB,LuidH>(refID) {}
+      TestB (ID const& refID) : Mixin (refID) {}
+      
+      bool operator== (TestB const& o)  const { return this->getID() == o.getID(); }
     };
   struct TestDA : TestB {};
   struct TestDB : TestB {};
@@ -56,13 +56,33 @@ namespace test{
   
   /***************************************************************************
    * @test proof-of-concept test for a generic hash based and typed ID struct.
-   * @see  lib::HashIndexed::Id
+   *       - check the various ctors 
+   *       - check default assignment works properly
+   *       - check assumptions about memory layout
+   *       - check equality comparison
+   *       - extract LUID and then cast LUID back into ID
+   *       - use the embedded hash ID (LUID) as hashtable key
+   *       
+   * @see lib::HashIndexed::Id
+   * @see mobject::Placement real world usage example 
    */
   class HashIndexed_test : public Test
     {
       
       virtual void
-      run (Arg) 
+      run (Arg)
+        {
+          checkBasicProperties();
+          checkLUID_passing();
+          
+          //            ---key-type-------+-value-+-hash-function--- 
+          buildHashtable<TestB::Id<TestDB>, TestDB, TestB::UseHashID> ();
+          buildHashtable<TestDB,            TestDB, TestB::UseEmbeddedHash>();
+        }
+      
+      
+      void
+      checkBasicProperties ()
         {
           TestB::Id<TestDA> idDA;
           
@@ -72,8 +92,8 @@ namespace test{
           TestB::Id<TestDB> idDB2 (idDB1);
           
           ASSERT (sizeof (idDB1)     == sizeof (idDA) );
-          ASSERT (sizeof (TestB::ID) == sizeof (LuidH));
-          ASSERT (sizeof (TestDA)    == sizeof (LuidH) + sizeof (Base));
+          ASSERT (sizeof (TestB::ID) == sizeof (hash::LuidH));
+          ASSERT (sizeof (TestDA)    == sizeof (hash::LuidH) + sizeof (DummyAncestor));
           
           ASSERT (idDA  == bb.getID() );
           ASSERT (idDB1 == idDB2 );            // equality handled by the hash impl (here LuidH)
@@ -84,12 +104,58 @@ namespace test{
           
           d2 = d1; 
           ASSERT (d1.getID() == d2.getID());   // default assignment operator works as expected
-        } 
+        }
+      
+      
+      void
+      checkLUID_passing ()
+        {
+          TestB::Id<TestDA> idOrig;
+          
+          lumiera_uid plainLUID;
+          lumiera_uid_copy (&plainLUID, idOrig.get());
+          
+          // now, maybe after passing it through a Layer barrier...
+          TestB::ID const& idCopy = reinterpret_cast<TestB::ID & > (plainLUID);
+          
+          ASSERT (idOrig == idCopy);
+        }
+      
+      
+      template<class KEY, class VAL, class HashFunc>
+      void
+      buildHashtable ()
+        {
+          typedef std::tr1::unordered_map<KEY, VAL, HashFunc> Hashtable;
+          
+          Hashtable tab;
+          
+          VAL o1;  KEY key1 (o1);
+          VAL o2;  KEY key2 (o2);
+          VAL o3;  KEY key3 (o3);
+          
+          tab[key1] = o1;                             // store copy into hashtable
+          tab[key2] = o2;
+          tab[key3] = o3;
+          
+          ASSERT (&o1 != &tab[key1]);                 // indeed a copy...
+          ASSERT (&o2 != &tab[key2]);
+          ASSERT (&o3 != &tab[key3]);
+          
+          ASSERT (o1.getID() == tab[key1].getID());   // but "equal" by ID
+          ASSERT (o2.getID() == tab[key2].getID());
+          ASSERT (o3.getID() == tab[key3].getID());
+          
+          ASSERT (o1.getID() != tab[key2].getID());
+          ASSERT (o1.getID() != tab[key3].getID());
+          ASSERT (o2.getID() != tab[key3].getID());
+        }
+      
     };
   
   
   /** Register this test class... */
   LAUNCHER (HashIndexed_test, "unit common");
-      
-      
+  
+  
 }} // namespace lib::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index b6ed85551..4a8ad8028 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -758,9 +758,9 @@ config.macros.timeline.handler = function(place,macroName,params,wikifier,paramS
 }
 //}}}</pre>
 </div>
-<div title="BindingMO" modifier="Ichthyostega" modified="200905210149" created="200905210144" tags="def design discuss SessionLogic" changecount="2">
+<div title="BindingMO" modifier="Ichthyostega" modified="200905222252" created="200905210144" tags="def design discuss SessionLogic" changecount="4">
 <pre>Sometimes, two entities within the [[Session]] are deliberately associated, and this association has to carry some specific mappings between properties or facilities within the entities to be linked together. When this connection isn't just the [[Placement]] of an object, and isn't just a logical or structural relationship either &amp;mdash; then we create an explicit Binding object to be stored into the session.
-* Connecting a [[Sequence|EDL]] gets connected to a certain [[Timeline]] also establishes a mapping between the possible media stream channels produced by the sequence and the real output slots found within the timeline.
+* When connecting a [[Sequence|EDL]] to a certain [[Timeline]], we also establish a mapping between the possible media stream channels produced by the sequence and the real output slots found within the timeline.
 * similarly, using a sequence within a [[meta-clip|VirtualClip]] requires to remember such a mapping.
 * another example is the root [[scope|PlacementScope]], which (conceptually) is a link between the definition part of the Session and the graph of MObjects, which are the session's contents.
 
@@ -2810,7 +2810,7 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
-<div title="PlacementIndex" modifier="Ichthyostega" modified="200905192358" created="200905090053" tags="SessionLogic spec impl draft" changecount="10">
+<div title="PlacementIndex" modifier="Ichthyostega" modified="200905232251" created="200905090053" tags="SessionLogic spec impl draft" changecount="11">
 <pre>An implementation facility used to keep track of individual Placements and their relations.
 Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
 
@@ -2828,7 +2828,7 @@ Alternatively, we could try to use a ''structure based index''. Following this i
 * this way, the &quot;index&quot; could be reduced to being the session datastructure itself.
 
 
-!supported operations {{red{WIP}}}
+!supported operations
 The placement index is utilized by editing operations, by executing the build process and besides these core operations it allows resolving PlacementRef objects (which possibly may have crossed layer boundaries). From these use cases we derive the following main operations to support:
 * find the actual [[Placement]] object for a given ID
 * find the //scope//&amp;nbsp; a given placement resides in. More specifically, find the [[placement defining this scope|PlacementScope]]
@@ -2836,20 +2836,21 @@ The placement index is utilized by editing operations, by executing the build pr
 * add a new placement to a scope given as parameter
 * remove a placement from index
 
-//does a placement need to know it's own ID?// Obviously, there needs to be a way to find out the ID for a given placement, especially in the following situations:
+//does a placement need to know it's own ID?// &amp;nbsp; Obviously, there needs to be a way to find out the ID for a given placement, especially in the following situations:
 * for most of the operations above, when querying some additional informations from index for a given placement
 * to create a PlacementRef (this is a variant of the &quot;shared ptr from this&quot;-problem)
-On second sight, this problem seems to be quite nasty, because either we have to keep a second indext table for the reversed lookup (memory address -&gt; ID), or have to tie the placement by a backlink when adding it to the index/session datastructure, or (at least) it forces us to store a copy of the ID //within// the placement itself. The last possibility seems to create the least impact; but implementing it this way effectively gears the implementation towards a hashtable based approach.
+On second sight, this problem seems to be quite nasty, because either we have to keep a second index table for the reversed lookup (memory address -&gt; ID), or have to tie the placement by a backlink when adding it to the index/session datastructure, or (at least) it forces us to store a copy of the ID //within// the placement itself. The last possibility seems to create the least impact; but implementing it this way effectively gears the implementation towards a hashtable based approach.
+
+!implementation {{red{WIP}}}
+Consequently, we incorporate a random hash (implemented as {{{LUID}}}) into the individual placement, this way creating an distinguishable //placement identity,// which is retained on copying of the placement. The actual ID tag is complemented by a compile time type (template parameter), thus allowing to pass on additional context information through API calls.
 </pre>
 </div>
-<div title="PlacementRef" modifier="Ichthyostega" modified="200905192350" created="200905090032" tags="def spec draft" changecount="3">
+<div title="PlacementRef" modifier="Ichthyostega" modified="200905232242" created="200905090032" tags="def spec draft" changecount="4">
 <pre>A generic reference mechanism for Placements, as added to the current session.
-While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object.
+While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object. As a plus, this approach allows to //reverse// the relation denoted by such a reference, inasmuch it is possible to retrieve all other placements referring to a given target placement.
 
-!questions {{red{WIP}}}
-Currently (5/09) ichthyo is in doubt what implementation to use best. It is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, the design decision boils down to the question how to implement the ID tag.
-* a flat random hash, e.g. using a {{{LUID}}}?
-* a structure based index, which also denotes the position in the (tree like) datastructure (Sequences within the session)?
+!implementation {{red{WIP}}}
+From the usage context it is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, this design decision is interconnected with the implementation technique used for the index (&amp;rarr; PlacementIndex). From the requirement of the ID tag to be contained in a fixed sized storage, and also from the expected kinds of queries Ichthyo (5/09) choose to incorporate a {{{LUID}}} as a random hash immediately into the placement and build the ID tag on top of it.
 </pre>
 </div>
 <div title="PlacementScope" modifier="Ichthyostega" modified="200905210132" created="200905120304" tags="SessionLogic spec draft" changecount="5">
@@ -3547,14 +3548,14 @@ Currently as of 5/09, this is an ongoing [[implementation and planning effort|Pl
 <div title="SessionInterface" modifier="Ichthyostega" modified="200904242109" created="200904242108" tags="SessionLogic GuiIntegration design draft discuss" changecount="2">
 <pre>{{red{WIP}}}</pre>
 </div>
-<div title="SessionLogic" modifier="Ichthyostega" modified="200904252317" created="200904242110" tags="overview" changecount="10">
+<div title="SessionLogic" modifier="Ichthyostega" modified="200905232229" created="200904242110" tags="overview" changecount="11">
 <pre>The Session contains all informations, state and objects to be edited by the User (&amp;rarr;[[def|Session]]).
 As such, the SessionInterface is the main entrance point to Proc-Layer functionality, both for the primary EditingOperations and for playback/rendering processes.
 
 Currently (as of 5/09), Ichthyo is [[targeting|PlanningSessionInMem]] a first preliminary implementation of the [[Session in Memory|SessionDataMem]]
 
 !Design and handling of Objects within the Session
-Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. They behave like //instances// of a given object, and at the same time define the &quot;non-substancial&quot; properties of the object, like its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render proceeses within the engine, but also to external parts within the GUI and in plugins.</pre>
+Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. Effectively, such a placement within the session behaves like an //instances// of a given object, and at the same time it defines the &quot;non-substantial&quot; properties of the object, e.g. its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render processes within the engine, but also to external parts within the GUI and in plugins. The actual implementation of these object references is built on top of the PlacementRef tags, thus relying on the PlacementIndex the session maintains to keep track of all placements and their relations.</pre>
 </div>
 <div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design" changecount="29">
 <pre>&lt;&lt;&lt;

From 003895b08dc3c1b236c070fd0e41456fb1ba874a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 24 May 2009 19:34:47 +0200
Subject: [PATCH 028/368] =?UTF-8?q?considering=20how=20to=20bring=20the=20?=
 =?UTF-8?q?new=20hash=20ID=C2=A0into=20Placement.=20Which=20in=20turn=20is?=
 =?UTF-8?q?=20required=20for=20the=20Placement/MObject=20ref=20and=20the?=
 =?UTF-8?q?=20Placement=20index?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/proc/mobject/mobject.hpp                  |  28 +++--
 tests/43session.tests                         |   4 +
 tests/components/Makefile.am                  |   1 +
 .../proc/mobject/placement-hierarchy-test.cpp | 101 ++++++++++++++++++
 wiki/renderengine.html                        |  27 +++--
 5 files changed, 135 insertions(+), 26 deletions(-)
 create mode 100644 tests/components/proc/mobject/placement-hierarchy-test.cpp

diff --git a/src/proc/mobject/mobject.hpp b/src/proc/mobject/mobject.hpp
index c97ac6d63..fecb8ee81 100644
--- a/src/proc/mobject/mobject.hpp
+++ b/src/proc/mobject/mobject.hpp
@@ -30,7 +30,7 @@
 #include "proc/common.hpp"
 #include "proc/mobject/builder/buildertool.hpp"
 #include "proc/mobject/placement.hpp"
-#include "proc/asset.hpp"                 // TODO finally not needed?
+#include "proc/asset.hpp"                    //TODO finally not needed?
 
 #include <boost/noncopyable.hpp>
 #include <boost/operators.hpp>
@@ -39,24 +39,23 @@
 
 using std::list;
 
-#include "proc/assetmanager.hpp"                
-using proc_interface::IDA;                // TODO finally not needed?
+#include "proc/assetmanager.hpp"
+using proc_interface::IDA;                   //TODO finally not needed?
 //using proc_interface::PAsset;              //TODO: only temporarily
 using proc_interface::AssetManager;
 
-namespace mobject
-  {
+namespace mobject {
+  
   using lumiera::P;
   
   //NOBUG_DECLARE_FLAG (mobjectmem);
   
   
-  namespace session
-    {
+  namespace session {
     class MObjectFactory;
-    }
-
-
+  }
+  
+  
   /**
    * MObject is the interface class for all "Media Objects".
    * All the contents and elements that can be placed and 
@@ -70,7 +69,7 @@ namespace mobject
     {
     protected:
       typedef lumiera::Time Time;
-
+      
       // TODO: how to represent time intervals best?
       Time length;
       
@@ -89,15 +88,14 @@ namespace mobject
       virtual Time& getLength() =0; ///< @todo how to deal with the time/length field??
       
       virtual bool operator== (const MObject& oo)  const =0;
-
+      
     };
-
   
-    
+  
+  
   typedef Placement<MObject> PMO;
 
 
-
 } // namespace mobject
 #endif
 /*
diff --git a/tests/43session.tests b/tests/43session.tests
index b72392b8b..6978f50f0 100644
--- a/tests/43session.tests
+++ b/tests/43session.tests
@@ -29,6 +29,10 @@ PLANNED "PlacementBasic_test" PlacementBasic_test <<END
 END
 
 
+PLANNED "PlacementHierarchy_test" PlacementHierarchy_test <<END
+END
+
+
 PLANNED "PlacementIndex_test" PlacementIndex_test <<END
 END
 
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index cf61adbf4..dece6cfd0 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -53,6 +53,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildsegmenttest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/controller/rendersegmenttest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/placement-basic-test.cpp		\
+	$(testcomponents_srcdir)/proc/mobject/placement-hierarchy-test.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/placement-index-test.cpp		\
 	$(testcomponents_srcdir)/proc/mobject/placement-ref-test.cpp		\
 	$(testcomponents_srcdir)/proc/mobject/session/addcliptest.cpp		\
diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
new file mode 100644
index 000000000..0c21621f8
--- /dev/null
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -0,0 +1,101 @@
+/*
+  PlacementHierarchy(Test)  -  concept draft how to deal with the MObject hierarchy in Placements
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-ref.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+//#include "lib/util.hpp"
+
+#include <boost/format.hpp>
+#include <tr1/memory>
+#include <iostream>
+
+using std::tr1::shared_ptr;
+using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+using std::cout;
+
+
+namespace mobject {
+namespace session {
+namespace test    {
+  
+  
+  
+  template<class TY, class B>
+  struct Pla;
+  
+  struct MOj { };
+  struct Sub1 : MOj { };
+  
+  template<>
+  struct Pla<MOj,MOj>
+    :  shared_ptr<MOj>
+    {
+      
+    };
+  
+  template<class TY, class B>
+  struct Pla
+    : Pla<MOj, MOj>
+    {
+      
+    };
+  
+  
+  /*******************************************************************************
+   * @test Currently (5/09) this is a concept draft separate of any existing types.
+   *       The intention is to rework the Placement implementation based on the
+   *       outcomes of this experiment. When doing so, this test could later on
+   *       serve to document and cover the corresponding Placement properties.
+   * @see  mobject::Placement
+   * @see  mobject::MObject#create
+   */
+  class PlacementHierarchy_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          Pla<Sub1,MOj> pSub1;
+          
+          /////////////////////////////////TODO
+          format fmt ("sizeof( %s ) = %d\n");
+          cout << fmt % "Pla<Sub1>"     % sizeof(pSub1);
+          cout << "Hurgha!\n";
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (PlacementHierarchy_test, "unit session");
+  
+  
+}}} // namespace mobject::session::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 4a8ad8028..6cc4c2b52 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1930,9 +1930,9 @@ The general idea is, that each facade interface actually provides access to a sp
 
 &amp;rarr; overview [[MObject class hierarchy|MObjects]]</pre>
 </div>
-<div title="MObjectRef" modifier="Ichthyostega" modified="200905090026" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="16">
+<div title="MObjectRef" modifier="Ichthyostega" modified="200905241554" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="18">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
-Moreover [[MObject instances|MObject]] have a 2-level structure: the core object holds just the properties in a strict sense, i.e. the properties which the object //owns.// Any properties due to putting the object into a specific context, i.e. all relation properties are represented as [[Placement]] of the object. Thus, a reference to a specific ~MObject //instance,// actually denotes a specific Placement of this object into the Session.
+Moreover [[MObject instances|MObject]] have a 2-level structure: the core object holds just the properties in a strict sense, i.e. the properties which the object //owns.// Any properties due to putting the object into a specific context, i.e. all relation properties are represented as [[Placement]] of the object. Thus, when viewed from the client side, a reference to a specific ~MObject //instance,// actually denotes a //specific//&amp;nbsp; Placement of this object into the Session.
 
 !Requirements
 * just the reference allone is sufficient to access the placement //and//&amp;nbsp; the core object.
@@ -2810,26 +2810,26 @@ Placements have //value semantics,// i.e. we don't stress the identity of a plac
 
 </pre>
 </div>
-<div title="PlacementIndex" modifier="Ichthyostega" modified="200905232251" created="200905090053" tags="SessionLogic spec impl draft" changecount="11">
+<div title="PlacementIndex" modifier="Ichthyostega" modified="200905241504" created="200905090053" tags="SessionLogic spec impl draft" changecount="15">
 <pre>An implementation facility used to keep track of individual Placements and their relations.
-Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessiates finding those other objects).
+Especially, the [[Session]] maintains such an index, allowing to use the (opaque) PlacementRef tags for referring to a specific &quot;instance&quot; of an MObject, //placed// in a unique way into the current session. And, moreover, this index allows for one placement referring to another placement, so to implement a //relative// placement mode. Because there is an index behind the scenes, it is possible to actually access such a referral in the reverse direction, which is necessary for implementing the desired placement behaviour (if an object instance used as anchor is moved, all objects placed relatively to it have to move accordingly, which necessitates finding those other objects).
 
 !questions {{red{WIP}}}
-What implementation approach to take for the index. This of course largely depends on the usage pattern, which in turn is not-yet existant. To start with, we need a preliminary implementation!
+What implementation approach to take for the index. This of course largely depends on the usage pattern, which in turn is not-yet existent. To start with, we need a preliminary implementation!
 
 Using a ''flat hashtable'' would allow to access a Placement denoted by ID in O(1). This way we could get the Placement, but nothing more. So, additionally we'd have to set up an data record holding additional information:
 * the [[scope|PlacementScope]] containing this placement
 * especially the path &quot;up&quot; from this scope, which is used for resolving any queries
 * relations to other placements
 
-Alternatively, we could try to use a ''structure based index''. Following this idea, we could try to avoid the mentioned description record by folding any of the contained informations into the surrounding datastructure:
+Alternatively, we could try to use a ''structure based index''. Following this idea, we could try to avoid the mentioned description record by folding any of the contained informations into the surrounding data structure:
 * the scope would be obvious from the index, resp. from the path used to resolve this index
 * any other informations, especially the relations, would be folded into the placement
-* this way, the &quot;index&quot; could be reduced to being the session datastructure itself.
+* this way, the &quot;index&quot; could be reduced to being the session data structure itself.
 
 
 !supported operations
-The placement index is utilized by editing operations, by executing the build process and besides these core operations it allows resolving PlacementRef objects (which possibly may have crossed layer boundaries). From these use cases we derive the following main operations to support:
+The placement index is utilized by editing operations, by executing the build process. Besides these core operations it allows for resolving PlacementRef objects. This latter functionality is used by all kinds of relative placements and for dealing with them while building, but it is also used to resolve [[object reference tags|MObjectRef]], which possibly may have been handed out via an external API or may have crossed layer boundaries. From these use cases we derive the following main operations to support:
 * find the actual [[Placement]] object for a given ID
 * find the //scope//&amp;nbsp; a given placement resides in. More specifically, find the [[placement defining this scope|PlacementScope]]
 * find (any/all) other placements referring to a given placement
@@ -2839,18 +2839,23 @@ The placement index is utilized by editing operations, by executing the build pr
 //does a placement need to know it's own ID?// &amp;nbsp; Obviously, there needs to be a way to find out the ID for a given placement, especially in the following situations:
 * for most of the operations above, when querying some additional informations from index for a given placement
 * to create a PlacementRef (this is a variant of the &quot;shared ptr from this&quot;-problem)
-On second sight, this problem seems to be quite nasty, because either we have to keep a second index table for the reversed lookup (memory address -&gt; ID), or have to tie the placement by a backlink when adding it to the index/session datastructure, or (at least) it forces us to store a copy of the ID //within// the placement itself. The last possibility seems to create the least impact; but implementing it this way effectively gears the implementation towards a hashtable based approach.
+On second sight, this problem seems to be quite nasty, because either we have to keep a second index table for the reversed lookup (memory address -&gt; ID), or have to tie the placement by a back-link when adding it to the index/session data structure, or (at least) it forces us to store a copy of the ID //within// the placement itself. The last possibility seems to create the least impact; but implementing it this way effectively gears the implementation towards a hashtable based approach.
 
 !implementation {{red{WIP}}}
 Consequently, we incorporate a random hash (implemented as {{{LUID}}}) into the individual placement, this way creating an distinguishable //placement identity,// which is retained on copying of the placement. The actual ID tag is complemented by a compile time type (template parameter), thus allowing to pass on additional context information through API calls.
 </pre>
 </div>
-<div title="PlacementRef" modifier="Ichthyostega" modified="200905232242" created="200905090032" tags="def spec draft" changecount="4">
+<div title="PlacementRef" modifier="Ichthyostega" modified="200905241641" created="200905090032" tags="def spec draft" changecount="7">
 <pre>A generic reference mechanism for Placements, as added to the current session.
-While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object. As a plus, this approach allows to //reverse// the relation denoted by such a reference, inasmuch it is possible to retrieve all other placements referring to a given target placement.
+While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object. As a plus, this approach allows to //reverse// the relation denoted by such a reference, inasmuch it is possible to retrieve all other placements referring to a given target placement. But for an (external) user, this link to an index implementation is kept transparent and implicit.
 
 !implementation {{red{WIP}}}
 From the usage context it is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, this design decision is interconnected with the implementation technique used for the index (&amp;rarr; PlacementIndex). From the requirement of the ID tag to be contained in a fixed sized storage, and also from the expected kinds of queries Ichthyo (5/09) choose to incorporate a {{{LUID}}} as a random hash immediately into the placement and build the ID tag on top of it.
+
+!using placement references
+Placement references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation can fail, because the validity of the reference is checked. From this point onward, the referred ~MObject is kept alive by the reference &amp;mdash; but note, this doesn't extend to the placement, which still may be modified or removed within the session without further notice. {{red{TODO investigate synchronisation guarantees or a locking mechanism}}} Thus, client code should never store direct references to the latter.
+
+Placement references have value semantics, i.e. they don't have an identity and can be copied feely. Dereferencing yields a direct (language) ref to the MObject, while the placement can be accessed by a separate function {{{getPlacement()}}}. Moreover, the PlacementRef instance provides a direct API to some of the most common query functions you could imagine to call on both the object and the placement (i.e. to find out about the start time, length, ....)
 </pre>
 </div>
 <div title="PlacementScope" modifier="Ichthyostega" modified="200905210132" created="200905120304" tags="SessionLogic spec draft" changecount="5">

From 2e0daaf88e318debec2bac49e0325c38ac072f96 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 27 May 2009 03:20:33 +0200
Subject: [PATCH 029/368] concept draft featuring an alternative way to define
 the Placement template

---
 .../proc/mobject/placement-hierarchy-test.cpp | 131 ++++++++++++++++--
 1 file changed, 119 insertions(+), 12 deletions(-)

diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index 0c21621f8..454e583ea 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -29,11 +29,12 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-ref.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
-//#include "lib/util.hpp"
+#include "lib/util.hpp"
 
 #include <boost/format.hpp>
 #include <tr1/memory>
 #include <iostream>
+#include <cstdlib>
 
 using std::tr1::shared_ptr;
 using boost::format;
@@ -41,6 +42,7 @@ using boost::format;
 //using util::contains;
 using std::string;
 using std::cout;
+using std::rand;
 
 
 namespace mobject {
@@ -48,28 +50,120 @@ namespace session {
 namespace test    {
   
   
+  /**
+   * a dummy version of the MObject hierarchy,
+   * used to experiment with the Placement template structure
+   */
+  struct MOj;
   
-  template<class TY, class B>
-  struct Pla;
-  
-  struct MOj { };
-  struct Sub1 : MOj { };
+
+  template<class TY, class B =MOj>
+  class Pla;
   
   template<>
-  struct Pla<MOj,MOj>
-    :  shared_ptr<MOj>
+  class Pla<MOj,MOj>
+    : protected shared_ptr<MOj>
     {
+    protected:
+      typedef shared_ptr<MOj> Base;
+      typedef void (*Deleter)(MOj*);
+      
+      Pla (MOj & subject, Deleter killer) 
+        : Base (&subject, killer) {};
+        
+      friend class MOjFac;
+      
+    public:
+      virtual MOj * 
+      operator-> ()  const 
+        { 
+          ENSURE (*this); 
+          return Base::operator-> (); 
+        }      
+      
+      size_t use_count()  const { return Base::use_count(); }
+      
+      virtual ~Pla() {};
       
     };
   
   template<class TY, class B>
-  struct Pla
-    : Pla<MOj, MOj>
+  class Pla
+    : public Pla<B>
     {
+    protected:
+      typedef Pla<B> _Par;
+      typedef typename _Par::Base Base;
+      typedef typename _Par::Deleter Deleter;
+      
+      Pla (TY & mo, Deleter killer)
+        : _Par (mo, killer)
+        { };
+        
+      friend class MOjFac;
+      
+    public:
+      virtual TY*
+      operator-> ()  const
+        {
+          ENSURE (INSTANCEOF (TY, this->get()));
+          return static_cast<TY*>
+            (Base::operator-> ());
+        }
+    };
+  
+  
+  class MOjFac;
+    
+  struct MOj 
+    {
+      static MOjFac create;
+      
+      int id_;
+      
+      MOj() : id_(rand() % 1000) {}
+      virtual ~MOj() {}
+      
+      void show() { cout << "ID=" << id_ << "\n"; }
+    };
+  struct Sub1 : MOj { };
+  struct Sub2 : MOj 
+    {
+      void specialAPI() { cout << "specialAPI()\n";}
+    };
+  struct Sub3 : Sub2
+    { 
       
     };
   
   
+  
+  class MOjFac
+    {
+      static void deleterFunc (MOj* o) { delete o; }
+      
+    public:
+      
+      template<class MO>
+      Pla<MO>
+      special ()
+        {
+          return Pla<MO> (*new MO, &deleterFunc);
+        }
+      
+      typedef Pla<Sub3,Sub2> Pla3;
+      
+      Pla3
+      specialSub3 ()
+        {
+          return Pla3 (*new Sub3, &deleterFunc);
+        }
+    };
+  
+  MOjFac MOj::create;
+  
+  
+  
   /*******************************************************************************
    * @test Currently (5/09) this is a concept draft separate of any existing types.
    *       The intention is to rework the Placement implementation based on the
@@ -84,11 +178,24 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          Pla<Sub1,MOj> pSub1;
+          Pla<Sub1> pSub1    = MOj::create.special<Sub1>();
+          Pla<Sub2> pSub2    = MOj::create.special<Sub2>();
+          Pla<Sub2> pSub3    = MOj::create.specialSub3();
+          
+          Pla<MOj>  pSubM (pSub3);
           
           /////////////////////////////////TODO
           format fmt ("sizeof( %s ) = %d\n");
-          cout << fmt % "Pla<Sub1>"     % sizeof(pSub1);
+          cout << fmt % "Pla<Sub1>"   % sizeof(pSub1);
+          cout << fmt % "Pla<Sub2>"   % sizeof(pSub2);
+          cout << fmt % "Pla<Sub3>"   % sizeof(pSub3);
+          
+          pSub1->show();
+          pSub2->show();
+          pSub3->show();
+          pSubM->show();
+          pSub3->specialAPI();
+          
           cout << "Hurgha!\n";
         }
     };

From 0d41379dda5242ad3fef30a5220d8120c039226d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 28 May 2009 03:43:59 +0200
Subject: [PATCH 030/368] incorporate the hash ID into the concept draft

---
 .../proc/mobject/placement-hierarchy-test.cpp | 21 +++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index 454e583ea..07cb6d54c 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -29,6 +29,7 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-ref.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
+#include "lib/hash-indexed.hpp"
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
@@ -38,8 +39,10 @@
 
 using std::tr1::shared_ptr;
 using boost::format;
+using boost::str;
 //using lumiera::Time;
 //using util::contains;
+using lib::HashIndexed;
 using std::string;
 using std::cout;
 using std::rand;
@@ -55,14 +58,14 @@ namespace test    {
    * used to experiment with the Placement template structure
    */
   struct MOj;
-  
 
   template<class TY, class B =MOj>
   class Pla;
   
   template<>
   class Pla<MOj,MOj>
-    : protected shared_ptr<MOj>
+    : protected shared_ptr<MOj>,
+      public HashIndexed<Pla<MOj>, lib::hash::LuidH>     //////TODO: really need to be inherited publicly?
     {
     protected:
       typedef shared_ptr<MOj> Base;
@@ -113,6 +116,15 @@ namespace test    {
     };
   
   
+  string
+  format_PlacementID (Pla<MOj> const& pla)
+  {
+    static format fmt ("pID(%x)");
+    
+    size_t hashVal = pla.getID();
+    return str(fmt % hashVal);
+  }
+    
   class MOjFac;
     
   struct MOj 
@@ -196,6 +208,11 @@ namespace test    {
           pSubM->show();
           pSub3->specialAPI();
           
+          cout << format_PlacementID(pSub1) << "\n";
+          cout << format_PlacementID(pSub2) << "\n";
+          cout << format_PlacementID(pSub3) << "\n";
+          cout << format_PlacementID(pSubM) << "\n";
+          
           cout << "Hurgha!\n";
         }
     };

From efa7b4717cf53d9f1be22c05a15a340a198ca181 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 29 May 2009 07:10:54 +0200
Subject: [PATCH 031/368] rework placement to contain a LUID, and to deal with
 inheritance according to the concept draft

---
 src/lib/hash-indexed.hpp                      |   4 +-
 src/proc/mobject/builder/buildertool.hpp      |   7 +-
 src/proc/mobject/placement.cpp                |  45 +++---
 src/proc/mobject/placement.hpp                | 134 ++++++++++++------
 src/proc/mobject/session/clip.hpp             |  21 +--
 src/proc/mobject/session/effect.hpp           |  35 ++---
 src/proc/mobject/session/locatingpin.cpp      |   2 +-
 src/proc/mobject/session/locatingpin.hpp      |  34 +++--
 src/proc/mobject/session/meta.hpp             |  39 +++--
 src/proc/mobject/session/relativelocation.hpp |  13 +-
 src/proc/mobject/session/track.hpp            |  29 ++--
 11 files changed, 212 insertions(+), 151 deletions(-)

diff --git a/src/lib/hash-indexed.hpp b/src/lib/hash-indexed.hpp
index ab759ff90..6645a9850 100644
--- a/src/lib/hash-indexed.hpp
+++ b/src/lib/hash-indexed.hpp
@@ -113,8 +113,8 @@ namespace lib {
     
     
     /* === for use within unordered_map === */
-    size_t hash_value (Plain const& plainHash)  { return plainHash; }
-    size_t hash_value (LuidH const& luid_Hash)  { return luid_Hash; }
+    inline size_t hash_value (Plain const& plainHash)  { return plainHash; }
+    inline size_t hash_value (LuidH const& luid_Hash)  { return luid_Hash; }
     
   } // namespace "hash"
   
diff --git a/src/proc/mobject/builder/buildertool.hpp b/src/proc/mobject/builder/buildertool.hpp
index fefa22172..1ad28d0d8 100644
--- a/src/proc/mobject/builder/buildertool.hpp
+++ b/src/proc/mobject/builder/buildertool.hpp
@@ -116,6 +116,11 @@ namespace mobject {
           {
             currentWrapper_ = ptr_toWrappedTarget;
           }
+        template<class TAR>
+        void rememberWrapper (Placement<TAR>* ptr_toWrappedTarget)
+          {
+            currentWrapper_ = ptr_toWrappedTarget;
+          }
         
         void forgetWrapper ()
           {
@@ -153,7 +158,7 @@ namespace mobject {
     
     
     /** 
-     * declare the concrete types a BuilderTool may recievee and treat.
+     * declare the concrete types a BuilderTool may receive and treat.
      * @note it is recommended to use ApplicableBuilderTargetTypes
      */
     template
diff --git a/src/proc/mobject/placement.cpp b/src/proc/mobject/placement.cpp
index 58e145e72..e148694a9 100644
--- a/src/proc/mobject/placement.cpp
+++ b/src/proc/mobject/placement.cpp
@@ -26,34 +26,45 @@
 #include "proc/mobject/mobject.hpp"
 
 #include <boost/format.hpp>
+
+using boost::format;
 using boost::str;
 
-namespace mobject
-  {
+namespace mobject {
 
 
-  template<class MO>
-  ExplicitPlacement
-  Placement<MO>::resolve ()  const 
-    { 
-      return ExplicitPlacement (*this, chain.resolve()); 
-    }
-  
   /** @note we know we need only this single specialisation,
    *        because we define the Placements of more specific 
    *        MObject kinds to be subclasses of Placement<MObject>,
    *        so they will inherit this function.
    */
-  template ExplicitPlacement Placement<MObject>::resolve()  const;
-
-
+  ExplicitPlacement
+  Placement<MObject>::resolve ()  const 
+  { 
+    return ExplicitPlacement (*this, chain.resolve()); 
+  }
+  
+  
   
-  template<>
   Placement<MObject>::operator string ()  const 
-    {
-      static boost::format fmt("Placement<%s> %|50T.| use-cnt=%x adr=%x pointee=%x");
-      return str(fmt % typeid(*get()).name() % use_count() % this % get() ); 
-    }
+  {
+    static format fmt("Placement<%s> %|50T.| use-cnt=%x ID(%x) adr=%x pointee=%x");
+    return str(fmt % typeid(*get()).name() % use_count()
+                                           % (size_t)getID() 
+                                           % this 
+                                           % get()
+                                           ); 
+  }
+  
+  
+  string
+  format_PlacementID (Placement<MObject> const& pla)
+  {
+    static format fmt ("pID(%x)");
+    
+    size_t hashVal = pla.getID();
+    return str(fmt % hashVal);
+  }
   
   
 
diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp
index 6ac85a866..49c7005aa 100644
--- a/src/proc/mobject/placement.hpp
+++ b/src/proc/mobject/placement.hpp
@@ -25,8 +25,8 @@
  ** Placements are at the very core of all editing operations,
  ** because they act as handles to access the media objects to be manipulated. 
  ** Moreover, Placements are the actual content of the EDL(s) and Fixture and thus
- ** are small objects with value semantics. Many editing tasks include locating some
- ** Placement in the EDL or directly take a ref to a Placement.
+ ** are small handle like objects. Many editing tasks include locating some Placement
+ ** within the Session or directly take a ref to a Placement.
  ** 
  ** Placements are <b>refcounting smart pointers</b>: By acting on the Placement object,
  ** we can change parameters of the way the media object is placed (e.g. adjust an offset), 
@@ -41,6 +41,17 @@
  ** case of such constraining is to add a FixedLocation, thus placing the MObject at one
  ** absolute position (time, track).
  ** 
+ ** Together, this yields semantics somewhere in between value semantics and reference semantics.
+ ** As any smart-ptr, placements are copyable, any such copies being considered equivalent. \em But,
+ ** when added to the Session, a placement acts as if it was an \em instance of the object it
+ ** points at, with the purpose to bind this instance into the Session with specific placement
+ ** properties. Thus, such a placement-within-session \em is an distinguishable entity, because
+ ** the settings on the contained LocatingPin chain \em do constitute the relation properties
+ ** of the MObject "placed" by this placement. To support this rather ref-like semantics, any
+ ** placement has an embedded ID (identity), and the Session won't allow to add a clone copy
+ ** of an placement with the same identity. Moreover, it is possible to create a smart-ptr
+ ** like PlacementRef to denote a specific placement found within the current Session.
+ ** 
  ** Placements are templated on the type of the actual MObject they refer to, so, sometimes
  ** we rather use a Placement<Clip> to be able to use the more specific methods of the
  ** session::Clip interface. But <i>please note the following detail:</i> this type
@@ -58,8 +69,10 @@
 #define MOBJECT_PLACEMENT_H
 
 #include "pre.hpp"
+#include "lib/hash-indexed.hpp"
 #include "proc/mobject/session/locatingpin.hpp"
-#include "proc/asset/pipe.hpp"
+
+#include "proc/asset/pipe.hpp"   /////TODO: get rid of this (Trac #109)
 
 #include <tr1/memory>
 
@@ -68,25 +81,49 @@ namespace mobject {
   
   namespace session{ class MObjectFactory; }
   
+  class MObject;
   class ExplicitPlacement;
   
   using std::tr1::shared_ptr;
+  using lib::HashIndexed;
   
   
   
   /**
    * A refcounting Handle to an MObject of type MO,
-   * used to constrain or explicitly specify the
-   * location where the MObject is supposed to
-   * be within the Session/EDL
+   * used to constrain or explicitly specify the  location
+   * where the MObject is supposed to be within the Session/EDL.
+   * Placements are copyable (like values), but may be distinguished
+   * by their identity (reference semantics), which is based on an
+   * \link lib::HashIndexed hash-ID \endlink.
+   * 
+   * Placements are defined to form a hierarchy, thereby mirroring
+   * the relations between their referents to some degree. This allows
+   * for building APIs targeted at specific kinds of MObjects, and 
+   * at the same time allows a specific placement to stand-in when
+   * just a unspecific Placement<MObject> is required.  
+   * 
+   * @param MO the (compile time) type of the referent
+   * @param B  immediate base class of this placement
    */
-  template<class MO>
-  class Placement : protected shared_ptr<MO>
+  template<class MO, class B =MObject>
+  class Placement ;
+  
+  
+  /** 
+   * this specialisation forms the root of all placements
+   * and defines all of Placement's actual functionality.
+   */
+  template<>
+  class Placement<MObject,MObject>
+    : protected shared_ptr<MObject>,
+      public HashIndexed<Placement<MObject>, lib::hash::LuidH>     //////TODO: really need to be inherited publicly?
     {
     protected:
-      typedef shared_ptr<MO> Base;
+      typedef shared_ptr<MObject> _SmartPtr;
+      typedef void (*Deleter)(MObject*);
       typedef lumiera::Time Time;
-      typedef asset::shared_ptr<asset::Pipe> Pipe;
+      typedef asset::shared_ptr<asset::Pipe> Pipe;   ////TODO: get rid of this
       
       
       
@@ -95,15 +132,15 @@ namespace mobject {
        *  which is subject to placement.
        *  @note we don't provide operator*
        */
-      virtual MO * 
+      virtual MObject * 
       operator-> ()  const 
         { 
           ENSURE (*this); 
-          return Base::operator-> (); 
+          return _SmartPtr::operator-> (); 
         }      
       
       operator string()   const ;
-      size_t use_count()  const { return Base::use_count(); }
+      size_t use_count()  const { return _SmartPtr::use_count(); }
       
       virtual ~Placement() {};
       
@@ -123,44 +160,55 @@ namespace mobject {
       
       
     protected:
-      Placement (MO & subject, void (*moKiller)(MO*)) 
-        : shared_ptr<MO> (&subject, moKiller) {};
+      Placement (MObject & subject, Deleter killer) 
+        : _SmartPtr (&subject, killer) {};
         
       friend class session::MObjectFactory;
     };
   
   
-  
-  
-  
-  /* === defining specialisations to be subclasses === */
-
-#define DEFINE_SPECIALIZED_PLACEMENT(SUBCLASS, BASE)  \
-  template<>                                           \
-  class Placement<SUBCLASS> : public Placement<BASE>    \
-    {                                                    \
-    protected:                                            \
-      Placement (SUBCLASS & m, void (*moKiller)(MObject*)) \
-        : Placement<BASE>::Placement (m, moKiller)         \
-        { };                                               \
-      friend class session::MObjectFactory;                \
-                                                           \
-    public:                                                \
-      virtual SUBCLASS*                                    \
-      operator-> ()  const                                 \
-        {                                                  \
-          ENSURE (INSTANCEOF (SUBCLASS, this->get()));     \
-          return static_cast<SUBCLASS*>                    \
-            (shared_ptr<MObject>::operator-> ());          \
-        }                                                  \
+  /**
+   * any specific placements are supposed to be derived
+   * from Placement<MObject>, or an intermediary interface,
+   * in case the second template parameter is used.
+   * @note please refrain from adding additional functionality
+   *       to these subclasses. Especially, don't add any fields
+   *       to the subclass, as Placements are treated like values
+   *       at times, and thus slicing will happen, which in this
+   *       special case is acceptable.
+   */
+  template<class MO, class B>
+  class Placement
+    : public Placement<B>
+    {
+    protected:
+      typedef Placement<B> _Parent;
+      typedef typename _Parent::Deleter Deleter;
+      typedef typename _Parent::_SmartPtr _SmartPtr;
+      
+      
+      Placement (MO & mo, Deleter killer)
+        : _Parent (mo, killer)
+        { };
+      friend class session::MObjectFactory;
+      
+    public:
+      virtual MO*
+      operator-> ()  const
+        {
+          ENSURE (INSTANCEOF (MO, this->get()));
+          return static_cast<MO*>
+            (_SmartPtr::operator-> ());
+        }
     };
   
-  /* a note to the maintainer: please don't add any fields or methods to
-   * these subclasses which aren't also present in Placement<MObject>!
-   * Placements are frequently treated like values and thus slicing
-   * will happen, which in this special case is acceptable.
-   */
   
+  string
+  format_PlacementID (Placement<MObject> const&) ;
+  
+  
+  /** @todo cleanup uses of ref-to-placement. See Trac #115 */
+  typedef Placement<MObject> PMO; 
 
 
 } // namespace mobject
diff --git a/src/proc/mobject/session/clip.hpp b/src/proc/mobject/session/clip.hpp
index 362b6fe11..f0652c2e6 100644
--- a/src/proc/mobject/session/clip.hpp
+++ b/src/proc/mobject/session/clip.hpp
@@ -33,10 +33,9 @@ namespace asset
     class Clip;
   }
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+namespace session {
+    
     using asset::Media;
     typedef P<Media> PMedia;
     typedef P<asset::Clip> PClipAsset;
@@ -57,7 +56,7 @@ namespace mobject
     class Clip : public AbstractMO
       {
       protected:
-        /** startpos in source */
+        /** start position in source */
         Time start_;
 
         /** @todo using a mere ref here is against the scheme and only 
@@ -93,14 +92,8 @@ namespace mobject
       };
       
     typedef Placement<Clip> PClipMO;
-
-
-
-  } // namespace mobject::session
-  
-  /** Placement<Clip> defined to be subclass of Placement<MObject> */
-  DEFINE_SPECIALIZED_PLACEMENT (session::Clip, MObject);
     
-
-} // namespace mobject
+    
+    
+}} // namespace mobject::session
 #endif
diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp
index e4cdbee16..587cec927 100644
--- a/src/proc/mobject/session/effect.hpp
+++ b/src/proc/mobject/session/effect.hpp
@@ -32,26 +32,19 @@
 using std::string;
 
 
-namespace mobject
-  {
-  namespace session
+namespace mobject {
+namespace session {
+  
+  
+  class Effect : public AbstractMO
     {
-
-
-    class Effect : public AbstractMO
-      {
-      protected:
-        /** Identifier of the Plugin to be used */
-        string plugID;
-
-      };
-    
-    
-     
-  } // namespace mobject::session
-
-  /** Placement<Effect> defined to be subclass of Placement<MObject> */
-  DEFINE_SPECIALIZED_PLACEMENT (session::Effect, MObject);
-    
-} // namespace mobject
+    protected:
+      /** Identifier of the Plugin to be used */
+      string plugID;
+      
+    };
+  
+  
+  
+}} // namespace mobject::session
 #endif
diff --git a/src/proc/mobject/session/locatingpin.cpp b/src/proc/mobject/session/locatingpin.cpp
index 17bb34bbe..d1f4ba6dd 100644
--- a/src/proc/mobject/session/locatingpin.cpp
+++ b/src/proc/mobject/session/locatingpin.cpp
@@ -188,7 +188,7 @@ namespace mobject
     
     
     RelativeLocation& 
-    LocatingPin::operator() (PMO refObj, Time offset)
+    LocatingPin::operator() (PlacementRef& refObj, Time offset)
     {
       return static_cast<RelativeLocation&> 
                 (addChain (new RelativeLocation (refObj, offset)));
diff --git a/src/proc/mobject/session/locatingpin.hpp b/src/proc/mobject/session/locatingpin.hpp
index 799255589..c9e478f10 100644
--- a/src/proc/mobject/session/locatingpin.hpp
+++ b/src/proc/mobject/session/locatingpin.hpp
@@ -31,6 +31,11 @@
  ** RelativeLocation#resolve(LocatingSolution&) etc. If this is to be extended,
  ** we'll need a real spatial discrete constraint solver (and this probably will be
  ** some library implementation, because the problem is anything but trivial).
+ ** 
+ ** @todo this can be considered a preliminary sketch without being backed
+ **       by actual functionality. Just enough to be able to drive the design of
+ **       other parts ahead. See esp. Trac #100, which contains an idea for a
+ **       refactoring. 
  **
  */
 
@@ -53,21 +58,28 @@ using boost::scoped_ptr;
 
 namespace asset { class Pipe; }
 
-namespace mobject
-  {
+namespace mobject {
+  
   class MObject;
-  template<class MO> class Placement;
-  typedef Placement<MObject> PMO;
 
-  namespace session
-    {
+///////////////////////////////////////////TODO: all those dependencies are just a plain mess right now.  
+//  
+//template<class MO, class B=MObject> 
+//class Placement ;
+//typedef Placement<MObject> PMO;
+
+  class PlacementRef;    ///TODO: as of 5/09 the idea is to phase out direct dependency on the placement class and recast those dependencies in terms of PlacementRef
+
+
+  namespace session {
+    
     class FixedLocation;
     class RelativeLocation;
     
     
     
     /**
-     * Positioning specification, possibliy chained
+     * Positioning specification, possibly chained
      * to further specifications. The base class LocatingPin
      * is a "no-op" specification which doesn't constrain the
      * possible locations and thus can be embedded into pristine
@@ -84,7 +96,7 @@ namespace mobject
         typedef lumiera::Time Time;
         typedef Time* Track; //TODO dummy declaration; we don't use Tracks as first-class entity any longer
         typedef std::tr1::shared_ptr<asset::Pipe> Pipe;
-        typedef std::pair<Time,Pipe> SolutionData;  //TODO (ichthyo consideres better passing of solution by subclass)
+        typedef std::pair<Time,Pipe> SolutionData;  //TODO (ichthyo considers better passing of solution by subclass)
         struct LocatingSolution;
       
         /** next additional Pin, if any */
@@ -104,7 +116,7 @@ namespace mobject
         /* Factory functions for adding LocatingPins */
         
         FixedLocation&    operator() (Time start, Track track=0);
-        RelativeLocation& operator() (PMO refObj, Time offset=0);
+        RelativeLocation& operator() (PlacementRef& refObj, Time offset=0);
         
         LocatingPin (const LocatingPin&);
         LocatingPin& operator= (const LocatingPin&);
@@ -117,7 +129,7 @@ namespace mobject
 //TODO (for working out the buildable interface; ctor should be protected)
 protected:
   
-        friend class Placement<MObject>;
+//        friend class Placement<MObject>;
         
         /** 
          * @internal helper for the (preliminary)
@@ -125,7 +137,7 @@ protected:
          * @todo we can't sensibly reason about tracks, 
          * because at the moment (10/07) we lack a track implementation...
          * @todo shouldn't we use a range-restriction LocatingPin (subclass)
-         * to represent the to-be-found solution? (ichthyo: siehe Trac #100)
+         * to represent the to-be-found solution? (ichthyo: see Trac #100)
          */  
         struct LocatingSolution
           {
diff --git a/src/proc/mobject/session/meta.hpp b/src/proc/mobject/session/meta.hpp
index db679a904..f1a69b98d 100644
--- a/src/proc/mobject/session/meta.hpp
+++ b/src/proc/mobject/session/meta.hpp
@@ -28,29 +28,22 @@
 
 
 
-namespace mobject
-  {
-  namespace session
+namespace mobject {
+namespace session {
+
+
+  /**
+   * Meta-MObject doesn't represent real Media Content,
+   * but rather all sorts of Processing Instructions
+   * and other metadata, which can be placed and
+   * attached within the EDL/Session.
+   */
+  class Meta : public AbstractMO
     {
-
-
-    /**
-     * Meta-MObject doesn't represent real Media Content,
-     * but rather all sorts of Processing Instructions
-     * and other metadata, which can be placed and
-     * attached within the EDL/Session.
-     */
-    class Meta : public AbstractMO
-      {
-        ///////////
-      };
-
-
-
-  } // namespace mobject::session
+      ///////////
+    };
   
-  /** Placement<Meta> defined to be subclass of Placement<MObject> */
-  DEFINE_SPECIALIZED_PLACEMENT (session::Meta, MObject);
-
-} // namespace mobject
+  
+  
+}} // namespace mobject::session
 #endif
diff --git a/src/proc/mobject/session/relativelocation.hpp b/src/proc/mobject/session/relativelocation.hpp
index 33b857053..d5967b606 100644
--- a/src/proc/mobject/session/relativelocation.hpp
+++ b/src/proc/mobject/session/relativelocation.hpp
@@ -24,6 +24,7 @@
 #ifndef MOBJECT_SESSION_RELATIVELOCATION_H
 #define MOBJECT_SESSION_RELATIVELOCATION_H
 
+#include "proc/mobject/placement-ref.hpp"
 #include "proc/mobject/session/locatingpin.hpp"
 
 
@@ -35,10 +36,16 @@ namespace mobject
     {
 
 
-
+    /**
+     * @todo just a design sketch, nothing finished yet.
+     *       possibly to be reworked or phased out completely.
+     *       See Trac #100
+     */
     class RelativeLocation : public LocatingPin
       {
-        const PMO & anchor_;  ////////////TODO: ooooops, this is a nasty design problem!!!
+//        const PMO & anchor_;  ////////////TODO: ooooops, this is a nasty design problem!!!
+        
+        const PlacementRef anchor_;
         
       public:
 
@@ -51,7 +58,7 @@ namespace mobject
         };
 
       protected:
-        RelativeLocation (const PMO& a, Time ofs) : anchor_(a), offset_(ofs) { }
+        RelativeLocation (PlacementRef const& a, Time ofs) : anchor_(a), offset_(ofs) { }
         friend class LocatingPin;
 
         /** the kind of relation denoted by this Placement */
diff --git a/src/proc/mobject/session/track.hpp b/src/proc/mobject/session/track.hpp
index f8b2c0017..d58284dc6 100644
--- a/src/proc/mobject/session/track.hpp
+++ b/src/proc/mobject/session/track.hpp
@@ -30,10 +30,9 @@
 
 namespace asset { class Track; }
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+namespace session {
+    
     using lumiera::P;
     
     class Track;
@@ -41,26 +40,26 @@ namespace mobject
     
     typedef P<Track> PTrack;
     typedef P<TrackAsset> PTrackAsset;
-
-
+    
+    
     /**
      * A Track is grouping device within the EDL.
-     * The corresponding Placement by which this Track object is refered
+     * The corresponding Placement by which this Track object is referred
      * defines fallback placing properties to be used by all objects placed on this track
      * in case they don't specify more concrete placements.
      * Typically, tracks are used do make default processing pipe connections,
      * define a layer or pan for sound and for for disabling groups
      * of clips. Note tracks are grouped in a tree like fashion.
      * \par
-     * This Media Object (often refered to as "track-MO") is allways dealt with
+     * This Media Object (often referred to as "track-MO") is always dealt with
      * locally within one EDL. Client code normally doesn't have to care for creating
-     * or retrieving track-MO. Rather, it referes to the global track-asset-ID. The same
+     * or retrieving track-MO. Rather, it refers to the global track-asset-ID. The same
      * holds true when placing some other Media Object onto a track: the corresponding
      * placement just refers the global trackID, while the builder automatically retrieves
      * the matching track-MO for the EDL in question. If some EDL contains several instances
-     * (track-MO) refering to the same trackID (asset), then this causes all objects placed
+     * (track-MO) referring to the same trackID (asset), then this causes all objects placed
      * onto this track to be included several times in the resulting render nodes network
-     * (possibliy with varying placement properties) 
+     * (possibly with varying placement properties) 
      */
     class Track : public Meta
       {
@@ -70,7 +69,7 @@ namespace mobject
       protected:
         Track (PTrackAsset&);
         friend class MObjectFactory;
-
+        
       public:
         /** Child tracks in a tree structure */
         vector<Placement<Track> > subTracks;  ////TODO: it should really work with Placements! this here is just a decoy!!!!!!!
@@ -82,8 +81,8 @@ namespace mobject
       
   } // namespace mobject::session
   
-  /** Placement<Track> defined to be subclass of Placement<MObject> */
-  DEFINE_SPECIALIZED_PLACEMENT (session::Track, session::Meta);
-
+  /** Placement<Track> defined to be subclass of Placement<Meta> */
+  template class Placement<session::Track, session::Meta>;
+  
 } // namespace mobject
 #endif

From dedb70aac97c2087a8be129066e21d06e72f6c2a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 16 Oct 2008 20:31:02 +0200
Subject: [PATCH 032/368] @Joel: a simple convenience wrapper for gavl_time_t

---
 src/lib/lumitime.cpp                         |  7 ++-
 src/lib/lumitime.hpp                         | 54 +++++++++++++-------
 tests/components/proc/asset/makecliptest.cpp |  2 +-
 3 files changed, 39 insertions(+), 24 deletions(-)

diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index 9590b6c3a..d9e849a49 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -1,5 +1,5 @@
 /*
-  Time  -  unified representation of a time point, including conversion functions
+  Time  -  convenience wrapper for working with gavl_time in C++
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -28,10 +28,9 @@
 namespace lumiera
   {
 
-   // TODO: dummy values; should be adjusted when switching to the real time implementation provided by the backend
   
-   const Time Time::MAX = +std::numeric_limits<long>::max();
-   const Time Time::MIN = -std::numeric_limits<long>::max();
+   const Time Time::MAX = +std::numeric_limits<int64_t>::max();
+   const Time Time::MIN = -std::numeric_limits<int64_t>::max();
 
 
 } // namespace lumiera
diff --git a/src/lib/lumitime.hpp b/src/lib/lumitime.hpp
index 33b5bb4c3..5bc60c044 100644
--- a/src/lib/lumitime.hpp
+++ b/src/lib/lumitime.hpp
@@ -1,5 +1,5 @@
 /*
-  LUMITIME.hpp  -  unified representation of a time point, including conversion functions
+  LUMITIME.hpp  -  convenience wrapper for working with gavl_time in C++
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -26,35 +26,51 @@
 
 #include <boost/operators.hpp>
 
+extern "C" {
+#include <gavl/gavltime.h>
+}
 
-namespace lumiera
-  {
+namespace lumiera {
 
 
   /**
-   * denotes a temporal position (time point), based on timeline start.
+   * C++ convenience wrapper representing a time value, which could denote
+   * a temporal position (time point) relative to an (implicit) timeline zero
+   * point, or it could represent a time interval.
    * 
-   * @todo currently (9/07) this is a dummy implementation to find out
-   *       what interface the Proc layer needs. Cehteh has already written
-   *       elaborate timehandling functions in the backend and the goal
-   *       is for class Time to be just a thin wrapper!
+   * @note this is currently (10/08) an experimental implementation to ease
+   *       the time handling within C++ code. It is advisable not to use it
+   *       on external interfaces (use gavl_time_t there please).
    */
-  class Time : boost::totally_ordered<Time>
+  class Time 
+    : boost::additive<Time,
+      boost::multipliable<Time, int64_t,
+      boost::totally_ordered<Time> > >
     {
-      long dummy;
+      gavl_time_t t_;
+      
     public:
-      Time(long dum=0) : dummy(dum) {}
-      operator long () { return dummy; }
-      
-      bool operator<  (const Time& ot)  const { return dummy <  ot.dummy; }
-      bool operator== (const Time& ot)  const { return dummy == ot.dummy; }
-      
       static const Time MAX ; 
       static const Time MIN ;
+      
+      Time(gavl_time_t val=0) : t_(val) {}
+      operator gavl_time_t () { return t_; }
+      
+      
+      // Supporting additive
+      Time& operator+= (Time const& tx)  { t_ += tx.t_; return *this; }
+      Time& operator-= (Time const& tx)  { t_ -= tx.t_; return *this; }
+      
+      // Supporting multiplication with integral factor
+      Time& operator*= (int64_t fact)    { t_ *= fact;  return *this; }
+       
+      // Supporting totally_ordered
+      friend bool operator<  (Time const& t1, Time const& t2)  { return t1.t_ <  t2.t_; }
+      friend bool operator== (Time const& t1, Time const& t2)  { return t1.t_ == t2.t_; }
     };
-    
   
-
-   
+  
+  
+  
 } // namespace lumiera
 #endif
diff --git a/tests/components/proc/asset/makecliptest.cpp b/tests/components/proc/asset/makecliptest.cpp
index 0dc4365cc..0da91b126 100644
--- a/tests/components/proc/asset/makecliptest.cpp
+++ b/tests/components/proc/asset/makecliptest.cpp
@@ -61,7 +61,7 @@ namespace asset {
             PM cm = cc->getMedia();
             
             ASSERT (cm);
-            ASSERT (0 < cc->getLength());
+            ASSERT (Time(0) < cc->getLength());
             ASSERT (cm->ident.category.hasKind (VIDEO));
             ASSERT (cm->getFilename() == mm->getFilename());
 TODO ("implement Processing Pattern!!!");   

From 940d63a9fa999eefc9a0814099504f9fc6228bd3 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 16 Oct 2008 22:02:13 +0200
Subject: [PATCH 033/368] time wrapper minimal test coverage

---
 src/lib/lumitime.cpp                     |   7 +-
 src/lib/lumitime.hpp                     |  24 ++++-
 src/proc/mobject/session/clip.cpp        |   2 +-
 src/proc/mobject/session/locatingpin.hpp |   2 +-
 tests/40components.tests                 |   5 +
 tests/common/timewrappertest.cpp         | 129 +++++++++++++++++++++++
 6 files changed, 160 insertions(+), 9 deletions(-)
 create mode 100644 tests/common/timewrappertest.cpp

diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index d9e849a49..867477c5f 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -25,12 +25,11 @@
 #include <limits>
 
 
-namespace lumiera
-  {
+namespace lumiera {
 
   
-   const Time Time::MAX = +std::numeric_limits<int64_t>::max();
-   const Time Time::MIN = -std::numeric_limits<int64_t>::max();
+   const Time Time::MAX ( +std::numeric_limits<int64_t>::max() );
+   const Time Time::MIN ( -std::numeric_limits<int64_t>::max() );
 
 
 } // namespace lumiera
diff --git a/src/lib/lumitime.hpp b/src/lib/lumitime.hpp
index 5bc60c044..da0d58ee7 100644
--- a/src/lib/lumitime.hpp
+++ b/src/lib/lumitime.hpp
@@ -38,14 +38,28 @@ namespace lumiera {
    * a temporal position (time point) relative to an (implicit) timeline zero
    * point, or it could represent a time interval.
    * 
+   * This wrapper is deliberately kept rather limited as not to be completely
+   * interchangeable with and integral type. The rationale is that time values
+   * should be kept separate and tagged as time values. The following is supported:
+   * - conversions from / to gavl_time_t (which is effectively a int64_t)
+   * - additions and subtractions of time values
+   * - multiplication with an integral factor
+   * - comparisons between time values and gavl_time_t values
+   * 
+   * @todo consider the possible extensions
+   *       - parsing and pretty printing
+   *       - quantising of floating point values
+   *       - conversion to boost::rational
+   *       - define a Framerate type
+   * 
    * @note this is currently (10/08) an experimental implementation to ease
    *       the time handling within C++ code. It is advisable not to use it
    *       on external interfaces (use gavl_time_t there please).
    */
   class Time 
     : boost::additive<Time,
-      boost::multipliable<Time, int64_t,
-      boost::totally_ordered<Time> > >
+      boost::totally_ordered<Time,
+      boost::totally_ordered<Time, gavl_time_t> > >
     {
       gavl_time_t t_;
       
@@ -53,7 +67,8 @@ namespace lumiera {
       static const Time MAX ; 
       static const Time MIN ;
       
-      Time(gavl_time_t val=0) : t_(val) {}
+      explicit Time (gavl_time_t val=0) : t_(val) {}
+      
       operator gavl_time_t () { return t_; }
       
       
@@ -66,7 +81,10 @@ namespace lumiera {
        
       // Supporting totally_ordered
       friend bool operator<  (Time const& t1, Time const& t2)  { return t1.t_ <  t2.t_; }
+      friend bool operator<  (Time const& t1, gavl_time_t t2)  { return t1.t_ <  t2   ; }
+      friend bool operator>  (Time const& t1, gavl_time_t t2)  { return t1.t_ >  t2   ; }
       friend bool operator== (Time const& t1, Time const& t2)  { return t1.t_ == t2.t_; }
+      friend bool operator== (Time const& t1, gavl_time_t t2)  { return t1.t_ == t2   ; }
     };
   
   
diff --git a/src/proc/mobject/session/clip.cpp b/src/proc/mobject/session/clip.cpp
index ce0e87a9f..78655283f 100644
--- a/src/proc/mobject/session/clip.cpp
+++ b/src/proc/mobject/session/clip.cpp
@@ -51,7 +51,7 @@ namespace mobject
     Clip::isValid ()  const
     {
       TODO ("check consistency of clip length def, implies accessing the underlying media def");
-      return length > 0;
+      return length > Time(0);
     }
     
     
diff --git a/src/proc/mobject/session/locatingpin.hpp b/src/proc/mobject/session/locatingpin.hpp
index 799255589..27074e0cd 100644
--- a/src/proc/mobject/session/locatingpin.hpp
+++ b/src/proc/mobject/session/locatingpin.hpp
@@ -104,7 +104,7 @@ namespace mobject
         /* Factory functions for adding LocatingPins */
         
         FixedLocation&    operator() (Time start, Track track=0);
-        RelativeLocation& operator() (PMO refObj, Time offset=0);
+        RelativeLocation& operator() (PMO refObj, Time offset=Time(0));   //////////TODO: warning, just a dummy placeholder for now!!
         
         LocatingPin (const LocatingPin&);
         LocatingPin& operator= (const LocatingPin&);
diff --git a/tests/40components.tests b/tests/40components.tests
index 1ce98d957..221c5e3db 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -354,6 +354,11 @@ return: 0
 END
 
 
+TEST "Time Wrapper" TimeWrapper_test <<END
+return: 0
+END
+
+
 TEST "TestOption_test" TestOption_test <<END
 out: Testing invocation with cmdline: ...
 out: --> Testgroup=ALL
diff --git a/tests/common/timewrappertest.cpp b/tests/common/timewrappertest.cpp
new file mode 100644
index 000000000..0a96ab7aa
--- /dev/null
+++ b/tests/common/timewrappertest.cpp
@@ -0,0 +1,129 @@
+/*
+  TimeWrapper(Test)  -  working with gavl_time_t values in C++...
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "common/test/run.hpp"
+
+#include "common/util.hpp"
+#include <boost/lexical_cast.hpp>
+
+using boost::lexical_cast;
+using util::isnil;
+
+
+#include "common/lumitime.hpp"
+
+
+
+namespace lumiera {
+  namespace test {
+    
+    
+    /********************************************
+     * @test sanity of the C++ time wrapper.
+     */
+    class TimeWrapper_test : public Test
+      {
+        virtual void
+        run (Arg arg) 
+          {
+            int64_t refval= isnil(arg)?  1 : lexical_cast<int64_t> (arg[1]);
+            
+            Time ref (refval);
+            
+            checkBasics (ref);
+            checkComparisons (ref);
+          } 
+        
+        
+        void
+        checkBasics (Time const& ref)
+          {
+            Time zero;
+            Time one (1);
+            Time max (Time::MAX);
+            Time min (Time::MIN);
+            
+            Time val (ref);
+            
+            val += Time(2);
+            val *= 2;
+            ASSERT (zero == (val - 2*(ref + Time(2))) );
+            
+            val = ref;
+            ASSERT (zero == (val - ref));
+          }
+        
+        
+        void
+        checkComparisons (Time const& ref)
+          {
+            Time zero;
+            Time max (Time::MAX);
+            Time min (Time::MIN);
+            
+            ASSERT (zero == Time(0));
+            ASSERT (min < zero);
+            ASSERT (max > zero);
+            
+            Time val (ref);
+            ASSERT ( (val == ref) );
+            ASSERT (!(val != ref) );
+            ASSERT ( (val >= ref) );
+            ASSERT ( (val <= ref) );
+            ASSERT (!(val <  ref) );
+            ASSERT (!(val >  ref) );
+            
+            val += Time(2);
+            ASSERT (!(val == ref) );
+            ASSERT ( (val != ref) );
+            ASSERT ( (val >= ref) );
+            ASSERT (!(val <= ref) );
+            ASSERT (!(val <  ref) );
+            ASSERT ( (val >  ref) );
+            
+            gavl_time_t gat(val);
+            ASSERT (!(gat == ref) );
+            ASSERT ( (gat != ref) );
+            ASSERT ( (gat >= ref) );
+            ASSERT (!(gat <= ref) );
+            ASSERT (!(gat <  ref) );
+            ASSERT ( (gat >  ref) );
+            
+            ASSERT ( (val == gat) );
+            ASSERT (!(val != gat) );
+            ASSERT ( (val >= gat) );
+            ASSERT ( (val <= gat) );
+            ASSERT (!(val <  gat) );
+            ASSERT (!(val >  gat) );
+          }
+      };
+    
+    
+    /** Register this test class... */
+    LAUNCHER (TimeWrapper_test, "unit common");
+    
+    
+    
+  } // namespace test
+
+} // namespace lumiera

From 767638bc863cc2f6e91a83f791b6f313c891656f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Dec 2008 04:14:49 +0100
Subject: [PATCH 034/368] adapt TimeWrapperTest to the new lib directory layout
 (shared lib build)

---
 tests/{common => lib}/timewrappertest.cpp | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
 rename tests/{common => lib}/timewrappertest.cpp (97%)

diff --git a/tests/common/timewrappertest.cpp b/tests/lib/timewrappertest.cpp
similarity index 97%
rename from tests/common/timewrappertest.cpp
rename to tests/lib/timewrappertest.cpp
index 0a96ab7aa..c27ed6f9b 100644
--- a/tests/common/timewrappertest.cpp
+++ b/tests/lib/timewrappertest.cpp
@@ -21,16 +21,16 @@
 * *****************************************************/
 
 
-#include "common/test/run.hpp"
+#include "lib/test/run.hpp"
 
-#include "common/util.hpp"
+#include "lib/util.hpp"
 #include <boost/lexical_cast.hpp>
 
 using boost::lexical_cast;
 using util::isnil;
 
 
-#include "common/lumitime.hpp"
+#include "lib/lumitime.hpp"
 
 
 

From 02e464da12581c30425adc7880a3b300b557ff74 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 29 May 2009 21:16:12 +0200
Subject: [PATCH 035/368] small tweak to the task macro (estimate rather in
 days)

---
 wiki/renderengine.html | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 6cc4c2b52..aa5c658ad 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -4064,7 +4064,7 @@ h1,h2,h3,h4,h5,h6 {
 <div title="TabTimeline" modifier="Ichthyostega" modified="200806030148" created="200706191949" changecount="4">
 <pre>&lt;&lt;timeline better:true maxDays:55 maxEntries:45&gt;&gt;</pre>
 </div>
-<div title="TaskMacroPlugin" modifier="Ichthyostega" created="200712100248" tags="systemConfig excludeMissing" changecount="2">
+<div title="TaskMacroPlugin" modifier="Ichthyostega" modified="200905291912" created="200712100248" tags="systemConfig excludeMissing" changecount="3">
 <pre>/***
 |Name|TaskMacroPlugin|
 |Author|&lt;&lt;extension TaskMacroPlugin author&gt;&gt;|
@@ -4228,7 +4228,7 @@ function wrapEventHandler( otherHandler ) {
 !Task Macro
 Usage:
 &gt; {{{&lt;&lt;task orig cur spent&gt;&gt;description}}}
-All of orig, cur, and spent are optional numbers of hours.  The description goes through the end of the line, and is wikified.
+All of orig, cur, and spent are optional numbers of days.  The description goes through the end of the line, and is wikified.
 ***/
 //{{{
 config.macros.task = {
@@ -4248,15 +4248,15 @@ config.macros.task = {
 		descClickTip:	&quot; -- Double-click to edit task description&quot;,
 		statusClickTip:	&quot; -- Double-click to mark task complete&quot;,
 		statusDoneTip:	&quot; -- Double-click to adjust the time spent, to revive the task&quot;,
-		origTip:	&quot;Original estimate in hours&quot;,
-		curTip:		&quot;Current estimate in hours&quot;,
-		curTip2:	&quot;Estimate in hours&quot;, // For when orig == cur
+		origTip:	&quot;Original estimate in days&quot;,
+		curTip:		&quot;Current estimate in days&quot;,
+		curTip2:	&quot;Estimate in days&quot;, // For when orig == cur
 		clickTip:	&quot; -- Click to adjust&quot;,
-		spentTip:	&quot;Hours spent on this task&quot;,
-		remTip:		&quot;Hours remaining&quot;,
-		curPrompt:	&quot;Estimate this task in hours, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.&quot;,
-		spentPrompt:	&quot;Enter the number of hours you've spent on this task, or adjust the current number by starting with + or -.\n\nYou may optionally also set or adjust the time remaining by putting a second number after the first.&quot;,
-		remPrompt:	&quot;Enter the number of hours it will take to finish this task, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.&quot;,
+		spentTip:	&quot;Days spent on this task&quot;,
+		remTip:		&quot;Days remaining&quot;,
+		curPrompt:	&quot;Estimate this task in days, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.&quot;,
+		spentPrompt:	&quot;Enter the number of days you've spent on this task, or adjust the current number by starting with + or -.\n\nYou may optionally also set or adjust the time remaining by putting a second number after the first.&quot;,
+		remPrompt:	&quot;Enter the number of days it will take to finish this task, or adjust the current estimate by starting with + or -.\n\nYou may optionally also set or adjust the time spent by putting a second number after the first.&quot;,
 		numbersOnly:	&quot;Enter numbers only, please&quot;,
 		notCurrent:	&quot;The tiddler has been modified since it was displayed, please redisplay it before doing this.&quot;
 	},
@@ -4535,15 +4535,15 @@ config.macros.tasksum = {
 		mustMatch:	&quot;&lt;&lt;%0 end&gt;&gt; must match a preceding &lt;&lt;%0 start&gt;&gt;&quot;,
 		defIntro:	&quot;Task summary:&quot;,
 		nascentSum:	&quot;''%0 not estimated''&quot;,
-		doneSum:	&quot;%0 complete (in %1 hours)&quot;,
-		liveSum:	&quot;%0 ongoing (%1 hours so far, ''%2 hours remaining'')&quot;,
+		doneSum:	&quot;%0 complete (in %1 days)&quot;,
+		liveSum:	&quot;%0 ongoing (%1 days so far, ''%2 days remaining'')&quot;,
 		overSum:	&quot;Total overestimate: %0%.&quot;,
 		underSum:	&quot;Total underestimate: %0%.&quot;,
 		descPattern:	&quot;%0 %1. %2&quot;,
-                origTip:	&quot;Total original estimates in hours&quot;,
-		curTip:		&quot;Total current estimates in hours&quot;,
-		spentTip:	&quot;Total hours spent on tasks&quot;,
-		remTip:		&quot;Total hours remaining&quot;
+                origTip:	&quot;Total original estimates in days&quot;,
+		curTip:		&quot;Total current estimates in days&quot;,
+		spentTip:	&quot;Total days spent on tasks&quot;,
+		remTip:		&quot;Total days remaining&quot;
 	},
 
 	// The macro handler
@@ -4685,7 +4685,7 @@ config.macros.taskadder = {
 	lingo: {
 		unrecParam:	&quot;&lt;&lt;%0&gt;&gt; doesn't recognize '%1' as a parameter&quot;,
 		descTip:	&quot;Describe a new task&quot;,
-		curTip:		&quot;Estimate how long in hours the task will take&quot;,
+		curTip:		&quot;Estimate how much days the task will take&quot;,
 		buttonText:	&quot;add task&quot;,
 		buttonTip:	&quot;Add a new task with the description and estimate as entered&quot;,
 		notCurrent:	&quot;The tiddler has been modified since it was displayed, please redisplay it before adding a task this way.&quot;,

From 50a42e510435ce1b74c8f1bbe8cce3ee850e05ed Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 29 May 2009 22:12:12 +0200
Subject: [PATCH 036/368] extract dummy MObject hierarchy for unit tests

---
 src/proc/mobject/session/abstractmo.hpp       |  54 ++++-----
 .../proc/mobject/builder/buildertooltest.cpp  |  61 ++--------
 .../proc/mobject/test-dummy-mobject.hpp       | 107 ++++++++++++++++++
 3 files changed, 140 insertions(+), 82 deletions(-)
 create mode 100644 tests/components/proc/mobject/test-dummy-mobject.hpp

diff --git a/src/proc/mobject/session/abstractmo.hpp b/src/proc/mobject/session/abstractmo.hpp
index 5de61737f..bb18823f3 100644
--- a/src/proc/mobject/session/abstractmo.hpp
+++ b/src/proc/mobject/session/abstractmo.hpp
@@ -28,34 +28,30 @@
 
 
 
-namespace mobject
-  {
-  namespace session
+namespace mobject {
+namespace session {
+  
+  
+  /**
+   *  abstract base class of all MObjects for providing common services.
+   *  @todo seems that we don't need this intermediate class...
+   */
+  class AbstractMO : public MObject
     {
-
-
-    /**
-     *  abstract base class of all MObjects for providing common services.
-     *  @todo seems that we don't need this intermediate class...
-     */
-    class AbstractMO : public MObject
-      {
-        
-      public:
-        
-        /* some dummy implementations used to make the code compile... */
-        
-        virtual Time& getLength() { return length; }
-        
-        DEFINE_PROCESSABLE_BY (builder::BuilderTool);
-
-        virtual bool operator== (const MObject& oo)  const;
-
-     };
-
-
-
-  } // namespace mobject::session
-
-} // namespace mobject
+      
+    public:
+      
+      /* some dummy implementations used to make the code compile... */
+      
+      virtual Time& getLength() { return length; }
+      
+      DEFINE_PROCESSABLE_BY (builder::BuilderTool);
+      
+      virtual bool operator== (const MObject& oo)  const;
+      
+    };
+  
+  
+  
+}} // namespace mobject::session
 #endif
diff --git a/tests/components/proc/mobject/builder/buildertooltest.cpp b/tests/components/proc/mobject/builder/buildertooltest.cpp
index 102c81bea..70fc613d2 100644
--- a/tests/components/proc/mobject/builder/buildertooltest.cpp
+++ b/tests/components/proc/mobject/builder/buildertooltest.cpp
@@ -28,6 +28,7 @@
 #include "proc/asset/category.hpp"
 #include "proc/asset/media.hpp"
 #include "proc/mobject/session/clip.hpp"
+#include "proc/mobject/test-dummy-mobject.hpp"
 #include "lib/util.hpp"
 
 #include <iostream>
@@ -39,62 +40,20 @@ using std::cout;
 
 
 namespace mobject {
-  namespace builder {
-    namespace test {
+namespace builder {
+namespace test    {
       
       using session::Clip;
       using session::AbstractMO;
+      using namespace mobject::test;
       
       
       
-      /** 
-       *  Test MObject subclass, which, contrary to any real MObject,
-       *  can be created directly without involving MObjectFactory.
-       */
-      class TestMO : public AbstractMO
-        {
-        public:
-          TestMO() { };
-          
-          DEFINE_PROCESSABLE_BY (BuilderTool);
-          
-          virtual bool isValid()  const        { return true;}
-          static void killDummy (MObject* dum) { delete (TestMO*)dum; }
-        };
-      
-      /** 
-       * Subclass-1 is \em not defined "processible",
-       * thus will always be handled as TestMO...
-       */
-      class TestSubMO1 : public TestMO 
-        { };
-      
-      /** 
-       * Subclass-2 \em is defined "processible", 
-       * but we omit the necessary "applicable" definition in TestTool,
-       * resulting in an invocation of the error (catch-all) function...
-       */
-      class TestSubMO2 : public TestMO 
-        { 
-          DEFINE_PROCESSABLE_BY (BuilderTool);
-        };
-      
-      
-      template<class MO>
-      class TestPlacement : public Placement<MO>
-        {
-        public:
-          TestPlacement(TestMO& testObject) 
-            : Placement<MO>::Placement(testObject, &TestMO::killDummy)
-            { }
-        };
-      
-      
       /**
        * BuilderTool implementation for checking the invocation of the correct
        * \c treat() function and for accessing the original Placement from 
        * within this invocation. It is declared to be applicable to Clip
-       * and TestMO objects (wrapped into any acceptable shared-ptr).
+       * and DummyMO objects (wrapped into any acceptable shared-ptr).
        * Intentionally, we omit to declare it applicable to TestSubMO2 instances.
        * In reality this would be a case of misconfiguration, because TestSubMO2
        * is defined to be processable and consequently has an \apply() function,
@@ -102,7 +61,7 @@ namespace mobject {
        * so it will call the \c onUnknown(Buildable&) instead
        */
       class TestTool 
-        : public Applicable<TestTool, Types<Clip, TestMO>::List>
+        : public Applicable<TestTool, Types<Clip, DummyMO>::List>
         {
         public:
           string log_;
@@ -157,7 +116,7 @@ namespace mobject {
               TestPlacement<MObject> test1(*new TestSubMO1);
               TestPlacement<MObject> test2(*new TestSubMO2);
               
-
+              
               cout << "apply (tool, clip);\n";
               apply (tool, clip);
               INFO (test, "got Wrapper = %s", t1.log_.c_str());
@@ -181,8 +140,4 @@ namespace mobject {
       
       
       
-    } // namespace test
-    
-  } // namespace builder
-  
-} // namespace mobject
+}}} // namespace mobject::builder::test
diff --git a/tests/components/proc/mobject/test-dummy-mobject.hpp b/tests/components/proc/mobject/test-dummy-mobject.hpp
new file mode 100644
index 000000000..e77eb761a
--- /dev/null
+++ b/tests/components/proc/mobject/test-dummy-mobject.hpp
@@ -0,0 +1,107 @@
+/*
+  TEST-DUMMY-MOBJECT.hpp  -  dummy MObject hierarchy for unit tests
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file test-dummy-mobject.hpp
+ ** A hierarchy of simple dummy-Media-Objects for easy unit testing. 
+ ** Normally, the creation of MObjects and corresponding Placements is defined to be
+ ** very restricted. Any MObjects are supposed to be created by the MObjectFactory,
+ ** which provided very specialised factory functions. When writing unit tests to
+ ** check the basic MObject properties and behaviour, this can be an obstacle. 
+ ** Thus we create a separate branch in the MObject hierarchy with relaxed
+ ** requirements and some dummy/test API functions.
+ **
+ ** @see mobject::session::BuilderTool_test
+ ** @see mobject::session::PlacementHierarchy_test
+ ** 
+ */
+
+
+#ifndef MOBJECT_TEST_DUMMY_MOBJECT_H
+#define MOBJECT_TEST_DUMMY_MOBJECT_H
+
+#include "lib/test/run.hpp"
+
+#include "proc/mobject/builder/buildertool.hpp"
+#include "proc/mobject/session/abstractmo.hpp"
+#include "proc/mobject/placement.hpp"
+#include "lib/util.hpp"
+
+#include <iostream>
+
+using util::cStr;
+using std::string;
+using std::cout;
+
+
+
+namespace mobject {
+namespace test    {
+  
+  using builder::BuilderTool;
+  
+  
+  /** 
+   *  Test MObject subclass, which, contrary to any real MObject,
+   *  can be created directly without involving MObjectFactory.
+   */
+  class DummyMO : public session::AbstractMO
+    {
+    public:
+      DummyMO() { };
+      
+      DEFINE_PROCESSABLE_BY (BuilderTool);
+      
+      virtual bool isValid()  const        { return true;}
+      static void killDummy (MObject* dum) { delete (DummyMO*)dum; }
+    };
+  
+  /** 
+   * Subclass-1 is \em not defined "processible",
+   * thus will always be handled as DummyMO...
+   */
+  class TestSubMO1 : public DummyMO 
+    { };
+  
+  /** 
+   * Subclass-2 \em is defined "processible", 
+   * but we omit the necessary "applicable" definition in TestTool,
+   * resulting in an invocation of the error (catch-all) function...
+   */
+  class TestSubMO2 : public DummyMO 
+    { 
+      DEFINE_PROCESSABLE_BY (BuilderTool);
+    };
+  
+  
+  template<class MO>
+  class TestPlacement : public Placement<MO>
+    {
+    public:
+      TestPlacement(DummyMO& testObject) 
+        : Placement<MO>::Placement(testObject, &DummyMO::killDummy)
+        { }
+    };
+  
+  
+  
+}} // namespace mobject::test
+#endif

From 20a12686839fa7b0afbd47b4b770c1439fcd3b14 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 29 May 2009 23:13:56 +0200
Subject: [PATCH 037/368] recast the PlacementHierarchy_test to use the real
 Placement/MObject hierarchy

---
 src/proc/mobject/builder/buildertool.hpp      |   4 +-
 .../proc/mobject/builder/buildertooltest.cpp  |   4 +-
 .../proc/mobject/placement-hierarchy-test.cpp | 142 ++----------------
 .../proc/mobject/test-dummy-mobject.hpp       |  69 +++++++--
 wiki/renderengine.html                        |  15 +-
 5 files changed, 87 insertions(+), 147 deletions(-)

diff --git a/src/proc/mobject/builder/buildertool.hpp b/src/proc/mobject/builder/buildertool.hpp
index 1ad28d0d8..e0b90979e 100644
--- a/src/proc/mobject/builder/buildertool.hpp
+++ b/src/proc/mobject/builder/buildertool.hpp
@@ -116,8 +116,8 @@ namespace mobject {
           {
             currentWrapper_ = ptr_toWrappedTarget;
           }
-        template<class TAR>
-        void rememberWrapper (Placement<TAR>* ptr_toWrappedTarget)
+        template<template<class,class> class Placement, class TAR, class B>
+        void rememberWrapper (Placement<TAR,B>* ptr_toWrappedTarget)
           {
             currentWrapper_ = ptr_toWrappedTarget;
           }
diff --git a/tests/components/proc/mobject/builder/buildertooltest.cpp b/tests/components/proc/mobject/builder/buildertooltest.cpp
index 70fc613d2..4c419a971 100644
--- a/tests/components/proc/mobject/builder/buildertooltest.cpp
+++ b/tests/components/proc/mobject/builder/buildertooltest.cpp
@@ -113,8 +113,8 @@ namespace test    {
               BuilderTool& tool = t1;
                                 
               Placement<Clip> clip = asset::Media::create("test-1", asset::VIDEO)->createClip();
-              TestPlacement<MObject> test1(*new TestSubMO1);
-              TestPlacement<MObject> test2(*new TestSubMO2);
+              TestPlacement<> test1(*new TestSubMO1);
+              TestPlacement<> test2(*new TestSubMO2);
               
               
               cout << "apply (tool, clip);\n";
diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index 07cb6d54c..1064a3f79 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -29,6 +29,7 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-ref.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
+#include "proc/mobject/test-dummy-mobject.hpp"
 #include "lib/hash-indexed.hpp"
 #include "lib/util.hpp"
 
@@ -52,128 +53,7 @@ namespace mobject {
 namespace session {
 namespace test    {
   
-  
-  /**
-   * a dummy version of the MObject hierarchy,
-   * used to experiment with the Placement template structure
-   */
-  struct MOj;
-
-  template<class TY, class B =MOj>
-  class Pla;
-  
-  template<>
-  class Pla<MOj,MOj>
-    : protected shared_ptr<MOj>,
-      public HashIndexed<Pla<MOj>, lib::hash::LuidH>     //////TODO: really need to be inherited publicly?
-    {
-    protected:
-      typedef shared_ptr<MOj> Base;
-      typedef void (*Deleter)(MOj*);
-      
-      Pla (MOj & subject, Deleter killer) 
-        : Base (&subject, killer) {};
-        
-      friend class MOjFac;
-      
-    public:
-      virtual MOj * 
-      operator-> ()  const 
-        { 
-          ENSURE (*this); 
-          return Base::operator-> (); 
-        }      
-      
-      size_t use_count()  const { return Base::use_count(); }
-      
-      virtual ~Pla() {};
-      
-    };
-  
-  template<class TY, class B>
-  class Pla
-    : public Pla<B>
-    {
-    protected:
-      typedef Pla<B> _Par;
-      typedef typename _Par::Base Base;
-      typedef typename _Par::Deleter Deleter;
-      
-      Pla (TY & mo, Deleter killer)
-        : _Par (mo, killer)
-        { };
-        
-      friend class MOjFac;
-      
-    public:
-      virtual TY*
-      operator-> ()  const
-        {
-          ENSURE (INSTANCEOF (TY, this->get()));
-          return static_cast<TY*>
-            (Base::operator-> ());
-        }
-    };
-  
-  
-  string
-  format_PlacementID (Pla<MOj> const& pla)
-  {
-    static format fmt ("pID(%x)");
-    
-    size_t hashVal = pla.getID();
-    return str(fmt % hashVal);
-  }
-    
-  class MOjFac;
-    
-  struct MOj 
-    {
-      static MOjFac create;
-      
-      int id_;
-      
-      MOj() : id_(rand() % 1000) {}
-      virtual ~MOj() {}
-      
-      void show() { cout << "ID=" << id_ << "\n"; }
-    };
-  struct Sub1 : MOj { };
-  struct Sub2 : MOj 
-    {
-      void specialAPI() { cout << "specialAPI()\n";}
-    };
-  struct Sub3 : Sub2
-    { 
-      
-    };
-  
-  
-  
-  class MOjFac
-    {
-      static void deleterFunc (MOj* o) { delete o; }
-      
-    public:
-      
-      template<class MO>
-      Pla<MO>
-      special ()
-        {
-          return Pla<MO> (*new MO, &deleterFunc);
-        }
-      
-      typedef Pla<Sub3,Sub2> Pla3;
-      
-      Pla3
-      specialSub3 ()
-        {
-          return Pla3 (*new Sub3, &deleterFunc);
-        }
-    };
-  
-  MOjFac MOj::create;
-  
+  using namespace mobject::test;
   
   
   /*******************************************************************************
@@ -190,11 +70,11 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          Pla<Sub1> pSub1    = MOj::create.special<Sub1>();
-          Pla<Sub2> pSub2    = MOj::create.special<Sub2>();
-          Pla<Sub2> pSub3    = MOj::create.specialSub3();
+          TestPlacement<TestSubMO1>  pSub1(*new TestSubMO1);
+          TestPlacement<TestSubMO2>  pSub2(*new TestSubMO2);
+          TestPlacement<TestSubMO21> pSub3(*new TestSubMO21);
           
-          Pla<MOj>  pSubM (pSub3);
+          TestPlacement<DummyMO>     pSubM (pSub3);
           
           /////////////////////////////////TODO
           format fmt ("sizeof( %s ) = %d\n");
@@ -202,10 +82,12 @@ namespace test    {
           cout << fmt % "Pla<Sub2>"   % sizeof(pSub2);
           cout << fmt % "Pla<Sub3>"   % sizeof(pSub3);
           
-          pSub1->show();
-          pSub2->show();
-          pSub3->show();
-          pSubM->show();
+          cout << string(pSub1) << "\n";
+          cout << string(pSub2) << "\n";
+          cout << string(pSubM) << "\n";
+          cout << pSub1->operator string() << "\n";
+          cout << pSub2->operator string() << "\n";
+          cout << pSubM->operator string() << "\n";
           pSub3->specialAPI();
           
           cout << format_PlacementID(pSub1) << "\n";
diff --git a/tests/components/proc/mobject/test-dummy-mobject.hpp b/tests/components/proc/mobject/test-dummy-mobject.hpp
index e77eb761a..8d3e2cd1e 100644
--- a/tests/components/proc/mobject/test-dummy-mobject.hpp
+++ b/tests/components/proc/mobject/test-dummy-mobject.hpp
@@ -43,12 +43,17 @@
 #include "proc/mobject/builder/buildertool.hpp"
 #include "proc/mobject/session/abstractmo.hpp"
 #include "proc/mobject/placement.hpp"
+#include "include/symbol.hpp"
 #include "lib/util.hpp"
 
+#include <boost/format.hpp>
 #include <iostream>
+#include <cstdlib>
 
+using boost::format;
 using util::cStr;
 using std::string;
+using std::rand;
 using std::cout;
 
 
@@ -56,6 +61,7 @@ using std::cout;
 namespace mobject {
 namespace test    {
   
+  using lumiera::Symbol;
   using builder::BuilderTool;
   
   
@@ -65,42 +71,87 @@ namespace test    {
    */
   class DummyMO : public session::AbstractMO
     {
+      int id_;
+      
     public:
-      DummyMO() { };
+      DummyMO() : id_(rand() % 1000) {}
+      DummyMO(int i) : id_(i) {}
       
       DEFINE_PROCESSABLE_BY (BuilderTool);
       
-      virtual bool isValid()  const        { return true;}
+      virtual bool isValid()    const      { return true;}
+      virtual operator string() const      { return display("DummyMO"); }
       static void killDummy (MObject* dum) { delete (DummyMO*)dum; }
+      
+    protected:
+      string
+      display(Symbol name)  const
+        {
+          static format fmt("%s(ID=%4d)");
+          return boost::str(fmt % name % this->id_);
+        }
     };
   
   /** 
    * Subclass-1 is \em not defined "processible",
    * thus will always be handled as DummyMO...
    */
-  class TestSubMO1 : public DummyMO 
-    { };
+  struct TestSubMO1 : DummyMO 
+    {
+      virtual operator string() const      { return display("TestSubMO1"); }
+    };
   
   /** 
    * Subclass-2 \em is defined "processible", 
    * but we omit the necessary "applicable" definition in TestTool,
    * resulting in an invocation of the error (catch-all) function...
    */
-  class TestSubMO2 : public DummyMO 
+  struct TestSubMO2 : DummyMO 
     { 
       DEFINE_PROCESSABLE_BY (BuilderTool);
+
+      virtual operator string() const      { return display("TestSubMO2"); }
     };
   
+  struct TestSubMO21 : TestSubMO2 
+    {
+      virtual operator string() const      { return display("TestSubMO21"); }
+      void specialAPI()                    { cout << "specialAPI()\n";}
+    };
+
   
-  template<class MO>
-  class TestPlacement : public Placement<MO>
+  
+  template<class DMO=DummyMO, class B=DummyMO>
+  class TestPlacement ;
+  
+  template<>
+  class TestPlacement<> : public Placement<DummyMO>
     {
     public:
-      TestPlacement(DummyMO& testObject) 
-        : Placement<MO>::Placement(testObject, &DummyMO::killDummy)
+      TestPlacement(DummyMO& dummyObj) 
+        : Placement<DummyMO>::Placement(dummyObj, &DummyMO::killDummy)
         { }
     };
   
+  template<class DMO, class B>
+  class TestPlacement : public TestPlacement<B>
+    {
+    public:
+      TestPlacement(DMO& dummyObj) 
+        : TestPlacement<B>(dummyObj)
+        { }
+      
+      virtual DMO*
+      operator-> ()  const
+        {
+          ENSURE (INSTANCEOF (DMO, this->get()));
+          return static_cast<DMO*>
+            (Placement<MObject>::_SmartPtr::operator-> ());
+        }
+    };
+  
+  template class TestPlacement<TestSubMO21,TestSubMO2>;
+  
   
   
 }} // namespace mobject::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index aa5c658ad..9a6c5e54b 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -2969,7 +2969,7 @@ We need a way of addressing existing [[pipes|Pipe]]. Besides, as the Pipes and T
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
-<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200904252308" created="200904252258" tags="impl SessionLogic draft" changecount="2">
+<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200905291920" created="200904252258" tags="impl SessionLogic draft" changecount="16">
 <pre>//This page is a scrapbook for working out the implementation of the [[Session Datastructure in Memory|SessionDataMem]]//
 This is a difficult untertaking, because there are several dependencies (most of which aren't fully designed yet as of 5/09)
 * the GUI uses an adapted version of the HighLevelModel; these datastructures are intended to be backed by the Session
@@ -2980,7 +2980,7 @@ This is a difficult untertaking, because there are several dependencies (most of
 !!!requirements
 * can discover and ennumerate the structure
 * can ennumerate the contents (objects) of a specific scope
-* provide [[references|MObjectRef]] on these query/discovery operations
+* provide [[references|MObjectRef]] as result of these query/discovery operations
 
 !!!invariants
 * memory management consistency
@@ -2994,9 +2994,15 @@ This is a difficult untertaking, because there are several dependencies (most of
 
 !Interface
 &lt;&lt;task&gt;&gt;evaluate models for the [[reference problem|MObjectRef]]
+&lt;&lt;task 2 3 3&gt;&gt; implement an hash-ID to be incorporated into placements
+&lt;&lt;task 1 1 0&gt;&gt; implement PlacementRef
+&lt;&lt;task 2 2 0&gt;&gt; implement MObjectRef
 
 !Datastructure
 &lt;&lt;task&gt;&gt;investigate the best granularity for object collections
+&lt;&lt;task &gt;&gt; define a record to be used within the index
+&lt;&lt;task &gt;&gt; implement basic index operations
+&lt;&lt;task 1&gt;&gt; implement adding a placement relation
 
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
@@ -3090,7 +3096,7 @@ Besides, they provide an important __inward interface__ for the [[ProcNode]]s, w
 
 </pre>
 </div>
-<div title="ProcLayer and Engine" modifier="Ichthyostega" modified="200812050522" created="200706190056" tags="overview" changecount="15">
+<div title="ProcLayer and Engine" modifier="Ichthyostega" modified="200905291850" created="200706190056" tags="overview" changecount="18">
 <pre>The Render Engine is the part of the application doing the actual video calculations. Its operations are guided by the Objects and Parameters edited by the user in [[the EDL|EDL]] and it retrieves the raw audio and video data from the [[Data backend|backend.html]]. Because the inner workings of the Render Engine are closely related to the structures used in the EDL, this design covers [[the aspect of objects placed into the EDL|MObjects]] as well.
 &lt;&lt;&lt;
 ''Status'': started out as design draft in summer '07, Ichthyo is now in the middle of a implementing the foundations and main structures in C++
@@ -3099,12 +3105,13 @@ Besides, they provide an important __inward interface__ for the [[ProcNode]]s, w
 * made a first draft of how to wire and operate procesing nodes (&amp;rarr;[[more|RenderMechanics]])
 * working out the relation of [[Project, Timelines and Sequences|TimelineSequences]]
 * first attempts to [[integrate with the GUI|GuiIntegration]]
+* first outline of the [[session implementation|PlanningSessionInMem]]
 &lt;&lt;&lt;
 
 !Summary
 We have several kinds of &quot;things&quot; organized as [[assets|Asset]] in the AssetManager, like media, clips, effects, codecs, configuration templates. Within the context of the [[EDL]], we can use these as [[&quot;Media Objects&quot;|MObjects]] &amp;mdash; especially, we can [[place|Placement]] them in various kinds within the EDL and relative to one another. Basically, this is the [[editing work|EditingOperations]] done by the user.
 
-Now, from any given configuration within the EDL, we create sort or a frozen- and tied-down snapshot, here called [[&quot;Fixture&quot;|Fixture]], containing all currently active ~MObjects, broken down to elementary parts and made explicit if necessary. This Fixture acts as a isolation layer towards the Render Engine. We will hand it over to the  [[Builder]], which in turn will transform it into a network of connected [[render nodes|ProcNode]]. This network //is// the [[Render Engine|OverviewRenderEngine]].
+Now, from any given configuration within the EDL, we create sort or a frozen- and tied-down snapshot, here called [[&quot;Fixture&quot;|Fixture]], containing all currently active ~MObjects, broken down to elementary parts and made explicit if necessary. This Fixture acts as a isolation layer towards the Render Engine. We will hand it over to the  [[Builder]], which in turn will transform it into a network of connected [[render nodes|ProcNode]]. This network //implements//&amp;nbsp; the [[Render Engine|OverviewRenderEngine]].
 
 The system is ''open'' inasmuch every part mirrors the structure of corresponding parts in adjacent subsystems, and the transformation of any given structure from one subsystem (e.g. Asset) to another (e.g. Render Engine) is done with minimal &quot;magic&quot;. So the whole system should be able to handle completely new structures mostly by adding new configurations and components, without much need of rewriting basic workings.
 

From e0ad992f308d49d4f7e6713dfdeb7f3872f9e60e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 30 May 2009 23:49:02 +0200
Subject: [PATCH 038/368] spinn-off: collecting some frequently used bits to
 support unit testing

---
 .gitignore                          |   1 +
 src/lib/Makefile.am                 |   2 +
 src/lib/test/test-helper.cpp        |  46 +++++++++++++
 src/lib/test/test-helper.hpp        | 101 ++++++++++++++++++++++++++++
 tests/40components.tests            |   6 ++
 tests/lib/Makefile.am               |   1 +
 tests/lib/test/test-helper-test.cpp |  97 ++++++++++++++++++++++++++
 7 files changed, 254 insertions(+)
 create mode 100644 src/lib/test/test-helper.cpp
 create mode 100644 src/lib/test/test-helper.hpp
 create mode 100644 tests/lib/test/test-helper-test.cpp

diff --git a/.gitignore b/.gitignore
index cf7ebb45d..c89dffc5e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -16,6 +16,7 @@ scripts/*
 configure
 config.log
 aclocal.m4
+autom4te.cache
 semantic.cache
 wiki/backups/*
 doc/devel/draw/*.png
diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index cb1451c4f..8e5b1b8ae 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -43,6 +43,7 @@ liblumiera_la_SOURCES =						\
 	$(liblumiera_la_srcdir)/query.cpp			\
 	$(liblumiera_la_srcdir)/streamtype.cpp			\
 	$(liblumiera_la_srcdir)/test/testoption.cpp 		\
+	$(liblumiera_la_srcdir)/test/test-helper.cpp 		\
 	$(liblumiera_la_srcdir)/test/suite.cpp 			\
 	$(liblumiera_la_srcdir)/cmdline.cpp			\
 	$(liblumiera_la_srcdir)/logging.cpp
@@ -92,5 +93,6 @@ noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/test/mockinjector.hpp		\
 	$(liblumiera_la_srcdir)/test/suite.hpp			\
 	$(liblumiera_la_srcdir)/test/testoption.hpp		\
+	$(liblumiera_la_srcdir)/test/test-helper.hpp		\
 	$(liblumiera_la_srcdir)/test/run.hpp
 
diff --git a/src/lib/test/test-helper.cpp b/src/lib/test/test-helper.cpp
new file mode 100644
index 000000000..3e584bda0
--- /dev/null
+++ b/src/lib/test/test-helper.cpp
@@ -0,0 +1,46 @@
+/*
+  Test-Helper  -  collection of functions supporting unit testing
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/test-helper.hpp"
+
+//#include "lib/error.hpp"
+#include <boost/format.hpp>
+#include <typeinfo>
+
+using boost::format;
+using boost::str;
+
+namespace lib {
+namespace test{
+  
+  
+  string
+  showSizeof (size_t siz, Symbol name)
+  {
+    static format fmt ("sizeof( %s ) %|30t|= %3d");
+    return str (fmt % (name? name:"?") % siz);
+  }
+  
+  
+  
+}} // namespace lib::test
diff --git a/src/lib/test/test-helper.hpp b/src/lib/test/test-helper.hpp
new file mode 100644
index 000000000..23c252148
--- /dev/null
+++ b/src/lib/test/test-helper.hpp
@@ -0,0 +1,101 @@
+/*
+  TEST-HELPER.hpp  -  collection of functions supporting unit testing
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef LIB_TEST_TESTHELPER_H
+#define LIB_TEST_TESTHELPER_H
+
+
+#include "include/symbol.hpp"
+
+#include <typeinfo>
+#include <string>
+
+
+
+namespace lib {
+namespace test{
+  
+  using lumiera::Symbol;
+  using std::string;
+  
+  
+  
+  /** get a sensible display for a type or object 
+   *  @param obj object of the type in question
+   *  @param name optional name to be used literally
+   *  @return either the literal name without any further magic,
+   *          or the result of compile-time or run time 
+   *          type identification as implemented by the compiler.
+   */
+  template<typename T>
+  const char*
+  showType (T const& obj, Symbol name=0)
+  {
+    return name? name : typeid(obj).name();
+  }
+  
+  /** get a sensible display for a type 
+   *  @param name optional name to be used literally
+   *  @return either the literal name without any further magic,
+   *          or the result of compile-time or run time 
+   *          type identification as implemented by the compiler.
+   */
+  template<typename T>
+  const char*
+  showType (Symbol name=0)
+  {
+    return name? name : typeid(T).name();
+  }
+  
+  
+  /** for printing sizeof().
+   *  prints the given size and name litterally, without any further magic */
+  string
+  showSizeof (size_t siz, Symbol name);
+  
+  /** for printing sizeof(), trying to figure out the type name automatically */
+  template<typename T>
+  string
+  showSizeof(Symbol name=0)
+  {
+    return showSizeof (sizeof (T), showType<T> (name));
+  }
+  
+  template<typename T>
+  string
+  showSizeof(T const& obj, Symbol name=0)
+  {
+    return showSizeof (sizeof (obj), showType (obj,name));
+  }
+  
+  template<typename T>
+  string
+  showSizeof(T *obj, Symbol name=0)
+  {
+    return obj? showSizeof (*obj, name)
+              : showSizeof<T> (name);
+  }
+  
+  
+}} // namespace lib::test
+#endif
diff --git a/tests/40components.tests b/tests/40components.tests
index ea400e7f4..78ae76d6e 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -366,6 +366,12 @@ return: 0
 END
 
 
+TEST "Test support functions" TestHelper_test <<END
+out: Displaying types and sizes....
+out: --> Testgroup=ALL
+END
+
+
 TEST "TestOption_test" TestOption_test <<END
 out: Testing invocation with cmdline: ...
 out: --> Testgroup=ALL
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 7c9d41276..cea678415 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -69,6 +69,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/thread-wrapper-join-test.cpp		\
 	$(testlib_srcdir)/test/cmdlinewrappertest.cpp		\
 	$(testlib_srcdir)/test/testoptiontest.cpp		\
+	$(testlib_srcdir)/test/test-helper-test.cpp		\
 	$(testlib_srcdir)/vectortransfertest.cpp		\
 	$(testlib_srcdir)/visitingtoolconcept.cpp		\
 	$(testlib_srcdir)/visitingtoolextendedtest.cpp		\
diff --git a/tests/lib/test/test-helper-test.cpp b/tests/lib/test/test-helper-test.cpp
new file mode 100644
index 000000000..1a9c8c1dd
--- /dev/null
+++ b/tests/lib/test/test-helper-test.cpp
@@ -0,0 +1,97 @@
+/*
+  TestHelper(Test)  -  validate the unittest support functions
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+
+#include <iostream>
+
+using std::cout;
+using std::endl;
+
+
+namespace lib {
+namespace test{
+namespace test{
+  
+  template<class T>
+  class Wrmrmpft 
+    {
+      T tt_;
+    };
+  
+  struct Murpf { };
+  
+  
+  /*************************************************
+   * verifies the proper working of helper functions
+   * frequently used within the Lumiera testsuite.
+   * @see test-helper.hpp
+   */
+  class TestHelper_test : public Test
+    {
+      void
+      run (Arg)
+        {
+          checkTypeDisplay();
+        }
+      
+      
+      /** @test prints "sizeof()" including some type name. */
+      void
+      checkTypeDisplay ()
+        {
+          std::cout << "Displaying types and sizes....\n";
+          
+          typedef Wrmrmpft<Murpf> Wrmpf1;
+          typedef Wrmrmpft<char[2]> Wrmpf2;
+          typedef Wrmrmpft<char[3]> Wrmpf3;
+          
+          Wrmpf1 rmpf1;
+          Wrmpf2 rmpf2;
+          Wrmpf3 rmpf3;
+          Murpf murpf;
+          
+          ASSERT (1 == sizeof (rmpf1));
+          ASSERT (2 == sizeof (rmpf2));
+          ASSERT (3 == sizeof (rmpf3));
+          
+          cout << showSizeof(42,"theUniverse")     << endl;
+          cout << showSizeof<char>("just a char")  << endl;
+          cout << showSizeof(murpf)  << endl;
+          cout << showSizeof(rmpf1)  << endl;
+          cout << showSizeof(rmpf2)  << endl;
+          cout << showSizeof<Wrmpf3>() << endl;
+          
+          Wrmpf1 *p1 = &rmpf1;
+          Wrmpf1 *p2 = 0;
+          cout << showSizeof(p1)  << endl;
+          cout << showSizeof(p2)  << endl;
+        }
+    };
+  
+    LAUNCHER (TestHelper_test, "unit common");    
+    
+    
+}}} // namespace lib::test::test
+

From e8c25fca0a5489a6fb1dface4af38a317fbe08b4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 31 May 2009 02:41:00 +0200
Subject: [PATCH 039/368] supply test definition

---
 src/lib/test/test-helper.cpp        | 3 +--
 tests/40components.tests            | 8 +++++++-
 tests/lib/test/test-helper-test.cpp | 2 +-
 3 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/src/lib/test/test-helper.cpp b/src/lib/test/test-helper.cpp
index 3e584bda0..fbe7f1d4a 100644
--- a/src/lib/test/test-helper.cpp
+++ b/src/lib/test/test-helper.cpp
@@ -23,13 +23,12 @@
 
 #include "lib/test/test-helper.hpp"
 
-//#include "lib/error.hpp"
 #include <boost/format.hpp>
-#include <typeinfo>
 
 using boost::format;
 using boost::str;
 
+
 namespace lib {
 namespace test{
   
diff --git a/tests/40components.tests b/tests/40components.tests
index 78ae76d6e..154430c0a 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -368,7 +368,13 @@ END
 
 TEST "Test support functions" TestHelper_test <<END
 out: Displaying types and sizes....
-out: --> Testgroup=ALL
+out: sizeof..theUniverse.+ =  42
+out: sizeof..just a char.+ =   1
+out: sizeof.+lib.+test.+test.+Murpf.+ =   1
+out: sizeof.+lib.+test.+test.+Wrmrmpft.+Murpf.+ =   1
+out: sizeof.+lib.+test.+test.+Wrmrmpft.+ =   2
+out: sizeof.+lib.+test.+test.+Wrmrmpft.+ =   3
+out: sizeof.+lib.+test.+test.+Wrmrmpft.+Murpf.+ =   1
 END
 
 
diff --git a/tests/lib/test/test-helper-test.cpp b/tests/lib/test/test-helper-test.cpp
index 1a9c8c1dd..c903c523d 100644
--- a/tests/lib/test/test-helper-test.cpp
+++ b/tests/lib/test/test-helper-test.cpp
@@ -76,7 +76,7 @@ namespace test{
           ASSERT (2 == sizeof (rmpf2));
           ASSERT (3 == sizeof (rmpf3));
           
-          cout << showSizeof(42,"theUniverse")     << endl;
+          cout << showSizeof((size_t)42,"theUniverse")     << endl;
           cout << showSizeof<char>("just a char")  << endl;
           cout << showSizeof(murpf)  << endl;
           cout << showSizeof(rmpf1)  << endl;

From d49eea6e5d4e00c9d43cee732ba5febe535aef2d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 31 May 2009 05:02:03 +0200
Subject: [PATCH 040/368] finished reworking Placement (hierarchy and ID)

---
 src/proc/mobject/placement.cpp                |   1 +
 src/proc/mobject/placement.hpp                |   4 +-
 tests/43session.tests                         |  14 +-
 tests/components/proc/asset/basicpipetest.cpp |   2 +-
 .../proc/asset/dependent-assets-test.cpp      |  16 +-
 .../proc/mobject/placement-basic-test.cpp     |   2 +-
 .../proc/mobject/placement-hierarchy-test.cpp | 144 +++++++++++++-----
 .../proc/mobject/test-dummy-mobject.hpp       |   4 +-
 tests/lib/test/test-helper-test.cpp           |  12 +-
 wiki/renderengine.html                        |  11 +-
 10 files changed, 140 insertions(+), 70 deletions(-)

diff --git a/src/proc/mobject/placement.cpp b/src/proc/mobject/placement.cpp
index e148694a9..4af940bb4 100644
--- a/src/proc/mobject/placement.cpp
+++ b/src/proc/mobject/placement.cpp
@@ -26,6 +26,7 @@
 #include "proc/mobject/mobject.hpp"
 
 #include <boost/format.hpp>
+#include <typeinfo>
 
 using boost::format;
 using boost::str;
diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp
index 49c7005aa..f494d4815 100644
--- a/src/proc/mobject/placement.hpp
+++ b/src/proc/mobject/placement.hpp
@@ -132,7 +132,7 @@ namespace mobject {
        *  which is subject to placement.
        *  @note we don't provide operator*
        */
-      virtual MObject * 
+      MObject * 
       operator-> ()  const 
         { 
           ENSURE (*this); 
@@ -193,7 +193,7 @@ namespace mobject {
       friend class session::MObjectFactory;
       
     public:
-      virtual MO*
+      MO*
       operator-> ()  const
         {
           ENSURE (INSTANCEOF (MO, this->get()));
diff --git a/tests/43session.tests b/tests/43session.tests
index 6978f50f0..5b34fbdb2 100644
--- a/tests/43session.tests
+++ b/tests/43session.tests
@@ -29,7 +29,19 @@ PLANNED "PlacementBasic_test" PlacementBasic_test <<END
 END
 
 
-PLANNED "PlacementHierarchy_test" PlacementHierarchy_test <<END
+TEST "hierarchical placement types" PlacementHierarchy_test <<END
+out: sizeof\( \w+ \) =  \d{2}
+out: Placement.+mobject.+test.+TestSubMO1.+. use-cnt=1 .*
+out: Placement.+mobject.+test.+TestSubMO2.+. use-cnt=1 .*
+out: Placement.+mobject.+test.+TestSubMO21.+ use-cnt=2 .*
+out: Placement.+mobject.+test.+TestSubMO21.+ use-cnt=2 .*
+out: Placement.+mobject.+session.+Clip.+.... use-cnt=2 .*
+out: TestSubMO1\(ID= \d{3}\)
+out: TestSubMO2\(ID= \d{3}\)
+out: TestSubMO21\(ID= \d{3}\)
+out: specialAPI()
+out: specialAPI()
+out: pID\(\w{16}\)
 END
 
 
diff --git a/tests/components/proc/asset/basicpipetest.cpp b/tests/components/proc/asset/basicpipetest.cpp
index c10c77ea8..9c5069a79 100644
--- a/tests/components/proc/asset/basicpipetest.cpp
+++ b/tests/components/proc/asset/basicpipetest.cpp
@@ -121,7 +121,7 @@ namespace asset
             ASSERT (c1 == c2);
             
             PPipe pipe3 = Pipe::query ("pipe("+pID2+")");
-//////////////////////////////////////////////////////////////TODO: er macht eine Neue, anstatt die Bestehende zu finden            
+//////////////////////////////////////////////////////////////TODO: that's broken; creating a new one instead to find the existing one, as it should be            
             ASSERT (pipe3 == pipe2);
           }
         
diff --git a/tests/components/proc/asset/dependent-assets-test.cpp b/tests/components/proc/asset/dependent-assets-test.cpp
index d4c3de73d..8900592cf 100644
--- a/tests/components/proc/asset/dependent-assets-test.cpp
+++ b/tests/components/proc/asset/dependent-assets-test.cpp
@@ -33,10 +33,8 @@ using util::isnil;
 
 
 
-namespace asset
-  {
-  namespace test
-    {
+namespace asset{
+namespace test {
     
     
     
@@ -59,7 +57,7 @@ namespace asset
         
         typedef TestAsset<Asset> TA;
         typedef TA::PA PTestA;
-
+        
         
         /** @test check operation of basic asset dependency support
          */
@@ -149,12 +147,12 @@ namespace asset
             a2->enable(true);
             ASSERT (a1->isActive());
             ASSERT (a2->isActive());
-
+            
             a3->enable(false);
             ASSERT (a1->isActive());
             ASSERT (a2->isActive());
             ASSERT (!a3->isActive());  // no dependency...
-
+            
             a1->enable(false);
             a3->enable();
             ASSERT (!a1->isActive());
@@ -210,6 +208,4 @@ namespace asset
     
     
     
-  } // namespace test
-
-} // namespace asset
+}} // namespace asset::test
diff --git a/tests/components/proc/mobject/placement-basic-test.cpp b/tests/components/proc/mobject/placement-basic-test.cpp
index e11968877..637ee4f35 100644
--- a/tests/components/proc/mobject/placement-basic-test.cpp
+++ b/tests/components/proc/mobject/placement-basic-test.cpp
@@ -79,7 +79,7 @@ namespace mobject {
               ExplicitPlacement expla = pc.resolve();
               ASSERT (expla.time == 1);
               ASSERT (!expla.chain.isOverdetermined());
-              //ASSERT (*expla == *pc);  ////////////////////////TODO: define equality on placements
+              //ASSERT (*expla == *pc);  ////////////////////////TODO: define equality on placements (Trac #119)
               
               // now overconstraining with another Placement
               pc.chain(Time(2));
diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index 1064a3f79..d6fd03cab 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -1,5 +1,5 @@
 /*
-  PlacementHierarchy(Test)  -  concept draft how to deal with the MObject hierarchy in Placements
+  PlacementHierarchy(Test)  -  cooperating hierarchical placement types
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -22,47 +22,40 @@
 
 
 #include "lib/test/run.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-ref.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
+#include "lib/test/test-helper.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
-#include "lib/hash-indexed.hpp"
+#include "proc/mobject/session/clip.hpp"
+#include "proc/mobject/placement.hpp"
+#include "proc/asset/media.hpp"
 #include "lib/util.hpp"
 
-#include <boost/format.hpp>
 #include <tr1/memory>
 #include <iostream>
-#include <cstdlib>
+
+using lib::HashIndexed;
 
 using std::tr1::shared_ptr;
-using boost::format;
-using boost::str;
-//using lumiera::Time;
-//using util::contains;
-using lib::HashIndexed;
 using std::string;
 using std::cout;
-using std::rand;
+using std::endl;
 
 
 namespace mobject {
 namespace session {
 namespace test    {
   
+  using session::Clip;
+  using lib::test::showSizeof;
   using namespace mobject::test;
   
   
-  /*******************************************************************************
-   * @test Currently (5/09) this is a concept draft separate of any existing types.
-   *       The intention is to rework the Placement implementation based on the
-   *       outcomes of this experiment. When doing so, this test could later on
-   *       serve to document and cover the corresponding Placement properties.
+  /***************************************************************************************
+   * @test creating placements specifically typed, forming an hierarchy of placement types
+   *       which loosely mirrors the hierarchy of the pointee types. Assignments between
+   *       placement of differing type, while still sharing ownership.
    * @see  mobject::Placement
    * @see  mobject::MObject#create
+   * @see  lib::hash::HashIndexed
    */
   class PlacementHierarchy_test : public Test
     {
@@ -70,32 +63,99 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          TestPlacement<TestSubMO1>  pSub1(*new TestSubMO1);
-          TestPlacement<TestSubMO2>  pSub2(*new TestSubMO2);
-          TestPlacement<TestSubMO21> pSub3(*new TestSubMO21);
+          typedef Placement<MObject>                    PMObj;
+          typedef TestPlacement<>                       PDummy;
+          typedef TestPlacement<TestSubMO1>             PSub1;
+          typedef TestPlacement<TestSubMO2>             PSub2;
+          typedef TestPlacement<TestSubMO21,TestSubMO2> PSub21;
           
-          TestPlacement<DummyMO>     pSubM (pSub3);
+          PSub1  pSub1(*new TestSubMO1);
+          PSub2  pSub2(*new TestSubMO2);
+          PSub21 pSub3(*new TestSubMO21);
           
-          /////////////////////////////////TODO
-          format fmt ("sizeof( %s ) = %d\n");
-          cout << fmt % "Pla<Sub1>"   % sizeof(pSub1);
-          cout << fmt % "Pla<Sub2>"   % sizeof(pSub2);
-          cout << fmt % "Pla<Sub3>"   % sizeof(pSub3);
+          PDummy pSubM (pSub3);
+          
+          PMObj  pClip = asset::Media::create("test-1", asset::VIDEO)->createClip();
+          
+          ASSERT (INSTANCEOF (Placement<MObject>, &pSub1));
+          ASSERT (INSTANCEOF (Placement<MObject>, &pSub2));
+          ASSERT (INSTANCEOF (Placement<MObject>, &pSub3));
+          ASSERT (INSTANCEOF (Placement<MObject>, &pSubM));
+          
+          ASSERT (INSTANCEOF (Placement<DummyMO>, &pSub1));
+          ASSERT (INSTANCEOF (Placement<DummyMO>, &pSub2));
+          ASSERT (INSTANCEOF (Placement<DummyMO>, &pSub3));
+          
+          ASSERT (INSTANCEOF (TestPlacement<DummyMO>, &pSub1));
+          ASSERT (INSTANCEOF (TestPlacement<DummyMO>, &pSub2));
+          ASSERT (INSTANCEOF (TestPlacement<DummyMO>, &pSub3));
+          
+          ASSERT ( INSTANCEOF (TestPlacement<TestSubMO2>,  &pSub3));
+          
+          // the following won't succeed...
+//        ASSERT (INSTANCEOF (TestPlacement<TestSubMO21>, &pSub2)); // parent not instance of subclass
+//        ASSERT (INSTANCEOF (TestPlacement<TestSubMO2>,  &pSub1)); // separate branch in the hierarchy
+          
+          cout << showSizeof(pSub1) << endl;
+          cout << showSizeof(pSub2) << endl;
+          cout << showSizeof(pSub3) << endl;
+          cout << showSizeof(pSubM) << endl;
+          cout << showSizeof(pClip) << endl;
+          
+          ASSERT (sizeof(pSub1) == sizeof(pSub3));
+          ASSERT (sizeof(pClip) == sizeof(pSub3));
+          
+          cout << string(pSub1) << endl;
+          cout << string(pSub2) << endl;
+          cout << string(pSub3) << endl;
+          cout << string(pSubM) << endl;
+          cout << string(pClip) << endl;
+          cout << pSub1->operator string() << endl;
+          cout << pSub2->operator string() << endl;
+          cout << pSubM->operator string() << endl;
           
-          cout << string(pSub1) << "\n";
-          cout << string(pSub2) << "\n";
-          cout << string(pSubM) << "\n";
-          cout << pSub1->operator string() << "\n";
-          cout << pSub2->operator string() << "\n";
-          cout << pSubM->operator string() << "\n";
           pSub3->specialAPI();
           
-          cout << format_PlacementID(pSub1) << "\n";
-          cout << format_PlacementID(pSub2) << "\n";
-          cout << format_PlacementID(pSub3) << "\n";
-          cout << format_PlacementID(pSubM) << "\n";
+          ASSERT (2 == pSubM.use_count());
+          ASSERT (2 == pSub3.use_count());
+          pClip = pSubM;                      // slicing and shared ownership
+          ASSERT (3 == pSubM.use_count());
+          ASSERT (3 == pSub3.use_count());
+          ASSERT (3 == pClip.use_count());
           
-          cout << "Hurgha!\n";
+          
+          // now do a brute-force re-interpretation
+          // note this is still protected by an ASSERT on the operator->()
+          PSub21& hijacked = reinterpret_cast<PSub21&> (pClip);
+          
+          hijacked->specialAPI();
+          ASSERT (3 == hijacked.use_count());
+          ASSERT (hijacked.getID() == pSub3.getID());
+          
+          cout << format_PlacementID(pSub1) << endl;
+          cout << format_PlacementID(pSub2) << endl;
+          cout << format_PlacementID(pSub3) << endl;
+          cout << format_PlacementID(pSubM) << endl;
+          cout << format_PlacementID(pClip) << endl;
+          
+          pClip = pSub1;
+          ASSERT (2 == pSubM.use_count());
+          ASSERT (2 == pSub3.use_count());
+          
+          ASSERT (2 == pClip.use_count());
+          ASSERT (2 == pSub1.use_count());
+          
+///////////////////////////////////////////////////////////////////////////////TODO: find a way to configure NoBug to throw in case of assertion
+///////////////////////////////////////////////////////////////////////////////TODO: configure NoBug specifically for the testsuite
+//        try
+//          {
+//            hijacked->specialAPI();
+//            NOTREACHED;
+//          }
+//        catch (...)
+//          {
+//            ASSERT (lumiera_error () == error::LUMIERA_ERROR_ASSERTION);
+//          }
         }
     };
   
diff --git a/tests/components/proc/mobject/test-dummy-mobject.hpp b/tests/components/proc/mobject/test-dummy-mobject.hpp
index 8d3e2cd1e..28988c473 100644
--- a/tests/components/proc/mobject/test-dummy-mobject.hpp
+++ b/tests/components/proc/mobject/test-dummy-mobject.hpp
@@ -116,7 +116,7 @@ namespace test    {
   struct TestSubMO21 : TestSubMO2 
     {
       virtual operator string() const      { return display("TestSubMO21"); }
-      void specialAPI()                    { cout << "specialAPI()\n";}
+      virtual void specialAPI() const      { cout << "specialAPI()\n";}
     };
 
   
@@ -141,7 +141,7 @@ namespace test    {
         : TestPlacement<B>(dummyObj)
         { }
       
-      virtual DMO*
+      DMO *
       operator-> ()  const
         {
           ENSURE (INSTANCEOF (DMO, this->get()));
diff --git a/tests/lib/test/test-helper-test.cpp b/tests/lib/test/test-helper-test.cpp
index c903c523d..032eb3e9b 100644
--- a/tests/lib/test/test-helper-test.cpp
+++ b/tests/lib/test/test-helper-test.cpp
@@ -76,12 +76,12 @@ namespace test{
           ASSERT (2 == sizeof (rmpf2));
           ASSERT (3 == sizeof (rmpf3));
           
-          cout << showSizeof((size_t)42,"theUniverse")     << endl;
-          cout << showSizeof<char>("just a char")  << endl;
-          cout << showSizeof(murpf)  << endl;
-          cout << showSizeof(rmpf1)  << endl;
-          cout << showSizeof(rmpf2)  << endl;
-          cout << showSizeof<Wrmpf3>() << endl;
+          cout << showSizeof((size_t)42, "theUniverse") << endl;
+          cout << showSizeof<char>("just a char")       << endl;
+          cout << showSizeof(murpf)                     << endl;
+          cout << showSizeof(rmpf1)                     << endl;
+          cout << showSizeof(rmpf2)                     << endl;
+          cout << showSizeof<Wrmpf3>()                  << endl;
           
           Wrmpf1 *p1 = &rmpf1;
           Wrmpf1 *p2 = 0;
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 9a6c5e54b..f9a017247 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -579,7 +579,7 @@ For every Asset we generate a __Ident tuple__ and a long ID (hash) derived from
 <div title="AssetManager" modifier="Ichthyostega" created="200709200300" changecount="1">
 <pre>The Asset Manager provides an Interface to some internal Database holding all Assets in the current Session and System state. It may be a real Database at some point (and for the moment it's a Hashtable). Each [[Asset]] is registered automatically with the Asset Manager; it can be queried either by it's //identification tuple// or by it's unique ID.</pre>
 </div>
-<div title="AttachedPlacementProblem" modifier="Ichthyostega" modified="200905120332" created="200801111305" tags="SessionLogic impl draft dynamic" changecount="14">
+<div title="AttachedPlacementProblem" modifier="Ichthyostega" modified="200905292133" created="200801111305" tags="SessionLogic impl draft dynamic" changecount="15">
 <pre>Placing an MObject relatively to another object such that it should be handled as //attached//&amp;nbsp; to the latter results in several design and implementation challenges. Actually, such an attachment creates a cluster of objects. The typical use case is that of an effect attached to a clip or processing pipe.
 * attachment is not a globally fixed relation between objects, rather, it typically exists only for some limited time span (e.g. the duration of the basic clip the effect is attached to)
 * the order of attachment is important and the attached placement may create a fork in the signal flow, so we need a way for specifying reproducibly how the resulting wiring should be
@@ -592,7 +592,7 @@ The first step towards an solution is to isolate the problem; obviously we don't
 
 !!Implementation notes
 Attachment is managed within the participating placements, mostly by special [[locating pins|LocatingPin]]. Attachment doesn't necessarily nail down an attached object to a specific position, rather the behaviour depends on the type of the object and the locating pins actually involved, especially on their order and priority. For example, if an {{{Placement&lt;Effect&gt;}}} doesn't contain any locating pin defining a temporal position, then the attachment will result in the placement inheriting the temporal placement of the //attachment head// (i.e. the clip this effect has been attached to). But, if on the contrary the effect in question //does// have an additional locating pin, for example relative to another object or even to a fixed time position, this one will &quot;win&quot; and determine the start position of the effect &amp;mdash; it may even move the effect out of the time interval covered by the clip, in which case the attachment has no effect on the clip's processing pipe.
-The attachment relation is hierarchical and has a clearly defined //active// and //passive// side: The attachment head is the parent node in a tree, but plays the role of the passive partner, to which the child nodes attach. But note, this does not mean we are limited to a single attachment head. Actually, each placement has a list of locating pins and thus can attach to several other placements. For example, a transition attaches to at least two local pipes (clips).
+The attachment relation is hierarchical and has a clearly defined //active// and //passive// side: The attachment head is the parent node in a tree, but plays the role of the passive partner, to which the child nodes attach. But note, this does not mean we are limited to a single attachment head. Actually, each placement has a list of locating pins and thus can attach to several other placements. For example, a transition attaches to at least two local pipes (clips). {{red{TODO: unresolved design problem; seems to contradict the PlacementScope}}}
 
 !!!!Relation to memory management
 Attachment on itself does //not// keep an object alive. Rather, it's a direct reference and has to be taken into account when deleting an object. On the other hand, processing nodes in the render engine never depend on placements &amp;mdsash; they always refer directly to the MObject instance or even the underlying asset. In the case of MObject instances, the pointer from within the engine will //share ownership// with the placement (remember: both are derived from {{{boost::shared_ptr}}}).
@@ -2969,7 +2969,7 @@ We need a way of addressing existing [[pipes|Pipe]]. Besides, as the Pipes and T
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
-<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200905291920" created="200904252258" tags="impl SessionLogic draft" changecount="16">
+<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200905310301" created="200904252258" tags="impl SessionLogic draft" changecount="19">
 <pre>//This page is a scrapbook for working out the implementation of the [[Session Datastructure in Memory|SessionDataMem]]//
 This is a difficult untertaking, because there are several dependencies (most of which aren't fully designed yet as of 5/09)
 * the GUI uses an adapted version of the HighLevelModel; these datastructures are intended to be backed by the Session
@@ -2993,8 +2993,9 @@ This is a difficult untertaking, because there are several dependencies (most of
 &lt;&lt;task &gt;&gt; specify the editing operations
 
 !Interface
-&lt;&lt;task&gt;&gt;evaluate models for the [[reference problem|MObjectRef]]
-&lt;&lt;task 2 3 3&gt;&gt; implement an hash-ID to be incorporated into placements
+&lt;&lt;task 1 1 1&gt;&gt; evaluate models for the [[reference problem|MObjectRef]]
+&lt;&lt;task 2 3 3&gt;&gt; implement an hash-ID
+&lt;&lt;task 1 2 2&gt;&gt; incorporate this ID into class Placement
 &lt;&lt;task 1 1 0&gt;&gt; implement PlacementRef
 &lt;&lt;task 2 2 0&gt;&gt; implement MObjectRef
 

From 1f4676e7b6807ab1c5ca27990659210b07ee2034 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 31 May 2009 05:14:23 +0200
Subject: [PATCH 041/368] cleanup old ID definiton now superseeded by hash-ID

---
 src/proc/mobject/placement-index.hpp | 4 ++--
 src/proc/mobject/placement-ref.hpp   | 8 --------
 2 files changed, 2 insertions(+), 10 deletions(-)

diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index c5d401358..a5fea0800 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -63,12 +63,12 @@ namespace mobject {
     public:
       typedef Placement<MObject> PlacementMO;
       typedef PlacementRef PRef;
-      typedef PRef::ID ID;
+      typedef PlacementMO::ID ID;
       
       PlacementMO& find (ID)  const;
       
       template<class MO>
-      Placement<MO>& find (PRef::IDp<MO>)  const;
+      Placement<MO>& find (PlacementMO::Id<MO>)  const;
       
       PlacementMO& getScope (PlacementMO&)  const;
       PlacementMO& getScope (ID)            const;
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index ac8773471..d04c7c3af 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -53,14 +53,6 @@ namespace mobject {
       /**
        * 
        */
-      class ID
-        {
-        };
-      
-      template<class MO>
-      class IDp : public ID
-        {
-        };
       
       
     };

From 1f5d94683a330df73980e83749874122a3472b52 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 1 Jun 2009 04:53:45 +0200
Subject: [PATCH 042/368] WIP: test driven brainstorming...

---
 .../proc/mobject/placement-ref-test.cpp       | 119 +++++++++++++++---
 wiki/renderengine.html                        |  17 +--
 2 files changed, 115 insertions(+), 21 deletions(-)

diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index b5337dec9..c6927c6bb 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -22,33 +22,30 @@
 
 
 #include "lib/test/run.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
+#include "lib/lumitime.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
-//#include "lib/util.hpp"
+#include "proc/mobject/explicitplacement.hpp"
+#include "proc/mobject/test-dummy-mobject.hpp"
 
-//#include <boost/format.hpp>
-//#include <iostream>
+#include <iostream>
 
-//using boost::format;
-//using lumiera::Time;
-//using util::contains;
+using lumiera::Time;
 using std::string;
-//using std::cout;
+using std::cout;
 
 
 namespace mobject {
 namespace session {
 namespace test    {
   
-  
+  using namespace mobject::test;
+
   
   /***************************************************************************
    * @test properties and behaviour of the reference-mechanism for Placements.
+   *       We create an mock placement index and install it to be used
+   *       by all PlacementRef instances while conducting this test.
    * @see  mobject::Placement
    * @see  mobject::MObject#create
    * @see  mobject::Placement#addPlacement
@@ -60,7 +57,101 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          /////////////////////////////////TODO
+          typedef TestPlacement<TestSubMO21> PSub;
+          
+          PSub p1(*new TestSubMO21);
+          PSub p2(*new TestSubMO21);
+          p2.chain(Time(2));
+          
+          // Prepare an (test)Index backing the PlacementRefs
+          typedef shared_ptr<PlacementIndex> PIdx;
+          PIdx index (createPlacementIndex());
+          PMO& root = index->getRoot();
+          reset_PlacementRef(index);
+          
+          index->insert (p1, root);
+          index->insert (p2, root);
+          ASSERT (2 == index->size());
+          
+          Placement::Id<TestSubMO21> id2 = p2.getID();
+          ASSERT (id2);
+          ASSERT (id2 != p1.getID());
+          
+          // create placement refs
+          PlacementRef<TestSubMO21> ref1 (p1);
+          PlacementRef<TestSubMO21> ref2 (id2);
+          
+          PlacementRef<MObject> refX (ref2);
+          
+          ASSERT (ref1);
+          ASSERT (ref2);
+          ASSERT (refX);
+          ASSERT (ref1 != ref2);
+          ASSERT (ref2 == refX);
+          
+          // indeed a "reference": resolves to the same memory location
+          ASSERT (&p1 == &*ref1);
+          ASSERT (&p2 == &*ref2);
+          ASSERT (&p2 == &*refX);
+
+          cout << string(*ref1) << endl;
+          cout << string(*ref2) << endl;
+          cout << string(*refX) << endl;
+          
+          // PlacementRef mimics placement behaviour
+          ref1->specialAPI();
+          ASSERT (1 == ref1.use_count());
+          ASSERT (1 == ref2.use_count());
+          ExplicitPlacement exPla = refX.resolve();
+          ASSERT (exPla.time == 2);                // indeed get back the time we set on p2 above
+          ASSERT (2 == ref2.use_count());          // exPla shares ownership with p2
+          
+          ASSERT (indey->contains(ref1));          // ref can stand-in for a placement-ID 
+          ASSERT (sizeof(id2) == sizeof(ref2));    // (and is actually implemented based on an ID)
+          
+          // assignment on placement refs
+          refX = ref1;
+          ASSERT (ref1 != ref2);
+          ASSERT (ref1 == refX);
+          ASSERT (ref2 != refX);
+          
+          // resolution is indeed "live", we see changes to the referred placement
+          ASSERT (refX.resolve().time == 0);
+          p1 = p2;
+          ASSERT (refX.resolve().time == 2);       // now we get the time tie we originally set on p2
+          ASSERT (3 == ref2.use_count());          // p1, p2 and exPla share ownership
+
+          // actually, the assignment has invalidated ref1, because of the changed ID
+          ASSERT (p1.getID() == p2.getID());
+          try
+            {
+              *ref1;
+              NOTREACHED;
+            }
+          catch (...)
+            {
+              ASSERT (lumiera_error () == LUMIERA_ERROR_INVALID_PLACEMENTREF);
+            }
+          ASSERT (!index->contains(p1));           // index indeed detected the invalid ref
+          ASSERT (3 == ref2.use_count());          // but ref2 is still valid
+          
+          // actively removing p2 invalidates the other refs to
+          index->remove (ref2);
+          ASSERT (!ref2);                          // checks invalidity without throwing
+          ASSERT (!refX);
+          try
+            {
+              *ref2;
+              NOTREACHED;
+            }
+          catch (...)
+            {
+              ASSERT (lumiera_error () == LUMIERA_ERROR_INVALID_PLACEMENTREF);
+            }
+
+          //consistency check; then reset PlacementRef index to default
+          ASSERT (0 == index->size());
+          reset_PlacementRef();
         }
     };
   
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index f9a017247..a40b3db97 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -579,7 +579,7 @@ For every Asset we generate a __Ident tuple__ and a long ID (hash) derived from
 <div title="AssetManager" modifier="Ichthyostega" created="200709200300" changecount="1">
 <pre>The Asset Manager provides an Interface to some internal Database holding all Assets in the current Session and System state. It may be a real Database at some point (and for the moment it's a Hashtable). Each [[Asset]] is registered automatically with the Asset Manager; it can be queried either by it's //identification tuple// or by it's unique ID.</pre>
 </div>
-<div title="AttachedPlacementProblem" modifier="Ichthyostega" modified="200905292133" created="200801111305" tags="SessionLogic impl draft dynamic" changecount="15">
+<div title="AttachedPlacementProblem" modifier="Ichthyostega" modified="200905310342" created="200801111305" tags="SessionLogic impl draft dynamic" changecount="17">
 <pre>Placing an MObject relatively to another object such that it should be handled as //attached//&amp;nbsp; to the latter results in several design and implementation challenges. Actually, such an attachment creates a cluster of objects. The typical use case is that of an effect attached to a clip or processing pipe.
 * attachment is not a globally fixed relation between objects, rather, it typically exists only for some limited time span (e.g. the duration of the basic clip the effect is attached to)
 * the order of attachment is important and the attached placement may create a fork in the signal flow, so we need a way for specifying reproducibly how the resulting wiring should be
@@ -595,7 +595,7 @@ Attachment is managed within the participating placements, mostly by special [[l
 The attachment relation is hierarchical and has a clearly defined //active// and //passive// side: The attachment head is the parent node in a tree, but plays the role of the passive partner, to which the child nodes attach. But note, this does not mean we are limited to a single attachment head. Actually, each placement has a list of locating pins and thus can attach to several other placements. For example, a transition attaches to at least two local pipes (clips). {{red{TODO: unresolved design problem; seems to contradict the PlacementScope}}}
 
 !!!!Relation to memory management
-Attachment on itself does //not// keep an object alive. Rather, it's a direct reference and has to be taken into account when deleting an object. On the other hand, processing nodes in the render engine never depend on placements &amp;mdsash; they always refer directly to the MObject instance or even the underlying asset. In the case of MObject instances, the pointer from within the engine will //share ownership// with the placement (remember: both are derived from {{{boost::shared_ptr}}}).
+Attachment on itself does //not// keep an object alive. Rather, it's implemented by an opaque ID entry (&amp;rarr; PlacementRef), which can be resolved by the PlacementIndex. The existence of attachments should be taken into account when deleting an object, preferably removing any dangling attachments to prevent an exception to be thrown later on. On the other hand, contrary to the elements of the HighLevelModel, processing nodes in the render engine never depend on placements &amp;mdash; they always refer directly to the MObject instance or even the underlying asset. In the case of MObject instances, the pointer from within the engine will //share ownership// with the placement (remember: both are derived from {{{boost::shared_ptr}}}).
 </pre>
 </div>
 <div title="Automation" modifier="Ichthyostega" modified="200708100315" created="200706250751" tags="def" changecount="5">
@@ -1930,7 +1930,7 @@ The general idea is, that each facade interface actually provides access to a sp
 
 &amp;rarr; overview [[MObject class hierarchy|MObjects]]</pre>
 </div>
-<div title="MObjectRef" modifier="Ichthyostega" modified="200905241554" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="18">
+<div title="MObjectRef" modifier="Ichthyostega" modified="200905310321" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="19">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
 Moreover [[MObject instances|MObject]] have a 2-level structure: the core object holds just the properties in a strict sense, i.e. the properties which the object //owns.// Any properties due to putting the object into a specific context, i.e. all relation properties are represented as [[Placement]] of the object. Thus, when viewed from the client side, a reference to a specific ~MObject //instance,// actually denotes a //specific//&amp;nbsp; Placement of this object into the Session.
 
@@ -1956,6 +1956,11 @@ Obviously, the second approach has quite some appeal &amp;mdash; but, in order t
 Presumably, none of the both models is usable as-is; rather we try to reconstruct the viable properties of both, starting out with the more elegant second model. Thus, basically the ''reference is a smart-ptr'' referring to the core object. Additionally, it incorporates a ''systematic ID denoting the location of the placement''. This ID without the smart-ptr part is used for the C-implementation, making the full handle implementation a shortcut for an access sequence, which first querries the placement from the Session, followed by dereferencing the placement to get at the core object. Thus, the implementation builds upon another abstraction, the &amp;rarr; PlacementRef, which in turn assumes for an index within the implementation of the [[session datastructure|SessionDataMem]] to track and retrieve the actual Placement.
 
 
+!using ~MObject references
+~MObject references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation can fail, because the validity of the reference is checked. In this respect, they behave exactly like PlacementRef, and indeed are just implemented on top of the latter. From this point onward, the referred ~MObject is kept alive by the reference &amp;mdash; but note, this doesn't extend to the placement, which still may be modified or removed within the session without further notice. {{red{TODO investigate synchronisation guarantees or a locking mechanism}}} Thus, client code should never store direct references to the placement.
+
+~MObject references have value semantics, i.e. they don't have an identity and can be copied feely. Dereferencing yields a direct (language) ref to the MObject, while the placement can be accessed by a separate function {{{getPlacement()}}}. Moreover, the MObjectRef instance provides a direct API to some of the most common query functions you could imagine to call on both the object and the placement (i.e. to find out about the start time, length, ....)
+
 {{red{WIP}}}
 </pre>
 </div>
@@ -2845,7 +2850,7 @@ On second sight, this problem seems to be quite nasty, because either we have to
 Consequently, we incorporate a random hash (implemented as {{{LUID}}}) into the individual placement, this way creating an distinguishable //placement identity,// which is retained on copying of the placement. The actual ID tag is complemented by a compile time type (template parameter), thus allowing to pass on additional context information through API calls.
 </pre>
 </div>
-<div title="PlacementRef" modifier="Ichthyostega" modified="200905241641" created="200905090032" tags="def spec draft" changecount="7">
+<div title="PlacementRef" modifier="Ichthyostega" modified="200905310325" created="200905090032" tags="def spec draft" changecount="8">
 <pre>A generic reference mechanism for Placements, as added to the current session.
 While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object. As a plus, this approach allows to //reverse// the relation denoted by such a reference, inasmuch it is possible to retrieve all other placements referring to a given target placement. But for an (external) user, this link to an index implementation is kept transparent and implicit.
 
@@ -2853,9 +2858,7 @@ While this reference itself is not tied to the actual memory layout (meaning it'
 From the usage context it is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, this design decision is interconnected with the implementation technique used for the index (&amp;rarr; PlacementIndex). From the requirement of the ID tag to be contained in a fixed sized storage, and also from the expected kinds of queries Ichthyo (5/09) choose to incorporate a {{{LUID}}} as a random hash immediately into the placement and build the ID tag on top of it.
 
 !using placement references
-Placement references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation can fail, because the validity of the reference is checked. From this point onward, the referred ~MObject is kept alive by the reference &amp;mdash; but note, this doesn't extend to the placement, which still may be modified or removed within the session without further notice. {{red{TODO investigate synchronisation guarantees or a locking mechanism}}} Thus, client code should never store direct references to the latter.
-
-Placement references have value semantics, i.e. they don't have an identity and can be copied feely. Dereferencing yields a direct (language) ref to the MObject, while the placement can be accessed by a separate function {{{getPlacement()}}}. Moreover, the PlacementRef instance provides a direct API to some of the most common query functions you could imagine to call on both the object and the placement (i.e. to find out about the start time, length, ....)
+Placement references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation and dereferencing can fail, because the validity of the reference is checked with the index. Placement references have value semantics. Dereferencing searches the denoted Placement via index, yielding a direct (language) ref. {{red{WIP}}}
 </pre>
 </div>
 <div title="PlacementScope" modifier="Ichthyostega" modified="200905210132" created="200905120304" tags="SessionLogic spec draft" changecount="5">

From 78901837fc572446638e71bf790eca64451027ab Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 2 Jun 2009 03:13:52 +0200
Subject: [PATCH 043/368] WIP: planned refinement on PlacementRefs: augmented
 assignment

---
 .../proc/mobject/placement-ref-test.cpp       | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index c6927c6bb..d56d46b49 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -115,6 +115,31 @@ namespace test    {
           ASSERT (ref1 == refX);
           ASSERT (ref2 != refX);
           
+          // re-assignment with a new placement
+          refX = p2;
+          ASSERT (refX == ref2);
+          ASSERT (&*refX == &p2);
+          refX = p1.getID();
+          ASSERT (refX == ref1);
+          ASSERT (refX != ref2);
+          ASSERT (&*refX == &p1);
+          
+          LumieraUid luid2 (p2.getID().get());
+          refX = luid2;                            // assignment works even based on a plain LUID
+          ref2 = ref1;                             
+          ref1 = refX;                             // dynamic type check when downcasting  
+          ASSERT (&p1 == &*ref2);
+          ASSERT (&p2 == &*ref1);
+          refX = ref2;
+          ref2 = ref1;
+          ref1 = refX;
+          ASSERT (&p1 == &*ref1);
+          ASSERT (&p1 == &*refX);
+          ASSERT (&p2 == &*ref2);
+          ASSERT (ref1 != ref2);
+          ASSERT (ref1 == refX);
+          ASSERT (ref2 != refX);
+          
           // resolution is indeed "live", we see changes to the referred placement
           ASSERT (refX.resolve().time == 0);
           p1 = p2;

From 8a453bd52b162767340590237c77c7023e48cea0 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 2 Jun 2009 03:31:52 +0200
Subject: [PATCH 044/368] WIP: start drafing MObjectRef

---
 src/proc/Makefile.am                          |   1 +
 src/proc/mobject/mobject-ref.cpp              |  52 ++++++++
 src/proc/mobject/mobject-ref.hpp              | 126 ++++++++++++++++++
 src/proc/mobject/placement-index.hpp          |   7 +-
 src/proc/mobject/placement-ref.hpp            |   7 +-
 src/proc/mobject/session/locatingpin.hpp      |   3 +-
 tests/43session.tests                         |   6 +-
 tests/components/Makefile.am                  |   1 +
 .../proc/mobject/mobject-ref-test.cpp         |  67 ++++++++++
 .../proc/mobject/session/testsession1.hpp     |  66 +++++----
 wiki/renderengine.html                        |  13 +-
 11 files changed, 303 insertions(+), 46 deletions(-)
 create mode 100644 src/proc/mobject/mobject-ref.cpp
 create mode 100644 src/proc/mobject/mobject-ref.hpp
 create mode 100644 tests/components/proc/mobject/mobject-ref-test.cpp

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index b1f8a7946..677ddda75 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -91,6 +91,7 @@ liblumiprocmobject_la_SOURCES =					\
 	$(liblumiprocmobject_la_srcdir)/builderfacade.cpp	\
 	$(liblumiprocmobject_la_srcdir)/interpolator.cpp	\
 	$(liblumiprocmobject_la_srcdir)/mobject.cpp		\
+	$(liblumiprocmobject_la_srcdir)/mobject-ref.cpp		\
 	$(liblumiprocmobject_la_srcdir)/parameter.cpp		\
 	$(liblumiprocmobject_la_srcdir)/paramprovider.cpp	\
 	$(liblumiprocmobject_la_srcdir)/placement-index.cpp	\
diff --git a/src/proc/mobject/mobject-ref.cpp b/src/proc/mobject/mobject-ref.cpp
new file mode 100644
index 000000000..8758de088
--- /dev/null
+++ b/src/proc/mobject/mobject-ref.cpp
@@ -0,0 +1,52 @@
+/*
+  MobjectRef  -  active external reference to an MObject within the Session
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file mobject-ref.cpp 
+ ** Implementation part of the MObjectRef facility. 
+ ** Any C++ client about to use a MObjectRef needs to be linked (dynamically) against
+ ** this implementation. Especially, this implementation allows to (re)-connect transparently
+ ** to the PlacementIndex within the session, so to establish a direct link to the Object
+ ** denoted by the reference. 
+ ** 
+ ** @see PlacementRef
+ ** @see PlacementIndex
+ **
+ */
+
+
+#include "proc/mobject/mobject-ref.hpp"
+#include "proc/mobject/mobject.hpp"
+#include "proc/mobject/placement.hpp"
+
+//#include <boost/format.hpp>
+//using boost::str;
+
+namespace mobject {
+  
+  /** */
+  
+  
+  
+  
+  
+} // namespace mobject
diff --git a/src/proc/mobject/mobject-ref.hpp b/src/proc/mobject/mobject-ref.hpp
new file mode 100644
index 000000000..2c368932c
--- /dev/null
+++ b/src/proc/mobject/mobject-ref.hpp
@@ -0,0 +1,126 @@
+/*
+  MOBJECT-REF.hpp  -  active external reference to an MObject within the Session
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file mobject-ref.hpp
+ ** A reference tag for accessing an object within the session externally,
+ ** from a separate Layer or from plugin code.
+ **
+ ** @see MObject
+ ** @see Session
+ ** @see PlacementRef
+ ** @see PlacementIndex
+ **
+ */
+
+
+
+#ifndef MOBJECT_MOBJECT_REF_H
+#define MOBJECT_MOBJECT_REF_H
+
+//#include "pre.hpp"
+//#include "proc/mobject/session/locatingpin.hpp"
+//#include "proc/asset/pipe.hpp"
+#include "lib/handle.hpp"
+#include "proc/mobject/placement.hpp"
+#include "proc/mobject/placement-ref.hpp"
+
+//#include <tr1/memory>
+
+
+namespace mobject {
+  
+//  using std::tr1::shared_ptr;
+  
+  
+  class MObject;
+  
+  
+  /**
+   * An active (smart-ptr like) external reference
+   * to a specifically placed MObject "instance" within the session.
+   */
+  template<class MO =MObject>
+  class MORef
+    : public lib::Handle<MO>
+    {
+      PlacementRef<MO> pRef_;
+      
+      /** deleter function used to detach when refcount goes to zero */
+      static void whenDead (MObject*);
+      
+    public:
+      
+      MO*
+      operator-> ()  const
+        {
+          REQUIRE (smPtr_.get(), "Lifecycle-Error");
+          ENSURE (INSTANCEOF (MO, smPtr_.get()));
+          return smPtr_::operator-> ();
+        }
+      
+      Placement<MO>& getPlacement();
+      
+      /* === Lifecycle === */
+      
+      /** activate an MObject reference, based on an existing placement,
+       *  which needs to be contained (added to) the session. After checking
+       *  the validity of the placement, this MObjectRef shared ownership
+       *  of the referred MObject with the denoted placement.
+       *  @see #close() for detaching this MObjectRef
+       */
+      MORef&
+      activate (Placement<MO> const& placement)
+        {
+          pRef_ = placement;
+          smPtr_.reset (placement, &whenDead);
+          return *this;
+        }
+      
+      /** build and activate an MObject reference, based on anything
+       *  which might be assigned to an PlarementRef<MO> :
+       *  - any Placement
+       *  - any Placement-ID
+       *  - any Placement-Ref
+       *  - a plain LUID
+       * @throws error::Invalid when the (directly or indirectly 
+       *         referred placement isn't known to the session PlacementIndex,
+       *         or when the placement actually found has an incompatible dynamic type 
+       */
+      template<typename REF>
+      MORef&
+      activate (REF const& pRefID)
+        {
+          pRef_ = pRefID;
+          smPtr_.reset (*pRef_, &whenDead);
+          return *this;
+        }
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  typedef MORef<MObject> MObjectRef;
+  
+  
+} // namespace mobject
+#endif
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index a5fea0800..9afccdcf4 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -50,6 +50,7 @@ namespace mobject {
   using boost::scoped_ptr;
   using std::vector;
 
+  class MObject;
   
   
   /**
@@ -62,13 +63,15 @@ namespace mobject {
       
     public:
       typedef Placement<MObject> PlacementMO;
-      typedef PlacementRef PRef;
+      typedef PlacementRef<MObject> PRef;
       typedef PlacementMO::ID ID;
       
       PlacementMO& find (ID)  const;
       
       template<class MO>
-      Placement<MO>& find (PlacementMO::Id<MO>)  const;
+      Placement<MO>&  find (PlacementMO::Id<MO>)  const;
+      template<class MO>
+      Placement<MO>&  find (PlacementRef<MO>)     const;
       
       PlacementMO& getScope (PlacementMO&)  const;
       PlacementMO& getScope (ID)            const;
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index d04c7c3af..5f5e8baf5 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -30,8 +30,8 @@
 
 
 
-#ifndef MOBJECT_PLACEMENT__REF_H
-#define MOBJECT_PLACEMENT__REF_H
+#ifndef MOBJECT_PLACEMENT_REF_H
+#define MOBJECT_PLACEMENT_REF_H
 
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
@@ -45,8 +45,11 @@ namespace mobject {
 //  using std::tr1::shared_ptr;
   
   
+  class MObject;
+  
   /**
    */
+  template<class MO =MObject>
   class PlacementRef
     {
     public:
diff --git a/src/proc/mobject/session/locatingpin.hpp b/src/proc/mobject/session/locatingpin.hpp
index fa63cb2c3..fb09a0432 100644
--- a/src/proc/mobject/session/locatingpin.hpp
+++ b/src/proc/mobject/session/locatingpin.hpp
@@ -68,6 +68,7 @@ namespace mobject {
 //class Placement ;
 //typedef Placement<MObject> PMO;
 
+  template<class MO =MObject>
   class PlacementRef;    ///TODO: as of 5/09 the idea is to phase out direct dependency on the placement class and recast those dependencies in terms of PlacementRef
 
 
@@ -116,7 +117,7 @@ namespace mobject {
         /* Factory functions for adding LocatingPins */
         
         FixedLocation&    operator() (Time start, Track track=0);
-        RelativeLocation& operator() (PlacementRef& refObj, Time offset=Time(0));   //////////TODO: warning, just a dummy placeholder for now!!
+        RelativeLocation& operator() (PlacementRef<>& refObj, Time offset=Time(0));   //////////TODO: warning, just a dummy placeholder for now!!
         
         LocatingPin (const LocatingPin&);
         LocatingPin& operator= (const LocatingPin&);
diff --git a/tests/43session.tests b/tests/43session.tests
index 5b34fbdb2..a06c7558b 100644
--- a/tests/43session.tests
+++ b/tests/43session.tests
@@ -25,7 +25,11 @@ PLANNED "DeleteClip_test" DeleteClip_test <<END
 END
 
 
-PLANNED "PlacementBasic_test" PlacementBasic_test <<END
+PLANNED "external MObject references" MObjectRef_test <<END
+END
+
+
+PLANNED "basic placement properties" PlacementBasic_test <<END
 END
 
 
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index dece6cfd0..32a0d8962 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -52,6 +52,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildsegmenttest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/controller/rendersegmenttest.cpp	\
+	$(testcomponents_srcdir)/proc/mobject/mobject-ref-test.cpp		\
 	$(testcomponents_srcdir)/proc/mobject/placement-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/mobject/placement-hierarchy-test.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/placement-index-test.cpp		\
diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
new file mode 100644
index 000000000..d33771c99
--- /dev/null
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -0,0 +1,67 @@
+/*
+  MObjectRef(Test)  -  validating basic properties of the external MObject reference tag
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/lumitime.hpp"
+#include "proc/mobject/mobject.hpp"
+#include "proc/mobject/mobject-ref.hpp"
+#include "proc/mobject/placement.hpp"
+#include "proc/mobject/placement-ref.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/mobject/test-dummy-mobject.hpp"
+
+#include <iostream>
+
+//using lumiera::Time;
+using std::string;
+using std::cout;
+
+
+namespace mobject {
+namespace test    {
+  
+  using namespace mobject::test;
+
+  
+  /***************************************************************************
+   * @test properties and behaviour of the external reference-mechanism for
+   *       MObjects placed into the session. 
+   * @see  mobject::Placement
+   * @see  mobject::MObject
+   * @see  mobject::PlacementRef_test
+   */
+  class MObjectRef_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (MObjectRef_test, "unit session");
+  
+  
+}} // namespace mobject::test
diff --git a/tests/components/proc/mobject/session/testsession1.hpp b/tests/components/proc/mobject/session/testsession1.hpp
index 166fd1c02..4928c2b23 100644
--- a/tests/components/proc/mobject/session/testsession1.hpp
+++ b/tests/components/proc/mobject/session/testsession1.hpp
@@ -38,40 +38,36 @@ using std::string;
 using std::cout;
 
 
-namespace mobject
-  {
-  namespace session
+namespace mobject {
+namespace session {
+  
+  /**
+   * Create a Test Session configuration usable for various Tests.
+   * This Session holds two Clips and corresponds to "Example1"
+   * in the UML design. All changes are done to the (global)
+   * current session.
+   */
+  inline void 
+  buildTestsession1 ()
     {
-    
-    /**
-     * Create a Test Session configuration usable for various Tests.
-     * This Session holds two Clips and corresponds to "Example1"
-     * in the UML design. All changes are done to the (global)
-     * current session.
-     */
-    inline void 
-    buildTestseesion1 ()
-      {
-        UNIMPLEMENTED ("Test-Session 1");
-      };
-    
-      
-    /**
-     * Analyze the current (gloal) Session to verify the
-     * configuration of "Test-Session 1"
-     */
-    inline bool 
-    checkTestsession1 ()
-      {
-        UNIMPLEMENTED ("Test-Session 1");
-        return false;
-      };
-    
-
-    const string SESSION1_CLIP("TODO: some sensible way to refer to a clip");
-    
-    
-  } // namespace session
-
-} // namespace mobject
+      UNIMPLEMENTED ("Test-Session 1");
+    };
+  
+  
+  /**
+   * Analyse the current (global) Session to verify the
+   * configuration of "Test-Session 1"
+   */
+  inline bool 
+  checkTestsession1 ()
+    {
+      UNIMPLEMENTED ("Test-Session 1");
+      return false;
+    };
+  
+  
+  const string SESSION1_CLIP("TODO: some sensible way to refer to a clip");
+  
+  
+}} // namespace mobject::session
 #endif
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index a40b3db97..ff4258b84 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1930,7 +1930,7 @@ The general idea is, that each facade interface actually provides access to a sp
 
 &amp;rarr; overview [[MObject class hierarchy|MObjects]]</pre>
 </div>
-<div title="MObjectRef" modifier="Ichthyostega" modified="200905310321" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="19">
+<div title="MObjectRef" modifier="Ichthyostega" modified="200906020120" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="21">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
 Moreover [[MObject instances|MObject]] have a 2-level structure: the core object holds just the properties in a strict sense, i.e. the properties which the object //owns.// Any properties due to putting the object into a specific context, i.e. all relation properties are represented as [[Placement]] of the object. Thus, when viewed from the client side, a reference to a specific ~MObject //instance,// actually denotes a //specific//&amp;nbsp; Placement of this object into the Session.
 
@@ -1957,7 +1957,7 @@ Presumably, none of the both models is usable as-is; rather we try to reconstruc
 
 
 !using ~MObject references
-~MObject references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation can fail, because the validity of the reference is checked. In this respect, they behave exactly like PlacementRef, and indeed are just implemented on top of the latter. From this point onward, the referred ~MObject is kept alive by the reference &amp;mdash; but note, this doesn't extend to the placement, which still may be modified or removed within the session without further notice. {{red{TODO investigate synchronisation guarantees or a locking mechanism}}} Thus, client code should never store direct references to the placement.
+~MObject references have a distinct lifecycle: usually, they are created //empty// (invalid ref, inactive state), followed by activating them by attachment to an existing placement within the session. Later on, the reference can be closed (detached, deactivated). Activation can be done either directly by a {{{Placement&lt;MO&gt;&amp;}}}, or indirectly by any {{{Placement::ID}}} tag or even plain LUID denoting a placement known to the PlacementIndex embedded within the [[Session]]. Activation can fail, because the validity of the reference is checked. In this respect, they behave exactly like PlacementRef, and indeed are implemented on top of the latter. From this point onward, the referred ~MObject is kept alive by the reference &amp;mdash; but note, this doesn't extend to the placement, which still may be modified or removed within the session without further notice. {{red{TODO investigate synchronisation guarantees or a locking mechanism}}} Thus, client code should never store direct references to the placement.
 
 ~MObject references have value semantics, i.e. they don't have an identity and can be copied feely. Dereferencing yields a direct (language) ref to the MObject, while the placement can be accessed by a separate function {{{getPlacement()}}}. Moreover, the MObjectRef instance provides a direct API to some of the most common query functions you could imagine to call on both the object and the placement (i.e. to find out about the start time, length, ....)
 
@@ -2850,15 +2850,18 @@ On second sight, this problem seems to be quite nasty, because either we have to
 Consequently, we incorporate a random hash (implemented as {{{LUID}}}) into the individual placement, this way creating an distinguishable //placement identity,// which is retained on copying of the placement. The actual ID tag is complemented by a compile time type (template parameter), thus allowing to pass on additional context information through API calls.
 </pre>
 </div>
-<div title="PlacementRef" modifier="Ichthyostega" modified="200905310325" created="200905090032" tags="def spec draft" changecount="8">
+<div title="PlacementRef" modifier="Ichthyostega" modified="200906020130" created="200905090032" tags="def spec draft" changecount="12">
 <pre>A generic reference mechanism for Placements, as added to the current session.
 While this reference itself is not tied to the actual memory layout (meaning it's //not// a disguised pointer), the implementation relies on a [[placement index facility|PlacementIndex]] for tracking and retrieving the actual Placement implementation object. As a plus, this approach allows to //reverse// the relation denoted by such a reference, inasmuch it is possible to retrieve all other placements referring to a given target placement. But for an (external) user, this link to an index implementation is kept transparent and implicit.
 
 !implementation {{red{WIP}}}
-From the usage context it is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, this design decision is interconnected with the implementation technique used for the index (&amp;rarr; PlacementIndex). From the requirement of the ID tag to be contained in a fixed sized storage, and also from the expected kinds of queries Ichthyo (5/09) choose to incorporate a {{{LUID}}} as a random hash immediately into the placement and build the ID tag on top of it.
+From the usage context it is clear that the PlacementRef needs to incorporate a simple ID as the only actual data in memory, so it can be downcasted to a POD and passed as such via LayerSeparationInterfaces. And, of course, this ID tag should be the one used by PlacementIndex for organising the Placement index entries, thus enabling the PlacementRef to be passed immediately to the underlying index for resolution. Thus, this design decision is interconnected with the implementation technique used for the index (&amp;rarr; PlacementIndex). From the requirement of the ID tag to be contained in a fixed sized storage, and also from the expected kinds of queries Ichthyo (5/09) choose to incorporate a {{{LUID}}} as a random hash immediately into the placement and build the ID tag on top of it. 
 
 !using placement references
-Placement references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation and dereferencing can fail, because the validity of the reference is checked with the index. Placement references have value semantics. Dereferencing searches the denoted Placement via index, yielding a direct (language) ref. {{red{WIP}}}
+Placement references can be created directly from a given placement, or just from an {{{Placement::ID}}} tag. Creation and dereferencing can fail, because the validity of the reference is checked with the index. Placement references have value semantics. Dereferencing searches the denoted Placement via index, yielding a direct (language) ref.
+
+Placement references mimic the behaviour of a real placement, i.e. they proxy the placement API (actually the passive, query-related part of placement's API functions), while directly forwarding calls to the pointee (~MObejct or subclass) when using {{{operator-&gt;()}}}. They can be copied and especially allow a lot of assignments (from placement, placement-ID or even plain LUID), even including a dynamic downcast on the pointee. Bottom line is that a placement ref can pretty much be used in place of a language ref to a real placement, which is crucial for implementing MObjectRef.
+{{red{WIP}}}
 </pre>
 </div>
 <div title="PlacementScope" modifier="Ichthyostega" modified="200905210132" created="200905120304" tags="SessionLogic spec draft" changecount="5">

From 608c532df744e9b3d90d55f03b65198de5784e62 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 2 Jun 2009 03:32:48 +0200
Subject: [PATCH 045/368] Fix: wrong wiring of subsystem descriptor for the
 Session

---
 src/proc/facade.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/proc/facade.cpp b/src/proc/facade.cpp
index f2c18bfab..f3180550c 100644
--- a/src/proc/facade.cpp
+++ b/src/proc/facade.cpp
@@ -105,7 +105,7 @@ namespace proc {
   
   namespace {
     lumiera::Singleton<BuilderSubsysDescriptor> theBuilderDescriptor;   
-    lumiera::Singleton<BuilderSubsysDescriptor> theSessionDescriptor;
+    lumiera::Singleton<SessionSubsysDescriptor> theSessionDescriptor;
   }
   
   

From 87e528bd5830d500b403ff0c58632f0b90bb097d Mon Sep 17 00:00:00 2001
From: Anton Yakovlev <just.yakovlev@gmail.com>
Date: Wed, 3 Jun 2009 18:12:35 +0400
Subject: [PATCH 046/368] Cyclic L1-list. Implements almost the same set of
 operations as for L2-list (except those, which reverse enumeration of
 elements).

---
 src/lib/slist.h            | 666 +++++++++++++++++++++++++++++++++++++
 tests/15slist.tests        |  46 +++
 tests/Makefile.am          |   4 +
 tests/library/test-slist.c | 349 +++++++++++++++++++
 4 files changed, 1065 insertions(+)
 create mode 100644 src/lib/slist.h
 create mode 100644 tests/15slist.tests
 create mode 100644 tests/library/test-slist.c

diff --git a/src/lib/slist.h b/src/lib/slist.h
new file mode 100644
index 000000000..61fd9e10d
--- /dev/null
+++ b/src/lib/slist.h
@@ -0,0 +1,666 @@
+/*
+ *  slist.h - simple intrusive cyclic single linked list
+ *
+ *  Copyright (C)         Lumiera.org
+ *    2009                Anton Yakovlev <just.yakovlev@gmail.com>
+ *
+ *  This program is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU General Public License as
+ *  published by the Free Software Foundation; either version 2 of the
+ *  License, or (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#ifndef SLIST_H
+#define SLIST_H
+
+#include <stddef.h>
+
+/**
+ * @file
+ * Intrusive cyclic single linked list.
+ *
+ * List node is a structure, which consists only of a forward pointer. This is
+ * much easier and makes code much cleaner, than to have forward pointer as is.
+ * In a empty initialized node, this pointer points to the node itself. Note
+ * that this pointer can never ever become NULL.
+ *
+ * This lists are used by using one node as 'root' node where it's pointer is
+ * the head pointer to the actual list. Care needs to be taken to ensure not to
+ * apply any operations meant to be applied to data nodes to the root node.
+ * This way is the prefered way to use this lists.
+ *
+ * Alternatively one can store only a chain of data nodes and use a SList
+ * pointer to point to the first item (which might be NULL in case no data is
+ * stored). When using such approach care must be taken since most functions
+ * below expect lists to have a root node.
+ *
+ * Due to nature of single linked list, there's no easy way to implement
+ * functions, which need reverse passing through a list. But some of L1-list
+ * interface functions need such ability (for example, when we need to find
+ * previous element for current element). Because search of previous element
+ * requires visiting of exactly N-1 nodes (where N is length of L1-list), we
+ * use root node as start point. This gives to us probability of visiting
+ * 1 <= C <= N-1 nodes, and, thus, speed up search.
+ *
+ * This header can be used in 2 different ways:
+ * 1) (prerefered) just including it provides all functions as static inlined
+ *    functions. This is the default
+ * 2) #define LLIST_INTERFACE before including this header gives only the declarations
+ *    #define LLIST_IMPLEMENTATION before including this header yields in definitions
+ *    this can be used to generate a library. This is currently untested and not
+ *    recommended.
+ * The rationale for using inlined functions is that most functions are very
+ * small and likely to be used in performance critical parts. Inlining can give
+ * a hughe performance and optimization improvement here. The few functions
+ * which are slightly larger are expected to be the less common used ones, so
+ * inlining them too shouldn't be a problem either.
+ */
+
+/* TODO __STDC_VERSION__ 199901L
+150) This macro was not specified in ISO/IEC 9899:1990 and was specified as 199409L in
+ISO/IEC 9899/AMD1:1995. The intention is that this will remain an integer constant of type long
+int that is increased with each revision of this International Standard.
+*/
+
+#ifdef HAVE_INLINE
+#   define SLIST_MACRO static inline
+#else
+#   ifdef __GNUC__
+#       define SLIST_MACRO static __inline__
+#   else
+#       define SLIST_MACRO static
+#   endif
+#endif
+
+#if defined(SLIST_INTERFACE)
+/* only the interface is generated */
+#define SLIST_FUNC(proto, ...) proto
+#elif defined(SLIST_IMPLEMENTATION)
+/* generate a non inlined implementation */
+#define SLIST_FUNC(proto, ...) proto { __VA_ARGS__ }
+#else
+/* all functions are macro-like inlined */
+#define SLIST_FUNC(proto, ...) SLIST_MACRO proto { __VA_ARGS__ }
+#endif
+
+/*
+ * Type of a slist node.
+ */
+
+#ifndef SLIST_DEFINED
+#define SLIST_DEFINED
+
+struct slist_struct {
+    struct slist_struct* next;
+};
+
+#endif
+
+typedef struct slist_struct slist;
+typedef slist* SList;
+typedef const slist* const_SList;
+typedef slist** SList_ref;
+
+/**
+ * Macro to instantiate a local llist.
+ *
+ * @param name of the slist node
+ */
+
+#define SLIST_AUTO( name ) slist name = { &name }
+
+/*
+ * some macros for convenience
+ */
+
+#define slist_head slist_next
+#define slist_insert_head( list, element ) slist_insert( list, element )
+
+/**
+ * Сast back from a member of a structure to a pointer of the structure.
+ *
+ * Example:
+ *
+ *  struct point {
+ *      int x;
+ *      int y;
+ *      slist list;
+ *  };
+ *
+ *  SList points = ...; // some initialization; must be the root of our list
+ *
+ *  SLIST_FOREACH( points, current_node ) {
+ *      struct point* current_point = SLIST_TO_STRUCTP( current_node, struct point, list );
+ *      printf( "point = ( %d, %d )\n", current_point -> x, current_point -> y );
+ *  }
+ *
+ * @param list is a pointer to the SList member of the linked structures
+ * @param type is type name of the linked structures
+ * @param member is a name of the SList member of the linked structures
+ */
+
+#define SLIST_TO_STRUCTP( list, type, member ) \
+    ( ( type* ) ( ( ( char* )( list ) ) - offsetof( type, member ) ) )
+
+/**
+ * Iterate forward over a list.
+ *
+ * @param list the root node of the list to be iterated
+ * @param node pointer to the iterated node
+ */
+
+#define SLIST_FOREACH( list, node ) \
+    for ( SList node = slist_head( list ); ! slist_is_end( node, list ); slist_forward( &node ) )
+
+/**
+ * Iterate forward over a range.
+ *
+ * @param start first node to be interated
+ * @param end node after the last node be iterated
+ * @param node pointer to the iterated node
+ */
+
+#define SLIST_FORRANGE( start, end, node ) \
+    for ( SList node = start; node != end; slist_forward( &node ) )
+
+/**
+ * Consume a list from head.
+ * The body of this statement should remove the head from the list, else it would be a infinite loop
+ *
+ * @param list the root node of the list to be consumed
+ * @param head pointer to the head node
+ */
+
+#define SLIST_WHILE_HEAD( list, head ) \
+    for ( SList head = slist_head( list ); ! slist_is_empty( list ); head = slist_head( list ) )
+
+/**
+ * Initialize a new llist.
+ * Must not be applied to a list node which is not empty! Lists need to be initialized
+ * before any other operation on them is called.
+ *
+ * @param list node to be initialized
+ */
+
+SLIST_FUNC (
+    void slist_init( SList list ),
+    list -> next = list;
+);
+
+/**
+ * Check if a node is not linked with some other node.
+ */
+
+SLIST_FUNC (
+    int slist_is_empty( const_SList list ),
+    return list -> next == list;
+);
+
+/**
+ * Check if self is the only node in a list or self is not in a list.
+ *
+ * Warning:
+ *      There's no check for empty list, so if you have a list with no items,
+ *      you'll get seg fault here.
+ *
+ * @param list is root node of the list to be checked
+ */
+
+SLIST_FUNC (
+    int slist_is_single( const_SList list ),
+    return list -> next -> next == list;
+);
+
+/**
+ * Check for the head of a list.
+ *
+ * @param list is root node of the list
+ * @param head is expected head of the list
+ */
+
+SLIST_FUNC (
+    int slist_is_head( const_SList list, const_SList head ),
+    return list -> next == head;
+);
+
+/**
+ * Check for the end of a list.
+ * The end is by definition one past the tail of a list, which is the root node itself.
+ *
+ * @param list is root node of the list
+ * @param end is expected end of the list
+ */
+
+SLIST_FUNC (
+    int slist_is_end( const_SList list, const_SList end ),
+    return list == end;
+);
+
+/**
+ * Check if a node is a member of a list.
+ *
+ * @param list is root node of the list
+ * @param member is node to be searched
+ */
+
+SLIST_FUNC (
+    int slist_is_member( const_SList list, const_SList member ),
+    for ( const_SList i = member -> next; i != member; i = i -> next ) {
+        if ( i == list ) {
+            return 1;
+        }
+    }
+    return 0;
+);
+
+/**
+ * Check the order of elements in a list.
+ *
+ * @param list is root node of the list
+ * @param before is expected to be before after
+ * @param after is expected to be after before
+ */
+
+SLIST_FUNC (
+    int slist_is_before_after( const_SList list, const_SList before, const_SList after ),
+    for ( const_SList i = before -> next; i != list; i = i -> next ) {
+        if ( i == after ) {
+            return 1;
+        }
+    }
+    return 0;
+);
+
+/**
+ * Count the nodes of a list.
+ *
+ * @param list is root node of the list
+ * @return number of nodes in `list`
+ */
+
+SLIST_FUNC (
+    unsigned slist_count( const_SList list ),
+    unsigned cnt = 0;
+    for ( const_SList i = list; i -> next != list; ++cnt, i = i -> next ) {
+        ;
+    }
+    return cnt;
+);
+
+/**
+ * Get next node.
+ * Will not stop at tail.
+ *
+ * @param node is current node
+ * @return node after current node
+ */
+
+SLIST_FUNC (
+    SList slist_next( const_SList node ),
+    return node -> next;
+);
+
+/**
+ * Get previous node.
+ *
+ * @param list is root node of the list
+ * @param node is current node
+ * @return node before current node
+ */
+
+SLIST_FUNC (
+    SList slist_prev( SList list, SList node ),
+    while ( list -> next != node ) {
+        list = list -> next;
+    }
+    return list;
+);
+
+/**
+ * Remove a node from a list.
+ *
+ * @param list is root node of the list
+ * @param node to be removed
+ * @return node
+ */
+
+SLIST_FUNC (
+    SList slist_unlink( SList list, SList node ),
+    SList prev_node = slist_prev( list, node );
+    prev_node -> next = node -> next;
+    return node -> next = node;
+);
+
+/**
+ * Insert a node after another.
+ *
+ * @param head is node after which we want to insert
+ * @param node is node which shall be inserted after `head`. Could already linked to a list from where it will be removed.
+ * @return head
+ */
+
+SLIST_FUNC (
+    SList slist_insert( SList head, SList node ),
+    if ( ! slist_is_empty( node ) ) {
+        slist_unlink( node, node );
+    }
+    node -> next = head -> next;
+    head -> next = node;
+    return head;
+);
+
+/**
+ * Move the content of a list after a node in another list.
+ *
+ * @param xnode is node after which we want to insert a list
+ * @param ylist is root node of the list which shall be inserted after self. This list will be empty after call.
+ * @return xnode
+ */
+
+SLIST_FUNC (
+    SList slist_insert_list( SList xnode, SList ylist ),
+    if ( ! slist_is_empty( ylist ) ) {
+        SList tail = slist_prev( ylist, ylist ); // search for the Y list tail
+        tail -> next = xnode -> next;
+        xnode -> next = ylist -> next;
+
+        ylist -> next = ylist; // clear the Y list
+    }
+    return xnode;
+);
+
+/**
+ * Move a range of nodes after a given node.
+ *
+ * @param node is node after which the range shall be inserted
+ * @param start first node in range to be moved
+ * @param end node after the last node of the range
+ * @return node
+ */
+
+SLIST_FUNC (
+    SList slist_insert_range( SList node, SList start, SList end ),
+    // insert range
+    SList tail = slist_prev( start, end ); // search for the end of range
+    tail -> next = node -> next;
+    node -> next = start -> next;
+    // fix list
+    start -> next = end;
+    return node;
+);
+
+/**
+ * Swap a node with its next node.
+ * Advancing will not stop at tail, one has to check that if this is intended.
+ *
+ * @param list is root node of the list
+ * @param node is node to be advaced
+ * @return node
+ */
+
+SLIST_FUNC (
+    SList slist_advance( SList list, SList node ),
+    SList prev = slist_prev( list, node );
+    prev -> next = node -> next;
+    node -> next = node -> next -> next;
+    prev -> next -> next = node;
+    return node;
+);
+
+/**
+ * Advance a pointer to a node to its next node.
+ *
+ * @param node pointer-to-pointer to the current node. `node` will point to the next node after this call.
+ */
+
+SLIST_FUNC (
+    void slist_forward( SList_ref node ),
+    *node = ( *node ) -> next;
+);
+
+/**
+ * Get the nth element of a list (this function does not stop at head/tail).
+ *
+ * @param list is root node of the list to be queried
+ * @param n is number of element to find
+ * @return |n|-th element of list
+ */
+
+SLIST_FUNC (
+    SList slist_get_nth( SList list, unsigned int n ),
+    while ( n-- > 0 ) {
+        list = slist_next( list );
+    }
+    return list;
+);
+
+/**
+ * Get the nth element of a list with a stop node.
+ *
+ * @param list is root node of the list to be queried
+ * @param n is number of element to find
+ * @param stop is node which will abort the iteration
+ * @return |n|-th element of list or NULL if `stop` node has been reached
+ */
+
+SLIST_FUNC (
+    SList slist_get_nth_stop( SList list, unsigned int n, const_SList stop ),
+    while ( n-- > 0 ) {
+        list = slist_next( list );
+        if ( list == stop ) {
+            return NULL;
+        }
+    }
+    return list;
+);
+
+/**
+ * Sort a list.
+ *
+ * This is iterative version of bottom-up merge sort for (L1/L2) linked-list:
+ *  + there's no recursion
+ *  + there's no extra stackspace allocation (only a few bytes for locals)
+ * Such implementation should be optimal and fast enough.
+ *
+ * Maybe this function is too big for inlining (though I don't think so), so
+ * maybe somebody can make it smaller without losing perfomance? ;)
+ *
+ * @param list is root node of a list to be sorted
+ * @param cmp is compare function of 2 SList items
+ * @return list
+ */
+
+typedef int ( *slist_cmpfn )( const_SList a, const_SList b );
+
+SLIST_FUNC (
+    SList slist_sort( SList list, slist_cmpfn cmp ),
+    if ( ! slist_is_single( list ) ) {
+
+        unsigned int length = slist_count( list );
+
+        // `max_size` is a half of minimum power of 2, greater of equal to `length`
+        // ( 2 * max_size = 2^k ) >= length
+        // We need `max_size` value for proper binary division of a list for sorting.
+        
+        unsigned long long max_size = 1;
+        while ( ( max_size << 1 ) < length ) {
+            max_size <<= 1;
+        }
+
+        // The main idea of bottom-up merge sort is sequential merging of each pair
+        // of sequences of { 1, .. 2^k, .. max_size } length. That's all. :)
+
+        for ( unsigned int size = 1; size <= max_size; size <<= 1 ) {
+
+            // On each iteration:
+            //  * `result` points to the current node of global (merged/sorted) list.
+            //    thus, we can holds all nodes are linked.
+            //  * `left` and `right` points to begin of (sub)lists for merging.
+            
+            SList result = list;
+            SList left = list -> next;
+            SList right;
+
+            // Process each pairs of sequences of size=2^k length.
+            
+            for ( unsigned int position = 0; position < length; position += size + size ) {
+
+                right = slist_get_nth_stop( left, size, list );
+
+                unsigned int size_left = size;
+                unsigned int size_right = right == NULL ? 0 : size;
+
+                // Here we have 2 sublists of `size_left` and `size_right` sizes.
+                // Implementation of `merge` function is next three loops.
+
+                while ( ( size_left > 0 ) && ( size_right > 0 ) ) {
+
+                    if ( cmp( left, right ) <= 0 ) {
+                        
+                        result -> next = left;
+                        
+                        left = left -> next;
+                        if ( left == list ) {
+                            size_left = 0;
+                        } else {
+                            size_left--;
+                        }
+
+                    } else {
+                        
+                        result -> next = right;
+                        
+                        right = right -> next;
+                        if ( right == list ) {
+                            size_right = 0;
+                        } else {
+                            size_right--;
+                        }
+                        
+                    }
+                    
+                    result = result -> next;
+                    
+                }
+
+                while ( size_left > 0 ) {
+                    result -> next = left;
+                    result = left;
+                    
+                    left = left -> next;
+                    if ( left == list ) {
+                        break;
+                    }
+                    size_left--;
+                }
+
+                while ( size_right > 0 ) {
+                    result -> next = right;
+                    result = right;
+                    
+                    right = right -> next;
+                    if ( right == list ) {
+                        break;
+                    }
+                    size_right--;
+                }
+
+                // go to begin of next pair of sequences
+                
+                left = right;
+                
+            }
+
+            // here `result` points to the last node of a list.
+            // we wanna keep cyclic list.
+            
+            result -> next = list;
+            
+        }
+
+    }
+    return list;
+)
+            
+/**
+ * Find the first occurence of an element in a list.
+ * Does not change the order of a list.
+ *
+ * @param list is root node of a list to be searched
+ * @param pattern is template for the element being searched
+ * @param cmp is compare function of 2 SList items
+ * @return pointer to the found SList element or NULL if nothing found
+ */
+
+SLIST_FUNC (
+    SList slist_find( const_SList list, const_SList pattern, slist_cmpfn cmp ),
+    SLIST_FOREACH( list, node ) {
+        if ( cmp( node, pattern ) == 0 ) {
+            return node;
+        }
+    }
+    return NULL;
+)
+
+/**
+ * Find the first occurence of an element in an unsorted list.
+ *
+ * Searches the list until it finds the searched element and moves it then to
+ * the head. Useful if the order of the list is not required and few elements
+ * are frequently searched.
+ *
+ * @param list is root node of a list to be searched
+ * @param pattern is template for the element being searched
+ * @param cmp is compare function of 2 SList items
+ * @return pointer to the found SList element (head) or NULL if nothing found
+ */
+
+SLIST_FUNC (
+    SList slist_ufind( SList list, const_SList pattern, slist_cmpfn cmp ),
+    SLIST_FOREACH( list, node ) {
+        if ( cmp( node, pattern ) == 0 ) {
+            slist_insert_head( list, node );
+            return node;
+        }
+    }
+    return NULL;
+)
+
+/**
+ * Find the first occurence of an element in a sorted list.
+ *
+ * Searches the list until it finds the searched element, exits searching when
+ * found an element biggier than the searched one.
+ *
+ * @param list is root node of a list to be searched
+ * @param pattern is template for the element being searched
+ * @param cmp is compare function of 2 SList items
+ * @return pointer to the found SList element (head) or NULL if nothing found
+ */
+
+SLIST_FUNC (
+    SList slist_sfind( const_SList list, const_SList pattern, slist_cmpfn cmp ),
+    SLIST_FOREACH( list, node ) {
+        
+        int result = cmp( node, pattern );
+        
+        if ( result == 0 ) {
+            return node;
+        } else if ( result > 0 ) {
+            break;
+        }
+        
+    }
+    return NULL;
+)
+
+#endif /* SLIST_H */
diff --git a/tests/15slist.tests b/tests/15slist.tests
new file mode 100644
index 000000000..d482488f0
--- /dev/null
+++ b/tests/15slist.tests
@@ -0,0 +1,46 @@
+TESTING "Single Linked Lists" ./test-slist
+
+TEST "initialization and predicates" basic <<END
+out: 1
+out: 0
+out: 1
+out: 0
+out: 1
+out: 0
+out: 1
+out: 0
+END
+
+TEST "insert/delete nodes" insert_delete <<END
+out: 1
+out: 0
+out: 1
+out: 0
+out: 1
+END
+
+TEST "moving across a list" movement <<END
+out: 1
+END
+
+TEST "enumerates elements of a list" enumerations <<END
+out: A B C D .
+out: ---
+out: B C .
+out: ---
+out: A B C D .
+out: 1
+END
+
+TEST "get length and n-th element of a list" count <<END
+out: 3
+out: 1
+END
+
+TEST "sorts a list" sort <<END
+return: 0
+END
+
+TEST "finds element inside a list" search <<END
+out: 1
+END
diff --git a/tests/Makefile.am b/tests/Makefile.am
index acaf205b6..fee7134ae 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -69,6 +69,10 @@ test_resourcecollector_SOURCES = $(tests_srcdir)/library/test-resourcecollector.
 test_resourcecollector_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror -I$(top_srcdir)/src/
 test_resourcecollector_LDADD = $(NOBUGMT_LUMIERA_LIBS) liblumierabackend.la liblumieracommon.la liblumieraproc.la -ldl liblumiera.la -lboost_program_options-mt -lboost_regex-mt
 
+check_PROGRAMS += test-slist
+test_slist_SOURCES = $(tests_srcdir)/library/test-slist.c
+test_slist_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror
+test_slist_LDADD = $(NOBUGMT_LUMIERA_LIBS)                                  liblumiera.la -lboost_program_options-mt -lboost_regex-mt
 
 check_PROGRAMS += test-config
 test_config_SOURCES = $(tests_srcdir)/common/test-config.c
diff --git a/tests/library/test-slist.c b/tests/library/test-slist.c
new file mode 100644
index 000000000..c4c9bfbaa
--- /dev/null
+++ b/tests/library/test-slist.c
@@ -0,0 +1,349 @@
+/*
+ *  test-slist.c  -  test the linked list lib
+ *
+ *  Copyright (C)         Lumiera.org
+ *    2009                Anton Yakovlev <just.yakovlev@gmail.com>
+ *
+ *  This program is free software; you can redistribute it and/or
+ *  modify it under the terms of the GNU General Public License as
+ *  published by the Free Software Foundation; either version 2 of the
+ *  License, or (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#include "lib/slist.h"
+#include "tests/test.h"
+
+#include <sys/time.h>
+
+typedef struct item {
+    int key;
+    slist list;
+} item_t;
+
+int cmp( const_SList a, const_SList b ) {
+
+    item_t* x = SLIST_TO_STRUCTP( a, item_t, list );
+    item_t* y = SLIST_TO_STRUCTP( b, item_t, list );
+
+    if ( x -> key < y -> key ) {
+        return -1;
+    }
+
+    if ( x -> key > y -> key ) {
+        return +1;
+    }
+
+    return 0;
+    
+}
+
+TESTS_BEGIN
+
+/*
+ * 1. Basic:
+ *      SLIST_AUTO( name )
+ *      void slist_init( SList list )
+ *      int slist_is_empty( const_SList list )
+ *      int slist_is_single( const_SList list )
+ *      int slist_is_head( const_SList list, const_SList head )
+ *      int slist_is_end( const_SList list, const_SList end )
+ *      int slist_is_member( const_SList list, const_SList member )
+ *      int slist_is_before_after( const_SList list, const_SList before, const_SList after )
+ */
+
+TEST( "basic" ) {
+
+    SLIST_AUTO( listX );
+    slist listY;
+    SLIST_AUTO( nodeA );
+    SLIST_AUTO( nodeB );
+
+    printf( "%d\n", slist_is_end( &listX, &listX ) );
+    
+    slist_init( &listY );
+
+    printf( "%d\n", slist_is_empty( &listY ) );
+    
+    slist_insert( &listX, &nodeA );
+    printf( "%d\n", slist_is_empty( &listX ) );
+    printf( "%d\n", slist_is_single( &listX ) );
+    printf( "%d\n", slist_is_head( &listX, &nodeA ) );
+    printf( "%d\n", slist_is_end( &listX, &nodeA ) );
+    printf( "%d\n", slist_is_member( &listX, &nodeA ) );
+    printf( "%d\n", slist_is_member( &listX, &nodeB ) );
+
+    slist_insert( &nodeA, &nodeB );
+    printf( "%d\n", slist_is_empty( &listX ) );
+    printf( "%d\n", slist_is_single( &listX ) );
+    printf( "%d\n", slist_is_head( &listX, &nodeB ) );
+    printf( "%d\n", slist_is_end( &listX, &nodeB ) );
+    printf( "%d\n", slist_is_member( &listX, &nodeB ) );
+
+    printf( "%d\n", slist_is_before_after( &listX, &nodeA, &nodeB ) );
+    printf( "%d\n", slist_is_before_after( &listX, &nodeB, &nodeA ) );
+
+}
+
+/*
+ * 2. Insert/delete:
+ *      slist_insert_head( list, element )
+ *      SList slist_insert( SList head, SList node )
+ *      SList slist_insert_list( SList xnode, SList ylist )
+ *      SList slist_insert_range( SList node, SList start, SList end )
+ *      SList slist_unlink( SList list, SList node )
+ */
+
+TEST( "insert_delete" ) {
+
+    SLIST_AUTO( listX );
+    SLIST_AUTO( nodeA );
+    SLIST_AUTO( nodeB );
+    SLIST_AUTO( nodeC );
+
+    slist_insert_head( &listX, &nodeA );
+    slist_insert( &nodeA, &nodeB );
+    slist_insert( &nodeB, &nodeC );
+    printf( "%d\n", slist_next( &listX ) == &nodeA );
+    printf( "%d\n", slist_next( &nodeA ) == &nodeB );
+    printf( "%d\n", slist_next( &nodeB ) == &nodeC );
+    printf( "%d\n", slist_next( &nodeC ) == &listX );
+
+    slist_unlink( &listX, &nodeA );
+    printf( "%d\n", slist_next( &listX ) == &nodeB );
+
+    slist_insert( &listX, &nodeA );
+    printf( "%d\n", slist_next( &listX ) == &nodeA );
+
+    SLIST_AUTO( listY );
+
+    slist_insert_list( &listY, &listX );
+    printf( "%d\n", slist_is_empty( &listX ) );
+    printf( "%d\n", slist_next( &listY ) == &nodeA );
+    printf( "%d\n", slist_next( &nodeA ) == &nodeB );
+    printf( "%d\n", slist_next( &nodeB ) == &nodeC );
+    printf( "%d\n", slist_next( &nodeC ) == &listY );
+
+    slist_insert_range( &listX, &nodeA, &nodeB );
+    printf( "%d\n", slist_next( &listX ) == &nodeA );
+    printf( "%d\n", slist_next( &nodeA ) == &nodeB );
+    printf( "%d\n", slist_next( &nodeB ) == &listX );
+
+    printf( "%d\n", slist_is_single( &listY ) );
+    printf( "%d\n", slist_next( &listY ) == &nodeC );
+    printf( "%d\n", slist_next( &nodeC ) == &listY );
+    
+}
+
+/*
+ * 3. Movements:
+ *      slist_head()
+ *      SList slist_next( const_SList node )
+ *      SList slist_prev( SList list, SList node )
+ *      SList slist_advance( SList list, SList node )
+ *      void slist_forward( SList_ref node )
+ */
+
+TEST( "movement" ) {
+
+    SLIST_AUTO( listX );
+    SLIST_AUTO( nodeA );
+    SLIST_AUTO( nodeB );
+    SLIST_AUTO( nodeC );
+
+    slist_insert_head( &listX, &nodeA );
+    slist_insert( &nodeA, &nodeB );
+    slist_insert( &nodeB, &nodeC );
+
+    printf( "%d\n", slist_next( &listX ) == &nodeA );
+    printf( "%d\n", slist_next( &nodeA ) == &nodeB );
+    printf( "%d\n", slist_next( &nodeB ) == &nodeC );
+    printf( "%d\n", slist_next( &nodeC ) == &listX );
+
+    printf( "%d\n", slist_prev( &listX, &listX ) == &nodeC );
+    printf( "%d\n", slist_prev( &listX, &nodeC ) == &nodeB );
+    printf( "%d\n", slist_prev( &listX, &nodeB ) == &nodeA );
+    printf( "%d\n", slist_prev( &listX, &nodeA ) == &listX );
+    
+    slist_advance( &listX, &nodeA );
+    printf( "%d\n", slist_next( &listX ) == &nodeB );
+    printf( "%d\n", slist_next( &nodeB ) == &nodeA );
+    printf( "%d\n", slist_next( &nodeA ) == &nodeC );
+    printf( "%d\n", slist_next( &nodeC ) == &listX );
+
+    SList node = &listX;
+    slist_forward( &node );
+    printf( "%d\n", node == &nodeB );
+    
+}
+
+/*
+ * 4. Enumerations:
+ *      SLIST_TO_STRUCTP( list, type, member )
+ *      SLIST_FOREACH( list, node )
+ *      SLIST_FORRANGE( start, end, node )
+ *      SLIST_WHILE_HEAD( list, head )
+ */
+
+TEST( "enumerations" ) {
+
+    SLIST_AUTO( list );
+    
+    item_t nodeA = { 'A', { NULL } };
+    item_t nodeB = { 'B', { NULL } };
+    item_t nodeC = { 'C', { NULL } };
+    item_t nodeD = { 'D', { NULL } };
+
+    slist_init( &nodeA.list );
+    slist_init( &nodeB.list );
+    slist_init( &nodeC.list );
+    slist_init( &nodeD.list );
+
+    slist_insert( &list, &nodeA.list );
+    slist_insert( &nodeA.list, &nodeB.list );
+    slist_insert( &nodeB.list, &nodeC.list );
+    slist_insert( &nodeC.list, &nodeD.list );
+
+    SLIST_FOREACH ( &list, node ) {
+        item_t* item = ( item_t* ) SLIST_TO_STRUCTP( node, item_t, list );
+        printf( "%c ", item -> key );
+    }
+    printf( ".\n" );
+
+    printf( "---\n" );
+
+    SLIST_FORRANGE ( &nodeB.list, &nodeD.list, node ) {
+        item_t* item = ( item_t* ) SLIST_TO_STRUCTP( node, item_t, list );
+        printf( "%c ", item -> key );
+    }
+    printf( ".\n" );
+
+    printf( "---\n" );
+
+    SLIST_WHILE_HEAD ( &list, head ) {
+        item_t* item = ( item_t* ) SLIST_TO_STRUCTP( head, item_t, list );
+        printf( "%c ", item -> key );
+        slist_unlink( &list, head );
+    }
+    printf( ".\n" );
+
+    printf( "%d\n", slist_is_empty( &list ) );
+    
+}
+
+/*
+ * 5. Counting:
+ *      unsigned slist_count( const_SList list )
+ *      SList slist_get_nth( SList list, int n )
+ *      SList slist_get_nth_stop( SList list, int n, const_SList stop )
+ */
+
+TEST( "count" ) {
+
+    SLIST_AUTO( list );
+    SLIST_AUTO( nodeA );
+    SLIST_AUTO( nodeB );
+    SLIST_AUTO( nodeC );
+
+    slist_insert( &list, &nodeA );
+    slist_insert( &nodeA, &nodeB );
+    slist_insert( &nodeB, &nodeC );
+
+    printf( "%u\n", slist_count( &list ) );
+    printf( "%d\n", slist_get_nth( &list, 3 ) == &nodeC );
+    printf( "%d\n", slist_get_nth_stop( &list, 3, &nodeC ) == NULL );
+    
+}
+
+/*
+ * 6. Sort:
+ *      SList slist_sort( SList list, slist_cmpfn cmp )
+ */
+
+TEST( "sort" ) {
+
+    srand( time( NULL ) );
+    
+    SLIST_AUTO( list );
+
+    unsigned int n = 1000000;
+
+    item_t* items;
+    if ( ( items = ( item_t* ) malloc( sizeof( item_t ) * n ) ) == NULL ) {
+        return 1; // ERROR: not enough memory
+    }
+
+    for ( unsigned int i = 0; i < n; i++ ) {
+        items[ i ].key = rand();
+        slist_init( &items[ i ].list );
+        slist_insert( &list, &items[ i ].list );
+    }
+    
+    slist_sort( &list, cmp );
+
+    int is_first_cmp = 1;
+    int prev_key = 0;
+    
+    SLIST_FOREACH ( &list, x ) {
+        item_t* item = SLIST_TO_STRUCTP( x, item_t, list );
+        if ( is_first_cmp ) {
+            is_first_cmp = 0;
+        } else if ( prev_key > item -> key ) {
+            return 2; // ERROR: wrong order of elements
+        }
+        prev_key = item -> key;
+    }
+
+    free( items );
+    
+    return 0;
+    
+}
+
+/*
+ * 7. Search:
+ *      SList slist_find( const_SList list, const_SList pattern, slist_cmpfn cmp )
+ *      SList slist_ufind( SList list, const_SList pattern, slist_cmpfn cmp )
+ *      SList slist_sfind( const_SList list, const_SList pattern, slist_cmpfn cmp )
+ */
+
+TEST( "search" ) {
+
+    SLIST_AUTO( list );
+    
+    item_t nodeA = { 'A', { NULL } };
+    item_t nodeB = { 'B', { NULL } };
+    item_t nodeC = { 'C', { NULL } };
+    item_t nodeD = { 'D', { NULL } };
+    item_t nodeX = { '?', { NULL } };
+
+    slist_init( &nodeA.list );
+    slist_init( &nodeB.list );
+    slist_init( &nodeC.list );
+    slist_init( &nodeD.list );
+
+    slist_insert( &list, &nodeA.list );
+    slist_insert( &nodeA.list, &nodeB.list );
+    slist_insert( &nodeB.list, &nodeC.list );
+    slist_insert( &nodeC.list, &nodeD.list );
+
+    nodeX.key = 'C';
+
+    printf( "%d\n", slist_find( &list, &nodeX.list, cmp ) == &nodeC.list );
+    printf( "%d\n", slist_ufind( &list, &nodeX.list, cmp ) == &nodeC.list );
+    printf( "%d\n", slist_next( &nodeC.list ) == &nodeA.list );
+
+    nodeX.key = 'A';
+    printf( "%d\n", slist_sfind( &list, &nodeX.list, cmp ) == NULL );
+    
+}
+
+TESTS_END

From 85b1297b4a865cb0ce1861f965b9918dd9b1a44b Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sun, 10 May 2009 09:33:42 +0200
Subject: [PATCH 047/368] let llist_init return the initialized node

This makes it possible to use the init without a temporary variable:
 llist_insert_next (llist_init (foo), llist_init (bar));
---
 src/lib/llist.h | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/lib/llist.h b/src/lib/llist.h
index 25a9dca39..39c629ee5 100644
--- a/src/lib/llist.h
+++ b/src/lib/llist.h
@@ -193,8 +193,8 @@ typedef llist ** LList_ref;
  * before any other operation on them is called.
  * @param self node to be initialized
  */
-LLIST_FUNC (void llist_init (LList self),
-            self->next = self->prev = self;
+LLIST_FUNC (LList llist_init (LList self),
+            return self->next = self->prev = self;
 );
 
 /**

From 59de53b25a78cd330c0c6e0f637e8cf7618da433 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sun, 10 May 2009 10:07:35 +0200
Subject: [PATCH 048/368] llist: add an generic void* to the compare, sort and
 search functions

This allows the user to pass some extra data along, which improves the
usefulness in certain cases.
---
 src/lib/llist.h | 50 ++++++++++++++++++++++++++++++-------------------
 1 file changed, 31 insertions(+), 19 deletions(-)

diff --git a/src/lib/llist.h b/src/lib/llist.h
index 39c629ee5..d6511ebaf 100644
--- a/src/lib/llist.h
+++ b/src/lib/llist.h
@@ -533,15 +533,26 @@ LLIST_FUNC (LList llist_get_nth_stop (LList self, int n, const_LList stop),
 );
 
 
+/**
+ * The comparsion function function type.
+ * certain sort and find functions depend on a user supplied coparsion function
+ * @param a first operand for the comparsion
+ * @param b second operand for the comparsion
+ * @param extra user supplied data which passed through
+ * @return shall return a value less than zero, zero, biggier than zero when
+ *         a is less than, equal to, biggier than b
+ */
+typedef int (*llist_cmpfn)(const_LList a, const_LList b, void* extra);
+
+
 /**
  * Sort a list.
  * recursive mergesort, needs much extra stackspace (crappy implementation yet) but it reasonable fast
  * @param self list to be sorted
- * @param cmp function takeing 2 LLists
+ * @param cmp function for comparing 2 nodes
+ * @param extra generic data passed to the cmp function
  */
-typedef int (*llist_cmpfn)(const_LList a, const_LList b);
-
-LLIST_FUNC (LList llist_sort (LList self, llist_cmpfn cmp),
+LLIST_FUNC (LList llist_sort (LList self, llist_cmpfn cmp, void* extra),
             llist left;
             llist right;
             llist_init (&left);
@@ -552,11 +563,11 @@ LLIST_FUNC (LList llist_sort (LList self, llist_cmpfn cmp),
                 LLIST_WHILE_HEAD (self, head)
                   llist_insert_prev (++n & 1 ? &left : &right, head);
 
-                llist_sort (&left, cmp);
-                llist_sort (&right, cmp);
+                llist_sort (&left, cmp, extra);
+                llist_sort (&right, cmp, extra);
 
                 while (!llist_is_empty (&left) && !llist_is_empty (&right))
-                  llist_insert_prev (self, cmp (left.next, right.next) < 0 ? left.next : right.next);
+                  llist_insert_prev (self, cmp (left.next, right.next, extra) < 0 ? left.next : right.next);
 
                 if (!llist_is_empty (&left))
                   llist_insertlist_prev (self, &left);
@@ -573,13 +584,13 @@ LLIST_FUNC (LList llist_sort (LList self, llist_cmpfn cmp),
  * Does not change the list order.
  * @param self list to be searched
  * @param templ template for the element being searched
- * @param cmp function taking 2 LLists
- * @return pointer to the found LList element or NULL if nothing foound
+ * @param cmp function for comparing 2 nodes
+ * @return pointer to the found LList element or NULL if nothing found
  */
-LLIST_FUNC (LList llist_find (const_LList self, const_LList templ, llist_cmpfn cmp),
+LLIST_FUNC (LList llist_find (const_LList self, const_LList templ, llist_cmpfn cmp, void* extra),
             LLIST_FOREACH(self, node)
             {
-              if (!cmp (node, templ))
+              if (!cmp (node, templ, extra))
                 return node;
             }
             return NULL;
@@ -592,15 +603,16 @@ LLIST_FUNC (LList llist_find (const_LList self, const_LList templ, llist_cmpfn c
  * Useful if the order of the list is not required and few elements are frequently searched.
  * @param self list to be searched
  * @param templ template for the element being searched
- * @param cmp function taking 2 LLists
- * @return pointer to the found LList element (head) or NULL if nothing foound
+ * @param cmp function for comparing 2 nodes
+ * @return pointer to the found LList element (head) or NULL if nothing found
  */
-LLIST_FUNC (LList llist_ufind (LList self, const_LList templ, llist_cmpfn cmp),
+LLIST_FUNC (LList llist_ufind (LList self, const_LList templ, llist_cmpfn cmp, void* extra),
             LLIST_FOREACH(self, node)
             {
-              if (!cmp (node, templ))
+              if (!cmp (node, templ, extra))
                 {
-                  llist_insert_next (self, node);
+                  if (llist_next(self) != node)
+                    llist_insert_next (self, node);
                   return node;
                 }
             }
@@ -614,13 +626,13 @@ LLIST_FUNC (LList llist_ufind (LList self, const_LList templ, llist_cmpfn cmp),
  * biggier than the searched one.
  * @param self list to be searched
  * @param templ template for the element being searched
- * @param cmp function takeing 2 LLists
+ * @param cmp function for comparing 2 nodes
  * @return pointer to the found LList element or NULL if nothing foound
  */
-LLIST_FUNC (LList llist_sfind (const_LList self, const_LList templ, llist_cmpfn cmp),
+LLIST_FUNC (LList llist_sfind (const_LList self, const_LList templ, llist_cmpfn cmp, void* extra),
             LLIST_FOREACH(self, node)
             {
-              int c = cmp (node, templ);
+              int c = cmp (node, templ, extra);
               if (!c)
                 return node;
               else if (c>0)

From a115759128a9c4cef65fe6fee3d54c0d352d3f7d Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sun, 25 Jan 2009 14:39:18 +0100
Subject: [PATCH 049/368] new mutex and recmutex implementation (breaks
 sync.hpp for now)

prepares that chained sections if different kinds can be mixed
makes recmutexes typesafe
improves nobug tracking
---
 src/common/interfaceregistry.c |   4 +-
 src/common/interfaceregistry.h |   4 +-
 src/lib/Makefile.am            |   1 +
 src/lib/mutex.c                |  39 ++----
 src/lib/mutex.h                | 244 +++++++++++++++------------------
 src/lib/recmutex.c             |  74 ++++++++++
 src/lib/sectionlock.h          |  83 +++++++++++
 src/lib/sync.hpp               |  42 +++---
 tests/15locking.tests          |   8 +-
 tests/library/test-locking.c   |  34 ++++-
 10 files changed, 343 insertions(+), 190 deletions(-)
 create mode 100644 src/lib/recmutex.c
 create mode 100644 src/lib/sectionlock.h

diff --git a/src/common/interfaceregistry.c b/src/common/interfaceregistry.c
index ad8bd8224..5b0db98e7 100644
--- a/src/common/interfaceregistry.c
+++ b/src/common/interfaceregistry.c
@@ -47,7 +47,7 @@
 
 PSplay lumiera_interfaceregistry;
 PSplay lumiera_pluginregistry;
-lumiera_mutex lumiera_interface_mutex;
+lumiera_recmutex lumiera_interface_mutex;
 
 static int
 lumiera_interface_cmp_fn (const void* keya, const void* keyb);
@@ -126,7 +126,7 @@ lumiera_interfaceregistry_destroy (void)
     psplay_delete (lumiera_pluginregistry);
   lumiera_pluginregistry = NULL;
 
-  lumiera_mutex_destroy (&lumiera_interface_mutex, &NOBUG_FLAG(mutex_dbg));
+  lumiera_recmutex_destroy (&lumiera_interface_mutex, &NOBUG_FLAG(mutex_dbg));
 
   REQUIRE (!psplay_nelements (lumiera_interfaceregistry), "some interfaces still registered at shutdown");
 
diff --git a/src/common/interfaceregistry.h b/src/common/interfaceregistry.h
index 8adc46313..0ec20f29c 100644
--- a/src/common/interfaceregistry.h
+++ b/src/common/interfaceregistry.h
@@ -42,7 +42,7 @@
 //NOBUG_DECLARE_FLAG (interface);
 
 extern PSplay lumiera_interfaceregistry;
-extern lumiera_mutex lumiera_interface_mutex;
+extern lumiera_recmutex lumiera_interface_mutex;
 
 
 /**
@@ -75,8 +75,6 @@ struct lumiera_interfacenode_struct
   LumieraInterfacenode* deps;
 };
 
-extern lumiera_mutex lumiera_interface_mutex;
-
 
 /**
  * Initialize the interface registry
diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index cb1451c4f..0163d0c4c 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -25,6 +25,7 @@ liblumiera_la_SOURCES =						\
 	$(liblumiera_la_srcdir)/error.c				\
 	$(liblumiera_la_srcdir)/exception.cpp 			\
 	$(liblumiera_la_srcdir)/mutex.c				\
+	$(liblumiera_la_srcdir)/recmutex.c			\
 	$(liblumiera_la_srcdir)/rwlock.c			\
 	$(liblumiera_la_srcdir)/condition.c			\
 	$(liblumiera_la_srcdir)/reccondition.c			\
diff --git a/src/lib/mutex.c b/src/lib/mutex.c
index 60078671d..d6961982d 100644
--- a/src/lib/mutex.c
+++ b/src/lib/mutex.c
@@ -26,9 +26,9 @@
  * Mutual exclusion locking.
  */
 
-LUMIERA_ERROR_DEFINE (MUTEX_LOCK, "Mutex locking failed");
-LUMIERA_ERROR_DEFINE (MUTEX_UNLOCK, "Mutex unlocking failed");
-LUMIERA_ERROR_DEFINE (MUTEX_DESTROY, "Mutex destroy failed");
+LUMIERA_ERROR_DEFINE (LOCK_ACQUIRE, "locking failed");
+LUMIERA_ERROR_DEFINE (LOCK_RELEASE, "unlocking failed");
+LUMIERA_ERROR_DEFINE (LOCK_DESTROY, "lock destroy failed");
 
 
 LumieraMutex
@@ -44,32 +44,6 @@ lumiera_mutex_init (LumieraMutex self, const char* purpose, struct nobug_flag* f
 }
 
 
-static pthread_once_t recursive_mutexattr_once = PTHREAD_ONCE_INIT;
-static pthread_mutexattr_t recursive_mutexattr;
-
-static void recursive_mutexattr_init()
-{
-  pthread_mutexattr_init (&recursive_mutexattr);
-  pthread_mutexattr_settype (&recursive_mutexattr, PTHREAD_MUTEX_RECURSIVE);
-}
-
-
-LumieraMutex
-lumiera_recmutex_init (LumieraMutex self, const char* purpose, struct nobug_flag* flag)
-{
-  if (self)
-    {
-      if (recursive_mutexattr_once == PTHREAD_ONCE_INIT)
-        pthread_once (&recursive_mutexattr_once, recursive_mutexattr_init);
-
-      pthread_mutex_init (&self->mutex, &recursive_mutexattr);
-      NOBUG_RESOURCE_HANDLE_INIT (self->rh);
-      NOBUG_RESOURCE_ANNOUNCE_RAW (flag, "recmutex", purpose, self, self->rh);
-    }
-  return self;
-}
-
-
 LumieraMutex
 lumiera_mutex_destroy (LumieraMutex self, struct nobug_flag* flag)
 {
@@ -77,11 +51,16 @@ lumiera_mutex_destroy (LumieraMutex self, struct nobug_flag* flag)
     {
       NOBUG_RESOURCE_FORGET_RAW (flag,  self->rh);
       if (pthread_mutex_destroy (&self->mutex))
-        LUMIERA_DIE (MUTEX_DESTROY);
+        LUMIERA_DIE (LOCK_DESTROY);
     }
   return self;
 }
 
+int lumiera_mutex_unlock_cb (void* mutex)
+{
+  return pthread_mutex_unlock ((pthread_mutex_t*) mutex);
+}
+
 /*
 // Local Variables:
 // mode: C
diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index 0ab5b43c2..378fe00f1 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -23,6 +23,7 @@
 #define LUMIERA_MUTEX_H
 
 #include "lib/error.h"
+#include "lib/sectionlock.h"
 
 #include <pthread.h>
 #include <nobug.h>
@@ -32,35 +33,30 @@
  * Mutual exclusion locking, header.
  */
 
-LUMIERA_ERROR_DECLARE (MUTEX_LOCK);
-LUMIERA_ERROR_DECLARE (MUTEX_UNLOCK);
-LUMIERA_ERROR_DECLARE (MUTEX_DESTROY);
 
 /**
  * Mutual exclusive section.
  */
-#define LUMIERA_MUTEX_SECTION(nobugflag, mtx)                                                           \
-  for (lumiera_mutexacquirer NOBUG_CLEANUP(lumiera_mutexacquirer_ensureunlocked) lumiera_mutex_section_ \
-         = {(LumieraMutex)1 NOBUG_ALPHA_COMMA_NULL};                                                    \
-       lumiera_mutex_section_.mutex;)                                                                   \
-    for (                                                                                               \
-         ({                                                                                             \
-           lumiera_mutex_section_.mutex = (mtx);                                                        \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_mutex_section_.rh);                                      \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_mutex_section_,              \
-                           NOBUG_RESOURCE_EXCLUSIVE, lumiera_mutex_section_.rh);                        \
-           if (pthread_mutex_lock (&(mtx)->mutex)) LUMIERA_DIE (MUTEX_LOCK);                            \
-         });                                                                                            \
-         lumiera_mutex_section_.mutex;                                                                  \
-         ({                                                                                             \
-           if (lumiera_mutex_section_.mutex)                                                            \
-             {                                                                                          \
-               pthread_mutex_unlock (&lumiera_mutex_section_.mutex->mutex);                             \
-               lumiera_mutex_section_.mutex = NULL;                                                     \
-               RESOURCE_LEAVE(nobugflag, lumiera_mutex_section_.rh);                                    \
-             }                                                                                          \
+#define LUMIERA_MUTEX_SECTION(nobugflag, mtx)                                                   \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
+         lumiera_lock_section_ = {                                                              \
+         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(mtx)->mutex;                                          \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
          }))
 
+
 /**
  * Mutual exclusion chainbuilder section.
  * Usage: LUMIERA_MUTEX_SECTION(a){LUMIERA_MUTEX_SECTION_CHAIN(b){run();}}
@@ -68,99 +64,81 @@ LUMIERA_ERROR_DECLARE (MUTEX_DESTROY);
  * This macro should only be used inside LUMIERA_MUTEX_SECTION and should be
  * called on the correct mutexes, period.
  */
-#define LUMIERA_MUTEX_SECTION_CHAIN(nobugflag, mtx)                                                     \
-  for (lumiera_mutexacquirer *lumiera_mutex_section_old_ = &lumiera_mutex_section_,                     \
-         NOBUG_CLEANUP(lumiera_mutexacquirer_ensureunlocked) lumiera_mutex_section_ = {(LumieraMutex)1  \
-           NOBUG_ALPHA_COMMA_NULL};                                                                     \
-       lumiera_mutex_section_.mutex;)                                                                   \
-    for (                                                                                               \
-         ({                                                                                             \
-           lumiera_mutex_section_.mutex = (mtx);                                                        \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_mutex_section_.rh);                                      \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_mutex_section_,              \
-                           NOBUG_RESOURCE_EXCLUSIVE, lumiera_mutex_section_.rh);                        \
-           if (pthread_mutex_lock (&(mtx)->mutex)) LUMIERA_DIE (MUTEX_LOCK);                            \
-           if (lumiera_mutex_section_old_->mutex)                                                       \
-             {                                                                                          \
-               pthread_mutex_unlock (&lumiera_mutex_section_old_->mutex->mutex);                        \
-               lumiera_mutex_section_old_->mutex = NULL;                                                \
-               RESOURCE_LEAVE(nobugflag, lumiera_mutex_section_old_->rh);                               \
-             }                                                                                          \
-         });                                                                                            \
-         lumiera_mutex_section_.mutex;                                                                  \
-         ({                                                                                             \
-           if (lumiera_mutex_section_.mutex)                                                            \
-             {                                                                                          \
-               pthread_mutex_unlock (&lumiera_mutex_section_.mutex->mutex);                             \
-               lumiera_mutex_section_.mutex = NULL;                                                     \
-               RESOURCE_LEAVE(nobugflag, lumiera_mutex_section_.rh);                                    \
-             }                                                                                          \
+
+#define LUMIERA_MUTEX_SECTION_CHAIN(nobugflag, mtx)                                             \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_lock_section_ = {            \
+         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(mtx)->mutex;                                          \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
          }))
 
 
+#define LUMIERA_MUTEX_SECTION_UNLOCK            \
+  LUMIERA_SECTION_UNLOCK_(&lumiera_lock_section_)
+
+
 /**
  * Recursive Mutual exclusive section.
  */
-#define LUMIERA_RECMUTEX_SECTION(nobugflag, mtx)                                                        \
-  for (lumiera_mutexacquirer NOBUG_CLEANUP(lumiera_mutexacquirer_ensureunlocked) lumiera_mutex_section_ \
-         = {(LumieraMutex)1 NOBUG_ALPHA_COMMA_NULL};                                                    \
-       lumiera_mutex_section_.mutex;)                                                                   \
-    for (                                                                                               \
-         ({                                                                                             \
-           lumiera_mutex_section_.mutex = (mtx);                                                        \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_mutex_section_.rh);                                      \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_mutex_section_,           \
-                           NOBUG_RESOURCE_RECURSIVE, lumiera_mutex_section_.rh);                        \
-           if (pthread_mutex_lock (&(mtx)->mutex)) LUMIERA_DIE (MUTEX_LOCK);                            \
-         });                                                                                            \
-         lumiera_mutex_section_.mutex;                                                                  \
-         ({                                                                                             \
-           if (lumiera_mutex_section_.mutex)                                                            \
-             {                                                                                          \
-               pthread_mutex_unlock (&lumiera_mutex_section_.mutex->mutex);                             \
-               lumiera_mutex_section_.mutex = NULL;                                                     \
-               RESOURCE_LEAVE(nobugflag, lumiera_mutex_section_.rh);                                    \
-             }                                                                                          \
+#define LUMIERA_RECMUTEX_SECTION(nobugflag, mtx)                                                \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
+         lumiera_lock_section_ = {                                                              \
+         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(mtx)->recmutex;                                       \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
          }))
 
 
-/**
- * Mutual exclusion chainbuilder section.
- * Usage: LUMIERA_MUTEX_SECTION(a){LUMIERA_RECMUTEX_SECTION_CHAIN(b){run();}}
- *     calls lock(a); lock(b); unlock(a); run(); unlock(b);
- * This macro should only be used inside LUMIERA_MUTEX_SECTION and should be
- * called on the correct mutexes, period.
- */
-#define LUMIERA_RECMUTEX_SECTION_CHAIN(nobugflag, mtx)                                                  \
-  for (lumiera_mutexacquirer *lumiera_mutex_section_old_ = &lumiera_mutex_section_,                     \
-         NOBUG_CLEANUP(lumiera_mutexacquirer_ensureunlocked) lumiera_mutex_section_ = {(LumieraMutex)1  \
-           NOBUG_ALPHA_COMMA_NULL};                                                                     \
-       lumiera_mutex_section_.mutex;)                                                                   \
-    for (                                                                                               \
-         ({                                                                                             \
-           lumiera_mutex_section_.mutex = (mtx);                                                        \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_mutex_section_.rh);                                      \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_mutex_section_,           \
-                           NOBUG_RESOURCE_RECURSIVE, lumiera_mutex_section_.rh);                        \
-           if (pthread_mutex_lock (&(mtx)->mutex)) LUMIERA_DIE (MUTEX_LOCK);                            \
-           if (lumiera_mutex_section_old_->mutex)                                                       \
-             {                                                                                          \
-               pthread_mutex_unlock (&lumiera_mutex_section_old_->mutex->mutex);                        \
-               lumiera_mutex_section_old_->mutex = NULL;                                                \
-               RESOURCE_LEAVE(nobugflag, lumiera_mutex_section_old_->rh);                               \
-             }                                                                                          \
-         });                                                                                            \
-         lumiera_mutex_section_.mutex;                                                                  \
-         ({                                                                                             \
-           if (lumiera_mutex_section_.mutex)                                                            \
-             {                                                                                          \
-               pthread_mutex_unlock (&lumiera_mutex_section_.mutex->mutex);                             \
-               lumiera_mutex_section_.mutex = NULL;                                                     \
-               RESOURCE_LEAVE(nobugflag, lumiera_mutex_section_.rh);                                    \
-             }                                                                                          \
+#define LUMIERA_RECMUTEX_SECTION_CHAIN(nobugflag, mtx)                                          \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_lock_section_ = {            \
+         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(mtx)->recmutex;                                       \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_recursive, lumiera_lock_section_.rh);      \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                   \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
          }))
 
 
+#define LUMIERA_RECMUTEX_SECTION_UNLOCK            \
+  LUMIERA_SECTION_UNLOCK_(&lumiera_lock_section_)
+
+
+
 /**
  * Mutex.
  *
@@ -173,6 +151,14 @@ struct lumiera_mutex_struct
 typedef struct lumiera_mutex_struct lumiera_mutex;
 typedef lumiera_mutex* LumieraMutex;
 
+struct lumiera_recmutex_struct
+{
+  pthread_mutex_t recmutex;
+  RESOURCE_HANDLE (rh);
+};
+typedef struct lumiera_recmutex_struct lumiera_recmutex;
+typedef lumiera_recmutex* LumieraRecMutex;
+
 
 /**
  * Initialize a mutex variable
@@ -183,16 +169,6 @@ typedef lumiera_mutex* LumieraMutex;
 LumieraMutex
 lumiera_mutex_init (LumieraMutex self, const char* purpose, struct nobug_flag* flag);
 
-/**
- * Initialize a mutex variable
- * Initializes a 'recursive' mutex which might be locked by the same thread multiple times.
- * @param self is a pointer to the mutex to be initialized
- * @return self as given
- */
-LumieraMutex
-lumiera_recmutex_init (LumieraMutex self, const char* purpose, struct nobug_flag* flag);
-
-
 /**
  * Destroy a mutex variable
  * @param self is a pointer to the mutex to be destroyed
@@ -202,23 +178,31 @@ LumieraMutex
 lumiera_mutex_destroy (LumieraMutex self, struct nobug_flag* flag);
 
 
-/**
- * mutexacquirer used to manage the state of a mutex.
- */
-struct lumiera_mutexacquirer_struct
-{
-  LumieraMutex mutex;
-  RESOURCE_HANDLE (rh);
-};
-typedef struct lumiera_mutexacquirer_struct lumiera_mutexacquirer;
-typedef struct lumiera_mutexacquirer_struct* LumieraMutexacquirer;
 
-/* helper function for nobug */
-static inline void
-lumiera_mutexacquirer_ensureunlocked (LumieraMutexacquirer self)
-{
-  ENSURE (!self->mutex, "forgot to unlock mutex");
-}
+/**
+ * Initialize a recursive mutex variable
+ * Initializes a 'recursive' mutex which might be locked by the same thread multiple times.
+ * @param self is a pointer to the mutex to be initialized
+ * @return self as given
+ */
+LumieraRecMutex
+lumiera_recmutex_init (LumieraRecMutex self, const char* purpose, struct nobug_flag* flag);
+
+/**
+ * Destroy a recursive mutex variable
+ * @param self is a pointer to the mutex to be destroyed
+ * @return self as given
+ */
+LumieraRecMutex
+lumiera_recmutex_destroy (LumieraRecMutex self, struct nobug_flag* flag);
+
+/**
+ * Callback for unlocking mutexes.
+ * @internal
+ */
+int
+lumiera_mutex_unlock_cb (void* mutex);
+
 
 #endif
 /*
diff --git a/src/lib/recmutex.c b/src/lib/recmutex.c
new file mode 100644
index 000000000..b8a381e6f
--- /dev/null
+++ b/src/lib/recmutex.c
@@ -0,0 +1,74 @@
+/*
+  recmutex.c  -  recursive mutex
+
+  Copyright (C)         Lumiera.org
+    2008, 2009,         Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#include "lib/mutex.h"
+
+/**
+ * @file
+ * Recursive Mutexes.
+ */
+
+
+static pthread_once_t recmutexattr_once = PTHREAD_ONCE_INIT;
+static pthread_mutexattr_t recmutexattr;
+
+static void recmutexattr_init()
+{
+  pthread_mutexattr_init (&recmutexattr);
+  pthread_mutexattr_settype (&recmutexattr, PTHREAD_MUTEX_RECURSIVE);
+}
+
+
+LumieraRecMutex
+lumiera_recmutex_init (LumieraRecMutex self, const char* purpose, struct nobug_flag* flag)
+{
+  if (self)
+    {
+      if (recmutexattr_once == PTHREAD_ONCE_INIT)
+        pthread_once (&recmutexattr_once, recmutexattr_init);
+
+      pthread_mutex_init (&self->recmutex, &recmutexattr);
+      NOBUG_RESOURCE_HANDLE_INIT (self->rh);
+      NOBUG_RESOURCE_ANNOUNCE_RAW (flag, "recmutex", purpose, self, self->rh);
+    }
+  return self;
+}
+
+LumieraRecMutex
+lumiera_recmutex_destroy (LumieraRecMutex self, struct nobug_flag* flag)
+{
+  if (self)
+    {
+      NOBUG_RESOURCE_FORGET_RAW (flag,  self->rh);
+      if (pthread_mutex_destroy (&self->recmutex))
+        LUMIERA_DIE (LOCK_DESTROY);
+    }
+  return self;
+}
+
+
+/*
+// Local Variables:
+// mode: C
+// c-file-style: "gnu"
+// indent-tabs-mode: nil
+// End:
+*/
diff --git a/src/lib/sectionlock.h b/src/lib/sectionlock.h
new file mode 100644
index 000000000..0bc4d80fb
--- /dev/null
+++ b/src/lib/sectionlock.h
@@ -0,0 +1,83 @@
+/*
+  sectionlock.h  -  mutex state handle
+
+  Copyright (C)         Lumiera.org
+    2008,               Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#ifndef LUMIERA_SECTIONLOCK_H
+#define LUMIERA_SECTIONLOCK_H
+
+#include "lib/error.h"
+
+#include <pthread.h>
+#include <nobug.h>
+
+LUMIERA_ERROR_DECLARE (LOCK_ACQUIRE);
+LUMIERA_ERROR_DECLARE (LOCK_RELEASE);
+LUMIERA_ERROR_DECLARE (LOCK_DESTROY);
+
+
+typedef int (*lumiera_sectionlock_unlock_fn)(void*);
+
+/**
+ * sectionlock used to manage the state of mutexes.
+ */
+struct lumiera_sectionlock_struct
+{
+  void* lock;
+  lumiera_sectionlock_unlock_fn unlock;
+  NOBUG_IF_ALPHA(struct nobug_flag* flag);
+  RESOURCE_HANDLE (rh);
+};
+typedef struct lumiera_sectionlock_struct lumiera_sectionlock;
+typedef struct lumiera_sectionlock_struct* LumieraSectionlock;
+
+/* helper function for nobug */
+static inline void
+lumiera_sectionlock_ensureunlocked (LumieraSectionlock self)
+{
+  ENSURE (!self->lock, "forgot to unlock");
+}
+
+
+
+/**
+ * Unlock the lock hold in a SECTION
+ * @internal
+ * @param sectionname name used for the sectionlock instance
+ * @param ... some extra code to execute
+ */
+#define LUMIERA_SECTION_UNLOCK_(section, ...)                   \
+  do if ((section)->lock)                                       \
+    {                                                           \
+      if ((section)->unlock((section)->lock))                   \
+        LUMIERA_DIE (LOCK_RELEASE);                             \
+      (section)->lock = NULL;                                   \
+      __VA_ARGS__;                                              \
+      NOBUG_RESOURCE_LEAVE_RAW((section)->flag, (section)->rh); \
+    } while (0)
+
+
+#endif
+/*
+// Local Variables:
+// mode: C
+// c-file-style: "gnu"
+// indent-tabs-mode: nil
+// End:
+*/
diff --git a/src/lib/sync.hpp b/src/lib/sync.hpp
index 6515f35b9..e4fcb850a 100644
--- a/src/lib/sync.hpp
+++ b/src/lib/sync.hpp
@@ -102,21 +102,21 @@ namespace lib {
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __leave()     { TODO ("Record we are releasing the mutex"); }
+         void __left()     { TODO ("Record we are released the mutex"); }
         };
       
       
       struct Wrapped_LumieraRecMutex
-        : public lumiera_mutex
+        : public lumiera_recmutex
         {
         protected:
           Wrapped_LumieraRecMutex() { lumiera_recmutex_init (this, "Obj.Monitor RecMutex", &NOBUG_FLAG(sync)); }
-         ~Wrapped_LumieraRecMutex() { lumiera_mutex_destroy (this, &NOBUG_FLAG(sync)); }
+         ~Wrapped_LumieraRecMutex() { lumiera_recmutex_destroy (this, &NOBUG_FLAG(sync)); }
          
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __leave()     { TODO ("Record we are releasing the mutex"); }
+         void __left()     { TODO ("Record we are released the mutex"); }
         };
       
       
@@ -130,7 +130,7 @@ namespace lib {
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __leave()     { TODO ("Record we are releasing the mutex"); }
+         void __left()     { TODO ("Record we are released the mutex"); }
         };
       
       
@@ -144,7 +144,7 @@ namespace lib {
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __leave()     { TODO ("Record we are releasing the mutex"); }
+         void __left()     { TODO ("Record we are released the mutex"); }
         };
       
       
@@ -156,10 +156,10 @@ namespace lib {
         : protected MTX
         {
         protected:
-          using MTX::mutex;
+          //using MTX::mutex;
           using MTX::__may_block;
           using MTX::__enter;
-          using MTX::__leave;
+          using MTX::__left;
           
          ~Mutex () { }
           Mutex () { }
@@ -171,19 +171,22 @@ namespace lib {
             acquire()
               {
                 __may_block();
-                
-                if (pthread_mutex_lock (&mutex))
-                  throw lumiera::error::State("Mutex acquire failed.");  ///////TODO capture the error-code
-                
+
+                FIXME ("For to make C typesafe we have now mutex and recmutex member gnah :P -- cehteh");
+                // well .. specialization on the mutex type shall solve it ...
+                //if (pthread_mutex_lock (&mutex))
+                //  throw lumiera::error::State("Mutex acquire failed.");  ///////TODO capture the error-code
+
                 __enter();
               }
             
             void
             release()
-              { 
-                __leave();
-                
-                pthread_mutex_unlock (&mutex);
+              {
+                FIXME ("For to make C typesafe we have now mutex and recmutex member gnah :P -- cehteh");
+                //pthread_mutex_unlock (&mutex);
+
+                __left();
               }
             
         };
@@ -436,3 +439,10 @@ namespace lib {
   
 } // namespace lumiera
 #endif
+/*
+// Local Variables:
+// mode: C
+// c-file-style: "gnu"
+// indent-tabs-mode: nil
+// End:
+*/
diff --git a/tests/15locking.tests b/tests/15locking.tests
index 061a2da56..81387ac8e 100644
--- a/tests/15locking.tests
+++ b/tests/15locking.tests
@@ -11,6 +11,10 @@ TEST "mutex not unlocked asserts" mutexforgotunlock <<END
 return: 134
 END
 
+TEST "mutex explicitly unlocked" mutexexplicitunlock <<END
+return: 0
+END
+
 
 TEST "nested mutex section" nestedmutexsection <<END
 out: outer mutex locked section
@@ -25,8 +29,8 @@ END
 
 
 TEST "recursive mutex section" recursivemutexsection <<END
-out: mutex locked once
-out: mutex locked twice
+out: recmutex locked once
+out: recmutex locked twice
 END
 
 
diff --git a/tests/library/test-locking.c b/tests/library/test-locking.c
index aa2f6312c..f65ec8848 100644
--- a/tests/library/test-locking.c
+++ b/tests/library/test-locking.c
@@ -63,6 +63,22 @@ TEST ("mutexforgotunlock")
 }
 
 
+TEST ("mutexexplicitunlock")
+{
+  lumiera_mutex m;
+  lumiera_mutex_init (&m, "mutexforgotunlock", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_MUTEX_SECTION (NOBUG_ON, &m)
+    {
+      ECHO("mutex locked section");
+      LUMIERA_MUTEX_SECTION_UNLOCK;
+      break;
+    }
+
+  lumiera_mutex_destroy (&m, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
 TEST ("nestedmutexsection")
 {
   lumiera_mutex m;
@@ -107,25 +123,29 @@ TEST ("chainedmutexsection")
   lumiera_mutex_destroy (&m, &NOBUG_FLAG(NOBUG_ON));
 }
 
+
+
 TEST ("recursivemutexsection")
 {
-  lumiera_mutex m;
-  lumiera_recmutex_init (&m, "m_mutexsection", &NOBUG_FLAG(NOBUG_ON));
+  lumiera_recmutex m;
+  lumiera_recmutex_init (&m, "m_recmutexsection", &NOBUG_FLAG(NOBUG_ON));
 
 
-  LUMIERA_MUTEX_SECTION (NOBUG_ON, &m)
+  LUMIERA_RECMUTEX_SECTION (NOBUG_ON, &m)
     {
-      printf ("mutex locked once\n");
+      printf ("recmutex locked once\n");
 
-      LUMIERA_MUTEX_SECTION (NOBUG_ON, &m)
+      LUMIERA_RECMUTEX_SECTION (NOBUG_ON, &m)
         {
-          printf ("mutex locked twice\n");
+          printf ("recmutex locked twice\n");
         }
     }
 
- lumiera_mutex_destroy (&m, &NOBUG_FLAG(NOBUG_ON));
+ lumiera_recmutex_destroy (&m, &NOBUG_FLAG(NOBUG_ON));
 }
 
+
+
 TEST ("rwlocksection")
 {
   lumiera_rwlock rwlock;

From cf664ca970db40f1fcb4ecfb2807caa48fd4a019 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 26 Jan 2009 04:21:58 +0100
Subject: [PATCH 050/368] fix: forgotten backcasts in mutex.h

---
 src/lib/mutex.h | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index 378fe00f1..901a885ba 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -48,7 +48,8 @@
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
          });                                                                                    \
          lumiera_lock_section_.lock;                                                            \
@@ -76,7 +77,8 @@
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
          });                                                                                    \
@@ -104,7 +106,8 @@
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
          });                                                                                    \
          lumiera_lock_section_.lock;                                                            \
@@ -124,7 +127,8 @@
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock (lumiera_lock_section_.lock)) LUMIERA_DIE (LOCK_ACQUIRE);     \
+           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_recursive, lumiera_lock_section_.rh);      \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                   \
          });                                                                                    \

From ca0250c0184c62d26f9fd9290897e1f70c97514d Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 26 Jan 2009 07:28:07 +0100
Subject: [PATCH 051/368] error code changed to LOCK_DESTROY

---
 src/lib/reccondition.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/reccondition.c b/src/lib/reccondition.c
index 66000e7e1..b70f8d179 100644
--- a/src/lib/reccondition.c
+++ b/src/lib/reccondition.c
@@ -64,7 +64,7 @@ lumiera_reccondition_destroy (LumieraReccondition self, struct nobug_flag* flag)
       NOBUG_RESOURCE_FORGET_RAW (flag,  self->rh);
 
       if (pthread_mutex_destroy (&self->mutex))
-        LUMIERA_DIE (MUTEX_DESTROY);
+        LUMIERA_DIE (LOCK_DESTROY);
 
       if (pthread_cond_destroy (&self->cond))
         LUMIERA_DIE (CONDITION_DESTROY);

From 5c2ac96f354c2aa6c0f5d75d3b5c3795f6a239ca Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 26 Jan 2009 07:30:20 +0100
Subject: [PATCH 052/368] rwlock makeover, locksections etc...

The CHAINED variant is not tested, what could go wrong anyways :)
---
 src/lib/rwlock.c             |   6 ++
 src/lib/rwlock.h             | 149 +++++++++++++++++++++--------------
 tests/15locking.tests        |   9 +++
 tests/library/test-locking.c |  39 +++++++++
 4 files changed, 145 insertions(+), 58 deletions(-)

diff --git a/src/lib/rwlock.c b/src/lib/rwlock.c
index c5287d535..3242591c5 100644
--- a/src/lib/rwlock.c
+++ b/src/lib/rwlock.c
@@ -60,6 +60,12 @@ lumiera_rwlock_destroy (LumieraRWLock self, struct nobug_flag* flag)
   return self;
 }
 
+
+int lumiera_rwlock_unlock_cb (void* rwlock)
+{
+  return pthread_rwlock_unlock ((pthread_rwlock_t*) rwlock);
+}
+
 /*
 // Local Variables:
 // mode: C
diff --git a/src/lib/rwlock.h b/src/lib/rwlock.h
index 23376979b..a6b32d264 100644
--- a/src/lib/rwlock.h
+++ b/src/lib/rwlock.h
@@ -45,53 +45,104 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
 /**
  * Read locked section.
  */
-#define LUMIERA_RDLOCK_SECTION(nobugflag, rwlck)                                                                                        \
-  for (lumiera_rwlockacquirer NOBUG_CLEANUP(lumiera_rwlockacquirer_ensureunlocked) lumiera_rwlock_section_ = {(LumieraRWLock)1};        \
-       lumiera_rwlock_section_.rwlock;)                                                                                                 \
-    for (                                                                                                                               \
-         ({                                                                                                                             \
-           lumiera_rwlock_section_.rwlock = (rwlck);                                                                                    \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_rwlock_section_.rh);                                                                     \
-           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire rwlock for reading", &lumiera_rwlock_section_,                              \
-                           NOBUG_RESOURCE_EXCLUSIVE, lumiera_rwlock_section_.rh);                                                       \
-           if (pthread_rwlock_rdlock (&(rwlck)->rwlock)) LUMIERA_DIE (RWLOCK_RDLOCK);                                                   \
-         });                                                                                                                            \
-         lumiera_rwlock_section_.rwlock;                                                                                                \
-         ({                                                                                                                             \
-           if (lumiera_rwlock_section_.rwlock)                                                                                          \
-             {                                                                                                                          \
-               pthread_rwlock_unlock (&lumiera_rwlock_section_.rwlock->rwlock);                                                         \
-               lumiera_rwlock_section_.rwlock = NULL;                                                                                   \
-               RESOURCE_LEAVE(nobugflag, lumiera_rwlock_section_.rh);                                                                   \
-             }                                                                                                                          \
+#define LUMIERA_RDLOCK_SECTION(nobugflag, rwlck)                                                \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
+         lumiera_lock_section_ = {                                                              \
+         (void*)1, lumiera_rwlock_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};     \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+             RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock",                        \
+                             &lumiera_lock_section_, NOBUG_RESOURCE_WAITING,                    \
+                             lumiera_lock_section_.rh);                                         \
+           if (pthread_rwlock_rdlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           TODO ("implement NOBUG_RESOURCE_SHARED");                                            \
+           /*RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_SHARED, lumiera_lock_section_.rh); */ \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_RWLOCK_SECTION_UNLOCK;                                                       \
          }))
 
 
+#define LUMIERA_RDLOCK_SECTION_CHAIN(nobugflag, rwlck)                                          \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_lock_section_ = {            \
+         (void*)1, lumiera_rwlock_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};     \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock", &lumiera_lock_section_,  \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_rwlock_rdlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           /*RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_SHARED, lumiera_lock_section_.rh); */ \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
+         }))
+
+
+
+
 /**
  * Write locked section.
  */
-#define LUMIERA_WRLOCK_SECTION(nobugflag, rwlck)                                                                                        \
-  for (lumiera_rwlockacquirer NOBUG_CLEANUP(lumiera_rwlockacquirer_ensureunlocked) lumiera_rwlock_section_ = {(LumieraRWLock)1};        \
-       lumiera_rwlock_section_.rwlock;)                                                                                                 \
-    for (                                                                                                                               \
-         ({                                                                                                                             \
-           lumiera_rwlock_section_.rwlock = (rwlck);                                                                                    \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_rwlock_section_.rh);                                                                     \
-           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire rwlock for reading", &lumiera_rwlock_section_,                              \
-                           NOBUG_RESOURCE_EXCLUSIVE, lumiera_rwlock_section_.rh);                                                       \
-           if (pthread_rwlock_wrlock (&(rwlck)->rwlock)) LUMIERA_DIE (RWLOCK_WRLOCK);                                                   \
-         });                                                                                                                            \
-         lumiera_rwlock_section_.rwlock;                                                                                                \
-         ({                                                                                                                             \
-           if (lumiera_rwlock_section_.rwlock)                                                                                          \
-             {                                                                                                                          \
-               pthread_rwlock_unlock (&lumiera_rwlock_section_.rwlock->rwlock);                                                         \
-               lumiera_rwlock_section_.rwlock = NULL;                                                                                   \
-               RESOURCE_LEAVE(nobugflag, lumiera_rwlock_section_.rh);                                                                   \
-             }                                                                                                                          \
+#define LUMIERA_WRLOCK_SECTION(nobugflag, rwlck)                                                \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
+         lumiera_lock_section_ = {                                                              \
+         (void*)1, lumiera_rwlock_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};     \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+             RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock",                       \
+                             &lumiera_lock_section_, NOBUG_RESOURCE_WAITING,                    \
+                             lumiera_lock_section_.rh);                                         \
+           if (pthread_rwlock_wrlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_RWLOCK_SECTION_UNLOCK;                                                       \
          }))
 
 
+#define LUMIERA_WRLOCK_SECTION_CHAIN(nobugflag, rwlck)                                          \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_lock_section_ = {            \
+         (void*)1, lumiera_rwlock_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};     \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock", &lumiera_lock_section_, \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_rwlock_wrlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
+         }))
+
+
+#define LUMIERA_RWLOCK_SECTION_UNLOCK            \
+  LUMIERA_SECTION_UNLOCK_(&lumiera_lock_section_)
+
+
 /**
  * RWLock.
  *
@@ -121,26 +172,8 @@ LumieraRWLock
 lumiera_rwlock_destroy (LumieraRWLock self, struct nobug_flag* flag);
 
 
-
-
-
-/**
- * rwlockacquirer used to manage the state of a rwlock variable.
- */
-struct lumiera_rwlockacquirer_struct
-{
-  LumieraRWLock rwlock;
-  RESOURCE_HANDLE (rh);
-};
-typedef struct lumiera_rwlockacquirer_struct lumiera_rwlockacquirer;
-typedef struct lumiera_rwlockacquirer_struct* LumieraRWLockacquirer;
-
-/* helper function for nobug */
-static inline void
-lumiera_rwlockacquirer_ensureunlocked (LumieraRWLockacquirer self)
-{
-  ENSURE (!self->rwlock, "forgot to unlock rwlock");
-}
+int
+lumiera_rwlock_unlock_cb (void* rwlock);
 
 
 #endif
diff --git a/tests/15locking.tests b/tests/15locking.tests
index 81387ac8e..0fc57c233 100644
--- a/tests/15locking.tests
+++ b/tests/15locking.tests
@@ -45,6 +45,15 @@ return: 134
 END
 
 
+PLANNED "rwlock readlock in writelock asserts" rwlockdeadlockwr <<END
+return: 134
+END
+
+PLANNED "rwlock writelock in readlock asserts" rwlockdeadlockrw <<END
+return: 134
+END
+
+
 TEST "condition not unlocked asserts" conditionforgotunlock <<END
 return: 134
 END
diff --git a/tests/library/test-locking.c b/tests/library/test-locking.c
index f65ec8848..33ac2fccf 100644
--- a/tests/library/test-locking.c
+++ b/tests/library/test-locking.c
@@ -164,6 +164,7 @@ TEST ("rwlocksection")
   lumiera_rwlock_destroy (&rwlock, &NOBUG_FLAG(NOBUG_ON));
 }
 
+
 TEST ("rwlockforgotunlock")
 {
   lumiera_rwlock rwlock;
@@ -178,6 +179,44 @@ TEST ("rwlockforgotunlock")
 }
 
 
+
+TEST ("rwdeadlockwr")
+{
+  lumiera_rwlock rwlock;
+  lumiera_rwlock_init (&rwlock, "rwsection", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_WRLOCK_SECTION (NOBUG_ON, &rwlock)
+    {
+      printf ("write locked section 1\n");
+      LUMIERA_RDLOCK_SECTION (NOBUG_ON, &rwlock)
+        {
+          printf ("read locked section 2\n");
+        }
+    }
+
+  lumiera_rwlock_destroy (&rwlock, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
+
+TEST ("rwdeadlockrw")
+{
+  lumiera_rwlock rwlock;
+  lumiera_rwlock_init (&rwlock, "rwsection", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_RDLOCK_SECTION (NOBUG_ON, &rwlock)
+    {
+      printf ("read locked section 1\n");
+      LUMIERA_WRLOCK_SECTION (NOBUG_ON, &rwlock)
+        {
+          printf ("write locked section 2\n");
+        }
+    }
+
+  lumiera_rwlock_destroy (&rwlock, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
 TEST ("conditionsection")
 {
   lumiera_condition cond;

From cafcffd4b12b855cc2de891f5620ed0fd6f11cd7 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 26 Jan 2009 08:39:37 +0100
Subject: [PATCH 053/368] add check to chained locking validating that the
 parent lock is held

---
 src/lib/mutex.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index 901a885ba..a6943d5a5 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -73,6 +73,7 @@
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");            \
            lumiera_lock_section_.lock = &(mtx)->mutex;                                          \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
@@ -123,6 +124,7 @@
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
            lumiera_lock_section_.lock = &(mtx)->recmutex;                                       \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \

From 5b82f3355b8b98351992b50f84697c64af8e9501 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 26 Jan 2009 09:21:03 +0100
Subject: [PATCH 054/368] store a lumiera_mutex in a sectionlock, looks cleaner

---
 src/lib/mutex.c       |  2 +-
 src/lib/mutex.h       | 18 +++++++++---------
 src/lib/sectionlock.h |  3 +--
 3 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/src/lib/mutex.c b/src/lib/mutex.c
index d6961982d..c7d6df040 100644
--- a/src/lib/mutex.c
+++ b/src/lib/mutex.c
@@ -58,7 +58,7 @@ lumiera_mutex_destroy (LumieraMutex self, struct nobug_flag* flag)
 
 int lumiera_mutex_unlock_cb (void* mutex)
 {
-  return pthread_mutex_unlock ((pthread_mutex_t*) mutex);
+  return pthread_mutex_unlock (&((LumieraMutex)mutex)->mutex);
 }
 
 /*
diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index a6943d5a5..5708e19be 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -44,11 +44,11 @@
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           lumiera_lock_section_.lock = &(mtx)->mutex;                                          \
+           lumiera_lock_section_.lock = (mtx);                                                  \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+           if (pthread_mutex_lock (&(mtx)->mutex))                                              \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
          });                                                                                    \
@@ -73,12 +73,12 @@
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");            \
-           lumiera_lock_section_.lock = &(mtx)->mutex;                                          \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
+           lumiera_lock_section_.lock = mtx;                                                    \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+           if (pthread_mutex_lock (&(mtx)->mutex))                                              \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
@@ -103,11 +103,11 @@
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           lumiera_lock_section_.lock = &(mtx)->recmutex;                                       \
+           lumiera_lock_section_.lock = (mtx);                                                  \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+           if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
          });                                                                                    \
@@ -125,11 +125,11 @@
     for (                                                                                       \
          ({                                                                                     \
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
-           lumiera_lock_section_.lock = &(mtx)->recmutex;                                       \
+           lumiera_lock_section_.lock = (mtx);                                                  \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock ((pthread_mutex_t*)lumiera_lock_section_.lock))               \
+           if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_recursive, lumiera_lock_section_.rh);      \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                   \
diff --git a/src/lib/sectionlock.h b/src/lib/sectionlock.h
index 0bc4d80fb..c50ecfc8d 100644
--- a/src/lib/sectionlock.h
+++ b/src/lib/sectionlock.h
@@ -62,13 +62,12 @@ lumiera_sectionlock_ensureunlocked (LumieraSectionlock self)
  * @param sectionname name used for the sectionlock instance
  * @param ... some extra code to execute
  */
-#define LUMIERA_SECTION_UNLOCK_(section, ...)                   \
+#define LUMIERA_SECTION_UNLOCK_(section)                        \
   do if ((section)->lock)                                       \
     {                                                           \
       if ((section)->unlock((section)->lock))                   \
         LUMIERA_DIE (LOCK_RELEASE);                             \
       (section)->lock = NULL;                                   \
-      __VA_ARGS__;                                              \
       NOBUG_RESOURCE_LEAVE_RAW((section)->flag, (section)->rh); \
     } while (0)
 

From 93abe657c8cee09e3c0f17d049ab53e16310d949 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 26 Jan 2009 09:49:15 +0100
Subject: [PATCH 055/368] store lumiera_rwlock in sectionlock

---
 src/lib/rwlock.c |  2 +-
 src/lib/rwlock.h | 18 ++++++++++--------
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/src/lib/rwlock.c b/src/lib/rwlock.c
index 3242591c5..60929a458 100644
--- a/src/lib/rwlock.c
+++ b/src/lib/rwlock.c
@@ -63,7 +63,7 @@ lumiera_rwlock_destroy (LumieraRWLock self, struct nobug_flag* flag)
 
 int lumiera_rwlock_unlock_cb (void* rwlock)
 {
-  return pthread_rwlock_unlock ((pthread_rwlock_t*) rwlock);
+  return pthread_rwlock_unlock (&((LumieraRWLock)rwlock)->rwlock);
 }
 
 /*
diff --git a/src/lib/rwlock.h b/src/lib/rwlock.h
index a6b32d264..aa0814b37 100644
--- a/src/lib/rwlock.h
+++ b/src/lib/rwlock.h
@@ -52,12 +52,12 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
              RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock",                        \
                              &lumiera_lock_section_, NOBUG_RESOURCE_WAITING,                    \
                              lumiera_lock_section_.rh);                                         \
-           if (pthread_rwlock_rdlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+           if (pthread_rwlock_rdlock (&(rwlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            TODO ("implement NOBUG_RESOURCE_SHARED");                                            \
            /*RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_SHARED, lumiera_lock_section_.rh); */ \
@@ -75,11 +75,12 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
+           lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock", &lumiera_lock_section_,  \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_rwlock_rdlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+           if (pthread_rwlock_rdlock (&(rwlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            /*RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_SHARED, lumiera_lock_section_.rh); */ \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
@@ -102,12 +103,12 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
              RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock",                       \
                              &lumiera_lock_section_, NOBUG_RESOURCE_WAITING,                    \
                              lumiera_lock_section_.rh);                                         \
-           if (pthread_rwlock_wrlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+           if (pthread_rwlock_wrlock (&(rwlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
          });                                                                                    \
@@ -124,11 +125,12 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
        lumiera_lock_section_.lock;)                                                             \
     for (                                                                                       \
          ({                                                                                     \
-           lumiera_lock_section_.lock = &(rwlck)->rwlock;                                       \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
+           lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
            RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock", &lumiera_lock_section_, \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_rwlock_wrlock ((pthread_rwlock_t*)lumiera_lock_section_.lock))           \
+           if (pthread_rwlock_wrlock (&(twlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
            RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_lock_section_.rh);      \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \

From 30a117c1d838d564c44e0bc39b63f46adf5db8b2 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Tue, 27 Jan 2009 08:43:49 +0100
Subject: [PATCH 056/368] rename casing of RecMutex to Recmutex to be
 consistent

---
 src/lib/mutex.h    | 10 +++++-----
 src/lib/recmutex.c |  8 ++++----
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index 5708e19be..a3cd46fd9 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -163,7 +163,7 @@ struct lumiera_recmutex_struct
   RESOURCE_HANDLE (rh);
 };
 typedef struct lumiera_recmutex_struct lumiera_recmutex;
-typedef lumiera_recmutex* LumieraRecMutex;
+typedef lumiera_recmutex* LumieraRecmutex;
 
 
 /**
@@ -191,16 +191,16 @@ lumiera_mutex_destroy (LumieraMutex self, struct nobug_flag* flag);
  * @param self is a pointer to the mutex to be initialized
  * @return self as given
  */
-LumieraRecMutex
-lumiera_recmutex_init (LumieraRecMutex self, const char* purpose, struct nobug_flag* flag);
+LumieraRecmutex
+lumiera_recmutex_init (LumieraRecmutex self, const char* purpose, struct nobug_flag* flag);
 
 /**
  * Destroy a recursive mutex variable
  * @param self is a pointer to the mutex to be destroyed
  * @return self as given
  */
-LumieraRecMutex
-lumiera_recmutex_destroy (LumieraRecMutex self, struct nobug_flag* flag);
+LumieraRecmutex
+lumiera_recmutex_destroy (LumieraRecmutex self, struct nobug_flag* flag);
 
 /**
  * Callback for unlocking mutexes.
diff --git a/src/lib/recmutex.c b/src/lib/recmutex.c
index b8a381e6f..57b9b7d65 100644
--- a/src/lib/recmutex.c
+++ b/src/lib/recmutex.c
@@ -37,8 +37,8 @@ static void recmutexattr_init()
 }
 
 
-LumieraRecMutex
-lumiera_recmutex_init (LumieraRecMutex self, const char* purpose, struct nobug_flag* flag)
+LumieraRecmutex
+lumiera_recmutex_init (LumieraRecmutex self, const char* purpose, struct nobug_flag* flag)
 {
   if (self)
     {
@@ -52,8 +52,8 @@ lumiera_recmutex_init (LumieraRecMutex self, const char* purpose, struct nobug_f
   return self;
 }
 
-LumieraRecMutex
-lumiera_recmutex_destroy (LumieraRecMutex self, struct nobug_flag* flag)
+LumieraRecmutex
+lumiera_recmutex_destroy (LumieraRecmutex self, struct nobug_flag* flag)
 {
   if (self)
     {

From ec62ca073b39affedbfd64de85aa526f158166d3 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Tue, 27 Jan 2009 09:41:22 +0100
Subject: [PATCH 057/368] typo fix in mutex.h

---
 src/lib/mutex.h | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index a3cd46fd9..1199dbec5 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -131,7 +131,7 @@
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
-           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_recursive, lumiera_lock_section_.rh);      \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
            LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                   \
          });                                                                                    \
          lumiera_lock_section_.lock;                                                            \

From 4f29f302b2d8ac43ba4c03f5c5a2f35d28ac66be Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Tue, 27 Jan 2009 10:07:30 +0100
Subject: [PATCH 058/368] split mutex.h again into mutex.h and recmutex.h

---
 src/lib/Makefile.am          |   3 +-
 src/lib/mutex.c              |   2 +-
 src/lib/mutex.h              |  80 +--------------------
 src/lib/recmutex.c           |   2 +-
 src/lib/recmutex.h           | 132 +++++++++++++++++++++++++++++++++++
 src/lib/sync.hpp             |   1 +
 tests/library/test-locking.c |   2 +
 7 files changed, 140 insertions(+), 82 deletions(-)
 create mode 100644 src/lib/recmutex.h

diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index 0163d0c4c..8991e2e39 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -1,5 +1,5 @@
 #  Copyright (C)         Lumiera.org
-#    2007,               Christian Thaeter <ct@pipapo.org>
+#    2007, 2008, 2009    Christian Thaeter <ct@pipapo.org>
 #
 #  This program is free software; you can redistribute it and/or
 #  modify it under the terms of the GNU General Public License as
@@ -52,6 +52,7 @@ noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/error.h				\
 	$(liblumiera_la_srcdir)/error.hpp			\
 	$(liblumiera_la_srcdir)/mutex.h				\
+	$(liblumiera_la_srcdir)/recmutex.h			\
 	$(liblumiera_la_srcdir)/rwlock.h			\
 	$(liblumiera_la_srcdir)/condition.h			\
 	$(liblumiera_la_srcdir)/reccondition.h			\
diff --git a/src/lib/mutex.c b/src/lib/mutex.c
index c7d6df040..25b56679c 100644
--- a/src/lib/mutex.c
+++ b/src/lib/mutex.c
@@ -2,7 +2,7 @@
   mutex.c  -  mutex
 
   Copyright (C)         Lumiera.org
-    2008,               Christian Thaeter <ct@pipapo.org>
+    2008, 2009,         Christian Thaeter <ct@pipapo.org>
 
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index 1199dbec5..a76707933 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -2,7 +2,7 @@
   mutex.h  -  mutal exclusion locking
 
   Copyright (C)         Lumiera.org
-    2008,               Christian Thaeter <ct@pipapo.org>
+    2008, 2009,         Christian Thaeter <ct@pipapo.org>
 
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
@@ -93,58 +93,6 @@
   LUMIERA_SECTION_UNLOCK_(&lumiera_lock_section_)
 
 
-/**
- * Recursive Mutual exclusive section.
- */
-#define LUMIERA_RECMUTEX_SECTION(nobugflag, mtx)                                                \
-  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
-         lumiera_lock_section_ = {                                                              \
-         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
-       lumiera_lock_section_.lock;)                                                             \
-    for (                                                                                       \
-         ({                                                                                     \
-           lumiera_lock_section_.lock = (mtx);                                                  \
-           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
-                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
-             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
-           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
-         });                                                                                    \
-         lumiera_lock_section_.lock;                                                            \
-         ({                                                                                     \
-           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
-         }))
-
-
-#define LUMIERA_RECMUTEX_SECTION_CHAIN(nobugflag, mtx)                                          \
-  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
-         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_lock_section_ = {            \
-         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
-       lumiera_lock_section_.lock;)                                                             \
-    for (                                                                                       \
-         ({                                                                                     \
-           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
-           lumiera_lock_section_.lock = (mtx);                                                  \
-           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
-                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
-           if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
-             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
-           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
-           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                   \
-         });                                                                                    \
-         lumiera_lock_section_.lock;                                                            \
-         ({                                                                                     \
-           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
-         }))
-
-
-#define LUMIERA_RECMUTEX_SECTION_UNLOCK            \
-  LUMIERA_SECTION_UNLOCK_(&lumiera_lock_section_)
-
-
-
 /**
  * Mutex.
  *
@@ -157,14 +105,6 @@ struct lumiera_mutex_struct
 typedef struct lumiera_mutex_struct lumiera_mutex;
 typedef lumiera_mutex* LumieraMutex;
 
-struct lumiera_recmutex_struct
-{
-  pthread_mutex_t recmutex;
-  RESOURCE_HANDLE (rh);
-};
-typedef struct lumiera_recmutex_struct lumiera_recmutex;
-typedef lumiera_recmutex* LumieraRecmutex;
-
 
 /**
  * Initialize a mutex variable
@@ -184,24 +124,6 @@ LumieraMutex
 lumiera_mutex_destroy (LumieraMutex self, struct nobug_flag* flag);
 
 
-
-/**
- * Initialize a recursive mutex variable
- * Initializes a 'recursive' mutex which might be locked by the same thread multiple times.
- * @param self is a pointer to the mutex to be initialized
- * @return self as given
- */
-LumieraRecmutex
-lumiera_recmutex_init (LumieraRecmutex self, const char* purpose, struct nobug_flag* flag);
-
-/**
- * Destroy a recursive mutex variable
- * @param self is a pointer to the mutex to be destroyed
- * @return self as given
- */
-LumieraRecmutex
-lumiera_recmutex_destroy (LumieraRecmutex self, struct nobug_flag* flag);
-
 /**
  * Callback for unlocking mutexes.
  * @internal
diff --git a/src/lib/recmutex.c b/src/lib/recmutex.c
index 57b9b7d65..447a12350 100644
--- a/src/lib/recmutex.c
+++ b/src/lib/recmutex.c
@@ -19,7 +19,7 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
-#include "lib/mutex.h"
+#include "lib/recmutex.h"
 
 /**
  * @file
diff --git a/src/lib/recmutex.h b/src/lib/recmutex.h
new file mode 100644
index 000000000..a893d3bed
--- /dev/null
+++ b/src/lib/recmutex.h
@@ -0,0 +1,132 @@
+/*
+  recmutex.h  -  recursive mutal exclusion locking
+
+  Copyright (C)         Lumiera.org
+    2008, 2009,         Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#ifndef LUMIERA_RECMUTEX_H
+#define LUMIERA_RECMUTEX_H
+
+#include "lib/error.h"
+#include "lib/sectionlock.h"
+
+#include <pthread.h>
+#include <nobug.h>
+
+/**
+ * @file
+ * Mutual exclusion locking, header.
+ */
+
+/**
+ * Recursive Mutual exclusive section.
+ */
+#define LUMIERA_RECMUTEX_SECTION(nobugflag, mtx)                                                \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
+         lumiera_lock_section_ = {                                                              \
+         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_lock_section_.lock = (mtx);                                                  \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
+         }))
+
+
+#define LUMIERA_RECMUTEX_SECTION_CHAIN(nobugflag, mtx)                                          \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_lock_section_ = {            \
+         (void*)1, lumiera_mutex_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};      \
+       lumiera_lock_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
+           lumiera_lock_section_.lock = (mtx);                                                  \
+           NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
+                           NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
+           if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_lock_section_.rh);      \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                   \
+         });                                                                                    \
+         lumiera_lock_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_MUTEX_SECTION_UNLOCK;                                                        \
+         }))
+
+
+#define LUMIERA_RECMUTEX_SECTION_UNLOCK            \
+  LUMIERA_SECTION_UNLOCK_(&lumiera_lock_section_)
+
+
+
+/**
+ * Mutex.
+ *
+ */
+struct lumiera_recmutex_struct
+{
+  pthread_mutex_t recmutex;
+  RESOURCE_HANDLE (rh);
+};
+typedef struct lumiera_recmutex_struct lumiera_recmutex;
+typedef lumiera_recmutex* LumieraRecmutex;
+
+/**
+ * Initialize a recursive mutex variable
+ * Initializes a 'recursive' mutex which might be locked by the same thread multiple times.
+ * @param self is a pointer to the mutex to be initialized
+ * @return self as given
+ */
+LumieraRecmutex
+lumiera_recmutex_init (LumieraRecmutex self, const char* purpose, struct nobug_flag* flag);
+
+/**
+ * Destroy a recursive mutex variable
+ * @param self is a pointer to the mutex to be destroyed
+ * @return self as given
+ */
+LumieraRecmutex
+lumiera_recmutex_destroy (LumieraRecmutex self, struct nobug_flag* flag);
+
+/**
+ * Callback for unlocking mutexes.
+ * @internal
+ */
+int
+lumiera_mutex_unlock_cb (void* mutex);
+
+
+#endif
+/*
+// Local Variables:
+// mode: C
+// c-file-style: "gnu"
+// indent-tabs-mode: nil
+// End:
+*/
diff --git a/src/lib/sync.hpp b/src/lib/sync.hpp
index e4fcb850a..4a20852b6 100644
--- a/src/lib/sync.hpp
+++ b/src/lib/sync.hpp
@@ -73,6 +73,7 @@
 
 extern "C" {
 #include "lib/mutex.h"
+#include "lib/recmutex.h"
 #include "lib/condition.h"
 #include "lib/reccondition.h"
 }
diff --git a/tests/library/test-locking.c b/tests/library/test-locking.c
index 33ac2fccf..7ea7db794 100644
--- a/tests/library/test-locking.c
+++ b/tests/library/test-locking.c
@@ -21,7 +21,9 @@
 
 #include "tests/test.h"
 #include "lib/mutex.h"
+#include "lib/recmutex.h"
 #include "lib/condition.h"
+#include "lib/reccondition.h"
 #include "lib/rwlock.h"
 
 #include <stdio.h>

From d91620a60f24920a7f5942a4adb0990e6df72497 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Tue, 27 Jan 2009 10:10:03 +0100
Subject: [PATCH 059/368] New condition and reccondition implementation

Should be working but not thoroughly tested still, docs not complete
---
 src/lib/condition.c          |  18 ++--
 src/lib/condition.h          | 145 ++++++++++++++---------------
 src/lib/reccondition.c       |  13 ++-
 src/lib/reccondition.h       | 174 +++++++++++++++++------------------
 tests/15locking.tests        |  16 ++++
 tests/library/test-locking.c |  67 ++++++++++++++
 6 files changed, 259 insertions(+), 174 deletions(-)

diff --git a/src/lib/condition.c b/src/lib/condition.c
index a7f17e57b..9db79c54f 100644
--- a/src/lib/condition.c
+++ b/src/lib/condition.c
@@ -2,7 +2,7 @@
   condition.c  -  condition variable
 
   Copyright (C)         Lumiera.org
-    2008,               Christian Thaeter <ct@pipapo.org>
+    2008, 2009          Christian Thaeter <ct@pipapo.org>
 
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
@@ -26,8 +26,6 @@
  * Condition variables
  */
 
-LUMIERA_ERROR_DEFINE (CONDITION_DESTROY, "condition destroy failed");
-
 
 LumieraCondition
 lumiera_condition_init (LumieraCondition self, const char* purpose, struct nobug_flag* flag)
@@ -35,7 +33,7 @@ lumiera_condition_init (LumieraCondition self, const char* purpose, struct nobug
   if (self)
     {
       pthread_cond_init (&self->cond, NULL);
-      pthread_mutex_init (&self->mutex, NULL);
+      pthread_mutex_init (&self->cndmutex, NULL);
       NOBUG_RESOURCE_HANDLE_INIT (self->rh);
       NOBUG_RESOURCE_ANNOUNCE_RAW (flag, "cond_var", purpose, self, self->rh);
     }
@@ -50,15 +48,21 @@ lumiera_condition_destroy (LumieraCondition self, struct nobug_flag* flag)
     {
       NOBUG_RESOURCE_FORGET_RAW (flag,  self->rh);
 
-      if (pthread_mutex_destroy (&self->mutex))
-        LUMIERA_DIE (MUTEX_DESTROY);
+      if (pthread_mutex_destroy (&self->cndmutex))
+        LUMIERA_DIE (LOCK_DESTROY);
 
       if (pthread_cond_destroy (&self->cond))
-        LUMIERA_DIE (CONDITION_DESTROY);
+        LUMIERA_DIE (LOCK_DESTROY);
     }
   return self;
 }
 
 
 
+int lumiera_condition_unlock_cb (void* cond)
+{
+  return pthread_mutex_unlock (&((LumieraCondition)cond)->cndmutex);
+}
+
+
 
diff --git a/src/lib/condition.h b/src/lib/condition.h
index 328d07c49..a2e02cebd 100644
--- a/src/lib/condition.h
+++ b/src/lib/condition.h
@@ -23,58 +23,73 @@
 #define LUMIERA_CONDITION_H
 
 #include "lib/error.h"
-#include "lib/mutex.h"
+#include "lib/sectionlock.h"
 
+#include <pthread.h>
+#include <nobug.h>
 
 /**
  * @file
  * Condition variables, header
  */
 
-LUMIERA_ERROR_DECLARE (CONDITION_DESTROY);
-
-
 
 /**
  * Condition section.
  * Locks the condition mutex, one can use LUMIERA_CONDITION_WAIT to wait for signals or
  * LUMIERA_CONDITION_SIGNAL or LUMIERA_CONDITION_BROADCAST to wake waiting threads
+ * Condition variables must be at the end of locking chains, they can not be used at
+ * intermediate position.
  * @param nobugflag NoBug flag used to log actions on the condition
  * @param cnd Condition variable to be locked
  */
-#define LUMIERA_CONDITION_SECTION(nobugflag, cnd)                                                       \
-  for (lumiera_conditionacquirer NOBUG_CLEANUP(lumiera_conditionacquirer_ensureunlocked)                \
-         lumiera_condition_section_ = {(LumieraCondition)1};                                            \
-       lumiera_condition_section_.condition;)                                                           \
-    for (                                                                                               \
-         ({                                                                                             \
-           lumiera_condition_section_.condition = (cnd);                                                \
-           NOBUG_IF(NOBUG_MODE_ALPHA, lumiera_condition_section_.flag = &NOBUG_FLAG(nobugflag));        \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_condition_section_.rh);                                  \
-           RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condition", &lumiera_condition_section_,      \
-                           NOBUG_RESOURCE_EXCLUSIVE, lumiera_condition_section_.rh);                    \
-           if (pthread_mutex_lock (&(cnd)->mutex)) LUMIERA_DIE (MUTEX_LOCK);                            \
-         });                                                                                            \
-         lumiera_condition_section_.condition;                                                          \
-         ({                                                                                             \
-           LUMIERA_CONDITION_UNLOCK                                                                     \
+#define LUMIERA_CONDITION_SECTION(nobugflag, cnd)                                               \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                    \
+         lumiera_cond_section_ = {                                                              \
+         (void*)1, lumiera_condition_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};  \
+       lumiera_cond_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           lumiera_cond_section_.lock = (cnd);                                                  \
+           NOBUG_IF_ALPHA(lumiera_cond_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condmutex", &lumiera_cond_section_, \
+                             NOBUG_RESOURCE_WAITING, lumiera_cond_section_.rh);                 \
+           if (pthread_mutex_lock (&(cnd)->cndmutex))                                           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_cond_section_.rh);      \
+         });                                                                                    \
+         lumiera_cond_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_CONDITION_SECTION_UNLOCK;                                                    \
          }))
 
 
-/**
- * Explicit mutex unlock for a condition variable
- * One can early unlock the mutex of a condition variable prior leaving a CONDITION_SECTION.
- * The CONDITION_WAIT, CONDITION_SIGNAL and CONDITION_BROADCAST macros must not be used after the mutex
- * got unlocked.
- * @param nobugflag NoBug flag used to log actions on the condition
- */
-#define LUMIERA_CONDITION_UNLOCK                                                                \
-  if (lumiera_condition_section_.condition)                                                     \
-    {                                                                                           \
-      pthread_mutex_unlock (&lumiera_condition_section_.condition->mutex);                      \
-      lumiera_condition_section_.condition = NULL;                                              \
-      NOBUG_RESOURCE_LEAVE_RAW(lumiera_condition_section_.flag, lumiera_condition_section_.rh); \
-    }
+#define LUMIERA_CONDITION_SECTION_CHAIN(nobugflag, cnd)                                         \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                 \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_cond_section_ = {            \
+         (void*)1, lumiera_condition_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};  \
+       lumiera_cond_section_.lock;)                                                             \
+    for (                                                                                       \
+         ({                                                                                     \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
+           lumiera_cond_section_.lock = cnd;                                                    \
+           NOBUG_IF_ALPHA(lumiera_cond_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
+           RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condmutex", &lumiera_cond_section_,   \
+                           NOBUG_RESOURCE_WAITING, lumiera_cond_section_.rh);                   \
+           if (pthread_mutex_lock (&(cnd)->cndmutex))                                           \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_cond_section_.rh);      \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_);                                  \
+         });                                                                                    \
+         lumiera_cond_section_.lock;                                                            \
+         ({                                                                                     \
+           LUMIERA_CONDITION_SECTION_UNLOCK;                                                    \
+         }))
+
+
+
+#define LUMIERA_CONDITION_SECTION_UNLOCK                \
+  LUMIERA_SECTION_UNLOCK_(&lumiera_cond_section_)
 
 
 /**
@@ -82,12 +97,13 @@ LUMIERA_ERROR_DECLARE (CONDITION_DESTROY);
  * Must be used inside a CONDITION_SECTION.
  * @param expr Conditon which must become true, else the condition variable goes back into sleep
  */
-#define LUMIERA_CONDITION_WAIT(expr)                                                                                    \
-  do {                                                                                                                  \
-    ENSURE (lumiera_condition_section_.condition, "Condition mutex not locked");                                        \
-    NOBUG_RESOURCE_STATE_RAW (lumiera_condition_section_.flag, lumiera_condition_section_.rh, NOBUG_RESOURCE_WAITING);  \
-    pthread_cond_wait (&lumiera_condition_section_.condition->cond, &lumiera_condition_section_.condition->mutex);      \
-    NOBUG_RESOURCE_STATE_RAW (lumiera_condition_section_.flag, lumiera_condition_section_.rh, NOBUG_RESOURCE_EXCLUSIVE);\
+#define LUMIERA_CONDITION_WAIT(expr)                                                                            \
+  do {                                                                                                          \
+    REQUIRE (lumiera_cond_section_.lock, "Condition mutex not locked");                                         \
+    NOBUG_RESOURCE_STATE_RAW (lumiera_cond_section_.flag, NOBUG_RESOURCE_WAITING, lumiera_cond_section_.rh);    \
+    pthread_cond_wait (&((LumieraCondition)lumiera_cond_section_.lock)->cond,                                   \
+                       &((LumieraCondition)lumiera_cond_section_.lock)->cndmutex);                              \
+    NOBUG_RESOURCE_STATE_RAW (lumiera_cond_section_.flag, NOBUG_RESOURCE_EXCLUSIVE, lumiera_cond_section_.rh);  \
   } while (!(expr))
 
 
@@ -96,12 +112,12 @@ LUMIERA_ERROR_DECLARE (CONDITION_DESTROY);
  * Must be used inside a CONDITION_SECTION.
  * Wakes one thread waiting on the condition variable
  */
-#define LUMIERA_CONDITION_SIGNAL                                                        \
-do {                                                                                    \
-  ENSURE (lumiera_condition_section_.condition, "Condition mutex not locked");          \
-  NOBUG_IF(NOBUG_MODE_ALPHA, TRACE(lumiera_condition_section_.flag, "Signaling"));      \
-  pthread_cond_signal (&lumiera_condition_section_.condition->cond);                    \
-} while (0)
+#define LUMIERA_CONDITION_SIGNAL                                                                \
+  do {                                                                                          \
+    REQUIRE (lumiera_cond_section_.lock, "Condition mutex not locked");                         \
+    TRACE(NOBUG_FLAG_RAW(lumiera_cond_section_.flag), "Signal %p", &lumiera_cond_section_);     \
+    pthread_cond_signal (&((LumieraCondition)lumiera_cond_section_.lock)->cond);                \
+  } while (0)
 
 
 /**
@@ -109,13 +125,12 @@ do {
  * Must be used inside a CONDITION_SECTION.
  * Wakes all threads waiting on the condition variable
  */
-#define LUMIERA_CONDITION_BROADCAST                                                     \
-do {                                                                                    \
-  ENSURE (lumiera_condition_section_.condition, "Condition mutex not locked");          \
-  NOBUG_IF(NOBUG_MODE_ALPHA, TRACE(lumiera_condition_section_.flag, "Broadcasting"));   \
-  pthread_cond_broadcast (&lumiera_condition_section_.condition->cond);                 \
-} while (0)
-
+#define LUMIERA_CONDITION_BROADCAST                                                             \
+  do {                                                                                          \
+    REQUIRE (lumiera_cond_section_.lock, "Condition mutex not locked");                         \
+    TRACE(NOBUG_FLAG_RAW(lumiera_cond_section_.flag), "Broadcast %p", &lumiera_cond_section_);  \
+    pthread_cond_broadcast (&((LumieraCondition)lumiera_cond_section_.lock)->cond);             \
+  } while (0)
 
 
 /**
@@ -125,7 +140,7 @@ do {
 struct lumiera_condition_struct
 {
   pthread_cond_t cond;
-  pthread_mutex_t mutex;
+  pthread_mutex_t cndmutex;
   RESOURCE_HANDLE (rh);
 };
 typedef struct lumiera_condition_struct lumiera_condition;
@@ -149,26 +164,8 @@ lumiera_condition_init (LumieraCondition self, const char* purpose, struct nobug
 LumieraCondition
 lumiera_condition_destroy (LumieraCondition self, struct nobug_flag* flag);
 
-
-/**
- * conditionacquirer used to manage the state of a condition variable.
- */
-struct lumiera_conditionacquirer_struct
-{
-  LumieraCondition condition;
-  NOBUG_IF(NOBUG_MODE_ALPHA, struct nobug_flag* flag);
-  RESOURCE_HANDLE (rh);
-};
-typedef struct lumiera_conditionacquirer_struct lumiera_conditionacquirer;
-typedef struct lumiera_conditionacquirer_struct* LumieraConditionacquirer;
-
-
-/* helper function for nobug */
-static inline void
-lumiera_conditionacquirer_ensureunlocked (LumieraConditionacquirer self)
-{
-  ENSURE (!self->condition, "forgot to unlock condition variable");
-}
+int
+lumiera_condition_unlock_cb (void* cond);
 
 
 #endif
diff --git a/src/lib/reccondition.c b/src/lib/reccondition.c
index b70f8d179..59bc956aa 100644
--- a/src/lib/reccondition.c
+++ b/src/lib/reccondition.c
@@ -2,7 +2,7 @@
   reccondition.c  -  condition variable, w/ recursive mutex
 
   Copyright (C)         Lumiera.org
-    2008,               Christian Thaeter <ct@pipapo.org>
+    2008, 2009,         Christian Thaeter <ct@pipapo.org>
 
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
@@ -19,7 +19,6 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
-#include "lib/condition.h"
 #include "lib/reccondition.h"
 
 /**
@@ -48,7 +47,7 @@ lumiera_reccondition_init (LumieraReccondition self, const char* purpose, struct
         pthread_once (&recursive_mutexattr_once, recursive_mutexattr_init);
 
       pthread_cond_init (&self->cond, NULL);
-      pthread_mutex_init (&self->mutex, &recursive_mutexattr);
+      pthread_mutex_init (&self->reccndmutex, &recursive_mutexattr);
       NOBUG_RESOURCE_HANDLE_INIT (self->rh);
       NOBUG_RESOURCE_ANNOUNCE_RAW (flag, "reccond_var", purpose, self, self->rh);
     }
@@ -63,15 +62,19 @@ lumiera_reccondition_destroy (LumieraReccondition self, struct nobug_flag* flag)
     {
       NOBUG_RESOURCE_FORGET_RAW (flag,  self->rh);
 
-      if (pthread_mutex_destroy (&self->mutex))
+      if (pthread_mutex_destroy (&self->reccndmutex))
         LUMIERA_DIE (LOCK_DESTROY);
 
       if (pthread_cond_destroy (&self->cond))
-        LUMIERA_DIE (CONDITION_DESTROY);
+        LUMIERA_DIE (LOCK_DESTROY);
     }
   return self;
 }
 
 
 
+int lumiera_reccondition_unlock_cb (void* cond)
+{
+  return pthread_mutex_unlock (&((LumieraReccondition)cond)->reccndmutex);
+}
 
diff --git a/src/lib/reccondition.h b/src/lib/reccondition.h
index f3246c516..aa88567d9 100644
--- a/src/lib/reccondition.h
+++ b/src/lib/reccondition.h
@@ -1,8 +1,8 @@
 /*
-  reccondition.h  -  condition variables, w/ recursive mutex
+  reccondition.h  -  recursive locked condition variables
 
   Copyright (C)         Lumiera.org
-    2008,               Christian Thaeter <ct@pipapo.org>
+    2008, 2009,         Christian Thaeter <ct@pipapo.org>
 
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
@@ -23,106 +23,122 @@
 #define LUMIERA_RECCONDITION_H
 
 #include "lib/error.h"
-#include "lib/mutex.h"
+#include "lib/sectionlock.h"
 
+#include <pthread.h>
+#include <nobug.h>
 
 /**
  * @file
- * Reccondition variables. Same as Conditon variables but using a recursive mutex for locking.
+ * Condition variables, header
  */
 
 
 /**
- * Reccondition section.
- * Locks the reccondition mutex, one can then use LUMIERA_RECCONDITION_WAIT to wait for signals or
+ * Recursive Condition section.
+ * Locks the condition mutex, one can use LUMIERA_RECCONDITION_WAIT to wait for signals or
  * LUMIERA_RECCONDITION_SIGNAL or LUMIERA_RECCONDITION_BROADCAST to wake waiting threads
- * @param nobugflag NoBug flag used to log actions on the reccondition
- * @param rcnd Reccondition variable to be locked
+ * @param nobugflag NoBug flag used to log actions on the condition
+ * @param cnd Condition variable to be locked
  */
-#define LUMIERA_RECCONDITION_SECTION(nobugflag, rcnd)                                                           \
-  for (lumiera_recconditionacquirer NOBUG_CLEANUP(lumiera_recconditionacquirer_ensureunlocked)                  \
-         lumiera_reccondition_section_ = {(LumieraReccondition)1};                                              \
-       lumiera_reccondition_section_.reccondition;)                                                             \
-    for (                                                                                                       \
-         ({                                                                                                     \
-           lumiera_reccondition_section_.reccondition = (rcnd);                                                 \
-           NOBUG_IF(NOBUG_MODE_ALPHA, lumiera_reccondition_section_.flag = &NOBUG_FLAG(nobugflag));             \
-           NOBUG_RESOURCE_HANDLE_INIT (lumiera_reccondition_section_.rh);                                       \
-           RESOURCE_ENTER (nobugflag, (rcnd)->rh, "acquire reccondition", &lumiera_reccondition_section_,       \
-                           NOBUG_RESOURCE_RECURSIVE, lumiera_reccondition_section_.rh);                         \
-           if (pthread_mutex_lock (&(rcnd)->mutex)) LUMIERA_DIE (MUTEX_LOCK);                                   \
-         });                                                                                                    \
-         lumiera_reccondition_section_.reccondition;                                                            \
-         ({                                                                                                     \
-           LUMIERA_RECCONDITION_UNLOCK(nobugflag)                                                               \
+#define LUMIERA_RECCONDITION_SECTION(nobugflag, cnd)                                                    \
+  for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                            \
+         lumiera_reccond_section_ = {                                                                   \
+         (void*)1, lumiera_condition_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};          \
+       lumiera_reccond_section_.lock;)                                                                  \
+    for (                                                                                               \
+         ({                                                                                             \
+           lumiera_reccond_section_.lock = (cnd);                                                       \
+           NOBUG_IF_ALPHA(lumiera_reccond_section_.flag = &NOBUG_FLAG(nobugflag);)                      \
+             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire reccondmutex", &lumiera_reccond_section_,   \
+                             NOBUG_RESOURCE_WAITING, lumiera_reccond_section_.rh);                      \
+           if (pthread_mutex_lock (&(cnd)->reccndmutex))                                                \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                                \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_reccond_section_.rh);           \
+         });                                                                                            \
+         lumiera_reccond_section_.lock;                                                                 \
+         ({                                                                                             \
+           LUMIERA_RECCONDITION_SECTION_UNLOCK;                                                         \
          }))
 
 
-/**
- * Explicit mutex unlock for a reccondition variable
- * One can early unlock the mutex of a condition variable prior leaving a RECCONDITION_SECTION.
- * The RECCONDITION_WAIT, RECCONDITION_SIGNAL and RECCONDITION_BROADCAST macros must not be used after the mutex
- * got unlocked.
- * @param nobugflag NoBug flag used to log actions on the reccondition
- */
-#define LUMIERA_RECCONDITION_UNLOCK                                                     \
-  if (lumiera_reccondition_section_.reccondition)                                       \
-    {                                                                                   \
-      pthread_mutex_unlock (&lumiera_reccondition_section_.reccondition->mutex);        \
-      lumiera_reccondition_section_.reccondition = NULL;                                \
-      RESOURCE_LEAVE(nobugflag, lumiera_reccondition_section_.rh);                      \
-    }
+
+#define LUMIERA_RECCONDITION_SECTION_CHAIN(nobugflag, cnd)                                              \
+  for (lumiera_sectionlock *lumiera_lock_section_old_ = &lumiera_lock_section_,                         \
+         NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked) lumiera_reccond_section_ = {                 \
+         (void*)1, lumiera_reccondition_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};       \
+       lumiera_reccond_section_.lock;)                                                                  \
+    for (                                                                                               \
+         ({                                                                                             \
+           REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");                   \
+           lumiera_reccond_section_.lock = (cnd);                                                       \
+           NOBUG_IF_ALPHA(lumiera_reccond_section_.flag = &NOBUG_FLAG(nobugflag);)                      \
+           RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire reccondmutex", &lumiera_reccond_section_,     \
+                           NOBUG_RESOURCE_WAITING, lumiera_reccond_section_.rh);                        \
+           if (pthread_mutex_lock (&(cnd)->reccndmutex))                                                \
+             LUMIERA_DIE (LOCK_ACQUIRE);                                                                \
+           RESOURCE_STATE (nobugflag, NOBUG_RESOURCE_RECURSIVE, lumiera_reccond_section_.rh);           \
+           LUMIERA_SECTION_UNLOCK_(lumiera_lock_section_old_)                                           \
+         });                                                                                            \
+         lumiera_reccond_section_.lock;                                                                 \
+         ({                                                                                             \
+           LUMIERA_RECCONDITION_SECTION_UNLOCK;                                                         \
+         }))
+
+
+#define LUMIERA_RECCONDITION_SECTION_UNLOCK             \
+  LUMIERA_SECTION_UNLOCK_(&lumiera_reccond_section_)
 
 
 /**
- * Wait for a reccondition.
+ * Wait for a condition.
  * Must be used inside a RECCONDITION_SECTION.
- * @param expr Recconditon which must become true, else the reccondition variable goes back into sleep
+ * @param expr Conditon which must become true, else the condition variable goes back into sleep
  */
-#define LUMIERA_RECCONDITION_WAIT(expr)                                                                                         \
-  do {                                                                                                                          \
-    ENSURE (lumiera_reccondition_section_.reccondition, "Reccondition mutex not locked");                                       \
-    NOBUG_RESOURCE_STATE_RAW (lumiera_reccondition_section_.flag, lumiera_reccondition_section_.rh, NOBUG_RESOURCE_WAITING);    \
-    pthread_cond_wait (&lumiera_reccondition_section_.reccondition->cond, &lumiera_reccondition_section_.reccondition->mutex);  \
-    NOBUG_RESOURCE_STATE_RAW (lumiera_reccondition_section_.flag, lumiera_reccondition_section_.rh, NOBUG_RESOURCE_RECURSIVE);  \
+#define LUMIERA_RECCONDITION_WAIT(expr)                                                                                 \
+  do {                                                                                                                  \
+    REQUIRE (lumiera_reccond_section_.lock, "Condition recmutex not locked");                                           \
+    NOBUG_RESOURCE_STATE_RAW (lumiera_reccond_section_.flag, NOBUG_RESOURCE_WAITING, lumiera_reccond_section_.rh);      \
+    pthread_cond_wait (&((LumieraCondition)lumiera_reccond_section_.lock)->cond,                                        \
+                       &((LumieraCondition)lumiera_reccond_section_.lock)->cndmutex);                                   \
+    NOBUG_RESOURCE_STATE_RAW (lumiera_reccond_section_.flag, NOBUG_RESOURCE_RECURSIVE, lumiera_reccond_section_.rh);    \
   } while (!(expr))
 
 
 /**
- * Signal a reccondition variable
+ * Signal a condition variable
  * Must be used inside a RECCONDITION_SECTION.
  * Wakes one thread waiting on the condition variable
  */
-#define LUMIERA_RECCONDITION_SIGNAL                                                     \
-do {                                                                                    \
-  ENSURE (lumiera_reccondition_section_.reccondition, "Reccondition mutex not locked"); \
-  NOBUG_IF(NOBUG_MODE_ALPHA, TRACE(lumiera_reccondition_section_.flag, "Signaling"));   \
-  pthread_cond_signal (&lumiera_reccondition_section_.reccondition->cond);              \
-} while (0)
+#define LUMIERA_RECCONDITION_SIGNAL                                                                     \
+  do {                                                                                                  \
+    REQUIRE (lumiera_reccond_section_.lock, "Condition recmutex not locked");                           \
+    TRACE(NOBUG_FLAG_RAW(lumiera_reccond_section_.flag), "Signal %p", &lumiera_reccond_section_);       \
+    pthread_cond_signal (&((LumieraCondition)lumiera_reccond_section_.lock)->cond);                     \
+  } while (0)
 
 
 /**
- * Broadcast a reccondition variable
+ * Broadcast a condition variable
  * Must be used inside a RECCONDITION_SECTION.
- * Wakes all threads waiting on the reccondition variable
+ * Wakes all threads waiting on the condition variable
  */
-#define LUMIERA_RECCONDITION_BROADCAST                                                  \
-do {                                                                                    \
-  ENSURE (lumiera_reccondition_section_.reccondition, "Reccondition mutex not locked"); \
-  NOBUG_IF(NOBUG_MODE_ALPHA, TRACE(lumiera_reccondition_section_.flag, "Broadcasting"));\
-  pthread_cond_broadcast (&lumiera_reccondition_section_.reccondition->cond);           \
-} while (0)
-
+#define LUMIERA_RECCONDITION_BROADCAST                                                                  \
+  do {                                                                                                  \
+    REQUIRE (lumiera_reccond_section_.lock, "Condition recmutex not locked");                           \
+    TRACE(NOBUG_FLAG_RAW(lumiera_reccond_section_.flag), "Broadcast %p", &lumiera_reccond_section_);    \
+    pthread_cond_broadcast (&((LumieraCondition)lumiera_reccond_section_.lock)->cond);                  \
+  } while (0)
 
 
 /**
- * Reccondition variables.
+ * Condition variables. Recursive mutex variant.
  *
  */
 struct lumiera_reccondition_struct
 {
   pthread_cond_t cond;
-  pthread_mutex_t mutex;
+  pthread_mutex_t reccndmutex;
   RESOURCE_HANDLE (rh);
 };
 typedef struct lumiera_reccondition_struct lumiera_reccondition;
@@ -130,8 +146,8 @@ typedef lumiera_reccondition* LumieraReccondition;
 
 
 /**
- * Initialize a reccondition variable
- * @param self is a pointer to the reccondition variable to be initialized
+ * Initialize a condition variable
+ * @param self is a pointer to the condition variable to be initialized
  * @return self as given
  */
 LumieraReccondition
@@ -139,34 +155,16 @@ lumiera_reccondition_init (LumieraReccondition self, const char* purpose, struct
 
 
 /**
- * Destroy a reccondition variable
- * @param self is a pointer to the reccondition variable to be destroyed
+ * Destroy a condition variable
+ * @param self is a pointer to the condition variable to be destroyed
  * @return self as given
  */
 LumieraReccondition
 lumiera_reccondition_destroy (LumieraReccondition self, struct nobug_flag* flag);
 
 
-/**
- * recconditionacquirer used to manage the state of a reccondition variable.
- */
-struct lumiera_recconditionacquirer_struct
-{
-  LumieraReccondition reccondition;
-  NOBUG_IF(NOBUG_MODE_ALPHA, struct nobug_flag* flag);
-  RESOURCE_HANDLE (rh);
-};
-typedef struct lumiera_recconditionacquirer_struct lumiera_recconditionacquirer;
-typedef struct lumiera_recconditionacquirer_struct* LumieraRecconditionacquirer;
-
-
-/* helper function for nobug */
-static inline void
-lumiera_recconditionacquirer_ensureunlocked (LumieraRecconditionacquirer self)
-{
-  ENSURE (!self->reccondition, "forgot to unlock reccondition variable");
-}
-
+int
+lumiera_reccondition_unlock_cb (void* cond);
 
 #endif
 /*
diff --git a/tests/15locking.tests b/tests/15locking.tests
index 0fc57c233..0936499f2 100644
--- a/tests/15locking.tests
+++ b/tests/15locking.tests
@@ -70,3 +70,19 @@ PLANNED "condition broadcasting" <<END
 END
 
 
+TEST "reccondition not unlocked asserts" recconditionforgotunlock <<END
+return: 134
+END
+
+TEST "reccondition section" recconditionsection <<END
+out: reccondition locked section 1
+out: reccondition locked section 2
+END
+
+PLANNED "reccondition signaling" <<END
+END
+
+PLANNED "reccondition broadcasting" <<END
+END
+
+
diff --git a/tests/library/test-locking.c b/tests/library/test-locking.c
index 7ea7db794..5728783ec 100644
--- a/tests/library/test-locking.c
+++ b/tests/library/test-locking.c
@@ -219,6 +219,22 @@ TEST ("rwdeadlockrw")
 }
 
 
+TEST ("conditionops (compiletest only)")
+{
+  lumiera_condition cond;
+  lumiera_condition_init (&cond, "conditionsection", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_CONDITION_SECTION (NOBUG_ON, &cond)
+    {
+      LUMIERA_CONDITION_WAIT(1);
+      LUMIERA_CONDITION_SIGNAL;
+      LUMIERA_CONDITION_BROADCAST;
+    }
+
+  lumiera_condition_destroy (&cond, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
 TEST ("conditionsection")
 {
   lumiera_condition cond;
@@ -251,4 +267,55 @@ TEST ("conditionforgotunlock")
   lumiera_condition_destroy (&cond, &NOBUG_FLAG(NOBUG_ON));
 }
 
+
+
+TEST ("recconditionops (compiletest only)")
+{
+  lumiera_reccondition reccond;
+  lumiera_reccondition_init (&reccond, "recconditionsection", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_RECCONDITION_SECTION (NOBUG_ON, &reccond)
+    {
+      LUMIERA_RECCONDITION_WAIT(1);
+      LUMIERA_RECCONDITION_SIGNAL;
+      LUMIERA_RECCONDITION_BROADCAST;
+    }
+
+  lumiera_reccondition_destroy (&reccond, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
+TEST ("recconditionsection")
+{
+  lumiera_reccondition reccond;
+  lumiera_reccondition_init (&reccond, "recconditionsection", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_RECCONDITION_SECTION (NOBUG_ON, &reccond)
+    {
+      printf ("reccondition locked section 1\n");
+    }
+
+  LUMIERA_RECCONDITION_SECTION (NOBUG_ON, &reccond)
+    {
+      printf ("reccondition locked section 2\n");
+    }
+
+  lumiera_reccondition_destroy (&reccond, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
+TEST ("recconditionforgotunlock")
+{
+  lumiera_reccondition reccond;
+  lumiera_reccondition_init (&reccond, "recconditionforgotunlock", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_RECCONDITION_SECTION (NOBUG_ON, &reccond)
+    {
+      break;    // RECCONDITION_SECTIONS must not be left by a jump
+    }
+
+  lumiera_reccondition_destroy (&reccond, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
 TESTS_END

From 7758d76c7ba1f0d12079510a365cfe8503954e31 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Wed, 28 Jan 2009 04:17:01 +0100
Subject: [PATCH 060/368] weed out reccondition bugs/typos

---
 src/lib/reccondition.h | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/lib/reccondition.h b/src/lib/reccondition.h
index aa88567d9..a2dd54f58 100644
--- a/src/lib/reccondition.h
+++ b/src/lib/reccondition.h
@@ -44,7 +44,7 @@
 #define LUMIERA_RECCONDITION_SECTION(nobugflag, cnd)                                                    \
   for (lumiera_sectionlock NOBUG_CLEANUP(lumiera_sectionlock_ensureunlocked)                            \
          lumiera_reccond_section_ = {                                                                   \
-         (void*)1, lumiera_condition_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};          \
+         (void*)1, lumiera_reccondition_unlock_cb NOBUG_ALPHA_COMMA_NULL NOBUG_ALPHA_COMMA_NULL};       \
        lumiera_reccond_section_.lock;)                                                                  \
     for (                                                                                               \
          ({                                                                                             \
@@ -99,8 +99,8 @@
   do {                                                                                                                  \
     REQUIRE (lumiera_reccond_section_.lock, "Condition recmutex not locked");                                           \
     NOBUG_RESOURCE_STATE_RAW (lumiera_reccond_section_.flag, NOBUG_RESOURCE_WAITING, lumiera_reccond_section_.rh);      \
-    pthread_cond_wait (&((LumieraCondition)lumiera_reccond_section_.lock)->cond,                                        \
-                       &((LumieraCondition)lumiera_reccond_section_.lock)->cndmutex);                                   \
+    pthread_cond_wait (&((LumieraReccondition)lumiera_reccond_section_.lock)->cond,                                     \
+                       &((LumieraReccondition)lumiera_reccond_section_.lock)->reccndmutex);                             \
     NOBUG_RESOURCE_STATE_RAW (lumiera_reccond_section_.flag, NOBUG_RESOURCE_RECURSIVE, lumiera_reccond_section_.rh);    \
   } while (!(expr))
 
@@ -114,7 +114,7 @@
   do {                                                                                                  \
     REQUIRE (lumiera_reccond_section_.lock, "Condition recmutex not locked");                           \
     TRACE(NOBUG_FLAG_RAW(lumiera_reccond_section_.flag), "Signal %p", &lumiera_reccond_section_);       \
-    pthread_cond_signal (&((LumieraCondition)lumiera_reccond_section_.lock)->cond);                     \
+    pthread_cond_signal (&((LumieraReccondition)lumiera_reccond_section_.lock)->cond);                  \
   } while (0)
 
 
@@ -127,7 +127,7 @@
   do {                                                                                                  \
     REQUIRE (lumiera_reccond_section_.lock, "Condition recmutex not locked");                           \
     TRACE(NOBUG_FLAG_RAW(lumiera_reccond_section_.flag), "Broadcast %p", &lumiera_reccond_section_);    \
-    pthread_cond_broadcast (&((LumieraCondition)lumiera_reccond_section_.lock)->cond);                  \
+    pthread_cond_broadcast (&((LumieraReccondition)lumiera_reccond_section_.lock)->cond);               \
   } while (0)
 
 

From 323724b623ca83bdbb20d94af6cd971402fd841a Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Wed, 28 Jan 2009 04:18:53 +0100
Subject: [PATCH 061/368] fix some includes for new mutex/recmutex headers

---
 src/common/interface.c         | 2 +-
 src/common/interfaceregistry.c | 1 -
 src/common/interfaceregistry.h | 1 +
 src/common/plugin.c            | 2 +-
 4 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/common/interface.c b/src/common/interface.c
index 1853c7af3..a8d91c40f 100644
--- a/src/common/interface.c
+++ b/src/common/interface.c
@@ -21,7 +21,7 @@
 
 #include "include/logging.h"
 
-#include "lib/mutex.h"
+#include "lib/recmutex.h"
 #include "lib/safeclib.h"
 
 #include "common/plugin.h"
diff --git a/src/common/interfaceregistry.c b/src/common/interfaceregistry.c
index 5b0db98e7..3b67e77e1 100644
--- a/src/common/interfaceregistry.c
+++ b/src/common/interfaceregistry.c
@@ -20,7 +20,6 @@
 */
 
 #include "include/logging.h"
-#include "lib/mutex.h"
 #include "lib/error.h"
 #include "lib/psplay.h"
 #include "lib/safeclib.h"
diff --git a/src/common/interfaceregistry.h b/src/common/interfaceregistry.h
index 0ec20f29c..bc4f11440 100644
--- a/src/common/interfaceregistry.h
+++ b/src/common/interfaceregistry.h
@@ -22,6 +22,7 @@
 #define LUMIERA_INTERFACEREGISTRY_H
 
 #include "lib/mutex.h"
+#include "lib/recmutex.h"
 #include "lib/psplay.h"
 
 #include "common/interface.h"
diff --git a/src/common/plugin.c b/src/common/plugin.c
index 1d24f9c5e..2ddd58998 100644
--- a/src/common/plugin.c
+++ b/src/common/plugin.c
@@ -22,7 +22,7 @@
 #include "include/logging.h"
 #include "lib/safeclib.h"
 #include "lib/psplay.h"
-#include "lib/mutex.h"
+#include "lib/recmutex.h"
 #include "lib/error.h"
 
 #include "common/interfaceregistry.h"

From dd9b7a174f1e5f914c3ed499530ace4c7bef2960 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Wed, 28 Jan 2009 04:56:01 +0100
Subject: [PATCH 062/368] Add reccondition to threads, make its functionality
 complete

With this the threads are now usable, despite still a mockup
implementation.

Some basic tests to show their use included.
---
 src/backend/Makefile.am      |   4 +-
 src/backend/threads.c        |  57 ++++++-------
 src/backend/threads.h        |   4 +-
 tests/Makefile.am            |   6 ++
 tests/backend/test-threads.c | 159 +++++++++++++++++++++++++++++++++++
 tests/library/test-locking.c |   1 +
 6 files changed, 198 insertions(+), 33 deletions(-)
 create mode 100644 tests/backend/test-threads.c

diff --git a/src/backend/Makefile.am b/src/backend/Makefile.am
index c2161cc82..5729d910b 100644
--- a/src/backend/Makefile.am
+++ b/src/backend/Makefile.am
@@ -19,7 +19,7 @@ liblumierabackend_la_srcdir = $(top_srcdir)/src/backend
 lib_LTLIBRARIES += liblumierabackend.la
 
 liblumierabackend_la_CPPFLAGS = $(AM_CPPFLAGS)
-liblumierabackend_la_CFLAGS = $(AM_CFLAGS) -std=gnu99 -Wextra -Wall -Werror 
+liblumierabackend_la_CFLAGS = $(AM_CFLAGS) -std=gnu99 -Wextra -Wall -Werror
 liblumierabackend_la_LIBADD = liblumiera.la
 
 liblumierabackend_la_SOURCES =					\
@@ -29,10 +29,10 @@ liblumierabackend_la_SOURCES =					\
 	$(liblumierabackend_la_srcdir)/file.c			\
 	$(liblumierabackend_la_srcdir)/filehandle.c		\
 	$(liblumierabackend_la_srcdir)/filedescriptor.c		\
+	$(liblumierabackend_la_srcdir)/filehandlecache.c	\
 	$(liblumierabackend_la_srcdir)/mmap.c			\
 	$(liblumierabackend_la_srcdir)/mmapings.c		\
 	$(liblumierabackend_la_srcdir)/mmapcache.c		\
-	$(liblumierabackend_la_srcdir)/filehandlecache.c	\
 	$(liblumierabackend_la_srcdir)/enginefacade.cpp		\
 	$(liblumierabackend_la_srcdir)/scriptrunnerfacade.cpp	\
 	$(liblumierabackend_la_srcdir)/netnodefacade.cpp
diff --git a/src/backend/threads.c b/src/backend/threads.c
index 794d13b79..1ff7184f9 100644
--- a/src/backend/threads.c
+++ b/src/backend/threads.c
@@ -21,6 +21,7 @@
 
 //TODO: Support library includes//
 
+#include "include/logging.h"
 
 //TODO: Lumiera header includes//
 #include "threads.h"
@@ -41,8 +42,29 @@
 
 //code goes here//
 
-/* really dumb mutex, to make the mockup little less brittle */
-static pthread_mutex_t threads_mutex = PTHREAD_MUTEX_INITIALIZER;
+
+struct lumiera_thread_mockup
+{
+  void (*fn)(void*);
+  void* arg;
+  LumieraReccondition finished;
+};
+
+
+static void* pthread_runner (void* thread)
+{
+  pthread_setcancelstate (PTHREAD_CANCEL_DISABLE, NULL);
+
+  struct lumiera_thread_mockup* starter = (struct lumiera_thread_mockup*) thread;
+
+  starter->fn (starter->arg);
+
+  LUMIERA_RECCONDITION_SECTION(cond_sync, starter->finished)
+    LUMIERA_RECCONDITION_BROADCAST;
+
+  return NULL;
+}
+
 
 static pthread_once_t attr_once = PTHREAD_ONCE_INIT;
 static pthread_attr_t attrs;
@@ -51,42 +73,22 @@ static void thread_attr_init (void)
 {
   pthread_attr_init (&attrs);
   pthread_attr_setdetachstate (&attrs, PTHREAD_CREATE_DETACHED);
-  pthread_attr_setdetachstate (&attrs, PTHREAD_CREATE_DETACHED);
+  //cancel ...
 }
 
-struct lumiera_thread_mockup
-{
-  void (*fn)(void*);
-  void* arg;
-};
-
-
-static void* pthread_runner (void* thread)
-{
-  struct lumiera_thread_mockup* starter = (struct lumiera_thread_mockup*) thread;
-  (void) starter;
-  pthread_mutex_lock (&threads_mutex);
-  pthread_mutex_unlock (&threads_mutex);
-  starter->fn (starter->arg);
-  return NULL;
-}
-
-
+ 
 LumieraThread
 lumiera_thread_run (enum lumiera_thread_class kind,
                     void (*start_routine)(void *),
                     void * arg,
-                    LumieraCondition finished,
+                    LumieraReccondition finished,
                     const char* purpose,
                     struct nobug_flag* flag)
 {
   (void) kind;
-  (void) finished;
   (void) purpose;
   (void) flag;
 
-  REQUIRE (!finished, "Condition variable for finish notification not yet implemented");
-
   if (attr_once == PTHREAD_ONCE_INIT)
     pthread_once (&attr_once, thread_attr_init);
 
@@ -94,14 +96,11 @@ lumiera_thread_run (enum lumiera_thread_class kind,
 
   thread.fn = start_routine;
   thread.arg = arg;
-
-  pthread_mutex_lock (&threads_mutex);
+  thread.finished = finished;
 
   pthread_t dummy;
   int error = pthread_create (&dummy, &attrs, pthread_runner, &thread);
 
-  pthread_mutex_unlock (&threads_mutex);
-
   if (error) return 0;        /////TODO temporary addition by Ichthyo; probably we'll set lumiera_error?
   return (LumieraThread) 1;
 }
diff --git a/src/backend/threads.h b/src/backend/threads.h
index 50786c729..9d420fa2f 100644
--- a/src/backend/threads.h
+++ b/src/backend/threads.h
@@ -23,7 +23,7 @@
 #define LUMIERA_THREADS_H
 
 //TODO: Support library includes//
-#include "lib/condition.h"
+#include "lib/reccondition.h"
 
 
 //TODO: Forward declarations//
@@ -96,7 +96,7 @@ LumieraThread
 lumiera_thread_run (enum lumiera_thread_class kind,
                     void (*start_routine)(void *),
                     void * arg,
-                    LumieraCondition finished,
+                    LumieraReccondition finished,
                     const char* purpose,
                     struct nobug_flag* flag);
 
diff --git a/tests/Makefile.am b/tests/Makefile.am
index acaf205b6..f5404f3f1 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -105,4 +105,10 @@ test_interfaces_LDADD = 			\
 	-lboost_program_options-mt		\
 	-lboost_regex-mt
 
+check_PROGRAMS += test-threads
+test_threads_SOURCES = $(tests_srcdir)/backend/test-threads.c
+test_threads_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror -I$(top_srcdir)/src/
+test_threads_CFLAGS = $(AM_CFLAGS) $(PTHREAD_CFLAGS)
+test_threads_LDADD = liblumierabackend.la liblumiera.la -lnobugmt -lpthread -ldl -lm     liblumieracommon.la liblumieraproc.la -ldl -lboost_program_options-mt -lboost_regex-mt
+
 TESTS = $(tests_srcdir)/test.sh
diff --git a/tests/backend/test-threads.c b/tests/backend/test-threads.c
new file mode 100644
index 000000000..14237f7a2
--- /dev/null
+++ b/tests/backend/test-threads.c
@@ -0,0 +1,159 @@
+/*
+  test-threads.c  -  test thread management
+
+  Copyright (C)         Lumiera.org
+    2008,               Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+//#include <stdio.h>
+//#include <string.h>
+
+#include "common/config.h"
+
+#include "include/logging.h"
+#include "lib/mutex.h"
+#include "backend/threads.h"
+#include "tests/test.h"
+
+#include <unistd.h>
+#include <errno.h>
+#include <time.h>
+
+void threadfn(void* blah)
+{
+  (void) blah;
+  struct timespec wait = {0,300000000};
+
+  fprintf (stderr, "thread running %s\n", NOBUG_THREAD_ID_GET);
+  nanosleep (&wait, NULL);
+  fprintf (stderr, "thread done %s\n", NOBUG_THREAD_ID_GET);
+}
+
+
+void threadsyncfn(void* blah)
+{
+  struct timespec wait = {0,200000000};
+  LumieraReccondition sync = (LumieraReccondition) blah;
+
+  ECHO ("thread starting up %s", NOBUG_THREAD_ID_GET);
+  LUMIERA_RECCONDITION_SECTION(cond_sync, sync)
+    {
+      ECHO ("send startup signal %s", NOBUG_THREAD_ID_GET);
+      LUMIERA_RECCONDITION_SIGNAL;
+      ECHO ("wait for trigger %s", NOBUG_THREAD_ID_GET);
+      LUMIERA_RECCONDITION_WAIT(1);
+    }
+
+  ECHO ("thread running %s", NOBUG_THREAD_ID_GET);
+  nanosleep (&wait, NULL);
+  ECHO ("thread done %s", NOBUG_THREAD_ID_GET);
+}
+
+
+
+lumiera_mutex testmutex;
+
+void mutexfn(void* blah)
+{
+  (void) blah;
+  struct timespec wait = {0,300000000};
+
+  LUMIERA_MUTEX_SECTION (NOBUG_ON, &testmutex)
+    {
+      fprintf (stderr, "mutex thread running %s\n", NOBUG_THREAD_ID_GET);
+      nanosleep (&wait, NULL);
+      fprintf (stderr, "thread done %s\n", NOBUG_THREAD_ID_GET);
+    }
+}
+
+
+
+TESTS_BEGIN
+
+TEST ("simple_thread")
+{
+  fprintf (stderr, "main before thread %s\n", NOBUG_THREAD_ID_GET);
+
+  lumiera_thread_run (LUMIERA_THREAD_WORKER,
+                      threadfn,
+                      NULL,
+                      NULL,
+                      argv[1],
+                      NULL);
+
+  struct timespec wait = {0,600000000};
+  nanosleep (&wait, NULL);
+  fprintf (stderr, "main after thread %s\n", NOBUG_THREAD_ID_GET);
+}
+
+TEST ("thread_synced")
+{
+  lumiera_reccondition cnd;
+  lumiera_reccondition_init (&cnd, "threadsync", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_RECCONDITION_SECTION(cond_sync, &cnd)
+    {
+      ECHO ("main before thread %s", NOBUG_THREAD_ID_GET);
+
+      lumiera_thread_run (LUMIERA_THREAD_WORKER,
+                          threadsyncfn,
+                          &cnd,
+                          &cnd,
+                          argv[1],
+                          NULL);
+
+      ECHO ("main wait for thread being ready %s", NOBUG_THREAD_ID_GET);
+      LUMIERA_RECCONDITION_WAIT(1);
+
+      ECHO ("main trigger thread %s", NOBUG_THREAD_ID_GET);
+      LUMIERA_RECCONDITION_SIGNAL;
+
+      ECHO ("wait for thread end %s", NOBUG_THREAD_ID_GET);
+      LUMIERA_RECCONDITION_WAIT(1);
+      ECHO ("thread ended %s", NOBUG_THREAD_ID_GET);
+    }
+
+  lumiera_reccondition_destroy (&cnd, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
+
+TEST ("mutex_thread")
+{
+  lumiera_mutex_init (&testmutex, "test", &NOBUG_FLAG(NOBUG_ON));
+
+  LUMIERA_MUTEX_SECTION (NOBUG_ON, &testmutex)
+    {
+      fprintf (stderr, "main before thread %s\n", NOBUG_THREAD_ID_GET);
+
+      lumiera_thread_run (LUMIERA_THREAD_WORKER,
+                          mutexfn,
+                          NULL,
+                          NULL,
+                          argv[1],
+                          NULL);
+
+      struct timespec wait = {0,600000000};
+      nanosleep (&wait, NULL);
+      fprintf (stderr, "main after thread %s\n", NOBUG_THREAD_ID_GET);
+    }
+
+  lumiera_mutex_destroy (&testmutex, &NOBUG_FLAG(NOBUG_ON));
+}
+
+
+TESTS_END
diff --git a/tests/library/test-locking.c b/tests/library/test-locking.c
index 5728783ec..14ec0c458 100644
--- a/tests/library/test-locking.c
+++ b/tests/library/test-locking.c
@@ -254,6 +254,7 @@ TEST ("conditionsection")
 }
 
 
+
 TEST ("conditionforgotunlock")
 {
   lumiera_condition cond;

From 99b5f8d44d7aae9f3d1443c95311428910ddd90d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 29 Jan 2009 20:05:52 +0100
Subject: [PATCH 063/368] adapt the Sync template

---
 src/lib/sync.hpp | 57 +++++++++++++++++++++++++++---------------------
 1 file changed, 32 insertions(+), 25 deletions(-)

diff --git a/src/lib/sync.hpp b/src/lib/sync.hpp
index 4a20852b6..c4cef10ed 100644
--- a/src/lib/sync.hpp
+++ b/src/lib/sync.hpp
@@ -99,11 +99,13 @@ namespace lib {
         protected:
           Wrapped_LumieraExcMutex() { lumiera_mutex_init    (this, "Obj.Monitor ExclMutex", &NOBUG_FLAG(sync)); }
          ~Wrapped_LumieraExcMutex() { lumiera_mutex_destroy (this, &NOBUG_FLAG(sync)); }
-         
+          
+          pthread_mutex_t* mutex()  { return &(lumiera_mutex::mutex); }
+          
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __left()     { TODO ("Record we are released the mutex"); }
+         void __left()      { TODO ("Record we released the mutex"); }
         };
       
       
@@ -113,11 +115,13 @@ namespace lib {
         protected:
           Wrapped_LumieraRecMutex() { lumiera_recmutex_init (this, "Obj.Monitor RecMutex", &NOBUG_FLAG(sync)); }
          ~Wrapped_LumieraRecMutex() { lumiera_recmutex_destroy (this, &NOBUG_FLAG(sync)); }
-         
+          
+          pthread_mutex_t* mutex()  { return &recmutex; }
+          
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __left()     { TODO ("Record we are released the mutex"); }
+         void __left()      { TODO ("Record we are released the mutex"); }
         };
       
       
@@ -127,11 +131,14 @@ namespace lib {
         protected:
           Wrapped_LumieraExcCond() { lumiera_condition_init    (this, "Obj.Monitor ExclCondition", &NOBUG_FLAG(sync) ); }
          ~Wrapped_LumieraExcCond() { lumiera_condition_destroy (this, &NOBUG_FLAG(sync) ); }
-         
+          
+          pthread_mutex_t* mutex() { return &cndmutex; }
+          pthread_cond_t*  condv() { return &cond;     }
+          
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __left()     { TODO ("Record we are released the mutex"); }
+         void __left()      { TODO ("Record we released the mutex"); }
         };
       
       
@@ -141,11 +148,14 @@ namespace lib {
         protected:
           Wrapped_LumieraRecCond() { lumiera_reccondition_init    (this, "Obj.Monitor RecCondition", &NOBUG_FLAG(sync) ); } ////////TODO
          ~Wrapped_LumieraRecCond() { lumiera_reccondition_destroy (this, &NOBUG_FLAG(sync) ); }
-         
+          
+          pthread_mutex_t* mutex() { return &reccndmutex; }
+          pthread_cond_t*  condv() { return &cond;        }
+          
          //------------------Resource-Tracking------
          void __may_block() { TODO ("Record we may block on mutex"); }
          void __enter()     { TODO ("Record we successfully acquired the mutex"); }
-         void __left()     { TODO ("Record we are released the mutex"); }
+         void __left()     { TODO ("Record we released the mutex"); }
         };
       
       
@@ -157,7 +167,7 @@ namespace lib {
         : protected MTX
         {
         protected:
-          //using MTX::mutex;
+          using MTX::mutex;
           using MTX::__may_block;
           using MTX::__enter;
           using MTX::__left;
@@ -172,21 +182,18 @@ namespace lib {
             acquire()
               {
                 __may_block();
-
-                FIXME ("For to make C typesafe we have now mutex and recmutex member gnah :P -- cehteh");
-                // well .. specialization on the mutex type shall solve it ...
-                //if (pthread_mutex_lock (&mutex))
-                //  throw lumiera::error::State("Mutex acquire failed.");  ///////TODO capture the error-code
-
+                
+                if (pthread_mutex_lock (mutex()))
+                  throw lumiera::error::State("Mutex acquire failed.");  ///////TODO capture the error-code
+                
                 __enter();
               }
             
             void
             release()
-              {
-                FIXME ("For to make C typesafe we have now mutex and recmutex member gnah :P -- cehteh");
-                //pthread_mutex_unlock (&mutex);
-
+              { 
+                pthread_mutex_unlock (mutex());
+                
                 __left();
               }
             
@@ -201,7 +208,7 @@ namespace lib {
         : public Mutex<CDX>
         {
         protected:
-          using CDX::cond;
+          using CDX::condv;
           using CDX::mutex;
           
         public:
@@ -209,9 +216,9 @@ namespace lib {
           signal (bool wakeAll=false)
             {
               if (wakeAll)
-                  pthread_cond_broadcast (&cond);
+                  pthread_cond_broadcast (condv());
               else
-                  pthread_cond_signal (&cond);
+                  pthread_cond_signal (condv());
             }
           
           
@@ -222,9 +229,9 @@ namespace lib {
               int err=0;
               while (!predicate() && !err)
                 if (waitEndTime)
-                  err = pthread_cond_timedwait (&cond, &mutex, &waitEndTime);
+                  err = pthread_cond_timedwait (condv(), mutex(), &waitEndTime);
                 else
-                  err = pthread_cond_wait (&cond, &mutex);
+                  err = pthread_cond_wait (condv(), mutex());
               
               if (!err)           return true;
               if (ETIMEDOUT==err) return false;
@@ -442,7 +449,7 @@ namespace lib {
 #endif
 /*
 // Local Variables:
-// mode: C
+// mode: C++
 // c-file-style: "gnu"
 // indent-tabs-mode: nil
 // End:

From 2a9d59ccd03f264515ffe72181b9080fa457095b Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Mon, 11 May 2009 17:08:34 +0200
Subject: [PATCH 064/368] WIP: pooled allocator, initial version

 * creating and allocating, freeing elements
 * live objects will be destructed when a mpool gets destroyed and a
   destructor was set up
---
 src/include/logging.h      |   1 +
 src/lib/Makefile.am        |   2 +
 src/lib/mpool.c            | 487 +++++++++++++++++++++++++++++++++++++
 src/lib/mpool.h            | 173 +++++++++++++
 tests/15mpool.tests        |  46 ++++
 tests/Makefile.am          |   5 +
 tests/library/test-mpool.c | 191 +++++++++++++++
 7 files changed, 905 insertions(+)
 create mode 100644 src/lib/mpool.c
 create mode 100644 src/lib/mpool.h
 create mode 100644 tests/15mpool.tests
 create mode 100644 tests/library/test-mpool.c

diff --git a/src/include/logging.h b/src/include/logging.h
index 202836c08..4d674bc03 100644
--- a/src/include/logging.h
+++ b/src/include/logging.h
@@ -89,6 +89,7 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (  proc_dbg,                    debugging);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (  gui_dbg,                     debugging);
 /** base if debug logging for the support library */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (  library_dbg,                 debugging);
+NOBUG_CPP_DEFINE_FLAG_PARENT    (   mpool_dbg,                  library_dbg);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   psplay_dbg,                 library_dbg);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   resourcecollector_dbg,      library_dbg);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   mutex_dbg,                  library_dbg);
diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index 8991e2e39..98a0eb91d 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -23,6 +23,7 @@ liblumiera_la_CXXFLAGS = $(AM_CXXFLAGS) -Wall -Wextra
 
 liblumiera_la_SOURCES =						\
 	$(liblumiera_la_srcdir)/error.c				\
+	$(liblumiera_la_srcdir)/mpool.c				\
 	$(liblumiera_la_srcdir)/exception.cpp 			\
 	$(liblumiera_la_srcdir)/mutex.c				\
 	$(liblumiera_la_srcdir)/recmutex.c			\
@@ -51,6 +52,7 @@ liblumiera_la_SOURCES =						\
 noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/error.h				\
 	$(liblumiera_la_srcdir)/error.hpp			\
+	$(liblumiera_la_srcdir)/mpool.h				\
 	$(liblumiera_la_srcdir)/mutex.h				\
 	$(liblumiera_la_srcdir)/recmutex.h			\
 	$(liblumiera_la_srcdir)/rwlock.h			\
diff --git a/src/lib/mpool.c b/src/lib/mpool.c
new file mode 100644
index 000000000..0810efacc
--- /dev/null
+++ b/src/lib/mpool.c
@@ -0,0 +1,487 @@
+/*
+    mpool.h - memory pool for constant sized objects
+
+  Copyright (C)         Lumiera.org
+    2009,               Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#include <stdlib.h>
+#include <stdio.h>
+#include <stdint.h>
+#include <stdbool.h>
+#include <limits.h>
+
+#include "mpool.h"
+
+/*
+  Cluster and node structures are private
+*/
+
+typedef struct mpoolcluster_struct mpoolcluster;
+typedef mpoolcluster* MPoolcluster;
+typedef const mpoolcluster* const_MPoolcluster;
+
+struct mpoolcluster_struct
+{
+  llist node;           /* all clusters */
+  void* data[];         /* bitmap and elements */
+};
+
+
+typedef struct mpoolnode_struct mpoolnode;
+typedef mpoolnode* MPoolnode;
+typedef const mpoolnode* const_MPoolnode;
+
+struct mpoolnode_struct
+{
+  llist node;
+};
+
+
+MPool
+mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_destroy_fn dtor)
+{
+  TRACE (mpool_dbg, "%p: elem_size %zd: elem_per_cluster %u", self, elem_size, elements_per_cluster);
+
+  if (self)
+    {
+      llist_init (&self->freelist);
+      llist_init (&self->clusters);
+      self->elem_size = (elem_size+sizeof(void*)-1) / sizeof(void*) * sizeof(void*);    /* void* aligned */
+
+      /* minimum size is the size of a llist node */
+      if (self->elem_size < sizeof(llist))
+        self->elem_size = sizeof(llist);
+
+      self->elements_per_cluster = elements_per_cluster;
+
+      self->elements_free = 0;
+      self->destroy = dtor;
+      self->locality = NULL;
+    }
+
+  return self;
+}
+
+
+#define MPOOL_BITMAP_SIZE(elements_per_cluster)                 \
+  (((elements_per_cluster) + sizeof(uintptr_t)*CHAR_BIT - 1)    \
+  / (sizeof(uintptr_t) * CHAR_BIT) * sizeof (uintptr_t))
+
+
+static inline void*
+cluster_element_get (MPoolcluster cluster, MPool self, unsigned n)
+{
+  return (void*)cluster +                                       /* start address */
+    sizeof (*cluster) +                                         /* header */
+    MPOOL_BITMAP_SIZE (self->elements_per_cluster) +            /* bitmap */
+    self->elem_size * n;                                        /* offset*/
+}
+
+
+static inline bool
+bitmap_bit_get_nth (MPoolcluster cluster, unsigned index)
+{
+  TRACE (mpool_dbg, "cluster %p: index %u", cluster, index);
+
+  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+
+  return bitmap[div.quot] & ((uintptr_t)1<<div.rem);
+}
+
+
+MPool
+mpool_destroy (MPool self)
+{
+  TRACE (mpool_dbg, "%p", self);
+  if (self)
+    {
+      LLIST_WHILE_TAIL(&self->clusters, cluster)
+        {
+          if (self->destroy)
+            for (unsigned i = 0; i < self->elements_per_cluster; ++i)
+              {
+                if (bitmap_bit_get_nth ((MPoolcluster)cluster, i))
+                  {
+                    void* obj = cluster_element_get ((MPoolcluster)cluster, self, i);
+                    TRACE (mpool_dbg, "dtor: cluster %p: obj %p: freelist %p", cluster, obj, self->freelist);
+                    self->destroy (obj);
+                  }
+              }
+
+          llist_unlink_fast_ (cluster);
+          TRACE (mpool_dbg, "freeing cluster %p" , cluster);
+          free (cluster);
+        }
+
+      llist_init (&self->freelist);
+      self->elements_free = 0;
+      self->locality = NULL;
+    }
+
+  return self;
+}
+
+
+
+
+MPool
+mpool_cluster_alloc_ (MPool self)
+{
+  MPoolcluster cluster = malloc (sizeof (*cluster) +                                    /* header */
+                                 MPOOL_BITMAP_SIZE (self->elements_per_cluster) +       /* bitmap */
+                                 self->elem_size * self->elements_per_cluster);         /* elements */
+
+  TRACE (mpool_dbg, "%p", cluster);
+
+  if (!cluster)
+    return NULL;
+
+  /* clear the bitmap */
+  memset (&cluster->data, 0, MPOOL_BITMAP_SIZE (self->elements_per_cluster));
+
+  /* initialize freelist */
+  for (unsigned i = 0; i < self->elements_per_cluster; ++i)
+    {
+      MPoolnode node = cluster_element_get (cluster, self, i);
+      TRACE (mpool_dbg, "node %p", node);
+      llist_insert_tail (&self->freelist, llist_init (&node->node));
+    }
+
+  /* we insert the cluster at head because its likely be used next */
+  llist_insert_head (&self->clusters, llist_init (&cluster->node));
+
+  self->elements_free += self->elements_per_cluster;
+
+  return self;
+}
+
+
+static int
+cmp_cluster_contains_element (const_LList cluster, const_LList element, void* self)
+{
+  if (element < cluster)
+    return -1;
+
+  if ((void*)element >
+      (void*)cluster +
+      sizeof (*cluster) +                                               /* header */
+      MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster) +         /* bitmap */
+      ((MPool)self)->elem_size * ((MPool)self)->elements_per_cluster)   /* elements */
+    return 1;
+
+  return 0;
+}
+
+static inline MPoolcluster
+element_cluster_get (MPool self, void* element)
+{
+  return (MPoolcluster) llist_ufind (&self->clusters, (const_LList) element, cmp_cluster_contains_element, self);
+}
+
+
+static inline unsigned
+uintptr_nearestbit (uintptr_t v, unsigned n)
+{
+  unsigned r = 0;
+  uintptr_t mask = 1ULL<<n;
+
+  while (1)
+    {
+      if (v&mask)
+        {
+          if (v&mask& ~(~0ULL<<n))
+            return n-r;
+          else
+            return n+r;
+        }
+      if (mask == ~0ULL)
+        return ~0U;
+      ++r;
+      mask |= ((mask<<1)|(mask>>1));
+    }
+}
+
+
+
+static inline void*
+alloc_near (MPoolcluster cluster, MPool self, void* locality)
+{
+  void* begin_of_elements =
+    (void*)cluster +
+    sizeof (*cluster) +                                                 /* header */
+    MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
+
+#if UINTPTR_MAX > 4294967295U   /* 64 bit */
+  lldiv_t div = lldiv((locality - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+#else                           /* 32 bit */
+  ldiv_t div = ldiv((locality - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+#endif
+
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  unsigned r = ~0U;
+
+  TRACE (mpool_dbg, "cluster %p: bitmap %p %p: elements %p: index %d", cluster, bitmap, bitmap[div.quot], begin_of_elements, div.quot);
+
+  /* the bitmap word at locality */
+  if (bitmap[div.quot] < UINTPTR_MAX)
+    {
+      r = uintptr_nearestbit (~bitmap[div.quot], div.rem);
+    }
+  /* the bitmap word before locality, this gives a slight bias towards the begin, keeping the pool compact */
+  else if (div.quot && bitmap[div.quot-1] < UINTPTR_MAX)
+    {
+      --div.quot;
+      r = uintptr_nearestbit (~bitmap[div.quot], sizeof(uintptr_t)*CHAR_BIT-1);
+    }
+
+  if (r != ~0U)
+    {
+      void* ret = begin_of_elements + ((uintptr_t)(div.quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
+      return ret;
+    }
+  return NULL;
+}
+
+
+static inline void
+bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
+{
+  void* begin_of_elements =
+    (void*)cluster +
+    sizeof (*cluster) +                                                 /* header */
+    MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
+
+#if UINTPTR_MAX > 4294967295U   /* 64 bit */
+  lldiv_t div = lldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+#else                           /* 32 bit */
+  ldiv_t div = ldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+#endif
+
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  bitmap[div.quot] |= ((uintptr_t)1<<div.rem);
+
+  TRACE (mpool_dbg, "set bit %d, index %d, of %p is %p", div.rem, div.quot, element, bitmap[div.quot]);
+}
+
+
+static inline void
+bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
+{
+  void* begin_of_elements =
+    (void*)cluster +
+    sizeof (*cluster) +                                                 /* header */
+    MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
+
+#if UINTPTR_MAX > 4294967295U   /* 64 bit */
+  lldiv_t div = lldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+#else                           /* 32 bit */
+  ldiv_t div = ldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+#endif
+
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  bitmap[div.quot] &= ~((uintptr_t)1<<div.rem);
+
+  TRACE (mpool_dbg, "clear bit %d, index %d, of %p is %p", div.rem, div.quot, element, bitmap[div.quot]);
+}
+
+
+
+
+void*
+mpool_alloc (MPool self)
+{
+  if (!self->elements_free)
+    {
+      if (mpool_cluster_alloc_ (self))
+        {
+          self->locality = NULL; /* supress alloc_near() */
+        }
+      else
+        {
+          ERROR (mpool_dbg, "allocation failure");
+          return NULL;
+        }
+    }
+
+  void* ret = NULL;
+
+  if (self->locality)
+    {
+      ret = alloc_near (element_cluster_get (self, self->locality), self, self->locality);
+      TRACE_IF (ret, mpool_dbg, "near allocation %p", ret);
+    }
+
+  if (!ret)
+    {
+      ret = llist_head (&self->freelist);
+      TRACE_IF (ret, mpool_dbg, "far allocation %p", ret);
+    }
+
+  if (ret)
+    {
+      llist_unlink_fast_ ((LList)ret);
+      bitmap_set_element (element_cluster_get (self, ret), self, ret);
+    }
+
+  TRACE (mpool_dbg, "%p", ret);
+  self->locality = ret;
+  --self->elements_free;
+
+  return ret;
+}
+
+
+
+
+/*
+  put a element back on the pool
+*/
+static inline MPoolnode
+find_near (MPoolcluster cluster, MPool self, void* element)
+{
+  void* begin_of_elements =
+    (void*)cluster +
+    sizeof (*cluster) +                                                 /* header */
+    MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
+
+  uintptr_t index = (element - begin_of_elements) / self->elem_size;
+
+#if UINTPTR_MAX > 4294967295U   /* 64 bit */
+  lldiv_t div = lldiv (index, sizeof(uintptr_t)*CHAR_BIT);
+#else                           /* 32 bit */
+  ldiv_t div = ldiv (index, sizeof(uintptr_t)*CHAR_BIT);
+#endif
+
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  unsigned r = ~0U;
+
+  TRACE (mpool_dbg, "cluster %p: bitmap %p %p: elements %p: index %d", cluster, bitmap, bitmap[div.quot], begin_of_elements, div.quot);
+
+  /* the bitmap word at locality */
+  if (bitmap[div.quot] < UINTPTR_MAX)
+    {
+      r = uintptr_nearestbit (~bitmap[div.quot], div.rem);
+    }
+  /* the bitmap word after element, we assume that elements after the searched element are more likely be free */
+  else if (index < self->elements_per_cluster && bitmap[div.quot+1] < UINTPTR_MAX)
+    {
+      ++div.quot;
+      r = uintptr_nearestbit (~bitmap[div.quot], 0);
+    }
+  /* finally the bitmap word before element */
+  else if (index > 0 && bitmap[div.quot-1] < UINTPTR_MAX)
+    {
+      --div.quot;
+      r = uintptr_nearestbit (~bitmap[div.quot], sizeof(uintptr_t)*CHAR_BIT-1);
+    }
+
+  if (r != ~0U)
+    return begin_of_elements + ((uintptr_t)(div.quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
+
+  return NULL;
+}
+
+void
+mpool_free (MPool self, void* element)
+{
+  if (self && element)
+    {
+      TRACE (mpool_dbg, "mpool %p: element %p", self, element);
+
+      MPoolcluster cluster = element_cluster_get (self,element);
+
+      bitmap_clear_element (cluster, self, element);
+      llist_init (&((MPoolnode)element)->node);
+
+      MPoolnode near = find_near (cluster, self, element);
+      TRACE (mpool_dbg, "near %p", near);
+
+      if (near)
+        {
+          if (near < (MPoolnode)element)
+            llist_insert_next (&near->node, &((MPoolnode)element)->node);
+          else
+            llist_insert_prev (&near->node, &((MPoolnode)element)->node);
+        }
+      else
+        llist_insert_tail (&self->freelist, &((MPoolnode)element)->node);
+
+      bitmap_clear_element (cluster, self, element);
+
+      ++self->elements_free;
+    }
+}
+
+
+unsigned
+mpool_available (MPool self)
+{
+  return self->elements_free;
+}
+
+
+MPool
+mpool_reserve (MPool self, unsigned nelements)
+{
+  if (self)
+    while (self->elements_free < nelements)
+      if (!mpool_cluster_alloc_ (self))
+        return NULL;
+
+  return self;
+}
+
+
+
+void
+nobug_mpool_dump (const_MPool self,
+                  const int depth,
+                  const char* file,
+                  const int line,
+                  const char* func)
+{
+  if (self && depth)
+    {
+      DUMP_LOG ("mpool %p: ", self);
+
+      if (depth > 1)
+        {
+          DUMP_LOG ("  elements_per_cluster %u: ", self->elements_per_cluster);
+          DUMP_LOG ("  elements_free %u: ", self->elements_free);
+        }
+
+      if (depth > 2)
+        {
+          DUMP_LOG ("  clusters %p: ", self->clusters);
+          int i = 0;
+          LLIST_FOREACH (&self->clusters, cluster)
+            DUMP_LOG ("    %p: %u", cluster, ++i);
+        }
+
+      if (depth > 3)
+        {
+          DUMP_LOG ("  freelist %p: ", self->freelist);
+          int i = 0;
+          LLIST_FOREACH (&self->freelist, node)
+            DUMP_LOG ("    %p: %u", node, ++i);
+        }
+    }
+}
+
+
diff --git a/src/lib/mpool.h b/src/lib/mpool.h
new file mode 100644
index 000000000..509e8098a
--- /dev/null
+++ b/src/lib/mpool.h
@@ -0,0 +1,173 @@
+/*
+    mpool.h - memory pool for constant sized objects
+
+  Copyright (C)         Lumiera.org
+    2009,               Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#include <nobug.h>
+#include "lib/llist.h"
+#include "include/logging.h"
+
+/*
+//mpool Memory Pools
+//mpool ------------
+//mpool
+//mpool This memory pools are implemented as clusters of fixed sized elements. New clusters
+//mpool are allocated on demand or manually preallocated with a `reserve()` operation. The pool
+//mpool can be optimized by a `optimize()` operation which sorts the freelist by the addresses of
+//mpool free elements and optionally moves elements (when a move function is provided) to lower
+//mpool to fill up holes and improve cache locality.
+//mpool Clusters can be reclaimed with a `collect()` operation. Optimization and Collection are
+//mpool optional and are never automatically called.
+//mpool
+*/
+
+
+/*
+//index.mpool_destroy_fn xref:mpool_destroy_fn[mpool_destroy_fn]:: function prototype for destroying elements
+//mpool [[mpool_destroy_fn]]
+//mpool .mpool_destroy_fn
+//mpool When a memory pool gets destroyed it can call a destructor for any element which is still in the pool.
+//mpool This destructor is optional.
+//mpool
+//mpool  typedef void (*mpool_destroy_fn)(void* self)
+//mpool
+//mpool  `self`::
+//mpool         element to be destroyed
+//mpool
+*/
+typedef void (*mpool_destroy_fn)(void* self);
+
+
+/*
+//index.struct_mpool xref:struct_mpool[mpool (struct)]:: the memory pool management structure
+//mpool [[struct_mpool]]
+//mpool .mpool
+//mpool  typedef struct mpool_struct mpool
+//mpool  typedef mpool* MPool
+//mpool  typedef const mpool* const_MPool
+//mpool
+//mpool This structure should be considered opaque except for the documented members
+//mpool which may be read.
+//mpool
+//mpool  `unsigned mpool.elements_free`::
+//mpool         number of free elements in the pool
+//mpool
+*/
+typedef struct mpool_struct mpool;
+typedef mpool* MPool;
+typedef const mpool* const_MPool;
+
+struct mpool_struct
+{
+  llist freelist;
+  llist clusters;
+  size_t elem_size;
+  unsigned elements_per_cluster;
+  unsigned elements_free;               /* a counter of free elements is the price we pay to support a reserve() operation */
+  void* locality;
+  mpool_destroy_fn destroy;
+};
+
+
+/*
+//index.mpool_init xref:mpool_init[mpool_init]:: initialize a new memory pool
+//mpool [[mpool_init]]
+//mpool .mpool_init
+//mpool Memory pools must be initialized before being used.
+//mpool
+//mpool  MPool mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_move_fn mv, mpool_destroy_fn dtor)
+//mpool
+//mpool  `self`::
+//mpool         pointer to the memory pool structure to be initialized
+//mpool  `elem_size`::
+//mpool         size for a single element
+//mpool  `elements_per_cluster`::
+//mpool         how many elements to put into a cluster
+//mpool  `dtor`::
+//mpool         pointer to an optional destructor function or NULL
+//mpool  return::
+//mpool         self
+//mpool
+*/
+MPool
+mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_destroy_fn dtor);
+
+
+/*
+//index.mpool_destroy xref:mpool_destroy[mpool_destroy]:: destroy a memory pool
+//mpool [[mpool_destroy]]
+//mpool .mpool_destroy
+//mpool A memory pool is not used anymore it should be destroyed. This frees all memory allocated with it.
+//mpool When a destructor was provided at construction time, then this destructor is used on all non free elements
+//mpool before before the memory is freed. If no destructor was given then the memory is just freed.
+//mpool
+//mpool  MPool mpool_destroy (MPool self)
+//mpool
+//mpool  `self`::
+//mpool         pointer to an initialized memory pool to be destroyed.
+//mpool  return::
+//mpool         self
+//mpool
+//mpool
+*/
+MPool
+mpool_destroy (MPool self);
+
+
+/*
+  query how much free elements are available
+*/
+unsigned
+mpool_available (MPool self);
+
+
+/*
+  resize the pool that at least nelements become available without cluster reallocations
+*/
+MPool
+mpool_reserve (MPool self, unsigned nelements);
+
+
+/*
+  allocate and initialize a new cluster (internal)
+*/
+MPool
+mpool_cluster_alloc_ (MPool self);
+
+
+/*
+  alloc one element from the pool
+*/
+void* mpool_alloc (MPool self);
+
+
+/*
+  put a element back on the pool
+*/
+void
+mpool_free (MPool self, void* element);
+
+
+
+void
+nobug_mpool_dump (const_MPool self,
+                  const int depth,
+                  const char* file,
+                  const int line,
+                  const char* func);
diff --git a/tests/15mpool.tests b/tests/15mpool.tests
new file mode 100644
index 000000000..97efac290
--- /dev/null
+++ b/tests/15mpool.tests
@@ -0,0 +1,46 @@
+TESTING "Memory pool tests" ./test-mpool
+
+TEST "init/destroy" basic <<END
+err: initialized
+err: allocated
+err: freed
+err: destroyed
+return: 0
+END
+
+
+TEST "auto destruction" destroy <<END
+return: !0
+END
+
+
+TEST "cluster allocation" clusters <<END
+return: !0
+END
+
+
+TEST "random usage" random <<END
+return: !0
+END
+
+
+TEST "stats" statscheck <<END
+return: !0
+END
+
+
+TEST "optimizer" optimize <<END
+return: !0
+END
+
+
+TEST "collector" collect <<END
+return: !0
+END
+
+
+TEST "reserve" reserve <<END
+return: !0
+END
+
+
diff --git a/tests/Makefile.am b/tests/Makefile.am
index 405217a18..3105dd6e2 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -34,6 +34,11 @@ test_llist_SOURCES = $(tests_srcdir)/library/test-llist.c
 test_llist_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror
 test_llist_LDADD = $(NOBUGMT_LUMIERA_LIBS)                                  liblumiera.la -lboost_program_options-mt -lboost_regex-mt
 
+check_PROGRAMS += test-mpool
+test_mpool_SOURCES = $(tests_srcdir)/library/test-mpool.c
+test_mpool_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror
+test_mpool_LDADD = liblumiera.la $(NOBUGMT_LUMIERA_LIBS)     liblumieracommon.la liblumieraproc.la -ldl -lboost_program_options-mt -lboost_regex-mt
+
 check_PROGRAMS += test-psplay
 test_psplay_SOURCES = $(tests_srcdir)/library/test-psplay.c
 test_psplay_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror -I$(top_srcdir)/src/
diff --git a/tests/library/test-mpool.c b/tests/library/test-mpool.c
new file mode 100644
index 000000000..f2d66349d
--- /dev/null
+++ b/tests/library/test-mpool.c
@@ -0,0 +1,191 @@
+/*
+    test-mpool.c - memory pool for constant sized objects
+
+  Copyright (C)         Lumiera.org
+    2009,               Christian Thaeter <ct@pipapo.org>
+
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+*/
+
+#include "tests/test.h"
+#include "lib/mpool.h"
+
+
+static void
+dtor (void* o)
+{
+  ECHO("%x @%p", *(int*)o, o);
+}
+
+static void
+move (void* a, void* b)
+{
+  ECHO ("%p (%x) to %p ", b, *(int*)b, a);
+  *(int*)a = *(int*)b;
+  *(void**)b = NULL;
+}
+
+TESTS_BEGIN
+
+TEST ("basic")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(void*), 10, move, dtor);
+  ECHO ("initialized");
+
+  void* element;
+  element = mpool_alloc (&mypool);
+  ECHO ("allocated %p", element);
+  *(int*)element = 0xdeadbabe;
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_free (&mypool, element);
+  ECHO ("freed");
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+TEST ("destroy")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(void*), 10, move, dtor);
+  ECHO ("initialized");
+
+  void* element;
+  element = mpool_alloc (&mypool);
+  ECHO ("allocated %p", element);
+  *(int*)element = 0xbabeface;
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+TEST ("clusters")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(void*), 2, move, dtor);
+  ECHO ("initialized");
+
+  for (int i = 1; i <= 5; ++i)
+    {
+      void* element;
+      element = mpool_alloc (&mypool);
+      ECHO ("allocated %p", element);
+      *(int*)element = i;
+    }
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
+TEST ("clusters_big")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(void*), 200, move, dtor);
+  ECHO ("initialized");
+
+  for (int i = 1; i <= 700; ++i)
+    {
+      void* element;
+      element = mpool_alloc (&mypool);
+      ECHO ("allocated %p", element);
+      *(int*)element = i;
+    }
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
+TEST ("collect")
+{
+  mpool mypool;
+  mpool_init (&mypool, 24, 4, move, dtor);
+  ECHO ("initialized");
+
+  void* elem[32];
+
+  for (int i = 1; i <= 15; ++i)
+    {
+      elem[i] = mpool_alloc (&mypool);
+      *(int*)(elem[i]) = i;
+    }
+  ECHO ("allocated");
+
+  for (int i = 1; i <= 15; i+=3)
+    {
+      mpool_free (&mypool, elem[i]);
+    }
+  ECHO ("freed some");
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_collect (&mypool, 0);
+  ECHO ("collected");
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+TEST ("collect_no_move")
+{
+  mpool mypool;
+  mpool_init (&mypool, 24, 4, NULL, dtor);
+  ECHO ("initialized");
+
+  void* elem[32];
+
+  for (int i = 1; i <= 15; ++i)
+    {
+      elem[i] = mpool_alloc (&mypool);
+      *(int*)(elem[i]) = i;
+    }
+  ECHO ("allocated");
+
+  for (int i = 1; i <= 15; i+=3)
+    {
+      mpool_free (&mypool, elem[i]);
+    }
+  ECHO ("freed some");
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_collect (&mypool, 0);
+  ECHO ("collected");
+
+  DUMP(NOBUG_ON, mpool, &mypool, 4);
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
+TEST ("reserve")
+{
+}
+
+
+TESTS_END

From 29a1a6a7a06d5ca466e9ecfef758df2b8af95254 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Thu, 14 May 2009 19:56:33 +0200
Subject: [PATCH 065/368] mpool: some pending cosmetics an trace points

---
 src/lib/mpool.c | 61 ++++++++++++++++++++++++-------------------------
 1 file changed, 30 insertions(+), 31 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index 0810efacc..b79dc59b0 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -139,7 +139,6 @@ mpool_destroy (MPool self)
 
 
 
-
 MPool
 mpool_cluster_alloc_ (MPool self)
 {
@@ -165,7 +164,6 @@ mpool_cluster_alloc_ (MPool self)
 
   /* we insert the cluster at head because its likely be used next */
   llist_insert_head (&self->clusters, llist_init (&cluster->node));
-
   self->elements_free += self->elements_per_cluster;
 
   return self;
@@ -188,6 +186,7 @@ cmp_cluster_contains_element (const_LList cluster, const_LList element, void* se
   return 0;
 }
 
+
 static inline MPoolcluster
 element_cluster_get (MPool self, void* element)
 {
@@ -218,26 +217,26 @@ uintptr_nearestbit (uintptr_t v, unsigned n)
 }
 
 
-
 static inline void*
 alloc_near (MPoolcluster cluster, MPool self, void* locality)
 {
+  TRACE (mpool_dbg, "locality %p", locality);
   void* begin_of_elements =
     (void*)cluster +
     sizeof (*cluster) +                                                 /* header */
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
+  uintptr_t index = (locality - begin_of_elements) / self->elem_size;
+
 #if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv((locality - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+  lldiv_t div = lldiv(index, sizeof(uintptr_t)*CHAR_BIT);
 #else                           /* 32 bit */
-  ldiv_t div = ldiv((locality - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
 #endif
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
 
-  TRACE (mpool_dbg, "cluster %p: bitmap %p %p: elements %p: index %d", cluster, bitmap, bitmap[div.quot], begin_of_elements, div.quot);
-
   /* the bitmap word at locality */
   if (bitmap[div.quot] < UINTPTR_MAX)
     {
@@ -250,7 +249,7 @@ alloc_near (MPoolcluster cluster, MPool self, void* locality)
       r = uintptr_nearestbit (~bitmap[div.quot], sizeof(uintptr_t)*CHAR_BIT-1);
     }
 
-  if (r != ~0U)
+  if (r != ~0U && (div.quot*sizeof(uintptr_t)*CHAR_BIT+r) < self->elements_per_cluster)
     {
       void* ret = begin_of_elements + ((uintptr_t)(div.quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
       return ret;
@@ -267,10 +266,12 @@ bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
     sizeof (*cluster) +                                                 /* header */
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
+  uintptr_t index = (element - begin_of_elements) / self->elem_size;
+
 #if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+  lldiv_t div = lldiv(index, sizeof(uintptr_t)*CHAR_BIT);
 #else                           /* 32 bit */
-  ldiv_t div = ldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
 #endif
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
@@ -288,24 +289,26 @@ bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
     sizeof (*cluster) +                                                 /* header */
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
+  uintptr_t index = (element - begin_of_elements) / self->elem_size;
+
 #if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+  lldiv_t div = lldiv(index, sizeof(uintptr_t)*CHAR_BIT);
 #else                           /* 32 bit */
-  ldiv_t div = ldiv((element - begin_of_elements) / self->elem_size, sizeof(uintptr_t)*CHAR_BIT);
+  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
 #endif
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[div.quot] &= ~((uintptr_t)1<<div.rem);
 
-  TRACE (mpool_dbg, "clear bit %d, index %d, of %p is %p", div.rem, div.quot, element, bitmap[div.quot]);
+  TRACE (mpool_dbg, "cleared bit %d, index %d, of %p is %p", div.rem, div.quot, element, bitmap[div.quot]);
 }
 
 
-
-
 void*
 mpool_alloc (MPool self)
 {
+  TRACE (mpool_dbg);
+
   if (!self->elements_free)
     {
       if (mpool_cluster_alloc_ (self))
@@ -335,11 +338,10 @@ mpool_alloc (MPool self)
 
   if (ret)
     {
-      llist_unlink_fast_ ((LList)ret);
       bitmap_set_element (element_cluster_get (self, ret), self, ret);
+      llist_unlink_fast_ ((LList)ret);
     }
 
-  TRACE (mpool_dbg, "%p", ret);
   self->locality = ret;
   --self->elements_free;
 
@@ -347,11 +349,6 @@ mpool_alloc (MPool self)
 }
 
 
-
-
-/*
-  put a element back on the pool
-*/
 static inline MPoolnode
 find_near (MPoolcluster cluster, MPool self, void* element)
 {
@@ -371,8 +368,6 @@ find_near (MPoolcluster cluster, MPool self, void* element)
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
 
-  TRACE (mpool_dbg, "cluster %p: bitmap %p %p: elements %p: index %d", cluster, bitmap, bitmap[div.quot], begin_of_elements, div.quot);
-
   /* the bitmap word at locality */
   if (bitmap[div.quot] < UINTPTR_MAX)
     {
@@ -391,12 +386,13 @@ find_near (MPoolcluster cluster, MPool self, void* element)
       r = uintptr_nearestbit (~bitmap[div.quot], sizeof(uintptr_t)*CHAR_BIT-1);
     }
 
-  if (r != ~0U)
+  if (r != ~0U && (div.quot*sizeof(uintptr_t)*CHAR_BIT+r) < self->elements_per_cluster)
     return begin_of_elements + ((uintptr_t)(div.quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
 
   return NULL;
 }
 
+
 void
 mpool_free (MPool self, void* element)
 {
@@ -405,15 +401,14 @@ mpool_free (MPool self, void* element)
       TRACE (mpool_dbg, "mpool %p: element %p", self, element);
 
       MPoolcluster cluster = element_cluster_get (self,element);
+      MPoolnode near = find_near (cluster, self, element);
 
       bitmap_clear_element (cluster, self, element);
       llist_init (&((MPoolnode)element)->node);
 
-      MPoolnode near = find_near (cluster, self, element);
-      TRACE (mpool_dbg, "near %p", near);
-
       if (near)
         {
+          TRACE (mpool_dbg, "found near %p", near);
           if (near < (MPoolnode)element)
             llist_insert_next (&near->node, &((MPoolnode)element)->node);
           else
@@ -422,8 +417,6 @@ mpool_free (MPool self, void* element)
       else
         llist_insert_tail (&self->freelist, &((MPoolnode)element)->node);
 
-      bitmap_clear_element (cluster, self, element);
-
       ++self->elements_free;
     }
 }
@@ -448,7 +441,6 @@ mpool_reserve (MPool self, unsigned nelements)
 }
 
 
-
 void
 nobug_mpool_dump (const_MPool self,
                   const int depth,
@@ -485,3 +477,10 @@ nobug_mpool_dump (const_MPool self,
 }
 
 
+/*
+//      Local Variables:
+//      mode: C
+//      c-file-style: "gnu"
+//      indent-tabs-mode: nil
+//      End:
+*/

From 9ed817df97d95acf59ace3f3521affe424ced9c8 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Thu, 14 May 2009 22:43:05 +0200
Subject: [PATCH 066/368] mpool: precalculate cluster size to avoid excess
 recalculations

Callgrind before:
 1,963,501,246  PROGRAM TOTALS
After:
 1,747,160,336  PROGRAM TOTALS
---
 src/lib/mpool.c | 28 +++++++++++-----------------
 src/lib/mpool.h |  2 ++
 2 files changed, 13 insertions(+), 17 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index b79dc59b0..ae496c85c 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -21,7 +21,6 @@
 
 #include <stdlib.h>
 #include <stdio.h>
-#include <stdint.h>
 #include <stdbool.h>
 #include <limits.h>
 
@@ -51,6 +50,9 @@ struct mpoolnode_struct
   llist node;
 };
 
+#define MPOOL_BITMAP_SIZE(elements_per_cluster)                 \
+  (((elements_per_cluster) + sizeof(uintptr_t)*CHAR_BIT - 1)    \
+  / (sizeof(uintptr_t) * CHAR_BIT) * sizeof (uintptr_t))
 
 MPool
 mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_destroy_fn dtor)
@@ -69,6 +71,10 @@ mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_d
 
       self->elements_per_cluster = elements_per_cluster;
 
+      self->cluster_size = sizeof (mpoolcluster) +              /* header */
+        MPOOL_BITMAP_SIZE (self->elements_per_cluster) +        /* bitmap */
+        self->elem_size * self->elements_per_cluster;           /* elements */
+
       self->elements_free = 0;
       self->destroy = dtor;
       self->locality = NULL;
@@ -78,11 +84,6 @@ mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_d
 }
 
 
-#define MPOOL_BITMAP_SIZE(elements_per_cluster)                 \
-  (((elements_per_cluster) + sizeof(uintptr_t)*CHAR_BIT - 1)    \
-  / (sizeof(uintptr_t) * CHAR_BIT) * sizeof (uintptr_t))
-
-
 static inline void*
 cluster_element_get (MPoolcluster cluster, MPool self, unsigned n)
 {
@@ -142,10 +143,7 @@ mpool_destroy (MPool self)
 MPool
 mpool_cluster_alloc_ (MPool self)
 {
-  MPoolcluster cluster = malloc (sizeof (*cluster) +                                    /* header */
-                                 MPOOL_BITMAP_SIZE (self->elements_per_cluster) +       /* bitmap */
-                                 self->elem_size * self->elements_per_cluster);         /* elements */
-
+  MPoolcluster cluster = malloc (self->cluster_size);
   TRACE (mpool_dbg, "%p", cluster);
 
   if (!cluster)
@@ -171,16 +169,12 @@ mpool_cluster_alloc_ (MPool self)
 
 
 static int
-cmp_cluster_contains_element (const_LList cluster, const_LList element, void* self)
+cmp_cluster_contains_element (const_LList cluster, const_LList element, void* cluster_size)
 {
   if (element < cluster)
     return -1;
 
-  if ((void*)element >
-      (void*)cluster +
-      sizeof (*cluster) +                                               /* header */
-      MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster) +         /* bitmap */
-      ((MPool)self)->elem_size * ((MPool)self)->elements_per_cluster)   /* elements */
+  if ((void*)element > (void*)cluster + (uintptr_t)cluster_size)
     return 1;
 
   return 0;
@@ -190,7 +184,7 @@ cmp_cluster_contains_element (const_LList cluster, const_LList element, void* se
 static inline MPoolcluster
 element_cluster_get (MPool self, void* element)
 {
-  return (MPoolcluster) llist_ufind (&self->clusters, (const_LList) element, cmp_cluster_contains_element, self);
+  return (MPoolcluster) llist_ufind (&self->clusters, (const_LList) element, cmp_cluster_contains_element, (void*)self->cluster_size);
 }
 
 
diff --git a/src/lib/mpool.h b/src/lib/mpool.h
index 509e8098a..8d52950d1 100644
--- a/src/lib/mpool.h
+++ b/src/lib/mpool.h
@@ -19,6 +19,7 @@
   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
+#include <stdint.h>
 #include <nobug.h>
 #include "lib/llist.h"
 #include "include/logging.h"
@@ -79,6 +80,7 @@ struct mpool_struct
   llist clusters;
   size_t elem_size;
   unsigned elements_per_cluster;
+  uintptr_t cluster_size;
   unsigned elements_free;               /* a counter of free elements is the price we pay to support a reserve() operation */
   void* locality;
   mpool_destroy_fn destroy;

From 0dc0d18703f5baebe50764f2be241a35677e4fe4 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Thu, 14 May 2009 23:48:39 +0200
Subject: [PATCH 067/368] mpool: ldiv() division bites the dust in favor of
 some bitops

before:
 1,747,160,336  PROGRAM TOTALS
after:
 1,371,806,087  PROGRAM TOTALS
---
 src/lib/mpool.c | 87 +++++++++++++++++++++++--------------------------
 1 file changed, 40 insertions(+), 47 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index ae496c85c..1ef1d4763 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -26,6 +26,14 @@
 
 #include "mpool.h"
 
+
+
+#if UINTPTR_MAX > 4294967295U   /* 64 bit */
+#define MPOOL_DIV_SHIFT 6
+#else                           /* 32 bit */
+#define MPOOL_DIV_SHIFT 5
+#endif
+
 /*
   Cluster and node structures are private
 */
@@ -99,10 +107,11 @@ bitmap_bit_get_nth (MPoolcluster cluster, unsigned index)
 {
   TRACE (mpool_dbg, "cluster %p: index %u", cluster, index);
 
-  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
+  uintptr_t quot = index>>MPOOL_DIV_SHIFT;
+  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
 
-  return bitmap[div.quot] & ((uintptr_t)1<<div.rem);
+  return bitmap[quot] & ((uintptr_t)1<<rem);
 }
 
 
@@ -221,31 +230,27 @@ alloc_near (MPoolcluster cluster, MPool self, void* locality)
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
   uintptr_t index = (locality - begin_of_elements) / self->elem_size;
-
-#if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv(index, sizeof(uintptr_t)*CHAR_BIT);
-#else                           /* 32 bit */
-  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
-#endif
+  uintptr_t quot = index>>MPOOL_DIV_SHIFT;
+  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
 
   /* the bitmap word at locality */
-  if (bitmap[div.quot] < UINTPTR_MAX)
+  if (bitmap[quot] < UINTPTR_MAX)
     {
-      r = uintptr_nearestbit (~bitmap[div.quot], div.rem);
+      r = uintptr_nearestbit (~bitmap[quot], rem);
     }
   /* the bitmap word before locality, this gives a slight bias towards the begin, keeping the pool compact */
-  else if (div.quot && bitmap[div.quot-1] < UINTPTR_MAX)
+  else if (quot && bitmap[quot-1] < UINTPTR_MAX)
     {
-      --div.quot;
-      r = uintptr_nearestbit (~bitmap[div.quot], sizeof(uintptr_t)*CHAR_BIT-1);
+      --quot;
+      r = uintptr_nearestbit (~bitmap[quot], sizeof(uintptr_t)*CHAR_BIT-1);
     }
 
-  if (r != ~0U && (div.quot*sizeof(uintptr_t)*CHAR_BIT+r) < self->elements_per_cluster)
+  if (r != ~0U && (quot*sizeof(uintptr_t)*CHAR_BIT+r) < self->elements_per_cluster)
     {
-      void* ret = begin_of_elements + ((uintptr_t)(div.quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
+      void* ret = begin_of_elements + ((uintptr_t)(quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
       return ret;
     }
   return NULL;
@@ -261,17 +266,13 @@ bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
   uintptr_t index = (element - begin_of_elements) / self->elem_size;
-
-#if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv(index, sizeof(uintptr_t)*CHAR_BIT);
-#else                           /* 32 bit */
-  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
-#endif
+  uintptr_t quot = index>>MPOOL_DIV_SHIFT;
+  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
-  bitmap[div.quot] |= ((uintptr_t)1<<div.rem);
+  bitmap[quot] |= ((uintptr_t)1<<rem);
 
-  TRACE (mpool_dbg, "set bit %d, index %d, of %p is %p", div.rem, div.quot, element, bitmap[div.quot]);
+  TRACE (mpool_dbg, "set bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
 }
 
 
@@ -284,17 +285,13 @@ bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
   uintptr_t index = (element - begin_of_elements) / self->elem_size;
-
-#if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv(index, sizeof(uintptr_t)*CHAR_BIT);
-#else                           /* 32 bit */
-  ldiv_t div = ldiv(index, sizeof(uintptr_t)*CHAR_BIT);
-#endif
+  uintptr_t quot = index>>MPOOL_DIV_SHIFT;
+  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
-  bitmap[div.quot] &= ~((uintptr_t)1<<div.rem);
+  bitmap[quot] &= ~((uintptr_t)1<<rem);
 
-  TRACE (mpool_dbg, "cleared bit %d, index %d, of %p is %p", div.rem, div.quot, element, bitmap[div.quot]);
+  TRACE (mpool_dbg, "cleared bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
 }
 
 
@@ -352,36 +349,32 @@ find_near (MPoolcluster cluster, MPool self, void* element)
     MPOOL_BITMAP_SIZE (((MPool)self)->elements_per_cluster);            /* bitmap */
 
   uintptr_t index = (element - begin_of_elements) / self->elem_size;
-
-#if UINTPTR_MAX > 4294967295U   /* 64 bit */
-  lldiv_t div = lldiv (index, sizeof(uintptr_t)*CHAR_BIT);
-#else                           /* 32 bit */
-  ldiv_t div = ldiv (index, sizeof(uintptr_t)*CHAR_BIT);
-#endif
+  uintptr_t quot = index>>MPOOL_DIV_SHIFT;
+  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
 
   /* the bitmap word at locality */
-  if (bitmap[div.quot] < UINTPTR_MAX)
+  if (bitmap[quot] < UINTPTR_MAX)
     {
-      r = uintptr_nearestbit (~bitmap[div.quot], div.rem);
+      r = uintptr_nearestbit (~bitmap[quot], rem);
     }
   /* the bitmap word after element, we assume that elements after the searched element are more likely be free */
-  else if (index < self->elements_per_cluster && bitmap[div.quot+1] < UINTPTR_MAX)
+  else if (index < self->elements_per_cluster && bitmap[quot+1] < UINTPTR_MAX)
     {
-      ++div.quot;
-      r = uintptr_nearestbit (~bitmap[div.quot], 0);
+      ++quot;
+      r = uintptr_nearestbit (~bitmap[quot], 0);
     }
   /* finally the bitmap word before element */
-  else if (index > 0 && bitmap[div.quot-1] < UINTPTR_MAX)
+  else if (index > 0 && bitmap[quot-1] < UINTPTR_MAX)
     {
-      --div.quot;
-      r = uintptr_nearestbit (~bitmap[div.quot], sizeof(uintptr_t)*CHAR_BIT-1);
+      --quot;
+      r = uintptr_nearestbit (~bitmap[quot], sizeof(uintptr_t)*CHAR_BIT-1);
     }
 
-  if (r != ~0U && (div.quot*sizeof(uintptr_t)*CHAR_BIT+r) < self->elements_per_cluster)
-    return begin_of_elements + ((uintptr_t)(div.quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
+  if (r != ~0U && (quot*sizeof(uintptr_t)*CHAR_BIT+r) < self->elements_per_cluster)
+    return begin_of_elements + ((uintptr_t)(quot*sizeof(uintptr_t)*CHAR_BIT+r)*self->elem_size);
 
   return NULL;
 }

From 92271ba1c1afd99e41b080131a86194b8e83062a Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Fri, 15 May 2009 12:33:01 +0200
Subject: [PATCH 068/368] mpool: add an alloc_near() function which takes a
 explicit hint for locality

---
 src/lib/mpool.c | 46 +++++++++++++++++++++++++++++++++++++++++++++-
 src/lib/mpool.h | 11 ++++++++++-
 2 files changed, 55 insertions(+), 2 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index 1ef1d4763..eafa2d8b3 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -1,5 +1,5 @@
 /*
-    mpool.h - memory pool for constant sized objects
+    mpool.c - memory pool for constant sized objects
 
   Copyright (C)         Lumiera.org
     2009,               Christian Thaeter <ct@pipapo.org>
@@ -340,6 +340,50 @@ mpool_alloc (MPool self)
 }
 
 
+void*
+mpool_alloc_near (MPool self, void* near)
+{
+  TRACE (mpool_dbg);
+
+  if (!self->elements_free)
+    {
+      if (mpool_cluster_alloc_ (self))
+        {
+          near = NULL; /* supress alloc_near() */
+        }
+      else
+        {
+          ERROR (mpool_dbg, "allocation failure");
+          return NULL;
+        }
+    }
+
+  void* ret = NULL;
+
+  if (near)
+    {
+      ret = alloc_near (element_cluster_get (self, near), self, near);
+      TRACE_IF (ret, mpool_dbg, "near allocation %p", ret);
+    }
+
+  if (!ret)
+    {
+      ret = llist_head (&self->freelist);
+      TRACE_IF (ret, mpool_dbg, "far allocation %p", ret);
+    }
+
+  if (ret)
+    {
+      bitmap_set_element (element_cluster_get (self, ret), self, ret);
+      llist_unlink_fast_ ((LList)ret);
+    }
+
+  --self->elements_free;
+
+  return ret;
+}
+
+
 static inline MPoolnode
 find_near (MPoolcluster cluster, MPool self, void* element)
 {
diff --git a/src/lib/mpool.h b/src/lib/mpool.h
index 8d52950d1..f70915827 100644
--- a/src/lib/mpool.h
+++ b/src/lib/mpool.h
@@ -156,7 +156,16 @@ mpool_cluster_alloc_ (MPool self);
 /*
   alloc one element from the pool
 */
-void* mpool_alloc (MPool self);
+void*
+mpool_alloc (MPool self);
+
+/*
+  alloc one element from the pool
+
+  should be near 'near'
+*/
+void*
+mpool_alloc_near (MPool self, void* near);
 
 
 /*

From 58f1fbe3a867817ec1efc10d3c1293a621c24ab3 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Fri, 15 May 2009 01:09:57 +0200
Subject: [PATCH 069/368] mpool: completion

fix tests, add some benchmarks
finished documentation, cosmetics, cleanup
---
 src/lib/mpool.c            |  11 +-
 src/lib/mpool.h            | 127 +++++++++++++++++------
 tests/library/test-mpool.c | 206 ++++++++++++++++++++++++++++++++-----
 3 files changed, 279 insertions(+), 65 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index eafa2d8b3..8a40f3682 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -58,6 +58,11 @@ struct mpoolnode_struct
   llist node;
 };
 
+
+MPool
+mpool_cluster_alloc_ (MPool self);
+
+
 #define MPOOL_BITMAP_SIZE(elements_per_cluster)                 \
   (((elements_per_cluster) + sizeof(uintptr_t)*CHAR_BIT - 1)    \
   / (sizeof(uintptr_t) * CHAR_BIT) * sizeof (uintptr_t))
@@ -453,12 +458,6 @@ mpool_free (MPool self, void* element)
 }
 
 
-unsigned
-mpool_available (MPool self)
-{
-  return self->elements_free;
-}
-
 
 MPool
 mpool_reserve (MPool self, unsigned nelements)
diff --git a/src/lib/mpool.h b/src/lib/mpool.h
index f70915827..18c34dca8 100644
--- a/src/lib/mpool.h
+++ b/src/lib/mpool.h
@@ -29,12 +29,10 @@
 //mpool ------------
 //mpool
 //mpool This memory pools are implemented as clusters of fixed sized elements. New clusters
-//mpool are allocated on demand or manually preallocated with a `reserve()` operation. The pool
-//mpool can be optimized by a `optimize()` operation which sorts the freelist by the addresses of
-//mpool free elements and optionally moves elements (when a move function is provided) to lower
-//mpool to fill up holes and improve cache locality.
-//mpool Clusters can be reclaimed with a `collect()` operation. Optimization and Collection are
-//mpool optional and are never automatically called.
+//mpool are allocated on demand or manually preallocated with a `reserve()` operation.
+//mpool Some efforts are taken to ensure (cache) locality of the provided memory.
+//mpool All functions are reentrant but not threadsafe, if this is desired it is advised to
+//mpool care for proper locking elsewhere.
 //mpool
 */
 
@@ -63,12 +61,7 @@ typedef void (*mpool_destroy_fn)(void* self);
 //mpool  typedef mpool* MPool
 //mpool  typedef const mpool* const_MPool
 //mpool
-//mpool This structure should be considered opaque except for the documented members
-//mpool which may be read.
-//mpool
-//mpool  `unsigned mpool.elements_free`::
-//mpool         number of free elements in the pool
-//mpool
+//mpool This structure should be considered opaque.
 */
 typedef struct mpool_struct mpool;
 typedef mpool* MPool;
@@ -88,10 +81,12 @@ struct mpool_struct
 
 
 /*
-//index.mpool_init xref:mpool_init[mpool_init]:: initialize a new memory pool
+//index.mpool_init xref:mpool_init[mpool_init()]:: initialize a new memory pool
 //mpool [[mpool_init]]
 //mpool .mpool_init
-//mpool Memory pools must be initialized before being used.
+//mpool Initialize a memory pool, memory pools must be initialized before being used. One can supply
+//mpool an optional destructor function for elements, this will be used to destroy elements which are still
+//mpool in the pool when it gets destroyed itself. The destructor is _NOT_ called when elemented are freed.
 //mpool
 //mpool  MPool mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_move_fn mv, mpool_destroy_fn dtor)
 //mpool
@@ -112,12 +107,14 @@ mpool_init (MPool self, size_t elem_size, unsigned elements_per_cluster, mpool_d
 
 
 /*
-//index.mpool_destroy xref:mpool_destroy[mpool_destroy]:: destroy a memory pool
+//index.mpool_destroy xref:mpool_destroy[mpool_destroy()]:: destroy a memory pool
 //mpool [[mpool_destroy]]
 //mpool .mpool_destroy
 //mpool A memory pool is not used anymore it should be destroyed. This frees all memory allocated with it.
 //mpool When a destructor was provided at construction time, then this destructor is used on all non free elements
-//mpool before before the memory is freed. If no destructor was given then the memory is just freed.
+//mpool before before the clusters are freed. If no destructor was given then the clusters are just freed.
+//mpool The destroyed memory pool behaves as if it was freshly initialized and can be used again, this is some kindof
+//mpool exceptional behaviour.
 //mpool
 //mpool  MPool mpool_destroy (MPool self)
 //mpool
@@ -133,43 +130,101 @@ mpool_destroy (MPool self);
 
 
 /*
-  query how much free elements are available
+//index.mpool_available xref:mpool_available[mpool_available()]:: query number of free elements
+//mpool [[mpool_available]]
+//mpool .mpool_available
+//mpool One can check how much elements are available without a new cluster allocation in a memory pool.
+//mpool
+//mpool  unsigned mpool_available (MPool self)
+//mpool
+//mpool  `self`::
+//mpool         pointer to the memory pool to be queried
+//mpool  return::
+//mpool         number of available elements
+//mpool
 */
-unsigned
-mpool_available (MPool self);
+static inline unsigned
+mpool_available (MPool self)
+{
+  return self->elements_free;
+}
 
 
 /*
-  resize the pool that at least nelements become available without cluster reallocations
+//index.mpool_reserve xref:mpool_reserve[mpool_reserve()]:: preallocate elements
+//mpool [[mpool_reserve]]
+//mpool .mpool_reserve
+//mpool Resize the pool that at least nelements become available without cluster reallocations
+//mpool
+//mpool  unsigned mpool_reserve (MPool self, unsigned nelements)
+//mpool
+//mpool  `self`::
+//mpool         pointer to the memory pool
+//mpool  `nelements`::
+//mpool         minimum number of elements to preallocate
+//mpool  return::
+//mpool         self on success or NULL on error
+//mpool
 */
 MPool
 mpool_reserve (MPool self, unsigned nelements);
 
 
 /*
-  allocate and initialize a new cluster (internal)
-*/
-MPool
-mpool_cluster_alloc_ (MPool self);
-
-
-/*
-  alloc one element from the pool
+//index.mpool_alloc xref:mpool_alloc[mpool_alloc()]:: allocate one element
+//mpool [[mpool_alloc]]
+//mpool .mpool_alloc
+//mpool Allocates on element from a mpool. To improve cache locality allocations
+//mpool are grouped close together to recent allocations.
+//mpool
+//mpool  void* mpool_alloc (MPool self)
+//mpool
+//mpool  `self`::
+//mpool         pointer to the memory pool
+//mpool  return::
+//mpool         pointer to the allocated memory on success or NULL on error
+//mpool         will never fail when enough space was preallocated
+//mpool
 */
 void*
 mpool_alloc (MPool self);
 
-/*
-  alloc one element from the pool
 
-  should be near 'near'
+/*
+//index.mpool_alloc_near xref:mpool_alloc_near[mpool_alloc_near()]:: allocate one element, w/ locality
+//mpool [[mpool_alloc_near]]
+//mpool .mpool_alloc_near
+//mpool Allocates on element from a mpool. To improve cache locality the allocation
+//mpool tries to get an element close to another.
+//mpool
+//mpool  void* mpool_alloc_near (MPool self, void* near)
+//mpool
+//mpool  `self`::
+//mpool         pointer to the memory pool
+//mpool  `near`::
+//mpool         reference to another element which should be close to the returned element (hint only)
+//mpool  return::
+//mpool         pointer to the allocated memory on success or NULL on error
+//mpool         will never fail when enough space was preallocated
+//mpool
 */
 void*
 mpool_alloc_near (MPool self, void* near);
 
 
 /*
-  put a element back on the pool
+//index.mpool_free xref:mpool_free[mpool_free()]:: free one element
+//mpool [[mpool_free]]
+//mpool .mpool_free
+//mpool Frees the given element and puts it back into the pool for furhter allocations.
+//mpool
+//mpool  void mpool_free (MPool self, void* element)
+//mpool
+//mpool  `self`::
+//mpool         pointer to the memory pool
+//mpool  `element`::
+//mpool         element to be freed
+//mpool
 */
 void
 mpool_free (MPool self, void* element);
@@ -182,3 +237,11 @@ nobug_mpool_dump (const_MPool self,
                   const char* file,
                   const int line,
                   const char* func);
+
+/*
+//      Local Variables:
+//      mode: C
+//      c-file-style: "gnu"
+//      indent-tabs-mode: nil
+//      End:
+*/
diff --git a/tests/library/test-mpool.c b/tests/library/test-mpool.c
index f2d66349d..8e3bcd8a4 100644
--- a/tests/library/test-mpool.c
+++ b/tests/library/test-mpool.c
@@ -22,27 +22,33 @@
 #include "tests/test.h"
 #include "lib/mpool.h"
 
+struct teststruct
+{
+  llist node;
+  void* ptr[2];
+};
+
+
+static inline uint32_t mpool_fast_prng ()
+{
+  static uint32_t rnd=0xbabeface;
+  return rnd = rnd<<1 ^ ((rnd >> 30) & 1) ^ ((rnd>>2) & 1);
+}
 
 static void
 dtor (void* o)
 {
-  ECHO("%x @%p", *(int*)o, o);
+  ECHO("%d @%p", *(int*)o, o);
 }
 
-static void
-move (void* a, void* b)
-{
-  ECHO ("%p (%x) to %p ", b, *(int*)b, a);
-  *(int*)a = *(int*)b;
-  *(void**)b = NULL;
-}
+
 
 TESTS_BEGIN
 
 TEST ("basic")
 {
   mpool mypool;
-  mpool_init (&mypool, sizeof(void*), 10, move, dtor);
+  mpool_init (&mypool, sizeof(void*), 10, dtor);
   ECHO ("initialized");
 
   void* element;
@@ -61,10 +67,11 @@ TEST ("basic")
   ECHO ("destroyed");
 }
 
+
 TEST ("destroy")
 {
   mpool mypool;
-  mpool_init (&mypool, sizeof(void*), 10, move, dtor);
+  mpool_init (&mypool, sizeof(void*), 10, dtor);
   ECHO ("initialized");
 
   void* element;
@@ -78,10 +85,11 @@ TEST ("destroy")
   ECHO ("destroyed");
 }
 
+
 TEST ("clusters")
 {
   mpool mypool;
-  mpool_init (&mypool, sizeof(void*), 2, move, dtor);
+  mpool_init (&mypool, sizeof(void*), 2, dtor);
   ECHO ("initialized");
 
   for (int i = 1; i <= 5; ++i)
@@ -102,7 +110,7 @@ TEST ("clusters")
 TEST ("clusters_big")
 {
   mpool mypool;
-  mpool_init (&mypool, sizeof(void*), 200, move, dtor);
+  mpool_init (&mypool, sizeof(void*), 200, dtor);
   ECHO ("initialized");
 
   for (int i = 1; i <= 700; ++i)
@@ -120,10 +128,10 @@ TEST ("clusters_big")
 }
 
 
-TEST ("collect")
+TEST ("alloc_free")
 {
   mpool mypool;
-  mpool_init (&mypool, 24, 4, move, dtor);
+  mpool_init (&mypool, 24, 4, dtor);
   ECHO ("initialized");
 
   void* elem[32];
@@ -142,40 +150,33 @@ TEST ("collect")
   ECHO ("freed some");
   DUMP(NOBUG_ON, mpool, &mypool, 4);
 
-  mpool_collect (&mypool, 0);
-  ECHO ("collected");
-
-  DUMP(NOBUG_ON, mpool, &mypool, 4);
-
   mpool_destroy (&mypool);
   ECHO ("destroyed");
 }
 
-TEST ("collect_no_move")
+
+TEST ("alloc_free_big")
 {
   mpool mypool;
-  mpool_init (&mypool, 24, 4, NULL, dtor);
+  mpool_init (&mypool, 24, 4, dtor);
   ECHO ("initialized");
 
-  void* elem[32];
+  void* elem[2000];
 
-  for (int i = 1; i <= 15; ++i)
+  for (int i = 1; i <= 2000; ++i)
     {
       elem[i] = mpool_alloc (&mypool);
       *(int*)(elem[i]) = i;
     }
   ECHO ("allocated");
 
-  for (int i = 1; i <= 15; i+=3)
+  for (int i = 1; i <= 2000; i+=3)
     {
       mpool_free (&mypool, elem[i]);
     }
   ECHO ("freed some");
   DUMP(NOBUG_ON, mpool, &mypool, 4);
 
-  mpool_collect (&mypool, 0);
-  ECHO ("collected");
-
   DUMP(NOBUG_ON, mpool, &mypool, 4);
 
   mpool_destroy (&mypool);
@@ -183,9 +184,160 @@ TEST ("collect_no_move")
 }
 
 
+
 TEST ("reserve")
 {
 }
 
 
+/*
+  benchmark mpool vs malloc, first only the allocation/free itself with some necessary llist ops
+*/
+TEST ("bench_mpool")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(struct teststruct), 2000, NULL);
+  ECHO ("initialized");
+
+  llist list;
+  llist_init (&list);
+
+  for (int j = 1; j<=100; ++j)
+    {
+      for (int i = 1; i <= 50000; ++i)
+        {
+          struct teststruct* element =  mpool_alloc (&mypool);
+          llist_insert_tail (&list, llist_init (&element->node));
+        }
+
+      LLIST_WHILE_HEAD (&list, element)
+        {
+          llist_unlink_fast_ (element);
+          mpool_free (&mypool, element);
+        }
+    }
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
+TEST ("bench_malloc")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(llist), 2000, NULL);
+  ECHO ("initialized");
+
+  llist list;
+  llist_init (&list);
+
+  for (int j = 100; j; --j)
+    {
+      for (int i = 1; i <= 50000; ++i)
+        {
+          struct teststruct* element = malloc (sizeof(*element));
+          llist_insert_tail (&list, llist_init (&element->node));
+        }
+
+      LLIST_WHILE_HEAD (&list, element)
+        {
+          llist_unlink_fast_ (element);
+          free (element);
+        }
+    }
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
+/*
+  benchmark mpool vs malloc, try to simulate some slightly more realistic application usage
+  - allocate list nodes which have 2 data members as payload
+  - there is a 25% chance at each alloc that the head of the list gets deleted
+*/
+TEST ("bench_mpool_sim")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(struct teststruct), 2000, NULL);
+  ECHO ("initialized");
+
+  llist list;
+  llist_init (&list);
+
+  for (int j = 1; j<=100; ++j)
+    {
+      for (int i = 1; i <= 50000; ++i)
+        {
+          struct teststruct* element =  mpool_alloc (&mypool);
+          llist_insert_tail (&list, llist_init (&element->node));
+          element->ptr[0] = malloc(100+(mpool_fast_prng()%500));
+          element->ptr[1] = malloc(100+(mpool_fast_prng()%500));
+
+          if (!(mpool_fast_prng()%4))
+            {
+              struct teststruct* element = (struct teststruct*)llist_head (&list);
+              llist_unlink_fast_ (&element->node);
+              free(element->ptr[0]);
+              free(element->ptr[1]);
+              mpool_free (&mypool, element);
+            }
+        }
+
+      LLIST_WHILE_HEAD (&list, element)
+        {
+          llist_unlink_fast_ (element);
+          free(((struct teststruct*)element)->ptr[0]);
+          free(((struct teststruct*)element)->ptr[1]);
+          mpool_free (&mypool, element);
+        }
+    }
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
+TEST ("bench_malloc_sim")
+{
+  mpool mypool;
+  mpool_init (&mypool, sizeof(llist), 2000, NULL);
+  ECHO ("initialized");
+
+  llist list;
+  llist_init (&list);
+
+  for (int j = 100; j; --j)
+    {
+      for (int i = 1; i <= 50000; ++i)
+        {
+          struct teststruct* element = malloc (sizeof(*element));
+          llist_insert_tail (&list, llist_init (&element->node));
+          element->ptr[0] = malloc(100+(mpool_fast_prng()%500));
+          element->ptr[1] = malloc(100+(mpool_fast_prng()%500));
+
+          if (!(mpool_fast_prng()%4))
+            {
+              struct teststruct* element = (struct teststruct*)llist_head (&list);
+              llist_unlink_fast_ (&element->node);
+              free(element->ptr[0]);
+              free(element->ptr[1]);
+              free (element);
+            }
+        }
+
+      LLIST_WHILE_HEAD (&list, element)
+        {
+          llist_unlink_fast_ (element);
+          free(((struct teststruct*)element)->ptr[0]);
+          free(((struct teststruct*)element)->ptr[1]);
+          free (element);
+        }
+    }
+
+  mpool_destroy (&mypool);
+  ECHO ("destroyed");
+}
+
+
 TESTS_END

From e0ff915987ac69a8c61efdb6d0cd053c89eabf98 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 5 Jun 2009 05:00:53 +0200
Subject: [PATCH 070/368] adapt thread-wrapper.hpp to backend thread API change

---
 src/backend/thread-wrapper.hpp | 11 ++++++-----
 src/lib/sync.hpp               |  2 +-
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/backend/thread-wrapper.hpp b/src/backend/thread-wrapper.hpp
index e7e83ca57..8a76cb5cf 100644
--- a/src/backend/thread-wrapper.hpp
+++ b/src/backend/thread-wrapper.hpp
@@ -42,6 +42,7 @@ namespace backend {
   using std::tr1::function;
   using lumiera::Literal;
   using lib::Sync;
+  using lib::RecursiveLock_Waitable;
   using lib::NonrecursiveLock_Waitable;
   
   typedef struct nobug_flag* NoBugFlag;
@@ -65,17 +66,17 @@ namespace backend {
    *       details of the thread handling and didn't implement the waiting feature. 
    */
   class JoinHandle
-    : public Sync<NonrecursiveLock_Waitable>
-    , Sync<NonrecursiveLock_Waitable>::Lock
+    : public Sync<RecursiveLock_Waitable>
+    , Sync<RecursiveLock_Waitable>::Lock
     {
-      typedef Sync<NonrecursiveLock_Waitable> SyncBase;
+      typedef Sync<RecursiveLock_Waitable> SyncBase;
       
       bool isWaiting_;
       volatile bool armed_;
       
       friend class Thread;
       
-      LumieraCondition
+      LumieraReccondition
       accessLockedCondition()
         {
           ASSERT (!armed_, "Lifecycle error, JoinHandle used for several threads.");
@@ -171,7 +172,7 @@ namespace backend {
       
       
       void
-      start_thread (lumiera_thread_class kind, Literal& purpose, NoBugFlag logging_flag, LumieraCondition joinCond=0)
+      start_thread (lumiera_thread_class kind, Literal& purpose, NoBugFlag logging_flag, LumieraReccondition joinCond=0)
         {
           Lock sync(this);
           LumieraThread res = 
diff --git a/src/lib/sync.hpp b/src/lib/sync.hpp
index c4cef10ed..4d3fa0757 100644
--- a/src/lib/sync.hpp
+++ b/src/lib/sync.hpp
@@ -343,7 +343,7 @@ namespace lib {
           void setTimeout(ulong relative) {timeout_.setOffset(relative);}
           bool isTimedWait()              {return (timeout_);}
           
-          LumieraCondition accessCond()   {return static_cast<LumieraCondition> (this);}
+          LumieraReccondition accessCond(){return static_cast<LumieraReccondition> (this);}
         };
      
       typedef Mutex<Wrapped_LumieraExcMutex> NonrecursiveLock_NoWait;

From b6d22bb2e08258826d1525d87ebdced8f0ff9f73 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 5 Jun 2009 05:04:45 +0200
Subject: [PATCH 071/368] fix: condition for signalling thread termination is
 optional

---
 src/backend/threads.c  | 3 +++
 src/lib/reccondition.h | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/backend/threads.c b/src/backend/threads.c
index 1ff7184f9..46449156b 100644
--- a/src/backend/threads.c
+++ b/src/backend/threads.c
@@ -59,6 +59,9 @@ static void* pthread_runner (void* thread)
 
   starter->fn (starter->arg);
 
+  if (!starter->finished)
+    return NULL; // no condition var provided for signalling thread termination
+  
   LUMIERA_RECCONDITION_SECTION(cond_sync, starter->finished)
     LUMIERA_RECCONDITION_BROADCAST;
 
diff --git a/src/lib/reccondition.h b/src/lib/reccondition.h
index a2dd54f58..dcf4e33a4 100644
--- a/src/lib/reccondition.h
+++ b/src/lib/reccondition.h
@@ -93,7 +93,7 @@
 /**
  * Wait for a condition.
  * Must be used inside a RECCONDITION_SECTION.
- * @param expr Conditon which must become true, else the condition variable goes back into sleep
+ * @param expr Condition which must become true, else the condition variable goes back into sleep
  */
 #define LUMIERA_RECCONDITION_WAIT(expr)                                                                                 \
   do {                                                                                                                  \

From d740d9734d5a0229760eff8fdc0a43883ff97622 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 5 Jun 2009 05:35:24 +0200
Subject: [PATCH 072/368] re-enable test for waiting on thread termination

---
 src/proc/play/tick-service.hpp         | 4 ++--
 tests/40components.tests               | 3 ++-
 tests/lib/thread-wrapper-join-test.cpp | 2 ++
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/proc/play/tick-service.hpp b/src/proc/play/tick-service.hpp
index b27f936a3..876daadf9 100644
--- a/src/proc/play/tick-service.hpp
+++ b/src/proc/play/tick-service.hpp
@@ -91,8 +91,8 @@ namespace proc {
         void activate (uint fps)
           {
             REQUIRE (  0==fps 
-                    ||    1000000/fps < std::numeric_limits<uint>::max() 
-                       && 1000000/fps > POLL_TIMEOUT);
+                    ||(   1000000/fps < std::numeric_limits<uint>::max() 
+                       && 1000000/fps > POLL_TIMEOUT));
             if (fps)
               timespan_ = 1000000/fps; // microseconds per tick
             else
diff --git a/tests/40components.tests b/tests/40components.tests
index 221c5e3db..2cad2b9df 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -340,7 +340,8 @@ return: 0
 END
 
 
-PLANNED "Waiting on Thread termination" ThreadWrapperJoin_test  <<END
+TEST "Waiting on Thread termination" ThreadWrapperJoin_test  <<END
+return: 0
 END
 
 
diff --git a/tests/lib/thread-wrapper-join-test.cpp b/tests/lib/thread-wrapper-join-test.cpp
index 9ced9c4b3..57793d2ac 100644
--- a/tests/lib/thread-wrapper-join-test.cpp
+++ b/tests/lib/thread-wrapper-join-test.cpp
@@ -109,6 +109,7 @@ namespace backend {
             
 #ifdef DEBUG
             /////////////////////////////////////////////////////////////////////////////////////////////TODO: better way of detecting debug builds
+#if false   /////////////////////////////////////////////////////////////////////////////////////////////TODO: re-enable assertions to throw, and make this configurable
             try
               {
                 Thread("test Thread joining-3",
@@ -120,6 +121,7 @@ namespace backend {
               {
                 ASSERT (lumiera_error() == lumiera::error::LUMIERA_ERROR_ASSERTION);
               }
+#endif
 #endif            
             
             // note: the waitingHandle goes out of scope here,

From 638022c07f5fac6b7be38269fe2b08fca636eb62 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 04:02:08 +0200
Subject: [PATCH 073/368] WIP: add run-time type check API to Placement

---
 src/proc/mobject/placement.hpp                      | 13 ++++++++++++-
 .../proc/mobject/placement-hierarchy-test.cpp       |  8 ++++++++
 2 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp
index f494d4815..282cc89c4 100644
--- a/src/proc/mobject/placement.hpp
+++ b/src/proc/mobject/placement.hpp
@@ -137,7 +137,18 @@ namespace mobject {
         { 
           ENSURE (*this); 
           return _SmartPtr::operator-> (); 
-        }      
+        }
+      
+      /** run time diagnostics: is the pointee
+       *  of this placement compatible to the given type?
+       */
+      template<class Y>
+      bool
+      isCompatible ()  const
+        {
+          return 0 != dynamic_cast<const Y*> (get());
+        }
+      
       
       operator string()   const ;
       size_t use_count()  const { return _SmartPtr::use_count(); }
diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index d6fd03cab..6ca72b590 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -156,6 +156,14 @@ namespace test    {
 //          {
 //            ASSERT (lumiera_error () == error::LUMIERA_ERROR_ASSERTION);
 //          }
+          
+          // runtime type diagnostics based on pointee RTTI
+          ASSERT ( pSub2.isCompatible<MObject>());
+          ASSERT ( pSub2.isCompatible<DummyMO>());
+          ASSERT ( pSub2.isCompatible<TestSubMO2>());
+          ASSERT (!pSub2.isCompatible<TestSubMO21>());
+          ASSERT (!pSub2.isCompatible<TestSubMO1>());
+          ASSERT (!pSub2.isCompatible<Clip>());
         }
     };
   

From 4ee0b18731dd58d1b39df2b9c05f9f85ae44b894 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 04:04:33 +0200
Subject: [PATCH 074/368] Fix: activation of MObjectRef, exception safety

---
 src/proc/mobject/mobject-ref.hpp | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/src/proc/mobject/mobject-ref.hpp b/src/proc/mobject/mobject-ref.hpp
index 2c368932c..d858b7cb1 100644
--- a/src/proc/mobject/mobject-ref.hpp
+++ b/src/proc/mobject/mobject-ref.hpp
@@ -65,8 +65,6 @@ namespace mobject {
     {
       PlacementRef<MO> pRef_;
       
-      /** deleter function used to detach when refcount goes to zero */
-      static void whenDead (MObject*);
       
     public:
       
@@ -80,19 +78,22 @@ namespace mobject {
       
       Placement<MO>& getPlacement();
       
+      
       /* === Lifecycle === */
       
       /** activate an MObject reference, based on an existing placement,
        *  which needs to be contained (added to) the session. After checking
-       *  the validity of the placement, this MObjectRef shared ownership
+       *  the validity of the placement, this MObjectRef shares ownership
        *  of the referred MObject with the denoted placement.
+       *  @note STRONG exception safety guarantee
        *  @see #close() for detaching this MObjectRef
        */
       MORef&
       activate (Placement<MO> const& placement)
         {
-          pRef_ = placement;
-          smPtr_.reset (placement, &whenDead);
+          ASSERT (placement);
+          pRef_ = placement;           // STRONG exception safe
+          smPtr_.swap (placement);     // never throws
           return *this;
         }
       
@@ -110,9 +111,13 @@ namespace mobject {
       MORef&
       activate (REF const& pRefID)
         {
-          pRef_ = pRefID;
-          smPtr_.reset (*pRef_, &whenDead);
-          return *this;
+          if (pRefID != pRef_)
+            {
+              PlacementRef<MO> newRef (pRefID);
+              ASSERT (newRef);
+              return activate (*newRef); // STRONG exception safe
+            }
+          else return *this;
         }
       
     };

From fa31f3736e33f0c590f72ce66ef93645fdc896c6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 04:23:11 +0200
Subject: [PATCH 075/368] WIP some details regarding PlacementRef

---
 src/proc/mobject/placement-index.hpp |  7 +-
 src/proc/mobject/placement-ref.hpp   | 99 +++++++++++++++++++++++++++-
 2 files changed, 102 insertions(+), 4 deletions(-)

diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 9afccdcf4..8e26f598b 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -80,11 +80,12 @@ namespace mobject {
       
       
       /** retrieve the logical root scope */
-      PlacementMO& getRoot()        const;
+      PlacementMO& getRoot()                const;
       
       /** diagnostic: number of indexed entries */
-      size_t size()                 const;
-      bool contains (PlacementMO&)  const;
+      size_t size()                         const;
+      bool contains (PlacementMO const&)    const;
+      bool contains (ID const&)             const;
       
       
       /* == mutating operations == */
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index 5f5e8baf5..a667d2882 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -36,6 +36,7 @@
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
 //#include "proc/asset/pipe.hpp"
+#include "proc/mobject/placement.hpp"
 
 //#include <tr1/memory>
 
@@ -52,12 +53,108 @@ namespace mobject {
   template<class MO =MObject>
   class PlacementRef
     {
+      typedef Placement<MO>      PlacementMO;
+      typedef Placement<MObject>::ID     _ID;         ////TODO: superfluous...
+      typedef Placement<MObject>::Id<MO> _Id;
+      
+      _Id id_;
+      
     public:
       /**
-       * 
+       * Creating a PlacementRef from a compatible reference source.
+       * Any source allowing to infer a \em compatible mobject::Placement
+       * is accepted. Here, compatibility is decided based on the run time
+       * type of the pointee, in comparison to the template parameter Y.
+       * In any case, for this ctor to succeed, the provided ref or ID 
+       * needs to be resolvable to a placement by the implicit PlacementIndex
+       * facility used by all PlacementRef instances (typically the Session).
+       * @note there is no default ctor, a reference source is mandatory.
+       * @param refID reference resolvable to a placement via Index, especially
+       *              - an existing Placement
+       *              - just an Placement::ID
+       *              - a plain LUID
+       * @throw error::Invalid on incompatible run time type of the resolved ID  
        */
+      template<class Y>
+      explicit
+      PlacementRef (Y const& refID)
+        : id_(recast (refID))
+        { 
+          validate(id_); 
+        }
+      
+      PlacementRef (PlacementRef const& r)    ///< copy ctor
+        : id_(r.id_)
+        { 
+          validate(id_); 
+        }
+      
+      template<class X>
+      PlacementRef (PlacementRef<X> const& r) ///< extended copy ctor, when type X is assignable to MO
+        : id_(r.id_)
+        {
+          validate(id_); 
+        }
       
       
+      PlacementRef&
+      operator= (PlacementRef const& r)
+        {
+          validate(r.id_);
+          id_ = r.id_;
+          return *this;
+        }
+      
+      template<class X>
+      PlacementRef&
+      operator= (PlacementRef<X> const& r)
+        {
+          validate(r.id_);
+          id_ = r.id_;
+          return *this;
+        }
+      
+      template<class Y>
+      PlacementRef&
+      operator= (Y const& refID)
+        {
+          validate (recast (refID));
+          id_ = recast (refID);
+          return *this;
+        }
+      
+      
+      /* == forwarding smart-ptr operations == */
+      
+      PlacementMO& operator*()  const { return access(id_); } ///< dereferencing fetches referred Placement from Index
+      
+      MO* operator->()          const { return access(id_); } ///< provide access to pointee API by smart-ptr chaining 
+      
+      operator string()         const { return access(id_).operator string(); }
+      size_t use_count()        const { return access(id_).use_count(); }
+      
+      ////////////////TODO more operations to come....
+      
+    private:
+      static void
+      validate (_Id rId)
+        {
+          if (!access(rId).isCompatible<MO>())
+            throw error::Invalid(LUMIERA_ERROR_INVALID_PLACEMENTREF);
+        }
+      
+      static _Id const&
+      recast (_ID const& someID)
+        {
+          return static_cast<_Id const&> (someID);
+        }
+      
+      static _Id const&
+      recast (const LumieraUid luid)
+        {
+          REQUIRE (luid);
+          return reinterpret_cast<_Id const&> (*luid);
+        }
     };
   
   

From 815f8569ce358c2920e8250cbb7566c42ec690a1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 06:18:37 +0200
Subject: [PATCH 076/368] WIP: accessing the default PlacementIndex (within the
 Session)

---
 src/proc/Makefile.am                          |   4 +-
 src/proc/mobject/placement-index.cpp          |  57 ++++++-
 src/proc/mobject/placement-index.hpp          |  18 +-
 src/proc/mobject/placement-ref.hpp            |  14 ++
 src/proc/mobject/session.hpp                  |  20 +--
 .../mobject/session/sess-manager-impl.cpp     | 156 ++++++++++++++++++
 src/proc/mobject/session/session-impl.cpp     | 113 +++++++++++++
 src/proc/mobject/session/session-impl.hpp     | 120 ++++++++++++++
 src/proc/mobject/session/session.cpp          |   2 +-
 src/proc/mobject/session/sessionimpl.cpp      | 116 -------------
 src/proc/mobject/session/sessionimpl.hpp      | 111 -------------
 src/proc/mobject/session/sessmanagerimpl.cpp  | 151 -----------------
 .../proc/mobject/placement-index-test.cpp     |   2 +-
 .../proc/mobject/placement-ref-test.cpp       |   6 +-
 14 files changed, 485 insertions(+), 405 deletions(-)
 create mode 100644 src/proc/mobject/session/sess-manager-impl.cpp
 create mode 100644 src/proc/mobject/session/session-impl.cpp
 create mode 100644 src/proc/mobject/session/session-impl.hpp
 delete mode 100644 src/proc/mobject/session/sessionimpl.cpp
 delete mode 100644 src/proc/mobject/session/sessionimpl.hpp
 delete mode 100644 src/proc/mobject/session/sessmanagerimpl.cpp

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 677ddda75..3c87d3695 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -159,8 +159,8 @@ liblumiprocmobjectsession_la_SOURCES =					\
 	$(liblumiprocmobjectsession_la_srcdir)/segment.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/simpleclip.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/plug.cpp			\
-	$(liblumiprocmobjectsession_la_srcdir)/sessionimpl.cpp		\
-	$(liblumiprocmobjectsession_la_srcdir)/sessmanagerimpl.cpp	\
+	$(liblumiprocmobjectsession_la_srcdir)/session-impl.cpp		\
+	$(liblumiprocmobjectsession_la_srcdir)/sess-manager-impl.cpp	\
 	$(liblumiprocmobjectsession_la_srcdir)/edl.cpp			\
 	$(liblumiprocmobjectsession_la_srcdir)/session.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/track.cpp		\
diff --git a/src/proc/mobject/placement-index.cpp b/src/proc/mobject/placement-index.cpp
index 407994842..8185854ea 100644
--- a/src/proc/mobject/placement-index.cpp
+++ b/src/proc/mobject/placement-index.cpp
@@ -34,6 +34,7 @@
 
 
 #include "proc/mobject/placement-index.hpp"
+#include "proc/mobject/session/session-impl.hpp"
 
 //#include <boost/format.hpp>
 //using boost::str;
@@ -57,10 +58,14 @@ namespace mobject {
     };
   
   
-  /** */
+  /* some type shorthands */
+  typedef shared_ptr<PlacementIndex> PIdx;
+  typedef PlacementIndex::PlacementMO PlacementMO; 
+  typedef PlacementIndex::PRef PRef;
+  typedef PlacementIndex::ID ID;
   
   
-  PlacementIndex::PlacementMO&
+  PlacementMO&
   PlacementIndex::getRoot()  const
   {
     UNIMPLEMENTED ("managing the implicit root context within a scope hierarchy");
@@ -84,14 +89,52 @@ namespace mobject {
   
   
   
-  /** @internal factory function for creating a placement index for tests.
-   */
-  shared_ptr<PlacementIndex>
-  createPlacementIndex ()
+  namespace { // implementation detail: default global placement index access
+    
+    PIdx globalIndex (0);
+    
+    PIdx const&
+    getGlobalIndex()
+    {
+      if (globalIndex)
+        return globalIndex;
+      else
+        return session::SessManagerImpl::getCurrentIndex();
+    }
+    
+  } // (End) implementation detail
+  
+  
+  /** @internal factory function for creating a placement index for tests.  */
+  PIdx
+  create_PlacementIndex ()
   {
-    return shared_ptr<PlacementIndex> (new PlacementIndex());
+    return PIdx (new PlacementIndex());
   }
   
+  PIdx const&
+  reset_PlachementIndex(PIdx const& alternativeIndex)
+  {
+    globalIndex = alternativeIndex;
+  }
+  
+  /** @internal restore the implicit PlacementIndex to its default implementation (=the session) */
+  PIdx const&
+  reset_PlachementIndex()
+  {
+    globalIndex.reset(0);
+  }
+  
+  /** by default, this reaches for the PlacementIndex maintained within
+   *  the current session. But for the purpose of unit tests, an alternative
+   *  PlacementIndex may have been \link #reset_PlacementIndex installed \endlink 
+   */
+  Placement<MObject> &
+  fetch_PlachementIndex(Placement<MObject>::ID const& pID)
+  {
+    return getGlobalIndex()->find (pID);
+  }
+
 
 
 } // namespace mobject
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 8e26f598b..46ade7e7e 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -99,10 +99,24 @@ namespace mobject {
   
   
   /** preliminary helper for creating a placement index (instance).
-   *  @todo integrate this into the session and provide an extra factory for tests
+   *  @todo integrate this into the session and provide an extra factory for tests?
    */
   shared_ptr<PlacementIndex>
-  createPlacementIndex() ;
+  create_PlacementIndex() ;
+  
+  /** @internal there is an implicit PlacementIndex available on a global scale,
+   *            by default implemented within the current session. This function allows
+   *            to re-define this implicit index temporarily, e.g. for unit tests. */
+  shared_ptr<PlacementIndex> const&
+  reset_PlachementIndex(shared_ptr<PlacementIndex> const&) ;
+  
+  /** @internal restore the implicit PlacementIndex to its default implementation (=the session) */
+  shared_ptr<PlacementIndex> const&
+  reset_PlachementIndex() ;
+  
+  /** @internal access point for PlacementRef to the implicit global PlacementIndex */
+  Placement<MObject> &
+  fetch_PlachementIndex(Placement<MObject>::ID const&) ;
 
 
 } // namespace mobject
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index a667d2882..64a04704f 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -48,6 +48,11 @@ namespace mobject {
   
   class MObject;
   
+  // see placement-index.cpp 
+  Placement<MObject> &
+  fetch_PlachementIndex(Placement<MObject>::ID const&) ;
+  
+  
   /**
    */
   template<class MO =MObject>
@@ -155,6 +160,15 @@ namespace mobject {
           REQUIRE (luid);
           return reinterpret_cast<_Id const&> (*luid);
         }
+      
+      static PlacementMO&
+      access (_Id placementID)
+        {
+          Placement<MObject> & pla (fetch_PlachementIndex (placementID));  // may throw
+          REQUIRE (pla);
+          ASSERT (pla.isCompatible<MO>());
+          return static_cast<PlacementMO&> (pla);
+        }
     };
   
   
diff --git a/src/proc/mobject/session.hpp b/src/proc/mobject/session.hpp
index fb4c1960d..2759ded09 100644
--- a/src/proc/mobject/session.hpp
+++ b/src/proc/mobject/session.hpp
@@ -42,15 +42,14 @@
 
 
 
-namespace mobject
-  {
-  namespace session 
-    { 
+namespace mobject {
+  
+  namespace session { 
     class SessManager;
     class EDL; 
     class Fixture;
     typedef std::tr1::shared_ptr<Fixture> PFix;
-    }
+  }
   
   typedef session::SessManager& PSess;  ///< acts as a "PImpl" smart ptr
 
@@ -69,7 +68,7 @@ namespace mobject
    * the Session is similar to a Singleton instance.
    * 
    * @note Any client should be aware that the Session can be closed, 
-   *       replaced and loaded. The only way to accees the Session is
+   *       replaced and loaded. The only way to access the Session is
    *       via a "PImpl" smart pointer session::PSess (which indeed is
    *       a reference to the SessManager and is accessible as the static
    *       field Session::current). You will never be able to get a direct
@@ -99,8 +98,7 @@ namespace mobject
     };
   
   
-  namespace session
-    {
+  namespace session {
 
     /**
      * creation, access and Session lifecycle Interface.
@@ -122,13 +120,13 @@ namespace mobject
         virtual void reset () =0;
         
         /** replace the current session by a new
-         *  session loaded from serialized state.
+         *  session loaded from serialised state.
          */
         virtual void load () =0;
 
-        /** create a complete, serialized representation
+        /** create a complete, serialised representation
          *  of the current session config and contents.
-         *  @todo how to serialize, prameters, return value?
+         *  @todo how to serialise, parameters, return value?
          */
         virtual void save () =0;
         
diff --git a/src/proc/mobject/session/sess-manager-impl.cpp b/src/proc/mobject/session/sess-manager-impl.cpp
new file mode 100644
index 000000000..9a8ef5d3e
--- /dev/null
+++ b/src/proc/mobject/session/sess-manager-impl.cpp
@@ -0,0 +1,156 @@
+/*
+  SessManagerImpl  -  global session access and lifecycle
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file sess-manager-impl.cpp
+ ** Implementation of the Session management functions.
+ ** The Class SessManager is declared alongside with mobject::Session,
+ ** because it serves as smart ptr-to-Impl at the same time. Effectively,
+ ** the session manager owns the current session object and only grants
+ ** access via his overloaded operator->() . Because there is no operator*(),
+ ** no one can get at the address of the current session object. (correct?)
+ **
+ ** @see session-impl.hpp
+ ** @see mobject::Session#current
+ ** @see mobject::session::SessionManager_test
+ **
+ */
+
+
+#include "proc/mobject/session.hpp"
+#include "proc/mobject/session/session-impl.hpp"
+#include "proc/mobject/session/defsmanager.hpp"
+//#include "proc/mobject/session/defsregistry.hpp"
+#include "lib/error.hpp"
+
+using boost::scoped_ptr;
+
+
+
+namespace mobject {
+namespace session {
+  
+  LUMIERA_ERROR_DEFINE (CREATE_SESSION, "unable to create basic session");
+  
+  /** Access to the "current session", which actually is
+   *  an SessionImpl instance. This session object is created 
+   *  either by loading an existing session, or on demand by
+   *  this accessor function here (when no session was loaded
+   *  or created)
+   *  @note any exceptions arising while building the basic
+   *        session object(s) will halt the system.
+   */
+  SessionImpl*
+  SessManagerImpl::operator-> ()  throw()
+  {
+    if (!pImpl_)
+      try
+        { // create empty default configured session
+          this->reset();
+        }
+      catch (...)
+        {
+          ERROR (progress, "Unrecoverable Failure while creating the empty default session.");
+          throw lumiera::error::Fatal ( "Failure while creating the basic session object. System halted."
+                                      , LUMIERA_ERROR_CREATE_SESSION );
+        }
+    
+    
+    return pImpl_.get();
+  }
+  
+  
+  
+  /** Initially (at static init time), only the single system-wide
+   *  Session manger instance is created. It can be used to load an
+   *  existing session; otherwise an empty default Session an a
+   *  Defaults manager (Config Query system) is created at first
+   *  \link #operator-> access \endlink to the session object.
+   */
+  SessManagerImpl::SessManagerImpl ()  throw()
+    : pDefs_ (0),
+      pImpl_ (0)
+  { }
+  
+  
+  /** @note no transactional behaviour.
+   *        may succeed partial.
+   */
+  void
+  SessManagerImpl::clear ()
+  {
+    pImpl_->clear();
+  }
+  
+  
+  /** @note this operation is atomic and either succeeds or
+   *        fails completely, in which case the current session
+   *        remains unaltered.
+   *  @todo for this to work, we need to change the implementation of
+   *        AssetManager so support this kind of transactional switch!
+   */
+  void
+  SessManagerImpl::reset ()
+  {
+    scoped_ptr<DefsManager> tmpD (new DefsManager);
+    scoped_ptr<SessionImpl> tmpS (new SessionImpl (*tmpD));
+    
+    TODO ("reset the assets registered with AssetManager");
+    // Ichthyo-intern: ticket #95
+    
+    TODO ("thread lock");
+    pDefs_.swap (tmpD);
+    pImpl_.swap (tmpS);
+  }
+  
+  
+  void
+  SessManagerImpl::load ()
+  {
+    UNIMPLEMENTED ("load serialised session");
+  }
+  
+  
+  /** \par Implementation details
+   *  We intend to have several switchable object serialisers.
+   *  One of these serialisers should generate a comprehensible
+   *  text based representation suitable for checking into 
+   *  SCM systems.
+   *  Sessions can be saved into one single file or be split
+   *  to several files (master file and edl files)
+   */
+  void
+  SessManagerImpl::save ()
+  {
+    UNIMPLEMENTED ("save session (serialised)");
+  }
+  
+  
+  shared_ptr<PlacementIndex>
+  getCurrentIndex ()
+  {
+    return static_cast<SessManagerImpl&> (Session::current).pImpl_->pIdx_;
+  }
+  
+  
+  
+}} // namespace mobject::session
diff --git a/src/proc/mobject/session/session-impl.cpp b/src/proc/mobject/session/session-impl.cpp
new file mode 100644
index 000000000..a518b612f
--- /dev/null
+++ b/src/proc/mobject/session/session-impl.cpp
@@ -0,0 +1,113 @@
+/*
+  SessionImpl  -  holds the complete session data to be edited by the user
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "proc/mobject/session/session-impl.hpp"
+#include "proc/mobject/placement.hpp"
+#include "lib/error.hpp"
+
+namespace mobject {
+namespace session {
+  
+  /** create a new empty session with default values.
+   *  @note any exception arising while creating this
+   *        default session will inevitably halt the
+   *        system (and this is desirable)
+   */
+  SessionImpl::SessionImpl (DefsManager& defs)  throw()
+    : Session(defs),
+      focusEDL_(0),
+      edls(1),
+      fixture(new Fixture),
+      pIdx_(*create_PlacementIndex())
+    {
+    }
+  
+  
+  /** @internal used by SessionManager#clear
+   *            discard all EDL content, without
+   *            touching global configuration.
+   */
+  void 
+  SessionImpl::clear ()
+  {
+    try
+      {
+        edls.clear();
+        edls.resize(1);
+        focusEDL_ = 0;
+      }
+    catch (...)
+      {
+        focusEDL_ = 0;
+        throw lumiera::error::Fatal ("unexpected exception while clearing EDLs");
+      }
+  }
+  
+  
+  bool 
+  SessionImpl::isValid ()
+  {
+    UNIMPLEMENTED ("session self test");
+    return false; // TODO
+  }
+  
+  
+  void 
+  SessionImpl::add (PMO& placement)
+  {
+    UNIMPLEMENTED ("add Placement to the current EDL");
+  }
+  
+  
+  bool 
+  SessionImpl::remove (PMO& placement)
+  {
+    UNIMPLEMENTED ("search and remove a given Placement from current EDL");
+    return false; // TODO
+  }
+  
+  /// @deprecated should not grant direct access to EDL objects
+  EDL&
+  SessionImpl::currEDL ()
+  {
+    ASSERT (focusEDL_ < edls.size());
+    return  edls[focusEDL_];
+  }
+  
+  
+  PFix&
+  SessionImpl::getFixture ()
+  {
+    return fixture;
+  }
+  
+  
+  void
+  SessionImpl::rebuildFixture ()
+  { 
+    UNIMPLEMENTED ("rebuild Fixture");
+  }
+  
+  
+  
+}} // namespace mobject::session
diff --git a/src/proc/mobject/session/session-impl.hpp b/src/proc/mobject/session/session-impl.hpp
new file mode 100644
index 000000000..0d98f0861
--- /dev/null
+++ b/src/proc/mobject/session/session-impl.hpp
@@ -0,0 +1,120 @@
+/*
+  SESSION-IMPL.hpp  -  holds the complete session data to be edited by the user
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file session-impl.hpp
+ ** Session and SessionManager Implemention classes.
+ ** Session and the corresponding Manager are primary Interfaces
+ ** to control the behaviour of the editing part of the application.
+ ** All all implementaion complexities are hidden behind a "PImpl".
+ **
+ ** This file contains the implementation classes, it should never
+ ** be included by client code.
+ **
+ */
+
+
+#ifndef MOBJECT_SESSION_SESSIONIMPL_H
+#define MOBJECT_SESSION_SESSIONIMPL_H
+
+#include "proc/mobject/session.hpp"
+#include "proc/mobject/session/edl.hpp"
+#include "proc/mobject/session/fixture.hpp"
+#include "proc/mobject/placement-index.hpp"
+
+#include <boost/scoped_ptr.hpp>
+#include <vector>
+
+
+
+
+namespace mobject {
+namespace session {
+  
+  using std::vector;
+  using boost::scoped_ptr;
+  using std::tr1::shared_ptr;
+
+  
+  /**
+   * Implementation class for the Session interface
+   */
+  class SessionImpl : public mobject::Session
+    {
+      uint focusEDL_;
+      vector<EDL> edls;
+      PFix fixture;
+      shared_ptr<PlacementIndex> pIdx_;
+      
+      /* ==== Session API ==== */
+      virtual bool isValid ();
+      virtual void add (PMO& placement);
+      virtual bool remove (PMO& placement);
+      
+      virtual EDL&  currEDL ();
+      
+      virtual PFix& getFixture ();
+      virtual void rebuildFixture ();
+      
+    protected: /* == management API === */
+      SessionImpl (DefsManager&)  throw();
+      friend class SessManagerImpl;
+      
+      void clear ();
+      
+    };
+  
+  
+  /**
+   * Session manager implementation class holding the
+   * actual smart pointer to the current Session impl.
+   */
+  class SessManagerImpl : public SessManager
+    {
+      scoped_ptr<DefsManager> pDefs_;
+      scoped_ptr<SessionImpl> pImpl_;
+      
+      SessManagerImpl()  throw();
+      friend class lumiera::singleton::StaticCreate<SessManagerImpl>;
+      
+      virtual ~SessManagerImpl() {}
+      
+      /* ==== SessManager API ==== */
+      virtual void clear () ;
+      virtual void reset () ;
+      virtual void load ()  ;
+      virtual void save ()  ;
+      virtual SessionImpl* operator-> ()  throw() ;
+      
+      
+    public:
+      /* ==== proc layer internal API ==== */
+      
+      /** @internal access point for PlacementIndex and PlacementRef */
+      static shared_ptr<PlacementIndex> getCurrentIndex () ;  
+      
+    };
+  
+  
+  
+}} // namespace mobject::session
+#endif
diff --git a/src/proc/mobject/session/session.cpp b/src/proc/mobject/session/session.cpp
index 19a8aa7f1..d8e390eb5 100644
--- a/src/proc/mobject/session/session.cpp
+++ b/src/proc/mobject/session/session.cpp
@@ -33,7 +33,7 @@
 
 #include "proc/mobject/session.hpp"
 #include "proc/mobject/session/defsmanager.hpp"
-#include "proc/mobject/session/sessionimpl.hpp"
+#include "proc/mobject/session/session-impl.hpp"
 
 #include "lib/singleton.hpp"
 
diff --git a/src/proc/mobject/session/sessionimpl.cpp b/src/proc/mobject/session/sessionimpl.cpp
deleted file mode 100644
index b9af6f9ed..000000000
--- a/src/proc/mobject/session/sessionimpl.cpp
+++ /dev/null
@@ -1,116 +0,0 @@
-/*
-  SessionImpl  -  holds the complete session data to be edited by the user
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "proc/mobject/session/sessionimpl.hpp"
-#include "proc/mobject/placement.hpp"
-#include "lib/error.hpp"
-
-namespace mobject
-  {
-  namespace session
-    {
-    
-    /** create a new empty session with default values.
-     *  @note any exception arising while creating this
-     *        default session will inevitably halt the
-     *        system (and this is desirable)
-     */
-    SessionImpl::SessionImpl (DefsManager& defs)  throw()
-      : Session(defs),
-        focusEDL_(0),
-        edls(1), 
-        fixture(new Fixture) 
-      {
-      }
-    
-    
-    /** @internal used by SessionManager#clear
-     *            discard all EDL content, without
-     *            touching global configuration.
-     */
-    void 
-    SessionImpl::clear ()
-    {
-      try
-        {
-          edls.clear();
-          edls.resize(1);
-          focusEDL_ = 0;
-        }
-      catch (...)
-        {
-          focusEDL_ = 0;
-          throw lumiera::error::Fatal ("unexpected exception while clearing EDLs");
-        }
-    }
-    
-    
-    bool 
-    SessionImpl::isValid ()
-    {
-      UNIMPLEMENTED ("session self test");
-      return false; // TODO
-    }
-    
-    
-    void 
-    SessionImpl::add (PMO& placement)
-    {
-      UNIMPLEMENTED ("add Placement to the current EDL");
-    }
-    
-    
-    bool 
-    SessionImpl::remove (PMO& placement)
-    {
-      UNIMPLEMENTED ("search and remove a given Placement from current EDL");
-      return false; // TODO
-    }
-
-    /// @deprecated should not grant direct access to EDL objects
-    EDL& 
-    SessionImpl::currEDL () 
-    { 
-      ASSERT (focusEDL_ < edls.size());
-      return  edls[focusEDL_];
-    }
-    
-    
-    PFix& 
-    SessionImpl::getFixture () 
-    { 
-      return fixture; 
-    }
-    
-    
-    void 
-    SessionImpl::rebuildFixture () 
-    { 
-      UNIMPLEMENTED ("rebuild Fixture"); 
-    }
-
-
-
-  } // namespace mobject::session
-
-} // namespace mobject
diff --git a/src/proc/mobject/session/sessionimpl.hpp b/src/proc/mobject/session/sessionimpl.hpp
deleted file mode 100644
index a56fdb217..000000000
--- a/src/proc/mobject/session/sessionimpl.hpp
+++ /dev/null
@@ -1,111 +0,0 @@
-/*
-  SESSIONIMPL.hpp  -  holds the complete session data to be edited by the user
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-*/
-
-
-/** @file sessionimpl.hpp
- ** Session and SessionManager Implemention classes.
- ** Session and the corresponding Manager are primary Interfaces
- ** to control the behaviour of the editing part of the application.
- ** All all implementaion complexities are hidden behind a "PImpl".
- **
- ** This file contains the implementation classes, it should never
- ** be included by client code.
- **
- */
-
-
-#ifndef MOBJECT_SESSION_SESSIONIMPL_H
-#define MOBJECT_SESSION_SESSIONIMPL_H
-
-#include "proc/mobject/session.hpp"
-#include "proc/mobject/session/edl.hpp"
-#include "proc/mobject/session/fixture.hpp"
-
-#include <boost/scoped_ptr.hpp>
-#include <vector>
-
-using std::vector;
-
-
-
-namespace mobject
-  {
-  namespace session
-    {
-
-
-    /**
-     * Implementation class for the Session interface
-     */
-    class SessionImpl : public mobject::Session
-      {
-      protected:
-        uint focusEDL_;
-        vector<EDL> edls;
-        PFix fixture;
-        
-        SessionImpl (DefsManager&)  throw();
-        friend class SessManagerImpl;
-        
-        void clear ();
-        
-      public:
-        virtual bool isValid ();
-        virtual void add (PMO& placement);
-        virtual bool remove (PMO& placement);
-        
-        virtual EDL&  currEDL ();
-        
-        virtual PFix& getFixture ();
-        virtual void rebuildFixture ();
-
-      };
-      
-      
-    /**
-     * Session manager implementation class holding the
-     * actual smart pointer to the current Session impl.
-     */
-    class SessManagerImpl : public SessManager
-      {
-        boost::scoped_ptr<DefsManager> pDefs_;
-        boost::scoped_ptr<SessionImpl> pImpl_;
-        
-        SessManagerImpl()  throw();
-        friend class lumiera::singleton::StaticCreate<SessManagerImpl>;
-        
-      public:
-        virtual ~SessManagerImpl() {}
-        
-        virtual void clear () ;
-        virtual void reset () ;
-        virtual void load ()  ;
-        virtual void save ()  ;
-        virtual SessionImpl* operator-> ()  throw() ;
-      };
-
-      
-
-  } // namespace mobject::session
-
-} // namespace mobject
-#endif
diff --git a/src/proc/mobject/session/sessmanagerimpl.cpp b/src/proc/mobject/session/sessmanagerimpl.cpp
deleted file mode 100644
index d2c827aff..000000000
--- a/src/proc/mobject/session/sessmanagerimpl.cpp
+++ /dev/null
@@ -1,151 +0,0 @@
-/*
-  SessManagerImpl  -  global session access and lifecycle
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-/** @file sessmanagerimpl.cpp
- ** Implementation of the Session management functions.
- ** The Class SessManager is declared alongside with mobject::Session,
- ** because it serves as smart ptr-to-Impl at the same time. Effectively,
- ** the session manager owns the current session object and only grants
- ** access via his overloaded operator->() . Because there is no operator*(),
- ** no one can get at the address of the current session object. (correct?)
- **
- ** @see sessionimpl.hpp
- ** @see mobject::Session#current
- ** @see mobject::session::SessionManager_test
- **
- */
-
-
-#include "proc/mobject/session.hpp"
-#include "proc/mobject/session/sessionimpl.hpp"
-#include "proc/mobject/session/defsmanager.hpp"
-//#include "proc/mobject/session/defsregistry.hpp"
-#include "lib/error.hpp"
-
-using boost::scoped_ptr;
-
-
-
-namespace mobject {
-  namespace session {
-    
-    LUMIERA_ERROR_DEFINE (CREATE_SESSION, "unable to create basic session");
-    
-    /** Access to the "current session", which actually is
-     *  an SessionImpl instance. This session object is created 
-     *  either by loading an existing session, or on demand by
-     *  this accessor function here (when no session was loaded
-     *  or created)
-     *  @note any exceptions arising while building the basic
-     *        session object(s) will halt the system.
-     */
-    SessionImpl* 
-    SessManagerImpl::operator-> ()  throw() 
-    { 
-      if (!pImpl_)
-        try
-          { // create empty default configured session
-            this->reset();
-          }
-        catch (...)
-          {
-            ERROR (progress, "Unrecoverable Failure while creating the empty default session.");
-            throw lumiera::error::Fatal ( "Failure while creating the basic session object. System halted." 
-                                        , LUMIERA_ERROR_CREATE_SESSION );
-          }
-
-          
-      return pImpl_.get();
-    }
-
-    
-    
-    /** Initially (at static init time), only the single system-wide 
-     *  Session manger instance is created. It can be used to load an
-     *  existing session; otherwise an empty default Session an a
-     *  Defaults manager (Config Query system) is created at first
-     *  \link #operator-> access \endlink to the session object.
-     */
-    SessManagerImpl::SessManagerImpl ()  throw()
-      : pDefs_ (0),
-        pImpl_ (0)
-    { }
-    
-
-    /** @note no transactional behaviour. 
-     *        may succeed partial.
-     */
-    void
-    SessManagerImpl::clear ()
-    {
-      pImpl_->clear();
-    }
-
-
-    /** @note this operation is atomic and either succeeds or
-     *        fails completely, in which case the current session
-     *        remains unaltered.
-     *  @todo for this to work, we need to change the implementation of
-     *        AssetManager so support this kind of transactional switch!
-     */
-    void
-    SessManagerImpl::reset ()
-    {
-      scoped_ptr<DefsManager> tmpD (new DefsManager);
-      scoped_ptr<SessionImpl> tmpS (new SessionImpl (*tmpD));
-      
-      TODO ("reset the assets registered with AssetManager");
-      // Ichthyo-intern: ticket #95
-      
-      TODO ("thread lock");
-      pDefs_.swap (tmpD);
-      pImpl_.swap (tmpS);
-    }
-
-
-    void
-    SessManagerImpl::load ()
-    {
-      UNIMPLEMENTED ("load serialized session");
-    }
-
-
-    /** \par Implementation details
-     *  We intend to have several switchable object serialisers.
-     *  One of these serializers should genarate a comprehensible
-     *  text based representation suitable for checking into 
-     *  SCM systems.
-     *  Sessions can be saved into one single file or be splitted
-     *  to several files (master file and edl files)
-     */
-    void
-    SessManagerImpl::save ()
-    {
-      UNIMPLEMENTED ("save session (serialized)");
-    }
-
-
-
-  } // namespace mobject::session
-
-} // namespace mobject
diff --git a/tests/components/proc/mobject/placement-index-test.cpp b/tests/components/proc/mobject/placement-index-test.cpp
index fde419d73..6662d384e 100644
--- a/tests/components/proc/mobject/placement-index-test.cpp
+++ b/tests/components/proc/mobject/placement-index-test.cpp
@@ -64,7 +64,7 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          PIdx index (createPlacementIndex());
+          PIdx index (create_PlacementIndex());
           ASSERT (index);
           
           /////////////////////////////////TODO
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index d56d46b49..96f159700 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -65,9 +65,9 @@ namespace test    {
           
           // Prepare an (test)Index backing the PlacementRefs
           typedef shared_ptr<PlacementIndex> PIdx;
-          PIdx index (createPlacementIndex());
+          PIdx index (create_PlacementIndex());
           PMO& root = index->getRoot();
-          reset_PlacementRef(index);
+          reset_PlacementIndex(index);
           
           index->insert (p1, root);
           index->insert (p2, root);
@@ -176,7 +176,7 @@ namespace test    {
 
           //consistency check; then reset PlacementRef index to default
           ASSERT (0 == index->size());
-          reset_PlacementRef();
+          reset_PlacementIndex();
         }
     };
   

From 90dffdc9d208157d5dbf9b4f36e5bebddcaac138 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 06:55:13 +0200
Subject: [PATCH 077/368] some cleanup and renaming

---
 src/lib/factory.hpp                           |  27 +-
 .../mobject/session/defsregistryimpltest.cpp  |   4 +-
 tests/lib/Makefile.am                         |   2 +-
 tests/lib/factory-special-test.cpp            | 322 +++++++++++++++++
 tests/lib/factoryspecialtest.cpp              | 326 ------------------
 tests/lib/factorytest.cpp                     | 174 +++++-----
 wiki/renderengine.html                        |  17 +-
 7 files changed, 433 insertions(+), 439 deletions(-)
 create mode 100644 tests/lib/factory-special-test.cpp
 delete mode 100644 tests/lib/factoryspecialtest.cpp

diff --git a/src/lib/factory.hpp b/src/lib/factory.hpp
index 5645cfba6..e7e568bf8 100644
--- a/src/lib/factory.hpp
+++ b/src/lib/factory.hpp
@@ -28,16 +28,15 @@
 
 
 
-namespace lumiera
-  {
-  namespace factory
-    {
+namespace lumiera {
+  namespace factory {
+    
     /**
      * Wrapping any object created by the Factory into some smart ptr class.
-     * The Factory class inherits this functionallity, so it can be exchanged
+     * The Factory class inherits this functionality, so it can be exchanged
      * independently from the actual object creation behaviour. For example,
      * an Factory implementing some elaborate subclass creation scheme could
-     * be intantiated to either procuce auto-ptrs or shared-ptrs. 
+     * be instantiated to either produce auto-ptrs or shared-ptrs. 
      */
     template
       < class T,                     // the product to be created
@@ -54,7 +53,7 @@ namespace lumiera
     
     
     /**
-     * Basic Factory Template, for definig flexible Factory classes.
+     * Basic Factory Template, for defining flexible Factory classes.
      * These encapsulate the logic for creating of new objects, maybe
      * delegating the memory allocation to the backend layer. Usually,
      * the clients get just a smart-pointer or similar handle to the
@@ -83,13 +82,13 @@ namespace lumiera
     
     
     
-    /* -- some example and default instantiiations -- */  
+    /* -- some example and default instantiations -- */  
     
     using std::tr1::shared_ptr;
 
     /** 
      * a frequently used instantiation of the Wrapper,
-     * utilizing the refcounting shared_ptr from Boost.
+     * Utilising the refcounting tr1::shared_ptr.
      */
     template<class T>
     class Wrapper<T, shared_ptr<T> >
@@ -105,10 +104,10 @@ namespace lumiera
     /** 
      * Shortcut: commonly used (partial) instantiation of the Factory,
      * generating refcounting shared_ptr wrapped Objects. Built upon
-     * the corresponding special intstantiation of the Wrapper template. 
+     * the corresponding special instantiation of the Wrapper template. 
      */
     template<class T>
-    class RefcountPtr : public Factory<T, Wrapper<T,shared_ptr<T> > >
+    class RefcountFac : public Factory<T, Wrapper<T,shared_ptr<T> > >
       {
       public:
         typedef shared_ptr<T> PType;
@@ -116,16 +115,16 @@ namespace lumiera
      
     
     /** 
-     *  another convienience instantiiation: auto_ptr-to-Impl-Factory.
+     *  another convenience instantiation: auto_ptr-to-Impl-Factory.
      *  Creating an implementation subclass and wraps into auto_ptr.
-     *  @warning the TImpl object will typically be destoyed by the
+     *  @warning the TImpl object will typically be destroyed by the
      *           smart ptr using an T*, so ~T() needs to be virtual.
      */
     template
       < class T,       // Interface class
         class TImpl   // Implementation class to be created
       >
-    class PImplPtr : public Factory<T, Wrapper<T> >
+    class PImplFac : public Factory<T, Wrapper<T> >
       {
       public:
         typedef std::auto_ptr<T> PType;
diff --git a/tests/components/proc/mobject/session/defsregistryimpltest.cpp b/tests/components/proc/mobject/session/defsregistryimpltest.cpp
index 3a04e4aa4..b625cddab 100644
--- a/tests/components/proc/mobject/session/defsregistryimpltest.cpp
+++ b/tests/components/proc/mobject/session/defsregistryimpltest.cpp
@@ -110,8 +110,8 @@ namespace mobject {
           
           
           // fabricating Objects wrapped into smart-ptrs
-          lumiera::factory::RefcountPtr<Dummy<13> > oFac;
-          lumiera::factory::RefcountPtr<Dummy<23> > pFac;
+          lumiera::factory::RefcountFac<Dummy<13> > oFac;
+          lumiera::factory::RefcountFac<Dummy<23> > pFac;
           
           O o1, o2, o3;
           Q13 q1, q2, q3, q4, q5;
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index cea678415..323750462 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -40,7 +40,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/appconfigtest.cpp			\
 	$(testlib_srcdir)/customsharedptrtest.cpp		\
 	$(testlib_srcdir)/exceptionerrortest.cpp		\
-	$(testlib_srcdir)/factoryspecialtest.cpp		\
+	$(testlib_srcdir)/factory-special-test.cpp		\
 	$(testlib_srcdir)/factorytest.cpp			\
 	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
diff --git a/tests/lib/factory-special-test.cpp b/tests/lib/factory-special-test.cpp
new file mode 100644
index 000000000..c8cc078d3
--- /dev/null
+++ b/tests/lib/factory-special-test.cpp
@@ -0,0 +1,322 @@
+/*
+  Factory-Special(Test)  -  testing the more advanced features of factory
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+
+#include "testtargetobj.hpp"
+#include "lib/factory.hpp"
+
+#include <boost/lexical_cast.hpp>
+#include <boost/format.hpp>
+#include <iostream>
+
+using boost::lexical_cast;
+using boost::format;
+using util::isnil;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace test {
+  
+  /**
+   * Example Allocator using plain C memory management.
+   */
+  class MallocAllocator
+    {
+    public:
+      void* operator new (size_t siz) { return malloc (siz); };
+      void  operator delete (void* p) { if (p) free (p);     };
+    };
+  
+  
+  /** 
+   * Simple subclass used for custom alloc and as Interface class
+   */
+  class TargetO : public TestTargetObj
+    {
+      long additional_member;
+      
+    public:
+      TargetO (uint cnt) : TestTargetObj(cnt) {}
+      virtual ~TargetO () {};
+      
+      /** Example Base/Interface function */
+      virtual void funky()
+        {
+          cout << string(*this) << "\n";
+        }
+    };
+  
+  
+  /**
+   * Subclass of the Interface class TargetO, could be an implementation class.
+   */
+  class ImplObj : public TargetO
+    {
+    public:
+      ImplObj () : TargetO(12) {}
+      
+      /** Example Implementation function */
+      virtual void funky()
+        {
+          cout << ".....ImplObj::funky() called\n";
+          TargetO::funky();
+        }
+    };
+  
+  
+  /**
+   * Another special Subclass, using custom allocation.
+   */
+  class MallocO : public TestTargetObj, public MallocAllocator
+    {
+    public:
+      MallocO () : TestTargetObj (7) {}
+    };
+  
+  
+  
+  class Factory2; 
+    
+  /**
+   * Special Subclass prohibiting public use of ctor
+   */
+  class ParanoidObj : public TestTargetObj
+    {
+    private:
+      ParanoidObj (uint cnt) : TestTargetObj(cnt) {}
+      ~ParanoidObj () {}
+      
+      friend class Factory2;
+    };
+  
+  
+  
+  
+  /* ===== several specialised Factories ====== */
+  
+  using std::tr1::shared_ptr;
+  
+  /** 
+   * Factory creating refcounting TargetO pointers 
+   * and using placement Allocation. 
+   */ 
+  class Factory1 : public Factory<TargetO>
+    {
+    public:
+      typedef shared_ptr<TargetO> PType;
+      
+      /** Specialised Factory method
+       *  doing placement new and invoking
+       *  a special constructor. */
+      PType operator() (uint param) { return wrap (new(alloc()) TargetO(param) ); }
+      
+    protected:
+      PType wrap (TargetO* tO) { return PType (tO, &destroy); } ///< note: providing custom deleter function
+      
+      static void destroy (TargetO* victim) { victim->~TargetO(); }  ///< call dtor but don't delete mem
+      static void* alloc ()                 { return buff; }        ///<  returning raw mem for new object
+      static char buff[];                                          ///<   we place our (single) instance here
+    };
+  char Factory1::buff[sizeof(TargetO)];
+  
+  
+  
+  /** 
+   * Factory usable if object can be constructed only by friends
+   */ 
+  class Factory2 : public Factory<ParanoidObj>
+    {
+    public:
+      typedef shared_ptr<ParanoidObj> PType;
+      
+      /** allowed to call ctor because 
+       *  it's a friend of ParanoidObj. 
+       *  Note passing custom deleter. 
+       */
+      PType operator() (uint param)   { return PType (new ParanoidObj(param), &destroy); }
+      
+    protected:
+      /** custom deleter func is allowed to call 
+       *  ~ParanoidObj() because of friendship 
+       */
+      static void destroy (ParanoidObj* victim) { delete victim; }
+      
+    };
+  
+  
+  
+  /* === Factory instances ==============*/
+  
+  typedef Factory<MallocO> FactoryM;
+  typedef factory::PImplFac<TargetO,ImplObj> FactoryP;
+  
+  static Factory1  placement_fac;
+  static Factory2  paranoid_fac;
+  static FactoryM  malloc_fac;
+  static FactoryP  pimpl_fac;
+  
+  
+  
+  
+  
+  
+  /*******************************************************************
+   * testing the more advanced Factory variants and possibilities.
+   * We use several customised Factory subclasses supporting custom
+   * allocation, placement allocation, private constructors and
+   * the PIpmpl design pattern. All creating smart pointers.
+   */
+  class Factory_special_test : public Test
+    {
+      virtual void run(Arg arg) 
+        {
+          uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
+          
+          checkPlacement (num);
+          checkPrivate (num);
+          checkMalloc ();
+          checkPImpl () ;
+        }
+      
+      
+      /** @test using direct object placement instead of heap allocation.
+       *  Factory1 will place every new object into the same static buffer
+       *  and return a refcounting pointer
+       */
+      void checkPlacement (uint cnt)
+        {
+          cout << "checkPlacement--------\n";
+          
+          typedef Factory1::PType P;
+          format msg ("created %d shared_ptrs to Object placed in static buffer.\n");
+          void* raw (0);
+          P pX;
+          ASSERT (0 == pX.use_count());
+          
+            {
+              P p1 (placement_fac (cnt));
+              P p2 (p1);
+              P pX = p2;
+              
+              cout << msg % p2.use_count() 
+                   << string (*pX) << "\n";
+              
+              raw = p1.get(); // remember raw mem address
+            }
+            
+          ASSERT (0 == pX.use_count());
+          
+            {
+              P p1 (placement_fac (cnt+1));
+              P p2 (p1);
+              P p3 (p1);
+              P pX = p2;
+              
+              cout << msg % p2.use_count();
+              
+              ASSERT (raw == p1.get(), "explicit object placement at fixed buffer doesn't work.");
+            }
+            
+          ASSERT (0 == pX.use_count());
+        } 
+      
+      
+      
+      
+      /** @test simple factory creating std::auto_ptr wrapped instances
+       *  of an object with only private ctor and dtor. 
+       */
+      void checkPrivate (uint cnt)
+        {
+          cout << "checkPrivate--------\n";
+          
+          typedef Factory2::PType P;
+          format msg ("created %d shared_ptrs to paranoid Object.\n");
+          P pX;
+          
+          ASSERT (0 == pX.use_count());
+            {
+              P p1 (paranoid_fac (cnt));
+              P p2 (p1);
+              P pX = p2;
+              
+              cout << msg % p2.use_count() 
+                   << string (*pX) << "\n";
+            }
+          ASSERT (0 == pX.use_count());
+        }
+      
+      
+      
+      
+      /** @test simple factory creating std::auto_ptr wrapped instances,
+       *  but of a class using a custom allocation scheme (here implemented
+       *  by direct C-style malloc calls)
+       */
+      void checkMalloc (void)
+        {
+          cout << "checkMalloc--------\n";
+          
+          typedef FactoryM::PType P;
+          
+          P p1 (malloc_fac ());
+          P p2 = p1;
+          cout << ("created auto_ptr to malloc-ed Object.\n")
+               << string (*p2) << "\n";
+          
+          ASSERT (!p1.get());
+        }
+      
+      
+      
+      
+      /** @test using direct object placement instead of heap allocation.
+       *  Factory1 will place every new object into the same static buffer
+       *  and return a refcounting pointer
+       */
+      void checkPImpl (void)
+        {
+          cout << "checkPImpl--------\n";
+          
+          typedef FactoryP::PType P;
+          
+          P p1 (pimpl_fac ());
+          P p2 = p1;
+          cout << ("created auto_ptr to Interface Object.\n");
+          p2->funky(); // call a Interface function
+          
+          ASSERT (!p1.get());
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (Factory_special_test, "unit common");
+  
+  
+  
+}} // namespace lumiera::test
diff --git a/tests/lib/factoryspecialtest.cpp b/tests/lib/factoryspecialtest.cpp
deleted file mode 100644
index 26fda9084..000000000
--- a/tests/lib/factoryspecialtest.cpp
+++ /dev/null
@@ -1,326 +0,0 @@
-/*
-  Factory-Special(Test)  -  testing the more advanced features of factory
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "lib/test/run.hpp"
-#include "lib/util.hpp"
-
-#include "testtargetobj.hpp"
-#include "lib/factory.hpp"
-
-#include <boost/lexical_cast.hpp>
-#include <boost/format.hpp>
-#include <iostream>
-
-using boost::lexical_cast;
-using boost::format;
-using util::isnil;
-using std::string;
-using std::cout;
-
-
-namespace lumiera
-  {
-  namespace test
-    {
-    
-    /**
-     * Example Allocator using plain C memory management. 
-     */
-    class MallocAllocator
-      {
-      public:
-        void* operator new (size_t siz) { return malloc (siz); };
-        void  operator delete (void* p) { if (p) free (p);     };
-      };
-
-      
-    /** 
-     * Simple subclass used for custom alloc and as Interface class 
-     */
-    class TargetO : public TestTargetObj
-      {
-        long additional_member;
-        
-      public:
-        TargetO (uint cnt) : TestTargetObj(cnt) {}
-        virtual ~TargetO () {};
-        
-        /** Example Base/Interface function */
-        virtual void funky()
-          {
-            cout << string(*this) << "\n";
-          }
-      };
-      
-      
-    /**
-     * Subclass of the Interface class TargetO, could be an implementation class.
-     */
-    class ImplObj : public TargetO
-      {
-      public:
-        ImplObj () : TargetO(12) {}
-
-        /** Example Implementation function */
-        virtual void funky()
-          {
-            cout << ".....ImplObj::funky() called\n";
-            TargetO::funky();
-          }
-      };
-    
-
-    /**
-     * Another special Subclass, using custom allocation.
-     */
-    class MallocO : public TestTargetObj, public MallocAllocator
-      {
-      public:
-        MallocO () : TestTargetObj (7) {}
-      };
-    
-
-    
-    class Factory2; 
-      
-    /**
-     * Special Subclass prohibiting public use of ctor
-     */
-    class ParanoidObj : public TestTargetObj
-      {
-      private:
-        ParanoidObj (uint cnt) : TestTargetObj(cnt) {}
-        ~ParanoidObj () {}
-        
-        friend class Factory2;
-      };
-    
-      
-      
-    
-    /* ===== several specialized Factories ====== */
-
-    using std::tr1::shared_ptr;
-    
-    /** 
-     * Factory creating refcounting TargetO pointers 
-     * and using placement Allocation. 
-     */ 
-    class Factory1 : public Factory<TargetO>
-      {
-      public:
-        typedef shared_ptr<TargetO> PType;
-        
-        /** specialized Factory method 
-         *  doing placement new and invoking 
-         *  a special constructor. */
-        PType operator() (uint param) { return wrap (new(alloc()) TargetO(param) ); }
-        
-      protected:
-        PType wrap (TargetO* tO) { return PType (tO, &destroy); } ///< note: providing custom deleter func 
-        
-        static void destroy (TargetO* victim) { victim->~TargetO(); }  ///< call dtor but don't delete mem
-        static void* alloc ()                 { return buff; }        ///<  returning raw mem for new object
-        static char buff[];                                          ///<   we place our (single) instance here
-      };
-    char Factory1::buff[sizeof(TargetO)];
-
-      
-    
-    /** 
-     * Factory usable if object can be constructed only by friends
-     */ 
-    class Factory2 : public Factory<ParanoidObj>
-      {
-      public:
-        typedef shared_ptr<ParanoidObj> PType;
-        
-        /** allowed to call ctor because 
-         *  it's a friend of ParanoidObj. 
-         *  Note passing custom deleter. 
-         */
-        PType operator() (uint param)   { return PType (new ParanoidObj(param), &destroy); }
-        
-      protected:
-        /** custom deleter func is allowed to call 
-         *  ~ParanoidObj() because of friendship 
-         */
-        static void destroy (ParanoidObj* victim) { delete victim; }
-
-      };
-
-
-      
-    /* === Factory instances ==============*/
-      
-    typedef Factory<MallocO> FactoryM;
-    typedef factory::PImplPtr<TargetO,ImplObj> FactoryP;
-      
-    static Factory1  placement_fac;
-    static Factory2  paranoid_fac;
-    static FactoryM  malloc_fac;
-    static FactoryP  pimpl_fac;
-    
-    
-    
-    
-    
-    
-    /*******************************************************************
-     * testing the more advanced Factory variants and possibilities.
-     * We use several customised Factory subclasses supporting custom
-     * allocation, placement allocation, private constructors and
-     * the PIpmpl design pattern. All creating smart pointers.
-     */
-    class Factory_special_test : public Test
-      {
-        virtual void run(Arg arg) 
-          {
-            uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
-
-            checkPlacement (num);
-            checkPrivate (num);
-            checkMalloc ();
-            checkPImpl () ;
-          }
-        
-        
-        /** @test using direct object placement instead of heap allocation.
-         *  Factory1 will place every new object into the same static buffer
-         *  and return a refcounting pointer
-         */
-        void checkPlacement (uint cnt)
-          {
-            cout << "checkPlacement--------\n";
-            
-            typedef Factory1::PType P;
-            format msg ("created %d shared_ptrs to Object placed in static buffer.\n");
-            void* raw (0);
-            P pX;
-            ASSERT (0 == pX.use_count());
-            
-              {
-                P p1 (placement_fac (cnt));
-                P p2 (p1);
-                P pX = p2;
-                
-                cout << msg % p2.use_count() 
-                     << string (*pX) << "\n";
-                
-                raw = p1.get(); // remember raw mem address
-              }
-              
-            ASSERT (0 == pX.use_count());
-            
-              {
-                P p1 (placement_fac (cnt+1));
-                P p2 (p1);
-                P p3 (p1);
-                P pX = p2;
-                
-                cout << msg % p2.use_count();
-                
-                ASSERT (raw == p1.get(), "explicit object placement at fixed buffer doesn't work.");
-              }
-              
-            ASSERT (0 == pX.use_count());
-          } 
-        
-        
-        
-        
-        /** @test simple factory creating std::auto_ptr wrapped instances
-         *  of an object with only private ctor and dtor. 
-         */
-        void checkPrivate (uint cnt)
-          {
-            cout << "checkPrivate--------\n";
-            
-            typedef Factory2::PType P;
-            format msg ("created %d shared_ptrs to paranoid Object.\n");
-            P pX;
-
-            ASSERT (0 == pX.use_count());
-              {
-                P p1 (paranoid_fac (cnt));
-                P p2 (p1);
-                P pX = p2;
-                
-                cout << msg % p2.use_count() 
-                     << string (*pX) << "\n";
-              }
-            ASSERT (0 == pX.use_count());
-          }
-        
-        
-        
-        
-        /** @test simple factory creating std::auto_ptr wrapped instances,
-         *  but of a class using a custom allocation scheme (here implemented
-         *  by direct C-style malloc calls)
-         */
-        void checkMalloc (void)
-          {
-            cout << "checkMalloc--------\n";
-            
-            typedef FactoryM::PType P;
-            
-            P p1 (malloc_fac ());
-            P p2 = p1;
-            cout << ("created auto_ptr to malloc-ed Object.\n")
-                 << string (*p2) << "\n";
-            
-            ASSERT (!p1.get());
-          }
-        
-        
-        
-        
-        /** @test using direct object placement instead of heap allocation.
-         *  Factory1 will place every new object into the same static buffer
-         *  and return a refcounting pointer
-         */
-        void checkPImpl (void)
-          {
-            cout << "checkPImpl--------\n";
-            
-            typedef FactoryP::PType P;
-            
-            P p1 (pimpl_fac ());
-            P p2 = p1;
-            cout << ("created auto_ptr to Interface Object.\n");
-            p2->funky(); // call a Interface function
-            
-            ASSERT (!p1.get());
-          }
-      };
-    
-    
-    /** Register this test class... */
-    LAUNCHER (Factory_special_test, "unit common");
-    
-    
-    
-  } // namespace test
-
-} // namespace lumiera
diff --git a/tests/lib/factorytest.cpp b/tests/lib/factorytest.cpp
index 578c63085..d1026f7b4 100644
--- a/tests/lib/factorytest.cpp
+++ b/tests/lib/factorytest.cpp
@@ -36,93 +36,89 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera
-  {
-  namespace test
+namespace lumiera {
+namespace test {
+  
+  class ObjFactory;
+  
+  
+  /**
+   * Target object to be created by the Test-Factory.
+   * Allocates a variable amount of additional heap memory
+   * and prints diagnostic messages. Note we provide a
+   * static member TargetObj::create  for the client
+   * code to generate smart ptr wrapped instances.
+   */
+  class TargetObj : public TestTargetObj
     {
-    
-    class ObjFactory;
-    
-
-    /**
-     * Target object to be created by the Test-Factory.
-     * Allocates a variable amount of additional heap memory
-     * and prints diagnostic messages. Note we provide a
-     * static member TargetObj::create  for the client 
-     * code to generate smart ptr wrapped instances.
-     */
-    class TargetObj : public TestTargetObj
-      {
-      public:
-        TargetObj (uint cnt) : TestTargetObj(cnt) {}
-        
-        static ObjFactory create;
-      };
-    
-    
-    
-    /** Test-Factory specialized to create TargetObj instances
-     *  using the 1-argument constructor TargetObj::TargetObj(int).
-     *  It will create boost::shared_ptr instances, because 
-     *  factory::RefcountPtr was parametrized with this smart pointer type.
-     */ 
-    class ObjFactory : public factory::RefcountPtr<TargetObj>
-      {
-      public:
-        /** specialized Factory method for creating TargetObj instances.
-         *  Here, we invoke a special constructor, but basically we could
-         *  do everything we want, creating instances of sub classes,
-         *  registering objects etc. Further, we could have used a
-         *  custom allocator or a special deleter function. 
-         */
-        PType operator() (uint param) { return wrap (new TargetObj(param) ); }
-        
-      };
-    
-    
-    /** shorthand for the created smart-pointer class, 
-     *  here it's a (refcounting) boost::shared_ptr
-     */
-    typedef ObjFactory::PType pTarget;
-
-    ObjFactory TargetObj::create;
-    
-    
-    
-    
-    
-    
-    /*******************************************************************
-     * @test the basic object creation Factory behaviour: We declared
-     *       a static field TargetObj::create to be a ObjFactory. So,
-     *       by invoking this functor, we get a boost::shared_ptr
-     *       wrapping a new TargetObj instance. From this we copy
-     *       further shared-ptrs, invoke a member function and
-     *       finally, when leaving the scope, our TargetObj
-     *       will be destroyed automatically.
-     * @see  lumiera::Factory
-     */
-    class Factory_test : public Test
-      {
-        virtual void run(Arg arg) 
-          {
-            uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
-            
-            pTarget p1 (TargetObj::create (num));
-            pTarget p2 (p1);
-            pTarget p3 = p2;
-            
-            cout << "now the smart-ptr has refcount=" << p1.use_count() << "\n" 
-                 << string (*p3) << "\n";
-          } 
-      };
-    
-    
-    /** Register this test class... */
-    LAUNCHER (Factory_test, "unit common");
-    
-    
-    
-  } // namespace test
-
-} // namespace lumiera
+    public:
+      TargetObj (uint cnt) : TestTargetObj(cnt) {}
+      
+      static ObjFactory create;
+    };
+  
+  
+  
+  /** Test-Factory specialised to create TargetObj instances
+   *  using the 1-argument constructor TargetObj::TargetObj(int).
+   *  It will create boost::shared_ptr instances, because 
+   *  factory::RefcountFac was parametrised with this smart pointer type.
+   */ 
+  class ObjFactory : public factory::RefcountFac<TargetObj>
+    {
+    public:
+      /** specialised Factory method for creating TargetObj instances.
+       *  Here, we invoke a special constructor, but basically we could
+       *  do everything we want, creating instances of sub classes,
+       *  registering objects etc. Further, we could have used a
+       *  custom allocator or a special deleter function. 
+       */
+      PType operator() (uint param) { return wrap (new TargetObj(param) ); }
+      
+    };
+  
+  
+  /** shorthand for the created smart-pointer class,
+   *  here it's a (refcounting) boost::shared_ptr
+   */
+  typedef ObjFactory::PType pTarget;
+  
+  ObjFactory TargetObj::create;
+  
+  
+  
+  
+  
+  
+  /*******************************************************************
+   * @test the basic object creation Factory behaviour: We declared
+   *       a static field TargetObj::create to be a ObjFactory. So,
+   *       by invoking this functor, we get a boost::shared_ptr
+   *       wrapping a new TargetObj instance. From this we copy
+   *       further shared-ptrs, invoke a member function and
+   *       finally, when leaving the scope, our TargetObj
+   *       will be destroyed automatically.
+   * @see  lumiera::Factory
+   */
+  class Factory_test : public Test
+    {
+      virtual void run(Arg arg) 
+        {
+          uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
+          
+          pTarget p1 (TargetObj::create (num));
+          pTarget p2 (p1);
+          pTarget p3 = p2;
+          
+          cout << "now the smart-ptr has refcount=" << p1.use_count() << "\n"
+               << string (*p3) << "\n";
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (Factory_test, "unit common");
+  
+  
+  
+}} // namespace lumiera::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index ff4258b84..20ef06d76 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1232,7 +1232,7 @@ To make the intended use of the classes more clear, consider the following two e
 <pre>A special kind (subclass) of [[Placement]]. As such it is always linked to a //Subject//, i.e. a MObject. In addition to the properties of a (unspecific) Placement, the ExplicitPlacement specifies a absolute time and track position for locating the Subject
 </pre>
 </div>
-<div title="Factories" modifier="Ichthyostega" modified="200808110218" created="200708100401" tags="impl discuss excludeMissing" changecount="21">
+<div title="Factories" modifier="Ichthyostega" modified="200906060436" created="200708100401" tags="impl discuss excludeMissing" changecount="23">
 <pre>We use Factories
 * for centralizing [[memory management|MemoryManagement]]
 * to support polymorphism (of course...)
@@ -1261,7 +1261,7 @@ For this reason I make Factory a Functor, so it can be incorporated as a member
       int wow_;
 
     public:
-      typedef lumiera::factory::RefcountPtr&lt;Product&gt; Factory;
+      typedef lumiera::factory::RefcntFactory&lt;Product&gt; Factory;
       static Factory create;
       
       Product() : wow_(42) {} ;
@@ -1282,7 +1282,8 @@ Some further details
 * thus, when Functor or any derived class issues a new XX(), our custom Allocator gains control
 * the Functor-behaviour relies on a custom {{{operator()}}} which can be overridden in derived classes to take various parameter lists.
 * additionally, such a Factory class derived from Functor can do specific magic and e.g. create some subclass
-* and, as the created smart-pointer is a template parameter, such a custom Functor can create all sorts of Proxies, wrappers and the like
+* and, as the created smart-pointer is a template template parameter, such a custom Functor can create all sorts of Proxies, wrappers and the like
+* a special case of this factory use is the [[Singleton]] factory, which is used a lot within the Proy-Layer code
 </pre>
 </div>
 <div title="Fixture" modifier="Ichthyostega" modified="200712100439" created="200706220324" tags="def" changecount="4">
@@ -1500,13 +1501,15 @@ Finally, this example shows an ''automation'' data set controlling some paramete
 * decide on SessionInterface and create [[Session datastructure layout|SessionDataMem]]
 </pre>
 </div>
-<div title="ImplementationGuidelines" modifier="Ichthyostega" modified="200711210542" created="200711210531" tags="discuss draft" changecount="7">
+<div title="ImplementationGuidelines" modifier="Ichthyostega" modified="200906060443" created="200711210531" tags="discuss draft" changecount="12">
 <pre>!Observations, Ideas, Proposals
 ''this page is a scrapbook for collecting ideas'' &amp;mdash; please don't take anything noted here too literal. While writing code, I observe that I (ichthyo) follow certain informal guidelines, some of which I'd like to note down because they could evolve into general style guidelines for the proc layer code.
-* avoid doing anything non-local during the startup phase or shutdown phase of the application. consequently, allways prefer using an explicit lumiera::Singleton&lt;T&gt; over using an static instance directly, thus yielding better control when the ctor and dtor will be invoked.
-* write error handling code only if the error situation can be actually //handled// at this place. Otherwise, be prepared for exceptions just passing by and thus handle any resources by &quot;resource acquisition is initialisation&quot;. Remember: error handling defeats decoupling and encapsulation
+* avoid doing anything non-local during the startup phase or shutdown phase of the application. consequently, always prefer using an explicit lumiera::Singleton&lt;T&gt; over using an static instance directly, thus yielding better control when the ctor and dtor will be invoked.
+* write error handling code only if the error situation can be actually //handled// at this place. Otherwise, be prepared for exceptions just passing by and thus handle any resources by &quot;resource acquisition is initialisation&quot; (RAII). Remember: error handling defeats decoupling and encapsulation
 * (almost) never {{{delete}}} an object directly, use {{{new}}} only when some smart pointer is at hand.
-* when user/client code is inteded to create objects, make the ctor protected and provide a factory member called {{{create}}} instead, returning a smart pointer
+* when user/client code is intended to create objects, make the ctor protected and provide a factory member called {{{create}}} instead, returning a smart pointer
+* similarly, when we need just one instance of a given service, make the ctor protected and provide a factory member called {{{instance}}}, to be implemented by the lumiera::[[Singleton]] factory.
+* whenever possible, prefer this (lazy initialised [[Singleton]]) approach and avoid static initialisation magic
 * avoid asuming anything that can't be enforced by types, interfaces or signatures; this means: be prepared for open possibilities
 * prefer {{{const}}} and initialisation code over assignment and active changes (inspired by functional programming)
 </pre>

From ee7f2d6c0f24d0e0358ba40587565becd5a8419c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 07:12:09 +0200
Subject: [PATCH 078/368] WIP: replace direct ctor call by an embedded factory
 member

---
 src/proc/mobject/placement-index.cpp          | 11 ++++-----
 src/proc/mobject/placement-index.hpp          | 23 ++++++++++++-------
 src/proc/mobject/session/session-impl.cpp     |  2 +-
 .../proc/mobject/placement-index-test.cpp     |  2 +-
 .../proc/mobject/placement-ref-test.cpp       |  2 +-
 5 files changed, 23 insertions(+), 17 deletions(-)

diff --git a/src/proc/mobject/placement-index.cpp b/src/proc/mobject/placement-index.cpp
index 8185854ea..82c7aa7b3 100644
--- a/src/proc/mobject/placement-index.cpp
+++ b/src/proc/mobject/placement-index.cpp
@@ -105,12 +105,11 @@ namespace mobject {
   } // (End) implementation detail
   
   
-  /** @internal factory function for creating a placement index for tests.  */
-  PIdx
-  create_PlacementIndex ()
-  {
-    return PIdx (new PlacementIndex());
-  }
+  /** @internal Factory for creating a new placement index.
+   *            For use by the Session and for unit tests.  
+   */
+  PlacementIndex::Factory PlacementIndex::create;
+  
   
   PIdx const&
   reset_PlachementIndex(PIdx const& alternativeIndex)
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 46ade7e7e..1f1635e7d 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -36,10 +36,12 @@
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
 //#include "proc/asset/pipe.hpp"
+#include "lib/factory.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
 
 #include <tr1/memory>
+#include <boost/noncopyable.hpp>
 #include <boost/scoped_ptr.hpp>
 #include <vector>
 
@@ -56,6 +58,7 @@ namespace mobject {
   /**
    */
   class PlacementIndex
+    : boost::noncopyable
     {
       class Table;
       
@@ -66,6 +69,7 @@ namespace mobject {
       typedef PlacementRef<MObject> PRef;
       typedef PlacementMO::ID ID;
       
+      
       PlacementMO& find (ID)  const;
       
       template<class MO>
@@ -93,17 +97,20 @@ namespace mobject {
       ID   insert (PlacementMO& newObj, PlacementMO& targetScope);
       bool remove (PlacementMO&);
       bool remove (ID);
+      
+      
+      typedef lumiera::factory::RefcountFac<PlacementIndex> Factory;
+      
+      static Factory create;
+      
+    protected:
+      PlacementIndex() ;
+      friend class Factory;
     };
   ////////////////TODO currently just fleshing  out the API; probably have to split off an impl.class; but for now a PImpl is sufficient...
   
   
   
-  /** preliminary helper for creating a placement index (instance).
-   *  @todo integrate this into the session and provide an extra factory for tests?
-   */
-  shared_ptr<PlacementIndex>
-  create_PlacementIndex() ;
-  
   /** @internal there is an implicit PlacementIndex available on a global scale,
    *            by default implemented within the current session. This function allows
    *            to re-define this implicit index temporarily, e.g. for unit tests. */
@@ -117,7 +124,7 @@ namespace mobject {
   /** @internal access point for PlacementRef to the implicit global PlacementIndex */
   Placement<MObject> &
   fetch_PlachementIndex(Placement<MObject>::ID const&) ;
-
-
+  
+  
 } // namespace mobject
 #endif
diff --git a/src/proc/mobject/session/session-impl.cpp b/src/proc/mobject/session/session-impl.cpp
index a518b612f..d870e46a9 100644
--- a/src/proc/mobject/session/session-impl.cpp
+++ b/src/proc/mobject/session/session-impl.cpp
@@ -38,7 +38,7 @@ namespace session {
       focusEDL_(0),
       edls(1),
       fixture(new Fixture),
-      pIdx_(*create_PlacementIndex())
+      pIdx_(PlacementIndex::create())
     {
     }
   
diff --git a/tests/components/proc/mobject/placement-index-test.cpp b/tests/components/proc/mobject/placement-index-test.cpp
index 6662d384e..b9b003ede 100644
--- a/tests/components/proc/mobject/placement-index-test.cpp
+++ b/tests/components/proc/mobject/placement-index-test.cpp
@@ -64,7 +64,7 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          PIdx index (create_PlacementIndex());
+          PIdx index (PlacementIndex::create());
           ASSERT (index);
           
           /////////////////////////////////TODO
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index 96f159700..ff9d2f91d 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -65,7 +65,7 @@ namespace test    {
           
           // Prepare an (test)Index backing the PlacementRefs
           typedef shared_ptr<PlacementIndex> PIdx;
-          PIdx index (create_PlacementIndex());
+          PIdx index (PlacementIndex::create());
           PMO& root = index->getRoot();
           reset_PlacementIndex(index);
           

From bf94c90e59e6f6ac31f65247d3551ef6bfa726e4 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sat, 6 Jun 2009 15:22:48 +0200
Subject: [PATCH 079/368] add some more nobug keywords to the test.sh exception
 list

---
 tests/test.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test.sh b/tests/test.sh
index 7c2ca1427..ce4ef4dee 100755
--- a/tests/test.sh
+++ b/tests/test.sh
@@ -26,7 +26,7 @@
 #   stop testing on the first failure
 
 export LC_ALL=C
-NOBUG_LOGREGEX='^\(\*\*[0-9]*\*\* \)\?[0-9]\{10,\}: \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\):'
+NOBUG_LOGREGEX='^\(\*\*[0-9]*\*\* \)\?[0-9]\{10,\}: \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\|TODO\|PLANNED\|FIXME\|DEPRECATED\|UNIMPLEMENTED\|NOTREACHED\):'
 
 arg0="$0"
 srcdir="$(dirname "$arg0")"

From ee5c2b98eeb0b9e7077177db553e9411eeeabbf8 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sat, 6 Jun 2009 15:23:20 +0200
Subject: [PATCH 080/368] Fix: mpool build and tests

---
 tests/15mpool.tests | 26 +++++++++-----------------
 tests/Makefile.am   |  3 ++-
 2 files changed, 11 insertions(+), 18 deletions(-)

diff --git a/tests/15mpool.tests b/tests/15mpool.tests
index 97efac290..487ccb7b3 100644
--- a/tests/15mpool.tests
+++ b/tests/15mpool.tests
@@ -3,44 +3,36 @@ TESTING "Memory pool tests" ./test-mpool
 TEST "init/destroy" basic <<END
 err: initialized
 err: allocated
+err: DUMP
 err: freed
+err: DUMP
 err: destroyed
 return: 0
 END
 
 
 TEST "auto destruction" destroy <<END
-return: !0
+return: 0
 END
 
 
 TEST "cluster allocation" clusters <<END
-return: !0
+return: 0
 END
 
 
-TEST "random usage" random <<END
-return: !0
+PLANNED "random usage" random <<END
+return: 0
 END
 
 
-TEST "stats" statscheck <<END
-return: !0
-END
-
-
-TEST "optimizer" optimize <<END
-return: !0
-END
-
-
-TEST "collector" collect <<END
-return: !0
+PLANNED "stats" statscheck <<END
+return: 0
 END
 
 
 TEST "reserve" reserve <<END
-return: !0
+return: 0
 END
 
 
diff --git a/tests/Makefile.am b/tests/Makefile.am
index 3105dd6e2..c33287932 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -37,7 +37,8 @@ test_llist_LDADD = $(NOBUGMT_LUMIERA_LIBS)                                  libl
 check_PROGRAMS += test-mpool
 test_mpool_SOURCES = $(tests_srcdir)/library/test-mpool.c
 test_mpool_CPPFLAGS = $(AM_CPPFLAGS) -std=gnu99 -Wall -Werror
-test_mpool_LDADD = liblumiera.la $(NOBUGMT_LUMIERA_LIBS)     liblumieracommon.la liblumieraproc.la -ldl -lboost_program_options-mt -lboost_regex-mt
+test_mpool_LDADD = $(NOBUGMT_LUMIERA_LIBS) \
+	liblumiera.la liblumieracommon.la liblumierabackend.la liblumieraproc.la -lboost_program_options-mt -lboost_regex-mt -ldl
 
 check_PROGRAMS += test-psplay
 test_psplay_SOURCES = $(tests_srcdir)/library/test-psplay.c

From 64c123844554ecfa30a99d57ff5273b9e9574cf0 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sat, 6 Jun 2009 16:05:34 +0200
Subject: [PATCH 081/368] FIX: mpool: macro for constants depending on host
 wordsize

This might fix http://issues.lumiera.org/ticket/136 I have no 32bit
system to validate this.
---
 src/lib/mpool.c | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index 8a40f3682..88a2a8be2 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -30,8 +30,10 @@
 
 #if UINTPTR_MAX > 4294967295U   /* 64 bit */
 #define MPOOL_DIV_SHIFT 6
+#define MPOOL_C(c) c ## ULL
 #else                           /* 32 bit */
 #define MPOOL_DIV_SHIFT 5
+#define MPOOL_C(c) c ## UL
 #endif
 
 /*
@@ -113,7 +115,7 @@ bitmap_bit_get_nth (MPoolcluster cluster, unsigned index)
   TRACE (mpool_dbg, "cluster %p: index %u", cluster, index);
 
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
-  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
+  uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
 
   return bitmap[quot] & ((uintptr_t)1<<rem);
@@ -206,7 +208,7 @@ static inline unsigned
 uintptr_nearestbit (uintptr_t v, unsigned n)
 {
   unsigned r = 0;
-  uintptr_t mask = 1ULL<<n;
+  uintptr_t mask = MPOOL_C(1)<<n;
 
   while (1)
     {
@@ -217,7 +219,7 @@ uintptr_nearestbit (uintptr_t v, unsigned n)
           else
             return n+r;
         }
-      if (mask == ~0ULL)
+      if (mask == ~MPOOL_C(0))
         return ~0U;
       ++r;
       mask |= ((mask<<1)|(mask>>1));
@@ -236,7 +238,7 @@ alloc_near (MPoolcluster cluster, MPool self, void* locality)
 
   uintptr_t index = (locality - begin_of_elements) / self->elem_size;
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
-  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
+  uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
@@ -272,7 +274,7 @@ bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
 
   uintptr_t index = (element - begin_of_elements) / self->elem_size;
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
-  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
+  uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[quot] |= ((uintptr_t)1<<rem);
@@ -291,7 +293,7 @@ bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
 
   uintptr_t index = (element - begin_of_elements) / self->elem_size;
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
-  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
+  uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[quot] &= ~((uintptr_t)1<<rem);
@@ -399,7 +401,7 @@ find_near (MPoolcluster cluster, MPool self, void* element)
 
   uintptr_t index = (element - begin_of_elements) / self->elem_size;
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
-  uintptr_t rem = index & ~((~0ULL)<<MPOOL_DIV_SHIFT);
+  uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;

From 56ff31df0afed213d2860c8ead16176e4bb71f19 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 23:12:51 +0200
Subject: [PATCH 082/368] WIP: initial testbed for MObjectRef_test

---
 .../proc/mobject/mobject-ref-test.cpp         | 55 +++++++++++++++++--
 .../proc/mobject/placement-ref-test.cpp       |  2 +-
 2 files changed, 51 insertions(+), 6 deletions(-)

diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
index d33771c99..2a291c402 100644
--- a/tests/components/proc/mobject/mobject-ref-test.cpp
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -22,17 +22,17 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/lumitime.hpp"
+#include "lib/lumitime.hpp"
 #include "proc/mobject/mobject.hpp"
 #include "proc/mobject/mobject-ref.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
 
 #include <iostream>
 
-//using lumiera::Time;
+using lumiera::Time;
 using std::string;
 using std::cout;
 
@@ -40,12 +40,15 @@ using std::cout;
 namespace mobject {
 namespace test    {
   
-  using namespace mobject::test;
+  using session::Clip;
 
   
   /***************************************************************************
    * @test properties and behaviour of the external reference-mechanism for
-   *       MObjects placed into the session. 
+   *       MObjects placed into the session. We create a simple, simulated
+   *       "session" (no real session datastructure) and a mock PlacementIndex.
+   *       Then we add two Placements, which can be used then to build
+   *       MObjectRef instances to validate their behaviour. 
    * @see  mobject::Placement
    * @see  mobject::MObject
    * @see  mobject::PlacementRef_test
@@ -53,9 +56,51 @@ namespace test    {
   class MObjectRef_test : public Test
     {
       
+      typedef Placement<MObject>        PMObj;
+      typedef Placement<Clip>           PClip;
+      typedef TestPlacement<TestSubMO1> PSub1;
+      
+      
       virtual void
       run (Arg) 
         {
+          
+          // create data simulating a "Session"
+          PMObj  pClip1 = asset::Media::create("test-1", asset::VIDEO)->createClip();
+          PMObj  pClip2 = asset::Media::create("test-2", asset::VIDEO)->createClip();
+          
+          // set up a tie to fixed start positions
+          pClip1.chain(Time(10));
+          pClip2.chain(Time(20));
+          
+          ASSERT (pClip1->isValid());
+          ASSERT (pClip2->isValid());
+          ASSERT (2 == pClip1.use_count());  // one by the placement and one by the clip-Asset
+          ASSERT (2 == pClip2.use_count());
+          
+          
+          // Prepare an (test)Index
+          typedef shared_ptr<PlacementIndex> PIdx;
+          PIdx index (PlacementIndex::create());
+          PMO& root = index->getRoot();
+          reset_PlacementIndex(index);
+          
+          // Add the Clips to "session"
+          index->insert (pClip1, root);
+          index->insert (pClip2, root);
+          ASSERT (2 == index->size());
+          
+          
+          // -----Tests------------------
+          // -----Tests------------------
+          
+          // verify clean state
+          index->remove (pClip1);
+          index->remove (pClip2);
+          ASSERT (0 == index->size());
+          ASSERT (2 == pClip1.use_count());
+          ASSERT (2 == pClip2.use_count());
+          reset_PlacementIndex();
         }
     };
   
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index ff9d2f91d..e681843e8 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -61,7 +61,7 @@ namespace test    {
           
           PSub p1(*new TestSubMO21);
           PSub p2(*new TestSubMO21);
-          p2.chain(Time(2));
+          p2.chain(Time(2));         // define start time of Placement-2 to be at t=2
           
           // Prepare an (test)Index backing the PlacementRefs
           typedef shared_ptr<PlacementIndex> PIdx;

From 091c3a20ef833722ee379656f2a037aabf47e14d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 6 Jun 2009 23:58:44 +0200
Subject: [PATCH 083/368] fix indentation

---
 src/proc/mobject/session/clip.cpp | 109 ++++++++++++--------------
 src/proc/mobject/session/clip.hpp | 125 +++++++++++++++---------------
 2 files changed, 113 insertions(+), 121 deletions(-)

diff --git a/src/proc/mobject/session/clip.cpp b/src/proc/mobject/session/clip.cpp
index 78655283f..6c8965a7e 100644
--- a/src/proc/mobject/session/clip.cpp
+++ b/src/proc/mobject/session/clip.cpp
@@ -26,62 +26,55 @@
 #include "proc/asset/media.hpp"
 #include "proc/asset/clip.hpp"
 
-namespace mobject
+namespace mobject {
+namespace session {
+
+  /** new clip-MO linked with the given asset::Clip.
+   *  Initially, this clip will cover the whole source media length.
+   */
+  Clip::Clip (const asset::Clip& clipDef, const Media& mediaDef)
+    : start_(0),
+      mediaDef_(mediaDef),
+      clipDef_(clipDef)
   {
-  namespace session
-    {
-
-    /** new clip-MO linked with the given asset::Clip.
-     *  Initially, this clip will cover the whole source media length. 
-     */
-    Clip::Clip (const asset::Clip& clipDef, const Media& mediaDef)
-      : start_(0),
-        mediaDef_(mediaDef),
-        clipDef_(clipDef)
-    {
-      setupLength();
-    }
-    
-    
-    
-    /** implementing the common MObject self test.
-     *  Length definition is consitent, underlying 
-     *  media def is accessible etc. */
-    bool
-    Clip::isValid ()  const
-    {
-      TODO ("check consistency of clip length def, implies accessing the underlying media def");
-      return length > Time(0);
-    }
-    
-    
-    void 
-    Clip::setupLength()
-    {
-      TODO ("really calculate the length of a clip and set length field");
-      this->length = mediaDef_.getLength();
-    }
-    
-    
-    PMedia 
-    Clip::getMedia ()  const                        
-    { 
-      return asset::AssetManager::wrap (mediaDef_);
-    }
-    
-    
-    PClipAsset
-    Clip::findClipAsset ()  const
-    {
-      return asset::AssetManager::wrap (clipDef_);
-    }
-
-
-
-
-
-
-
-  } // namespace mobject::session
-
-} // namespace mobject
+    setupLength();
+  }
+  
+  
+  
+  /** implementing the common MObject self test.
+   *  Length definition is consitent, underlying
+   *  media def is accessible etc. */
+  bool
+  Clip::isValid ()  const
+  {
+    TODO ("check consistency of clip length def, implies accessing the underlying media def");
+    return length > Time(0);
+  }
+  
+  
+  void 
+  Clip::setupLength()
+  {
+    TODO ("really calculate the length of a clip and set length field");
+    this->length = mediaDef_.getLength();
+  }
+  
+  
+  PMedia 
+  Clip::getMedia ()  const                        
+  { 
+    return asset::AssetManager::wrap (mediaDef_);
+  }
+  
+  
+  PClipAsset
+  Clip::findClipAsset ()  const
+  {
+    return asset::AssetManager::wrap (clipDef_);
+  }
+  
+  
+  
+  
+}} // namespace mobject::session
diff --git a/src/proc/mobject/session/clip.hpp b/src/proc/mobject/session/clip.hpp
index f0652c2e6..54cc146b0 100644
--- a/src/proc/mobject/session/clip.hpp
+++ b/src/proc/mobject/session/clip.hpp
@@ -27,73 +27,72 @@
 #include "proc/mobject/session/abstractmo.hpp"
 
 
-namespace asset
-  {
-    class Media;
-    class Clip;
-  }
+namespace asset {
+  class Media;
+  class Clip;
+}
 
 namespace mobject {
 namespace session {
-    
-    using asset::Media;
-    typedef P<Media> PMedia;
-    typedef P<asset::Clip> PClipAsset;
-
-
-    /**
-     * A user visible/editable Clip is a reference to a contiguous
-     * sequence of media data loaded as Asset into the current Session.
-     * As such, it is a virtual (non destructive) cut or edit of the 
-     * source material and can be placed into the EDL to be rendered
-     * into the output. The actual media type of a clip will be derived
-     * at runtime by resolving this reference to the underlying Asset.
-     * 
-     * @todo define how to denote Time positions /lengths. This is tricky,
-     * because it depends on the actual media type, and we want to encapsulate
-     * all these details as much as possible. 
-     */
-    class Clip : public AbstractMO
-      {
-      protected:
-        /** start position in source */
-        Time start_;
-
-        /** @todo using a mere ref here is against the scheme and only 
-            done as temporal solution, until we work out how to handle
-            multichannel clips. It should be a smart pointer of some kind
-            and the unlink() function of the asset should take it into
-            account when breaking circular references.
-         */             
-        
-        const Media & mediaDef_;
-        const asset::Clip & clipDef_;
-
-        Clip (const asset::Clip&, const Media&);
-        friend class MObjectFactory;
-        
-        
-        virtual void setupLength();
-        
-      public:
-        virtual bool isValid()  const;
-        
-        /** access the underlying media asset */
-        PMedia getMedia ()  const;
-        
-        /** locate the corresponding asset
-         *  representing this clip or the whole
-         *  compound in case of a multichannel clip
-         */ 
-        PClipAsset findClipAsset ()  const;
-        
-        DEFINE_PROCESSABLE_BY (builder::BuilderTool);
-        
-      };
+  
+  using asset::Media;
+  typedef P<Media> PMedia;
+  typedef P<asset::Clip> PClipAsset;
+  
+  
+  /**
+   * A user visible/editable Clip is a reference to a contiguous
+   * sequence of media data loaded as Asset into the current Session.
+   * As such, it is a virtual (non destructive) cut or edit of the 
+   * source material and can be placed into the EDL to be rendered
+   * into the output. The actual media type of a clip will be derived
+   * at runtime by resolving this reference to the underlying Asset.
+   * 
+   * @todo define how to denote Time positions /lengths. This is tricky,
+   * because it depends on the actual media type, and we want to encapsulate
+   * all these details as much as possible.
+   */
+  class Clip : public AbstractMO
+    {
+    protected:
+      /** start position in source */
+      Time start_;
       
-    typedef Placement<Clip> PClipMO;
-    
-    
+      /** @todo using a mere ref here is against the scheme and only
+          done as temporal solution, until we work out how to handle
+          multichannel clips. It should be a smart pointer of some kind
+          and the unlink() function of the asset should take it into
+          account when breaking circular references.
+       */
+      
+      const Media & mediaDef_;
+      const asset::Clip & clipDef_;
+      
+      Clip (const asset::Clip&, const Media&);
+      friend class MObjectFactory;
+      
+      
+      virtual void setupLength();
+      
+    public:
+      virtual bool isValid()  const;
+      
+      /** access the underlying media asset */
+      PMedia getMedia ()  const;
+      
+      /** locate the corresponding asset
+       *  representing this clip or the whole
+       *  compound in case of a multichannel clip
+       */ 
+      PClipAsset findClipAsset ()  const;
+      
+      DEFINE_PROCESSABLE_BY (builder::BuilderTool);
+      
+    };
     
+  typedef Placement<Clip> PClipMO;
+  
+  
+  
 }} // namespace mobject::session
 #endif

From 2731e34c3ef173fd2b72ecc424bf92ef4d70f173 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 00:45:55 +0200
Subject: [PATCH 084/368] WIP: test driven brainstorming: basic MObjectRef
 behaviour

---
 src/proc/mobject/mobject-ref.hpp              |  1 +
 .../proc/mobject/mobject-ref-test.cpp         | 64 ++++++++++++++++++-
 2 files changed, 64 insertions(+), 1 deletion(-)

diff --git a/src/proc/mobject/mobject-ref.hpp b/src/proc/mobject/mobject-ref.hpp
index d858b7cb1..8bbab4c7a 100644
--- a/src/proc/mobject/mobject-ref.hpp
+++ b/src/proc/mobject/mobject-ref.hpp
@@ -46,6 +46,7 @@
 
 //#include <tr1/memory>
 
+///////////////////////////////////////////TODO: define an C-API representation here, make the header multilingual!
 
 namespace mobject {
   
diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
index 2a291c402..02156aafc 100644
--- a/tests/components/proc/mobject/mobject-ref-test.cpp
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -23,23 +23,26 @@
 
 #include "lib/test/run.hpp"
 #include "lib/lumitime.hpp"
+#include "proc/asset/media.hpp"
 #include "proc/mobject/mobject.hpp"
 #include "proc/mobject/mobject-ref.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
+#include "proc/mobject/session/clip.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
 
 #include <iostream>
 
-using lumiera::Time;
 using std::string;
 using std::cout;
+using std::endl;
 
 
 namespace mobject {
 namespace test    {
   
+  using lumiera::Time;
   using session::Clip;
 
   
@@ -90,8 +93,26 @@ namespace test    {
           index->insert (pClip2, root);
           ASSERT (2 == index->size());
           
+          // extract various kinds of IDs and refs
+          PMObj &         rP1 (pClip1);
+          PMObj const&    rP2 (pClip2);
+          PMObj::ID       id1 = pClip1.getID();
+          PMObj::Id<Clip> id2 = pClip2.getID();
+          LumieraUid luid = id1.get();
+          ///////////////////////////////////////////TODO: check the C-API representation here
+          PlacementRef<Clip>    ref1 (id1);
+          PlacementRef<MObject> ref2 (pClip2);
+          
           
           // -----Tests------------------
+          checkBuildMObjectRef (rP1,  &pClip1);
+          checkBuildMObjectRef (rP2,  &pClip2);
+          checkBuildMObjectRef (id1,  &pClip1);
+          checkBuildMObjectRef (id2,  &pClip2);
+          checkBuildMObjectRef (luid, &pClip1);
+          ///////////////////////////////////////////TODO: check the C-API representation here
+          checkBuildMObjectRef (ref1, &pClip1);
+          checkBuildMObjectRef (ref2, &pClip2);
           // -----Tests------------------
           
           // verify clean state
@@ -102,6 +123,47 @@ namespace test    {
           ASSERT (2 == pClip2.use_count());
           reset_PlacementIndex();
         }
+      
+      
+      template<typename REF>
+      void
+      checkBuildMObjectRef (REF refObj, void* placementAdr)
+        {
+          MORef<Clip> rMO;
+          ASSERT (!rMO);                    // still empty (not bound)
+          cout << rMO             << endl;
+          cout << showSizeof(rMO) << endl;
+          
+          // activate by binding to provided ref
+          rMO.activate(refObj);
+          ASSERT (rMO);                     // now bound
+          cout << rMO             << endl;
+          
+          // access MObject (Clip API)
+          cout << rMO->operator string() << endl;
+          cout << rMO->getMedia()->ident << endl;
+          ASSERT (rMO->isValid());
+          
+          // access the Placement-API
+          ASSERT (2 == rMO.use_count());    // we are referring, not creating a new Placement
+          ASSERT (0 < rMO.getStartTime());  // (internally, this resolves to an ExplicitPlacement)
+          ASSERT ( rMO.isCompatible<MObject>());
+          ASSERT ( rMO.isCompatible<Clip>());
+          ASSERT (!rMO.isCompatible<TestSubMO1>());
+          Time start = rMO.getStartTime();
+          
+          // re-link to the Placement (note we get the Clip API!)
+          Placement<Clip> & refP = rMO.getPlacement();
+          ASSERT (refP);
+          ASSERT (2 == refP.use_count());
+          ASSERT (&refP == placementAdr);   // actually denotes the address of the original Placement in the "session"
+          cout << string(refP) << endl;
+
+          ExplicitPlacement exPla = refP.resolve();
+          ASSERT (exPla.time == start);     // recovered Placement resolves to the same time as provided by the proxied API
+          ASSERT (3 == refP.use_count());   // but now we've indeed created an additional owner (exPla)
+          ASSERT (3 == rMO.use_count());
+        }
     };
   
   

From 905c0319beb9a988afcee8776935c0795ad75efd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 03:12:07 +0200
Subject: [PATCH 085/368] WIP: add lifecycle test

---
 .../proc/mobject/mobject-ref-test.cpp         | 70 +++++++++++++++++--
 1 file changed, 66 insertions(+), 4 deletions(-)

diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
index 02156aafc..ac0617818 100644
--- a/tests/components/proc/mobject/mobject-ref-test.cpp
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -31,6 +31,7 @@
 #include "proc/mobject/session/clip.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
+#include "lib/test/test-helper.hpp"
 
 #include <iostream>
 
@@ -113,6 +114,9 @@ namespace test    {
           ///////////////////////////////////////////TODO: check the C-API representation here
           checkBuildMObjectRef (ref1, &pClip1);
           checkBuildMObjectRef (ref2, &pClip2);
+          
+          checkLifecycle (rP1,rP2);
+          checkTypeHandling (luid);
           // -----Tests------------------
           
           // verify clean state
@@ -145,7 +149,7 @@ namespace test    {
           ASSERT (rMO->isValid());
           
           // access the Placement-API
-          ASSERT (2 == rMO.use_count());    // we are referring, not creating a new Placement
+          ASSERT (3 == rMO.use_count());    // now rMO shares ownership with the Placement
           ASSERT (0 < rMO.getStartTime());  // (internally, this resolves to an ExplicitPlacement)
           ASSERT ( rMO.isCompatible<MObject>());
           ASSERT ( rMO.isCompatible<Clip>());
@@ -155,14 +159,72 @@ namespace test    {
           // re-link to the Placement (note we get the Clip API!)
           Placement<Clip> & refP = rMO.getPlacement();
           ASSERT (refP);
-          ASSERT (2 == refP.use_count());
+          ASSERT (3 == refP.use_count());
           ASSERT (&refP == placementAdr);   // actually denotes the address of the original Placement in the "session"
           cout << string(refP) << endl;
-
+          
           ExplicitPlacement exPla = refP.resolve();
           ASSERT (exPla.time == start);     // recovered Placement resolves to the same time as provided by the proxied API
-          ASSERT (3 == refP.use_count());   // but now we've indeed created an additional owner (exPla)
+          ASSERT (4 == refP.use_count());   // but now we've indeed created an additional owner (exPla)
+          ASSERT (4 == rMO.use_count());
+        }
+      
+      void
+      checkLifecylce (PMObj const& p1, PMObj const& p1)
+        {
+          ASSERT (2 == p1.use_count());
+          ASSERT (2 == p2.use_count());
+          
+          MORef<Clip> rMO;
+          ASSERT (!rMO);
+          ASSERT (0 == rMO.use_count());
+          
+          rMO.activate(p1);
+          ASSERT (rMO);
+          ASSERT (rMO->getMedia()->getFilename() == "test-1");
           ASSERT (3 == rMO.use_count());
+          ASSERT (3 == p1.use_count());
+          ASSERT (2 == p2.use_count());
+          
+          rMO.activate(p2);
+          ASSERT (rMO);
+          ASSERT (rMO->getMedia()->getFilename() == "test-2");
+          ASSERT (3 == rMO.use_count());
+          ASSERT (2 == p1.use_count());
+          ASSERT (3 == p2.use_count());
+          
+          rMO.activate(p2);
+          ASSERT (3 == rMO.use_count());
+          
+          rMO.close();
+          ASSERT (!rMO);
+          ASSERT (2 == p1.use_count());
+          ASSERT (2 == p2.use_count());
+          
+          try
+            {
+              rMO.getPlacement();
+              NOTREACHED;
+            }
+          catch (...)
+            {
+              ASSERT (lumiera_error () == error::LUMIERA_ERROR_INVALID_PLACEMENTREF);
+            }
+          try
+            {
+              rMO->getMedia();
+              NOTREACHED
+            }
+          catch (...)
+            {
+              ASSERT (lumiera_error () == LUMIERA_ERROR_INVALID_MOBJECTREF);
+            }
+        }
+      
+      void
+      checkTypeHandling (LumieraUid luid)
+        {
+          
         }
     };
   

From f1827ea75360db3b2daa61fd0252ff01d3e3fca6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 03:22:08 +0200
Subject: [PATCH 086/368] WIP: test support macro for exception check

---
 src/lib/test/run.hpp                          |  2 +-
 src/lib/test/test-helper.hpp                  | 25 ++++++++++++++++++-
 src/lib/util.hpp                              |  2 +-
 .../proc/mobject/mobject-ref-test.cpp         | 20 ++-------------
 .../proc/mobject/placement-hierarchy-test.cpp | 13 +++-------
 5 files changed, 32 insertions(+), 30 deletions(-)

diff --git a/src/lib/test/run.hpp b/src/lib/test/run.hpp
index 0b3e896b3..930e3592f 100644
--- a/src/lib/test/run.hpp
+++ b/src/lib/test/run.hpp
@@ -90,7 +90,7 @@ namespace test
     
 } // namespace test
 
-// make them global for convienience 
+// make them global for convenience 
 using ::test::Arg;
 using ::test::Test;
 using ::test::Launch;
diff --git a/src/lib/test/test-helper.hpp b/src/lib/test/test-helper.hpp
index 23c252148..91b13da96 100644
--- a/src/lib/test/test-helper.hpp
+++ b/src/lib/test/test-helper.hpp
@@ -69,7 +69,7 @@ namespace test{
   
   
   /** for printing sizeof().
-   *  prints the given size and name litterally, without any further magic */
+   *  prints the given size and name literally, without any further magic */
   string
   showSizeof (size_t siz, Symbol name);
   
@@ -98,4 +98,27 @@ namespace test{
   
   
 }} // namespace lib::test
+
+
+
+
+/* === test helper macros === */
+
+/**
+ * Macro to verify a statement indeed raises an exception.
+ * If no exception is thrown, the #NOTREACHED macro will trigger
+ * an assertion failure. In case of an exception, the #lumiera_error
+ * state is checked, cleared and verified.
+ */
+#define VERIFY_ERROR(ERROR_ID, ERRONEOUS_STATEMENT) \
+          try                             \
+            {                             \
+              ERRONEOUS_STATEMENT ;       \
+              NOTREACHED;                 \
+            }                             \
+          catch (...)                     \
+            {                             \
+              ASSERT (lumiera_error () == LUMIERA_ERROR_##ERROR_ID ); \
+            }
+
 #endif
diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index 1fba41ca1..a835fc443 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -244,7 +244,7 @@ namespace util {
  *        and we probably will enforce this design rule in future. */
 #define INSTANCEOF(CLASS, EXPR) (dynamic_cast<const CLASS*> (EXPR))
 
-/** the inevitalbe MAX macro, sometimes still necessary in template code */
+/** the inevitable MAX macro, sometimes still necessary in template code */
 #ifndef MAX   // this is present to make this definition play nice with GLib
 #define MAX(A,B) ((A < B) ?  (B) : (A))
 #endif
diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
index ac0617818..cafae095f 100644
--- a/tests/components/proc/mobject/mobject-ref-test.cpp
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -201,24 +201,8 @@ namespace test    {
           ASSERT (2 == p1.use_count());
           ASSERT (2 == p2.use_count());
           
-          try
-            {
-              rMO.getPlacement();
-              NOTREACHED;
-            }
-          catch (...)
-            {
-              ASSERT (lumiera_error () == error::LUMIERA_ERROR_INVALID_PLACEMENTREF);
-            }
-          try
-            {
-              rMO->getMedia();
-              NOTREACHED
-            }
-          catch (...)
-            {
-              ASSERT (lumiera_error () == LUMIERA_ERROR_INVALID_MOBJECTREF);
-            }
+          VERIFY_ERROR (INVALID_PLACEMENTREF, rMO.getPlacement() );
+          VERIFY_ERROR (INVALID_MOBJECTREF,   rMO->getMedia()    );
         }
       
       void
diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index 6ca72b590..3da03055e 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -47,6 +47,7 @@ namespace test    {
   using session::Clip;
   using lib::test::showSizeof;
   using namespace mobject::test;
+  using error::LUMIERA_ERROR_ASSERTION;
   
   
   /***************************************************************************************
@@ -147,15 +148,9 @@ namespace test    {
           
 ///////////////////////////////////////////////////////////////////////////////TODO: find a way to configure NoBug to throw in case of assertion
 ///////////////////////////////////////////////////////////////////////////////TODO: configure NoBug specifically for the testsuite
-//        try
-//          {
-//            hijacked->specialAPI();
-//            NOTREACHED;
-//          }
-//        catch (...)
-//          {
-//            ASSERT (lumiera_error () == error::LUMIERA_ERROR_ASSERTION);
-//          }
+#ifdef false
+          VERIFY_ERROR (ASSERTION, hijacked->specialAPI() );
+#endif
           
           // runtime type diagnostics based on pointee RTTI
           ASSERT ( pSub2.isCompatible<MObject>());

From 321acc7f4e6973816b483cf47905049f2ca6ea50 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 03:36:27 +0200
Subject: [PATCH 087/368] WIP: add type handling and conversion test

---
 .../proc/mobject/mobject-ref-test.cpp         | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
index cafae095f..8c25041d4 100644
--- a/tests/components/proc/mobject/mobject-ref-test.cpp
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -208,7 +208,46 @@ namespace test    {
       void
       checkTypeHandling (LumieraUid luid)
         {
+          MObjectRef rMObj;
+          MORef<Clip> rClip;
+          MORef<TestSubMO1> rSub1;
           
+          ASSERT (0 == rMObj.use_count());
+          ASSERT (0 == rClip.use_count());
+          ASSERT (0 == rSub1.use_count());
+          
+          rMObj.activate(luid);
+          ASSERT (3 == rMObj.use_count());
+          ASSERT (0 == rClip.use_count());
+          ASSERT (0 == rSub1.use_count());
+          
+          rClip.activate(rMObj);              // attach on existing MObjectRef
+          ASSERT (4 == rMObj.use_count());
+          ASSERT (4 == rClip.use_count());
+          ASSERT (0 == rSub1.use_count());
+          
+          // impossible, because Clip isn't a subclass of TestSubMO1:
+          VERIFY_ERROR (INVALID_PLACEMENTREF, rSub1.activate(luid) );
+          VERIFY_ERROR (INVALID_PLACEMENTREF, rSub1 = rMObj        );
+          
+          ASSERT (rMObj->isValid());
+          ASSERT (rClip->isValid());
+          ASSERT (rMObj.getPlacement().getID() == rClip.getPlacement().getID());
+          
+          // doesn't compile, because the function isn't on MObject API:
+          // rMObj->getMedia();
+          
+          // can assign, because the actual type is relevant:
+          rClip.close();
+          ASSERT (3 == rMObj.use_count());
+          ASSERT (0 == rClip.use_count());
+          
+          rClip = rMObj;
+          ASSERT (4 == rMObj.use_count());
+          ASSERT (4 == rClip.use_count());
+          
+          cout << rClip << endl;
+          cout << rClip->getMedia()->ident << endl;
         }
     };
   

From 250bdf81cd82047e150c43cf98270b3ac456d114 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 16:42:13 +0200
Subject: [PATCH 088/368] UML: merge additions done on branch builder

---
 uml/lumiera/128133.diagram |   2 +-
 uml/lumiera/128261         |  55 +++++++++++++++-
 uml/lumiera/128389         |  17 +++--
 uml/lumiera/128389.diagram |  14 ++---
 uml/lumiera/128901         | 102 +++++++++++++++++++++++++++++-
 uml/lumiera/129285.diagram |   8 +++
 uml/lumiera/129925.diagram |   5 --
 uml/lumiera/130309         |   6 +-
 uml/lumiera/132868.diagram | 124 +++++++++++++++++++++++++++++++++++++
 9 files changed, 304 insertions(+), 29 deletions(-)
 delete mode 100644 uml/lumiera/129925.diagram
 create mode 100644 uml/lumiera/132868.diagram

diff --git a/uml/lumiera/128133.diagram b/uml/lumiera/128133.diagram
index 1fbd686ec..284608c18 100644
--- a/uml/lumiera/128133.diagram
+++ b/uml/lumiera/128133.diagram
@@ -173,7 +173,7 @@ relationcanvas 135685 relation_ref 130949 // <generalisation>
   no_multiplicity_a no_multiplicity_b
 relationcanvas 135941 relation_ref 131077 // <directional aggregation by value>
   from ref 128261 z 1999 stereotype "<<list>>" xyz 371 893 3000 to ref 135813
-  role_a_pos 365 849 3000 no_role_b
+  role_a_pos 374 844 3000 no_role_b
   multiplicity_a_pos 451 877 3000 no_multiplicity_b
 relationcanvas 136069 relation_ref 131205 // <unidirectional association>
   from ref 135813 z 1999 to point 433 897
diff --git a/uml/lumiera/128261 b/uml/lumiera/128261
index 0d01de253..d583563a8 100644
--- a/uml/lumiera/128261
+++ b/uml/lumiera/128261
@@ -1,6 +1,6 @@
 format 40
 "MObject" // ProcessingLayer::MObject
-  revision 33
+  revision 34
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
@@ -436,6 +436,49 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	  b multiplicity "" parent class_ref 128389 // Track
 	  association_type class_ref 128645 // Placement
       end
+
+      classrelation 163077 // <association>
+	relation_ref 158085 // <association>
+      end
+
+      classrelation 163333 // <association>
+	relation_ref 158213 // <association>
+      end
+    end
+
+    class 146565 "Segmentation"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 162821 // <directional aggregation by value>
+	relation 157957 *-->
+	  stereotype "list"
+	  a role_name "" multiplicity "1..*" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	    classrelation_ref 162821 // <directional aggregation by value>
+	  b multiplicity "" parent class_ref 135173 // Segment
+      end
+
+      classrelation 163205 // <association>
+	relation 158213 ----
+	  stereotype "partitioning"
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 163205 // <association>
+	  b role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 163333 // <association>
+      end
     end
 
     class 135173 "Segment"
@@ -476,6 +519,16 @@ ${inlines}
 	    classrelation_ref 138885 // elements (<directional aggregation>)
 	  b multiplicity "" parent class_ref 129797 // ExplicitPlacement
       end
+
+      classrelation 163589 // <unidirectional association>
+	relation 158469 --->
+	  stereotype "correspondance"
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 163589 // <unidirectional association>
+	  b multiplicity "" parent class_ref 131461 // RenderGraph
+      end
     end
 
     class 128389 "Track"
diff --git a/uml/lumiera/128389 b/uml/lumiera/128389
index 05bf51f89..49db4297c 100644
--- a/uml/lumiera/128389
+++ b/uml/lumiera/128389
@@ -1,6 +1,6 @@
 format 40
 "RenderEngine" // ProcessingLayer::RenderEngine
-  revision 17
+  revision 18
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
@@ -126,7 +126,7 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
 "
 	    classrelation_ref 132485 // renderSegments (<directional aggregation by value>)
-	  b multiplicity "1" parent class_ref 131461 // Processor
+	  b multiplicity "1" parent class_ref 131461 // RenderGraph
       end
 
       classrelation 136197 // <generalisation>
@@ -134,11 +134,11 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 136197 // <generalisation>
-	  b multiplicity "" parent class_ref 131461 // Processor
+	  b multiplicity "" parent class_ref 131461 // RenderGraph
       end
     end
 
-    class 131461 "Processor"
+    class 131461 "RenderGraph"
       visibility package 
       cpp_decl "${comment}${template}class ${name}${inherit}
   {
@@ -149,13 +149,13 @@ ${inlines}
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 132613 // output (<unidirectional association>)
+      classrelation 132613 // pipes (<unidirectional association>)
 	relation 131973 --->
-	  stereotype "has_a"
-	  a role_name "output" multiplicity "1" protected
+	  stereotype "list"
+	  a role_name "pipes" multiplicity "1..*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} * ${name}${value};
 "
-	    classrelation_ref 132613 // output (<unidirectional association>)
+	    classrelation_ref 132613 // pipes (<unidirectional association>)
 	  b multiplicity "" parent class_ref 131589 // ExitNode
       end
 
@@ -533,7 +533,6 @@ ${inlines}
 	    classrelation_ref 152453 // <generalisation>
 	  b multiplicity "" parent class_ref 132741 // State
       end
-
     end
 
     class 142597 "StateAdapter"
diff --git a/uml/lumiera/128389.diagram b/uml/lumiera/128389.diagram
index da7bca1cb..94ca2c897 100644
--- a/uml/lumiera/128389.diagram
+++ b/uml/lumiera/128389.diagram
@@ -4,9 +4,9 @@ classcanvas 128005 class_ref 131333 // RenderEngine
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
   xyz 175 325 2000
   end
-classcanvas 128133 class_ref 131461 // Processor
+classcanvas 128133 class_ref 131461 // RenderGraph
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 276 165 2000
+  xyz 267 165 2000
   end
 classcanvas 128389 class_ref 131589 // ExitNode
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
@@ -69,12 +69,12 @@ textcanvas 140037 "the 
 relationcanvas 128261 relation_ref 131845 // <directional aggregation by value>
   from ref 128005 z 1999 stereotype "<<list>>" xyz 178 278 3000 to point 216 200
   line 137733 z 1999 to ref 128133
-  role_a_pos 184 178 3000 no_role_b
-  multiplicity_a_pos 249 211 3000 multiplicity_b_pos 202 300 3000
+  role_a_pos 175 178 3000 no_role_b
+  multiplicity_a_pos 240 211 3000 multiplicity_b_pos 202 300 3000
 relationcanvas 128901 relation_ref 131973 // <unidirectional association>
-  from ref 128133 z 1999 stereotype "<<has_a>>" xyz 354 342 3000 to ref 128389
-  role_a_pos 440 419 3000 no_role_b
-  multiplicity_a_pos 414 419 3000 no_multiplicity_b
+  from ref 128133 z 1999 stereotype "<<list>>" xyz 362 375 3000 to ref 128389
+  role_a_pos 377 393 3000 no_role_b
+  multiplicity_a_pos 404 419 3000 no_multiplicity_b
 relationcanvas 129925 relation_ref 132101 // <generalisation>
   geometry VHV
   from ref 128389 z 1999 to point 445 397
diff --git a/uml/lumiera/128901 b/uml/lumiera/128901
index 9a2bf5b90..c6bc6940d 100644
--- a/uml/lumiera/128901
+++ b/uml/lumiera/128901
@@ -1,6 +1,6 @@
 format 40
 "Builder" // ProcessingLayer::MObject::Builder
-  revision 17
+  revision 18
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
@@ -171,7 +171,7 @@ format 40
       end
     end
 
-    classdiagram 129285 "Builder Entities"
+    classdiagram 129285 "Builder Tool (Visitor)"
       draw_all_relations default hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_parameter_dir no show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
       size A4
     end
@@ -205,6 +205,15 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	
 	comment "Main Operation of the Builder: create a render engine for a given part of the timeline"
       end
+
+      classrelation 162565 // <unidirectional association>
+	relation 157701 --->
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162565 // <unidirectional association>
+	  b multiplicity "" parent class_ref 131077 // Assembler
+      end
     end
 
     class 130693 "ToolFactory"
@@ -240,6 +249,52 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	    classrelation_ref 137221 // <dependency>
 	  b multiplicity "" parent class_ref 134149 // BuilderTool
       end
+
+      classrelation 161797 // <unidirectional association>
+	relation 157189 --->
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 161797 // <unidirectional association>
+	  b multiplicity "" parent class_ref 134277 // SegmentationTool
+      end
+
+      classrelation 161925 // <unidirectional association>
+	relation 157317 --->
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 161925 // <unidirectional association>
+	  b multiplicity "" parent class_ref 134405 // NodeCreatorTool
+      end
+
+      classrelation 162053 // <association>
+	relation 157445 ----
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162053 // <association>
+	  b role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162181 // <association>
+      end
+
+      classrelation 162437 // <association>
+	relation_ref 157573 // <association>
+      end
+
+      classrelation 162949 // <association>
+	relation 158085 ----
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162949 // <association>
+	  b role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 163077 // <association>
+      end
     end
 
     class 130821 "ConManager"
@@ -269,6 +324,10 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	
 	comment "TODO"
       end
+
+      classrelation 162181 // <association>
+	relation_ref 157445 // <association>
+      end
     end
 
     class 131077 "Assembler"
@@ -297,6 +356,18 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	
 	
       end
+
+      classrelation 162309 // <association>
+	relation 157573 ----
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162309 // <association>
+	  b role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162437 // <association>
+      end
     end
 
     class 132741 "State"
@@ -553,6 +624,16 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 	    classrelation_ref 146821 // <generalisation>
 	  b multiplicity "" parent class_ref 140293 // Applicable
       end
+
+      classrelation 163461 // <unidirectional association>
+	relation 158341 --->
+	  stereotype "create"
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 163461 // <unidirectional association>
+	  b multiplicity "" parent class_ref 146565 // Segmentation
+      end
     end
 
     class 134405 "NodeCreatorTool"
@@ -643,7 +724,7 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
       end
 
       attribute 129797 "proc"
-	protected type class_ref 131461 // Processor
+	protected type class_ref 131461 // RenderGraph
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
@@ -658,6 +739,21 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 	    classrelation_ref 146949 // <generalisation>
 	  b multiplicity "" parent class_ref 140293 // Applicable
       end
+
+      classrelation 162693 // <unidirectional association>
+	relation 157829 --->
+	  stereotype "create"
+	  a role_name "" multiplicity "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 162693 // <unidirectional association>
+	  b multiplicity "" parent class_ref 131461 // RenderGraph
+      end
+    end
+
+    classdiagram 132868 "Builder Entities"
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      size A4
     end
   end
 end
diff --git a/uml/lumiera/129285.diagram b/uml/lumiera/129285.diagram
index 0dbfb65e7..90c337f61 100644
--- a/uml/lumiera/129285.diagram
+++ b/uml/lumiera/129285.diagram
@@ -141,6 +141,14 @@ relationcanvas 136709 relation_ref 144773 // <generalisation>
   line 136837 z 2003 to ref 135557
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+relationcanvas 137989 relation_ref 157189 // <unidirectional association>
+  from ref 128645 z 1999 to ref 130565
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 138117 relation_ref 157317 // <unidirectional association>
+  from ref 128645 z 1999 to ref 130949
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
 line 131461 -_-_
   from ref 130565 z 1999 to point 302 530
   line 132101 z 1999 to point 265 528
diff --git a/uml/lumiera/129925.diagram b/uml/lumiera/129925.diagram
deleted file mode 100644
index 357ca1d90..000000000
--- a/uml/lumiera/129925.diagram
+++ /dev/null
@@ -1,5 +0,0 @@
-format 38
-
-artifactcanvas 128005 artifact_ref 128261 // mobject
-  xyz 123 127 2000
-end
diff --git a/uml/lumiera/130309 b/uml/lumiera/130309
index e89c34727..90b1618b3 100644
--- a/uml/lumiera/130309
+++ b/uml/lumiera/130309
@@ -1,6 +1,6 @@
 format 40
 "engine" // design::codegen::proc::engine
-  revision 9
+  revision 10
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
@@ -77,7 +77,7 @@ ${namespace_end}"
       comment "a complete network of processing nodes usable for rendering"
     end
 
-    artifact 132101 "processor"
+    artifact 132101 "rendergraph"
       stereotype "source"
       cpp_h "/*
   ${NAME}.hpp  -  ${description}
@@ -111,7 +111,7 @@ ${namespace_start}
 ${members}
 ${namespace_end}"
       associated_classes
-	class_ref 131461 // Processor
+	class_ref 131461 // RenderGraph
       end
       comment "a single render pipeline for one segment of the timeline"
     end
diff --git a/uml/lumiera/132868.diagram b/uml/lumiera/132868.diagram
new file mode 100644
index 000000000..448280cfa
--- /dev/null
+++ b/uml/lumiera/132868.diagram
@@ -0,0 +1,124 @@
+format 40
+
+classcanvas 128005 class_ref 131333 // RenderEngine
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 61 564 2000
+  end
+classcanvas 128133 class_ref 131461 // RenderGraph
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 220 458 2004
+  end
+classcanvas 128517 class_ref 131589 // ExitNode
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 382 586 3005
+  end
+classcanvas 128773 class_ref 145541 // Timeline
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 88 47 2000
+  end
+classcanvas 128901 class_ref 128261 // Fixture
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 56 148 2000
+  end
+classcanvas 129029 class_ref 135173 // Segment
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 218 304 2000
+  end
+classcanvas 129157 class_ref 146565 // Segmentation
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 74 266 2000
+  end
+classcanvas 129541 class_ref 130693 // ToolFactory
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 561 157 2000
+  end
+classcanvas 129669 class_ref 131077 // Assembler
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 444 94 2000
+  end
+classcanvas 129797 class_ref 134277 // SegmentationTool
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 481 293 2004
+  end
+classcanvas 130053 class_ref 134405 // NodeCreatorTool
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 596 324 2000
+  end
+classcanvas 130181 class_ref 130821 // ConManager
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 670 536 2000
+  end
+classcanvas 130309 class_ref 130565 // BuilderFacade
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  xyz 576 51 2000
+  end
+textcanvas 132101 "for each Timeline (top level)"
+  xyzwh 124 96 2000 136 18
+relationcanvas 128261 relation_ref 131845 // <directional aggregation by value>
+  from ref 128005 z 1999 stereotype "<<list>>" xyz 84 529 3000 to point 100 494
+  line 129285 z 1999 to ref 128133
+  role_a_pos 128 472 3000 no_role_b
+  multiplicity_a_pos 193 505 3000 multiplicity_b_pos 87 539 3000
+relationcanvas 128389 relation_ref 134789 // <generalisation>
+  geometry HV
+  from ref 128005 z 1999 to point 259 590
+  line 129413 z 1999 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 128645 relation_ref 131973 // <unidirectional association>
+  from ref 128133 z 1999 stereotype "<<list>>" xyz 324 555 3000 to ref 128517
+  role_a_pos 330 574 3000 no_role_b
+  multiplicity_a_pos 342 593 3000 no_multiplicity_b
+relationcanvas 129925 relation_ref 137221 // <directional aggregation by value>
+  from ref 129797 z 1999 stereotype "<<list>>" xyz 359 341 3000 to ref 129029
+  role_a_pos 286 317 3000 no_role_b
+  multiplicity_a_pos 286 350 3000 no_multiplicity_b
+relationcanvas 130437 relation_ref 157189 // <unidirectional association>
+  from ref 129541 z 1999 to ref 129797
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 130565 relation_ref 157317 // <unidirectional association>
+  from ref 129541 z 1999 to ref 130053
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 130821 relation_ref 157445 // <association>
+  from ref 129541 z 1999 to point 712 254
+  line 130949 z 1999 to ref 130181
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 131077 relation_ref 157573 // <association>
+  from ref 129669 z 1999 to ref 129541
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 131205 relation_ref 157701 // <unidirectional association>
+  from ref 130309 z 1999 to ref 129669
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 131589 relation_ref 157829 // <unidirectional association>
+  from ref 130053 z 1999 stereotype "<<create>>" xyz 419 446 3000 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 131717 relation_ref 157957 // <directional aggregation by value>
+  from ref 129157 z 1999 stereotype "<<list>>" xyz 158 317 3000 to ref 129029
+  no_role_a no_role_b
+  multiplicity_a_pos 191 341 3000 no_multiplicity_b
+relationcanvas 131845 relation_ref 158085 // <association>
+  from ref 129541 z 1999 to ref 128901
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 132229 relation_ref 158213 // <association>
+  from ref 129157 z 1999 stereotype "<<partitioning>>" xyz 113 233 3000 to ref 128901
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 132485 relation_ref 158341 // <unidirectional association>
+  from ref 129797 z 1999 stereotype "<<create>>" xyz 373 274 3000 to point 357 284
+  line 132613 z 1999 to ref 129157
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+relationcanvas 132741 relation_ref 158469 // <unidirectional association>
+  from ref 129029 z 1999 stereotype "<<correspondance>>" xyz 201 411 3000 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+line 131973 -_-_
+  from ref 128773 z 1999 to ref 128901
+end

From 6cf2e6cfb9b232659fc1e0988371cf189575e859 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 19:43:11 +0200
Subject: [PATCH 089/368] UML: adapted to *BOUML-4.4.2* (Debian/Lenny)

checked and cleaned up all diagrams, removed some outdated information
---
 uml/lumiera/128005              |  93 +++++----
 uml/lumiera/128005.diagram      |  48 +++--
 uml/lumiera/128133              | 171 ++++++++++++-----
 uml/lumiera/128133.diagram      | 317 +++++++++++++++++--------------
 uml/lumiera/128261              | 323 +++++++++++++++++++++-----------
 uml/lumiera/128261.diagram      |  66 +++++--
 uml/lumiera/128389              | 256 ++++++++++++++++---------
 uml/lumiera/128389.diagram      | 177 ++++++++---------
 uml/lumiera/128517              | 288 ++++++++++++++++++----------
 uml/lumiera/128773.diagram      |  33 ++--
 uml/lumiera/128901              | 206 +++++++++-----------
 uml/lumiera/128901.diagram      |  77 ++++----
 uml/lumiera/129029.diagram      |  81 ++++----
 uml/lumiera/129157.diagram      |  98 +++++-----
 uml/lumiera/129285              |  64 ++++---
 uml/lumiera/129285.diagram      | 149 ++++++++-------
 uml/lumiera/129413.diagram      |  71 +++----
 uml/lumiera/129669.diagram      |  80 ++++----
 uml/lumiera/130053.diagram      | 120 ++++++------
 uml/lumiera/130309.diagram      | 192 +++++++++++--------
 uml/lumiera/130437.diagram      | 242 ++++++++++++------------
 uml/lumiera/131077              | 221 ++++++++++++++--------
 uml/lumiera/131077.diagram      |  70 ++++---
 uml/lumiera/131205.diagram      |  61 +++---
 uml/lumiera/131333.diagram      |  29 +--
 uml/lumiera/131461.diagram      | 166 ++++++++--------
 uml/lumiera/131717.diagram      |  19 +-
 uml/lumiera/131845.diagram      |  29 +--
 uml/lumiera/131973.diagram      |  82 ++++----
 uml/lumiera/132229.diagram      |  97 +++++-----
 uml/lumiera/132357.diagram      | 139 ++++++++------
 uml/lumiera/132741.diagram      | 121 +++++++-----
 uml/lumiera/132869.diagram      | 122 ++++++------
 uml/lumiera/5.session           |  48 +----
 uml/lumiera/generation_settings | 132 ++++++++++---
 uml/lumiera/lumiera.prj         |  22 +--
 uml/lumiera/python_imports      |   1 +
 uml/lumiera/stereotypes         |   4 +-
 38 files changed, 2631 insertions(+), 1884 deletions(-)
 create mode 100644 uml/lumiera/python_imports

diff --git a/uml/lumiera/128005 b/uml/lumiera/128005
index d3970e39a..b7df2ba56 100644
--- a/uml/lumiera/128005
+++ b/uml/lumiera/128005
@@ -1,41 +1,41 @@
-format 40
+format 58
 "design" // design
-  revision 13
+  revision 15
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   comment "All things concering the big picture.
 Not a real code package, rather a container for design drafts, specifications, decisions."
   componentview 128005 "Architecture"
     //component diagram settings
     package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-    draw_component_as_icon default show_component_req_prov default show_component_rea default
+    draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
     comment "The various Components comprising the Lumiera Video editing Application"
     componentdiagram 128005 "Overview"
       package_name_in_tab default show_context default auto_label_position default draw_all_relations no shadow default
-      draw_component_as_icon default show_component_req_prov default show_component_rea default
+      draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
       comment "This drawing shows the top level compoents and relations"
       size A4
     end
@@ -153,23 +153,22 @@ Not a real code package, rather a container for design drafts, specifications, d
 
   classview 129413 "Project Entities"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 132741 "TimelineSequences"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -181,31 +180,33 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 158981 // <aggregation by value>
+      classrelation 158981 // <composition>
 	relation 154885 *---
 	  a role_name "" multiplicity "1..*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 158981 // <aggregation by value>
+	    classrelation_ref 158981 // <composition>
 	  b role_name "" multiplicity "1" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 159109 // <aggregation by value>
+	    classrelation_ref 159109 // <composition>
       end
 
-      classrelation 159365 // <aggregation by value>
+      classrelation 159365 // <composition>
 	relation 155141 *---
 	  a role_name "" multiplicity "1..*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 159365 // <aggregation by value>
+	    classrelation_ref 159365 // <composition>
 	  b role_name "" multiplicity "1" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 159493 // <aggregation by value>
+	    classrelation_ref 159493 // <composition>
       end
     end
 
@@ -217,6 +218,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -227,7 +230,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160389 // <unidirectional association>
-	  b multiplicity "" parent class_ref 146437 // PlayheadCursor
+	  b parent class_ref 146437 // PlayheadCursor
       end
     end
 
@@ -239,6 +242,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -249,16 +254,16 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160133 // <unidirectional association>
-	  b multiplicity "" parent class_ref 145541 // Timeline
+	  b parent class_ref 145541 // Timeline
       end
 
       classrelation 160517 // <association>
 	relation 156165 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160517 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160645 // <association>
@@ -273,16 +278,18 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       classrelation 160261 // <unidirectional association>
 	relation 155909 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160261 // <unidirectional association>
-	  b multiplicity "" parent class_ref 145541 // Timeline
+	  b parent class_ref 145541 // Timeline
       end
     end
 
@@ -294,11 +301,13 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 159493 // <aggregation by value>
-	relation_ref 155141 // <aggregation by value>
+      classrelation 159493 // <composition>
+	relation_ref 155141 // <composition>
       end
 
       classrelation 159877 // subSequences (<unidirectional association>)
@@ -313,11 +322,11 @@ ${inlines}
 
       classrelation 161541 // <unidirectional association>
 	relation 156933 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 161541 // <unidirectional association>
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
 
       classrelation 161669 // trackTree (<unidirectional association>)
@@ -326,7 +335,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 161669 // trackTree (<unidirectional association>)
-	  b multiplicity "" parent class_ref 128389 // Track
+	  b parent class_ref 128389 // Track
       end
     end
 
@@ -338,6 +347,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -354,10 +365,10 @@ ${inlines}
   componentview 128133 "interfaces"
     //component diagram settings
     package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-    draw_component_as_icon default show_component_req_prov default show_component_rea default
+    draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
     componentdiagram 130053 "proc-components"
       package_name_in_tab default show_context default auto_label_position default draw_all_relations no shadow default
-      draw_component_as_icon default show_component_req_prov default show_component_rea default
+      draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
       size A3
     end
 
@@ -380,7 +391,7 @@ ${inlines}
 
     componentdiagram 130693 "backend-components"
       package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-      draw_component_as_icon default show_component_req_prov default show_component_rea default
+      draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
       size A4
     end
 
diff --git a/uml/lumiera/128005.diagram b/uml/lumiera/128005.diagram
index 26b59ec1a..7ef27409d 100644
--- a/uml/lumiera/128005.diagram
+++ b/uml/lumiera/128005.diagram
@@ -1,4 +1,4 @@
-format 40
+format 58
 
 fragment 128005 "UI Layer"
   xyzwh 322 22 1994 828 100
@@ -13,44 +13,57 @@ end
 packagecanvas 128389 
   package_ref 128133 // Asset
     xyzwh 561 201 2005 265 241
+end
 packagecanvas 128517 
   package_ref 128261 // MObject
     xyzwh 94 201 2006 458 335
+end
 packagecanvas 128645 
   package_ref 128389 // RenderEngine
     xyzwh 94 551 2005 458 235
+end
 componentcanvas 128773 component_ref 128005 // Builder
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 122 419 2015 228 105
+end
 componentcanvas 128901 component_ref 128133 // Session
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 122 243 2011 322 155
+end
 componentcanvas 129029 component_ref 128261 // Controller
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 373 419 2011 188 105
+end
 componentcanvas 129157 component_ref 128389 // EDL
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 288 303 2016 152 78
+end
 componentcanvas 129285 component_ref 128517 // Fixture
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 125 319 2016 152 75
+end
 note 129541 "Structures edited by the User"
   xyzwh 43 269 2016 181 41
 componentcanvas 129669 component_ref 128645 // AssetManagement
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 578 233 2010 216 200
+end
 componentcanvas 129797 component_ref 128773 // Dispatcher
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 357 133 2005 192 75
+end
 componentcanvas 129925 component_ref 128901 // Engine
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 118 601 2010 235 175
+end
 componentcanvas 130053 component_ref 129029 // Frame (Stream) Provider
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 122 875 2005 228 75
+end
 componentcanvas 130181 component_ref 129157 // Cache
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 392 875 2005 192 75
+end
 note 131717 "Coordinates Building and Rendering"
   xyzwh 483 494 2016 149 63
 note 131845 "border of the low-level, performance-critical part of the system"
@@ -60,22 +73,27 @@ note 131973 "just works, never decides"
 note 132101 "codecs, effects, stream I/O here"
   xyzwh 618 876 2005 200 36
 componentcanvas 132229 component_ref 130181 // MediaFactory
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 593 355 2015 157 66
+end
 componentcanvas 132357 component_ref 130309 // AssetDB
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 629 289 2020 155 63
+end
 componentcanvas 132485 component_ref 131077 // client code
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 600 27 2005 156 63
+end
 arrowjunctioncanvas 132997 class_ref 141957 // ProcDispatcher
   xyz 473 83 2000 label_xy 441 100
 arrowjunctioncanvas 133253 class_ref 141957 // ProcDispatcher
   xyz 475 71 2000 label_xy 863 37
 simplerelationcanvas 131205 simplerelation_ref 128005
   from ref 130053 z 2004 to ref 130181
+end
 simplerelationcanvas 131333 simplerelation_ref 128133
   from ref 129925 z 2004 to ref 130053
+end
 line 133125 ---O
   from ref 129797 z 1999 to ref 132997
 line 133381 ---( geometry VHr
@@ -88,5 +106,5 @@ line 130821 -_-_ geometry HVr
   line 130949 z 2004 to ref 129029
 line 131077 -_-_
   from ref 129797 z 2004 to ref 129669
-preferred_whz 852 640 0.8
+preferred_whz 0 0 0.8
 end
diff --git a/uml/lumiera/128133 b/uml/lumiera/128133
index badc25cfd..345e6551d 100644
--- a/uml/lumiera/128133
+++ b/uml/lumiera/128133
@@ -1,65 +1,64 @@
-format 40
+format 58
 "Asset" // ProcessingLayer::Asset
-  revision 18
+  revision 19
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   classview 128901 "Assets"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 130309 "Asset Kinds"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     classdiagram 130437 "Media-Asset Relations"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     classdiagram 131077 "Proc-Asset Relations"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     classdiagram 131205 "Struct-Asset Relations"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -73,6 +72,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -85,6 +86,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "Asset primary key."
       end
@@ -94,6 +97,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "element ID, comprehensible but sanitized. The tuple (category, name, org) is unique."
       end
@@ -115,6 +120,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "origin or authorship id. Can be a project abbreviation, a package id or just the authors nickname or UID. This allows for the compnent name to be more generic (e.g. \"blur\"). Default for all assets provided by the core Lumiera codebase is \"lumi\"."
       end
@@ -125,6 +132,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "version number of the thing or concept represented by this asset. Of each unique tuple (name, category, org) there will be only one version in the whole system. Version 0 is reserved for internal purposes. Versions are considered to be ordered, and any higher version is supposed to be fully backwards compatible to all previous versions."
       end
@@ -134,6 +143,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "additional classification, selections or departments this asset belongs to. Groups are optional, non-exclusive and may be overlapping."
       end
@@ -143,6 +154,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "user visible Name-ID. To be localized."
       end
@@ -152,6 +165,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "user visible qualification of the thing, unit or concept represented by this asset. perferably \"in one line\". To be localized."
       end
@@ -169,6 +184,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "List of entities this asset depends on or requires to be functional. May be empty. The head of this list can be considered the primary prerequisite"
       end
 
@@ -185,6 +202,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "All the other assets requiring this asset to be functional. For example, all the clips depending on a given media file. May be empty. The dependency relation is transitive."
       end
 
@@ -201,6 +220,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "weather this asset is swithced on and consequently included in the fixture and participates in rendering"
       end
 
@@ -220,6 +241,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "change the enabled status of this asset. Note the corresponding #isActive predicate may depend on the enablement status of parent assets as well"
       end
     end
@@ -232,6 +255,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -252,6 +277,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 132485 "getAsset"
@@ -272,6 +299,8 @@ ${class}::${name} ${(}${t0} & ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "find and return corresponging object"
       end
 
@@ -289,6 +318,8 @@ ${class}::${name} ${(}${t0} ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "@return true if the given id is registered in the internal asset DB"
       end
 
@@ -309,6 +340,8 @@ ${class}::${name} ${(}${t0} ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "remove the given asset <i>together with all its dependants</i> from the internal DB"
       end
 
@@ -331,6 +364,8 @@ ${class}::${name} ${(}${t0} & ${p0}, ${t1} & ${p1}, ${t2} & ${p2}, ${t3}& ${p3}$
 "
 	
 	
+	
+	
 	comment "registers an asset object in the internal DB, providing its unique key"
       end
 
@@ -353,6 +388,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -362,7 +399,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139909 // <realization>
-	  b multiplicity "" parent class_ref 136453 // Asset
+	  b parent class_ref 136453 // Asset
       end
 
       operation 133253 "createClip"
@@ -378,6 +415,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "create a (possibly compound) Clip refering to this media, ready to be added to the EDL."
       end
 
@@ -394,6 +433,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "@return descriptor how to build a render pipeline corresponding to this media"
       end
 
@@ -402,7 +443,7 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 143237 // <dependency>
-	  b multiplicity "" parent class_ref 138757 // ProcPatt
+	  b parent class_ref 138757 // ProcPatt
       end
     end
 
@@ -414,6 +455,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -435,7 +478,7 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 144261 // <dependency>
-	  b multiplicity "" parent class_ref 139525 // MediaAccessFacade
+	  b parent class_ref 139525 // MediaAccessFacade
       end
     end
 
@@ -447,6 +490,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -457,7 +502,7 @@ e.g. the individual media streams found in one media file"
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 142213 // <generalisation>
-	  b multiplicity "" parent class_ref 136709 // Media
+	  b parent class_ref 136709 // Media
       end
 
       classrelation 142341 // tracks (<directional aggregation>)
@@ -480,6 +525,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -489,7 +536,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 140037 // <realization>
-	  b multiplicity "" parent class_ref 136453 // Asset
+	  b parent class_ref 136453 // Asset
       end
     end
 
@@ -501,6 +548,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -510,7 +559,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 140165 // <realization>
-	  b multiplicity "" parent class_ref 136453 // Asset
+	  b parent class_ref 136453 // Asset
       end
     end
 
@@ -522,6 +571,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -531,7 +582,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 140293 // <realization>
-	  b multiplicity "" parent class_ref 136453 // Asset
+	  b parent class_ref 136453 // Asset
       end
     end
 
@@ -543,6 +594,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -557,6 +610,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -566,7 +621,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 140549 // <generalisation>
-	  b multiplicity "" parent class_ref 136709 // Media
+	  b parent class_ref 136709 // Media
       end
 
       classrelation 141957 // source (<unidirectional association>)
@@ -589,6 +644,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -598,7 +655,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146181 // <generalisation>
-	  b multiplicity "" parent class_ref 136709 // Media
+	  b parent class_ref 136709 // Media
       end
     end
 
@@ -610,6 +667,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -619,7 +678,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146309 // <generalisation>
-	  b multiplicity "" parent class_ref 137477 // Unknown
+	  b parent class_ref 137477 // Unknown
       end
     end
 
@@ -631,6 +690,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -640,7 +701,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 141061 // <generalisation>
-	  b multiplicity "" parent class_ref 136837 // Proc
+	  b parent class_ref 136837 // Proc
       end
     end
 
@@ -652,6 +713,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -661,7 +724,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 141189 // <generalisation>
-	  b multiplicity "" parent class_ref 136837 // Proc
+	  b parent class_ref 136837 // Proc
       end
     end
 
@@ -673,6 +736,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -682,7 +747,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 141317 // <generalisation>
-	  b multiplicity "" parent class_ref 136965 // Struct
+	  b parent class_ref 136965 // Struct
       end
     end
 
@@ -694,6 +759,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -703,7 +770,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 141445 // <generalisation>
-	  b multiplicity "" parent class_ref 136965 // Struct
+	  b parent class_ref 136965 // Struct
       end
 
       classrelation 148101 // <dependency>
@@ -711,7 +778,7 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 148101 // <dependency>
-	  b multiplicity "" parent class_ref 138757 // ProcPatt
+	  b parent class_ref 138757 // ProcPatt
       end
 
       classrelation 148229 // wiringTemplate (<unidirectional association>)
@@ -720,7 +787,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 148229 // wiringTemplate (<unidirectional association>)
-	  b multiplicity "" parent class_ref 138757 // ProcPatt
+	  b parent class_ref 138757 // ProcPatt
       end
     end
 
@@ -732,6 +799,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -741,16 +810,16 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 143109 // <generalisation>
-	  b multiplicity "" parent class_ref 136965 // Struct
+	  b parent class_ref 136965 // Struct
       end
 
-      classrelation 143621 // instructions (<directional aggregation by value>)
+      classrelation 143621 // instructions (<directional composition>)
 	relation 141701 *-->
 	  stereotype "vector"
 	  a role_name "instructions" multiplicity "1..*" const_relation protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
 "
-	    classrelation_ref 143621 // instructions (<directional aggregation by value>)
+	    classrelation_ref 143621 // instructions (<directional composition>)
 	  b multiplicity "1" parent class_ref 139013 // BuildInstruct
       end
     end
@@ -763,6 +832,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -772,7 +843,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 141573 // <generalisation>
-	  b multiplicity "" parent class_ref 137093 // Meta
+	  b parent class_ref 137093 // Meta
       end
     end
 
@@ -784,6 +855,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -798,6 +871,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -812,6 +887,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -820,7 +897,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 143749 // <generalisation>
-	  b multiplicity "" parent class_ref 139013 // BuildInstruct
+	  b parent class_ref 139013 // BuildInstruct
       end
 
       classrelation 144133 // nodes (<directional aggregation>)
@@ -830,7 +907,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 144133 // nodes (<directional aggregation>)
-	  b multiplicity "" parent class_ref 136837 // Proc
+	  b parent class_ref 136837 // Proc
       end
 
       attribute 131461 "point"
@@ -838,6 +915,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "identifying the point where the nodes should be attached"
       end
@@ -851,6 +930,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -859,7 +940,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 143877 // <generalisation>
-	  b multiplicity "" parent class_ref 139013 // BuildInstruct
+	  b parent class_ref 139013 // BuildInstruct
       end
 
       classrelation 144005 // subPattern (<unidirectional association>)
diff --git a/uml/lumiera/128133.diagram b/uml/lumiera/128133.diagram
index 284608c18..d7efe1012 100644
--- a/uml/lumiera/128133.diagram
+++ b/uml/lumiera/128133.diagram
@@ -1,283 +1,316 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 128005 // SessionImpl
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 18 679 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 20 613 2000
+end
 classcanvas 128133 class_ref 128133 // Seq
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 231 679 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 233 613 2000
+end
 classcanvas 128261 class_ref 128261 // Fixture
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 202 895 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 204 829 2000
+end
 classcanvas 129029 class_ref 128389 // Track
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 425 679 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 427 613 2000
+end
 classcanvas 129413 class_ref 128517 // MObject
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 313 130 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 315 64 2000
+end
 classcanvas 129669 class_ref 128645 // Placement
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 634 120 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 636 55 2000
+end
 classcanvas 129925 class_ref 128389 // Track
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 357 991 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 359 925 2000
+end
 classcanvas 130949 class_ref 128773 // AbstractMO
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 317 258 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 319 192 2000
+end
 classcanvas 131461 class_ref 128901 // Clip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 279 368 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 281 302 2000
+end
 classcanvas 131717 class_ref 129029 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 332 368 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 334 302 2000
+end
 classcanvas 131973 class_ref 129157 // Meta
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 389 368 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 391 302 2000
+end
 classcanvas 132229 class_ref 129285 // FixedLocation
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 608 332 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 610 247 2005
+end
 classcanvas 132869 class_ref 129413 // RelativeLocation
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 491 332 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 493 247 2000
+end
 classcanvas 134149 class_ref 129541 // Allocation
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 568 427 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 569 342 2000
+end
 classcanvas 134405 class_ref 129669 // Label
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 457 476 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 459 410 2000
+end
 classcanvas 135429 class_ref 129797 // ExplicitPlacement
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 715 276 2004
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 724 169 2004
+end
 classcanvas 135813 class_ref 129797 // ExplicitPlacement
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 466 808 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 468 742 2000
+end
 classcanvas 136581 class_ref 129925 // Auto
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 375 466 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 377 400 2005
+end
 note 136837 "Placement \"locates\" a Media Object"
-  xyzwh 370 73 3005 207 36
+  xyzwh 393 12 3005 207 36
 textcanvas 137093 "Fixture is the actual assembly of various Media Objects ready to be performed"
-  xyzwh 28 862 2000 151 86
+  xyzwh 30 796 2000 151 86
 classcanvas 137221 class_ref 130053 // Wish
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 560 532 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 560 458 2000
+end
 classcanvas 137349 class_ref 130181 // Constraint
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 616 532 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 616 458 2000
+end
 classcanvas 138629 class_ref 135173 // Segment
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 666 731 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 668 665 2000
+end
 classcanvas 139013 class_ref 138629 // CompoundClip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 272 466 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 274 400 2000
+end
 classcanvas 139269 class_ref 139653 // Session
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 23 458 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 25 392 2000
+end
 classcanvas 139653 class_ref 139781 // SessManager
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 101 301 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 103 235 2000
+end
 classcanvas 141317 class_ref 139909 // LocatingPin
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 518 239 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 529 150 2000
+end
 classcanvas 146053 class_ref 138117 // Pipe
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 344 597 2004
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 346 523 2004
+end
 classcanvas 146437 class_ref 140421 // Plug
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 560 597 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 560 523 2000
+end
 classcanvas 146949 class_ref 145541 // Timeline
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 114 546 2000
-  end
-relationcanvas 128389 relation_ref 128005 // <directional aggregation by value>
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 116 480 2000
+end
+relationcanvas 128389 relation_ref 128005 // <directional composition>
   from ref 128005 z 1999 to ref 128133
-  role_a_pos 200 676 3000 no_role_b
-  multiplicity_a_pos 204 709 3000 no_multiplicity_b
+  role_a_pos 202 610 3000 no_role_b
+  multiplicity_a_pos 206 643 3000 no_multiplicity_b
+end
 relationcanvas 128517 relation_ref 128133 // <unidirectional association>
   from ref 128005 z 1999 to ref 128261
-  role_a_pos 230 870 3000 no_role_b
-  multiplicity_a_pos 204 870 3000 no_multiplicity_b
+  role_a_pos 232 804 3000 no_role_b
+  multiplicity_a_pos 206 804 3000 no_multiplicity_b
+end
 relationcanvas 128645 relation_ref 128261 // <generalisation>
   geometry VHr
-  from ref 128261 z 1999 to point 251 931
+  from ref 128261 z 1999 to point 253 859
   line 128901 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130821 relation_ref 128517 // <directional aggregation>
   geometry VH
-  from ref 128133 z 1999 stereotype "<<list>>" xyz 255 653 3000 to point 251 167
+  from ref 128133 z 1999 stereotype "<<list>>" xyz 257 587 3000 to point 253 95
   line 132357 z 1999 to ref 129413
-  role_a_pos 280 145 3000 no_role_b
-  multiplicity_a_pos 298 178 3000 no_multiplicity_b
+  role_a_pos 282 79 3000 no_role_b
+  multiplicity_a_pos 300 112 3000 no_multiplicity_b
+end
 relationcanvas 131077 relation_ref 129285 // <generalisation>
   geometry VHr
-  from ref 130949 z 1999 to point 350 277
+  from ref 130949 z 1999 to point 351 209
   line 131333 z 1999 to ref 129413
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131589 relation_ref 129413 // <generalisation>
   from ref 131461 z 1999 to ref 130949
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131845 relation_ref 129541 // <generalisation>
   from ref 131717 z 1999 to ref 130949
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132101 relation_ref 129669 // <generalisation>
   from ref 131973 z 1999 to ref 130949
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132997 relation_ref 129925 // <unidirectional association>
-  from ref 132869 z 1999 to point 455 329
-  line 133893 z 1999 to point 430 252
+  from ref 132869 z 1999 to point 457 263
+  line 133893 z 1999 to point 432 186
   line 144389 z 1999 to ref 129413
-  role_a_pos 417 223 3000 no_role_b
-  multiplicity_a_pos 406 208 3000 multiplicity_b_pos 474 359 3000
+  role_a_pos 419 157 3000 no_role_b
+  multiplicity_a_pos 408 142 3000 multiplicity_b_pos 476 277 3000
+end
 relationcanvas 134533 relation_ref 130309 // <generalisation>
   from ref 134405 z 1999 to ref 131973
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135685 relation_ref 130949 // <generalisation>
   geometry VHV
-  from ref 135429 z 1999 to point 766 245
-  line 141445 z 1999 to point 671 245
+  from ref 135429 z 1999 to point 772 151
+  line 141445 z 1999 to point 672 151
   line 141573 z 1999 to ref 129669
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 135941 relation_ref 131077 // <directional aggregation by value>
-  from ref 128261 z 1999 stereotype "<<list>>" xyz 371 893 3000 to ref 135813
-  role_a_pos 374 844 3000 no_role_b
-  multiplicity_a_pos 451 877 3000 no_multiplicity_b
+end
+relationcanvas 135941 relation_ref 131077 // <directional composition>
+  from ref 128261 z 1999 stereotype "<<list>>" xyz 327 814 3000 to ref 135813
+  role_a_pos 373 787 3000 no_role_b
+  multiplicity_a_pos 453 811 3000 no_multiplicity_b
+end
 relationcanvas 136069 relation_ref 131205 // <unidirectional association>
-  from ref 135813 z 1999 to point 433 897
+  from ref 135813 z 1999 to point 399 833
   line 136197 z 1999 to ref 129925
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136709 relation_ref 131333 // <generalisation>
   geometry HV
-  from ref 136581 z 1999 to point 409 501
+  from ref 136581 z 1999 to point 411 429
   line 138373 z 1999 to ref 131973
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137477 relation_ref 131461 // <generalisation>
   from ref 137221 z 1999 to ref 134149
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138245 relation_ref 131717 // <generalisation>
   from ref 137349 z 1999 to ref 134149
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138757 relation_ref 137093 // <directional aggregation>
   geometry VHr
-  from ref 138629 z 1999 stereotype "<<list>>" xyz 611 767 3000 to point 517 767
+  from ref 138629 z 1999 stereotype "<<list>>" xyz 613 701 3000 to point 516 695
   line 138885 z 1999 to ref 135813
-  role_a_pos 529 783 3000 no_role_b
-  multiplicity_a_pos 505 783 3000 no_multiplicity_b
+  role_a_pos 531 717 3000 no_role_b
+  multiplicity_a_pos 507 717 3000 no_multiplicity_b
+end
 relationcanvas 139141 relation_ref 140805 // <generalisation>
   from ref 139013 z 1999 to ref 131461
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139525 relation_ref 142725 // <realization>
-  from ref 128005 z 1999 stereotype "<<PImpl>>" xyz 56 594 3000 to ref 139269
+  from ref 128005 z 1999 stereotype "<<PImpl>>" xyz 58 528 3000 to ref 139269
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139781 relation_ref 142853 // <unidirectional association>
   geometry HV
-  from ref 139269 z 1999 to point 140 494
+  from ref 139269 z 1999 to point 140 422
   line 139909 z 1999 to ref 139653
-  role_a_pos 152 426 3000 no_role_b
-  multiplicity_a_pos 126 426 3000 no_multiplicity_b
+  role_a_pos 154 360 3000 no_role_b
+  multiplicity_a_pos 128 360 3000 no_multiplicity_b
+end
 relationcanvas 140165 relation_ref 142981 // <unidirectional association>
   from ref 129669 z 1999 to ref 129413
-  role_a_pos 413 151 3000 no_role_b
-  multiplicity_a_pos 403 151 3000 multiplicity_b_pos 589 153 3000
+  role_a_pos 401 79 3000 no_role_b
+  multiplicity_a_pos 401 102 3000 multiplicity_b_pos 609 102 3000
+end
 relationcanvas 142213 relation_ref 143237 // <unidirectional association>
   from ref 129669 z 1999 to ref 141317
-  role_a_pos 578 200 3000 no_role_b
-  multiplicity_a_pos 599 233 3000 no_multiplicity_b
+  role_a_pos 593 116 3000 no_role_b
+  multiplicity_a_pos 603 144 3000 no_multiplicity_b
+end
 relationcanvas 142981 relation_ref 143493 // <generalisation>
   geometry VHV
-  from ref 132869 z 1999 to point 539 304
-  line 143493 z 1999 to point 554 304
+  from ref 132869 z 1999 to point 538 215
+  line 143493 z 1999 to point 562 215
   line 143621 z 1999 to ref 141317
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 143109 relation_ref 143621 // <generalisation>
   geometry VHV
-  from ref 132229 z 1999 to point 650 304
-  line 143749 z 1999 to point 554 304
+  from ref 132229 z 1999 to point 648 215
+  line 143749 z 1999 to point 562 215
   line 143877 z 1999 to ref 141317
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 143237 relation_ref 143749 // <generalisation>
   geometry VHV unfixed
-  from ref 134149 z 1999 to point 599 304
-  line 144005 z 1999 to point 554 304
+  from ref 134149 z 1999 to point 597 215
+  line 144005 z 1999 to point 562 215
   line 144133 z 1999 to ref 141317
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 144517 relation_ref 143877 // <unidirectional association>
-  from ref 141317 z 1999 to point 488 239
-  line 144645 z 1999 to point 488 269
+  from ref 141317 z 1999 to point 499 150
+  line 144645 z 1999 to point 499 180
   line 144773 z 1999 to ref 141317
-  role_a_pos 492 244 3000 no_role_b
+  role_a_pos 503 161 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 144901 relation_ref 144901 // <generalisation>
-  from ref 129029 z 1999 to point 445 489
+  from ref 129029 z 1999 to point 447 423
   line 145029 z 1999 to ref 131973
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 145285 relation_ref 145029 // <directional aggregation by value>
-  from ref 129029 z 1999 stereotype "<<vector>>" xyz 389 732 3000 to point 445 749
-  line 145413 z 1999 to point 369 749
+end
+relationcanvas 145285 relation_ref 145029 // <directional composition>
+  from ref 129029 z 1999 stereotype "<<vector>>" xyz 391 666 3000 to point 447 683
+  line 145413 z 1999 to point 371 683
   line 145541 z 1999 to ref 129029
-  role_a_pos 390 750 3000 no_role_b
-  multiplicity_a_pos 410 715 3000 no_multiplicity_b
+  role_a_pos 369 622 3000 no_role_b
+  multiplicity_a_pos 412 645 3000 no_multiplicity_b
+end
 relationcanvas 145669 relation_ref 145157 // <unidirectional association>
   from ref 128133 z 1999 to ref 129029
-  role_a_pos 392 672 3000 no_role_b
+  role_a_pos 394 606 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 145925 relation_ref 145413 // <unidirectional association>
   from ref 128261 z 1999 to ref 129925
-  role_a_pos 321 978 3000 no_role_b
+  role_a_pos 321 916 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 146565 relation_ref 145669 // <generalisation>
   from ref 146437 z 1999 to ref 137221
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 146693 relation_ref 145797 // <unidirectional association>
   from ref 146437 z 1999 to ref 146053
-  role_a_pos 398 594 3000 no_role_b
+  role_a_pos 408 527 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 147077 relation_ref 155653 // <directional aggregation by value>
-  from ref 146949 z 1999 stereotype "<<list>>" xyz 191 582 3000 to ref 146053
-  role_a_pos 285 575 3000 no_role_b
-  multiplicity_a_pos 327 613 3000 multiplicity_b_pos 180 584 3000
+end
+relationcanvas 147077 relation_ref 155653 // <directional composition>
+  from ref 146949 z 1999 stereotype "<<list>>" xyz 187 493 3000 to ref 146053
+  role_a_pos 268 533 3000 no_role_b
+  multiplicity_a_pos 331 544 3000 multiplicity_b_pos 180 510 3000
+end
 end
diff --git a/uml/lumiera/128261 b/uml/lumiera/128261
index d583563a8..dc029b147 100644
--- a/uml/lumiera/128261
+++ b/uml/lumiera/128261
@@ -1,50 +1,49 @@
-format 40
+format 58
 "MObject" // ProcessingLayer::MObject
-  revision 34
+  revision 35
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   classview 128005 "Session"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 128133 "Session structure"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -56,6 +55,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -74,6 +75,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "The EDL currently in focus. In most cases, Session and EDL are almost the same, just EDL emphasizes the collection aspect. But generally (for larger editing projects) one Session can contain several EDLs, which may even be nested. At any given time, only one of these EDLs has focus and recieves the editing commands."
       end
 
@@ -90,6 +93,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "While the session can be comprised of several EDLs, 
 there is only one Fixture, which represents the actual
 configuration of all Objects to be rendered"
@@ -102,16 +107,16 @@ configuration of all Objects to be rendered"
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}& ${name}${value};
 "
 	    classrelation_ref 144773 // current (<unidirectional association>)
-	  b multiplicity "" parent class_ref 139781 // SessManager
+	  b parent class_ref 139781 // SessManager
       end
 
       classrelation 150917 // defaults (<unidirectional association>)
 	relation 148101 --->
-	  a role_name "defaults" multiplicity "" protected
+	  a role_name "defaults" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 150917 // defaults (<unidirectional association>)
-	  b multiplicity "" parent class_ref 141445 // DefaultsManager
+	  b parent class_ref 141445 // DefaultsManager
       end
     end
 
@@ -123,17 +128,19 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       comment "Implementation class for the Session interface"
-      classrelation 128005 // edls (<directional aggregation by value>)
+      classrelation 128005 // edls (<directional composition>)
 	relation 128005 *-->
 	  a role_name "edls" multiplicity "1..*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
 "
-	    classrelation_ref 128005 // edls (<directional aggregation by value>)
-	  b multiplicity "" parent class_ref 128133 // Seq
+	    classrelation_ref 128005 // edls (<directional composition>)
+	  b parent class_ref 128133 // Seq
       end
 
       classrelation 128261 // theFixture (<unidirectional association>)
@@ -142,7 +149,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} * ${name}${value};
 "
 	    classrelation_ref 128261 // theFixture (<unidirectional association>)
-	  b multiplicity "" parent class_ref 128261 // Fixture
+	  b parent class_ref 128261 // Fixture
       end
 
       classrelation 144645 // <realization>
@@ -151,7 +158,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 144645 // <realization>
-	  b multiplicity "" parent class_ref 139653 // Session
+	  b parent class_ref 139653 // Session
       end
 
       classrelation 147717 // pipes (<directional aggregation>)
@@ -162,7 +169,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 147717 // pipes (<directional aggregation>)
-	  b multiplicity "" parent class_ref 138117 // Pipe
+	  b parent class_ref 138117 // Pipe
       end
     end
 
@@ -174,6 +181,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -190,6 +199,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "clear current session contents 
 without resetting overall session config.
 Afterwards, the session will contain only one 
@@ -210,6 +221,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "reset all session config and 
 start with a pristine default session."
       end
@@ -227,6 +240,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "replace the current session by a new
 session loaded from serialized state."
       end
@@ -244,6 +259,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "create a complete, serialized representation
 of the current session config and contents.
 @todo how to serialize, prameters, return value?"
@@ -258,21 +275,23 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 159109 // <aggregation by value>
-	relation_ref 154885 // <aggregation by value>
+      classrelation 159109 // <composition>
+	relation_ref 154885 // <composition>
       end
 
       classrelation 159237 // <unidirectional association>
 	relation 155013 --->
 	  stereotype "own"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 159237 // <unidirectional association>
-	  b multiplicity "" parent class_ref 145925 // PlayControl
+	  b parent class_ref 145925 // PlayControl
       end
 
       classrelation 159621 // <unidirectional association>
@@ -281,16 +300,16 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 159621 // <unidirectional association>
-	  b multiplicity "" parent class_ref 146309 // Sequence
+	  b parent class_ref 146309 // Sequence
       end
 
-      classrelation 160005 // globalBusses (<directional aggregation by value>)
+      classrelation 160005 // globalBusses (<directional composition>)
 	relation 155653 *-->
 	  stereotype "list"
 	  a role_name "globalBusses" multiplicity "*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 160005 // globalBusses (<directional aggregation by value>)
+	    classrelation_ref 160005 // globalBusses (<directional composition>)
 	  b multiplicity "1" parent class_ref 138117 // Pipe
       end
     end
@@ -303,6 +322,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -311,25 +332,25 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 158853 // <realization>
-	  b multiplicity "" parent class_ref 145541 // Timeline
+	  b parent class_ref 145541 // Timeline
       end
 
       classrelation 159749 // <unidirectional association>
 	relation 155397 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 159749 // <unidirectional association>
-	  b multiplicity "" parent class_ref 146309 // Sequence
+	  b parent class_ref 146309 // Sequence
       end
 
       classrelation 160773 // <association>
 	relation 156293 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160773 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 160901 // <association>
@@ -344,6 +365,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -354,16 +377,16 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type} *> ${name}${value};
 "
 	    classrelation_ref 128901 // clips (<directional aggregation>)
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
 
       classrelation 147333 // track (<unidirectional association>)
 	relation 145157 --->
-	  a role_name "track" multiplicity "" protected
+	  a role_name "track" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 147333 // track (<unidirectional association>)
-	  b multiplicity "" parent class_ref 128389 // Track
+	  b parent class_ref 128389 // Track
 	  association_type class_ref 128645 // Placement
       end
     end
@@ -376,6 +399,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -384,17 +409,17 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 128517 // <generalisation>
-	  b multiplicity "" parent class_ref 128133 // Seq
+	  b parent class_ref 128133 // Seq
       end
 
-      classrelation 131717 // effectiveTimeline (<directional aggregation by value>)
+      classrelation 131717 // effectiveTimeline (<directional composition>)
 	relation 131077 *-->
 	  stereotype "list"
 	  a role_name "effectiveTimeline" multiplicity "*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 131717 // effectiveTimeline (<directional aggregation by value>)
-	  b multiplicity "" parent class_ref 129797 // ExplicitPlacement
+	    classrelation_ref 131717 // effectiveTimeline (<directional composition>)
+	  b parent class_ref 129797 // ExplicitPlacement
       end
 
       operation 128645 "getPlaylistForRender"
@@ -410,6 +435,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 129157 "getAutomation"
@@ -425,28 +452,26 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       classrelation 147589 // track (<unidirectional association>)
 	relation 145413 --->
-	  a role_name "track" multiplicity "" protected
+	  a role_name "track" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 147589 // track (<unidirectional association>)
-	  b multiplicity "" parent class_ref 128389 // Track
+	  b parent class_ref 128389 // Track
 	  association_type class_ref 128645 // Placement
       end
 
-      classrelation 163077 // <association>
-	relation_ref 158085 // <association>
-      end
-
       classrelation 163333 // <association>
 	relation_ref 158213 // <association>
       end
     end
 
-    class 146565 "Segmentation"
+    class 147333 "Segmentation"
       visibility package 
       cpp_decl "${comment}${template}class ${name}${inherit}
   {
@@ -454,27 +479,19 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 162821 // <directional aggregation by value>
-	relation 157957 *-->
-	  stereotype "list"
-	  a role_name "" multiplicity "1..*" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
-"
-	    classrelation_ref 162821 // <directional aggregation by value>
-	  b multiplicity "" parent class_ref 135173 // Segment
-      end
-
       classrelation 163205 // <association>
 	relation 158213 ----
 	  stereotype "partitioning"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 163205 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 163333 // <association>
@@ -489,6 +506,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -497,6 +516,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
       end
 
@@ -505,6 +526,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "duration (span) of this timeline segment."
       end
@@ -517,17 +540,17 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type} *> ${name}${value};
 "
 	    classrelation_ref 138885 // elements (<directional aggregation>)
-	  b multiplicity "" parent class_ref 129797 // ExplicitPlacement
+	  b parent class_ref 129797 // ExplicitPlacement
       end
 
       classrelation 163589 // <unidirectional association>
 	relation 158469 --->
 	  stereotype "correspondance"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 163589 // <unidirectional association>
-	  b multiplicity "" parent class_ref 131461 // RenderGraph
+	  b parent class_ref 131461 // RenderGraph
       end
     end
 
@@ -539,6 +562,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -548,18 +573,18 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 147077 // <generalisation>
-	  b multiplicity "" parent class_ref 129157 // Meta
+	  b parent class_ref 129157 // Meta
       end
 
-      classrelation 147205 // subTracks (<directional aggregation by value>)
+      classrelation 147205 // subTracks (<directional composition>)
 	relation 145029 *-->
 	  stereotype "vector"
 	  a role_name "subTracks" multiplicity "*" public
 	    comment "Child tracks in a tree structure"
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 147205 // subTracks (<directional aggregation by value>)
-	  b multiplicity "" parent class_ref 128389 // Track
+	    classrelation_ref 147205 // subTracks (<directional composition>)
+	  b parent class_ref 128389 // Track
 	  association_type class_ref 128645 // Placement
       end
 
@@ -568,7 +593,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 161413 // <realization>
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
     end
 
@@ -582,6 +607,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -592,6 +619,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "TODO: how to represent time intervals?"
       end
@@ -601,7 +630,7 @@ ${members}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 137093 // <generalisation>
-	  b multiplicity "" parent class_ref 134021 // Buildable
+	  b parent class_ref 134021 // Buildable
       end
     end
 
@@ -615,6 +644,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -635,6 +666,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "create an actual (explicit) placement while trying to satisfy the network of adjacent objects and placements."
       end
 
@@ -662,6 +695,8 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 "
 	
 	
+	
+	
 	comment "create and add another Placement for this media object, thus increasingly constraining the (possible) position of this object."
       end
 
@@ -672,7 +707,7 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 145413 // chain (<unidirectional association>)
-	  b multiplicity "" parent class_ref 139909 // LocatingPin
+	  b parent class_ref 139909 // LocatingPin
       end
     end
 
@@ -686,6 +721,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -696,7 +733,7 @@ ${members}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 131589 // <generalisation>
-	  b multiplicity "" parent class_ref 128645 // Placement
+	  b parent class_ref 128645 // Placement
       end
 
       attribute 128261 "time"
@@ -704,6 +741,8 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
       end
 
@@ -712,16 +751,18 @@ ${members}};
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
       end
 
       classrelation 131845 // <unidirectional association>
 	relation 131205 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 131845 // <unidirectional association>
-	  b multiplicity "" parent class_ref 128389 // Track
+	  b parent class_ref 128389 // Track
 	  association_type class_ref 128389 // Track
       end
     end
@@ -734,6 +775,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -742,7 +785,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 129925 // <generalisation>
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
     end
 
@@ -754,6 +797,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -762,7 +807,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 130053 // <generalisation>
-	  b multiplicity "" parent class_ref 128773 // AbstractMO
+	  b parent class_ref 128773 // AbstractMO
       end
 
       classrelation 142469 // source (<unidirectional association>)
@@ -780,7 +825,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 161029 // <realization>
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
     end
 
@@ -792,6 +837,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -801,7 +848,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 143365 // <generalisation>
-	  b multiplicity "" parent class_ref 128901 // Clip
+	  b parent class_ref 128901 // Clip
       end
     end
 
@@ -813,6 +860,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -824,7 +873,7 @@ e.g. the several streams found within multichannels media."
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 142597 // <generalisation>
-	  b multiplicity "" parent class_ref 128901 // Clip
+	  b parent class_ref 128901 // Clip
       end
 
       classrelation 143493 // components (<directional aggregation>)
@@ -845,6 +894,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -853,7 +904,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 130181 // <generalisation>
-	  b multiplicity "" parent class_ref 128773 // AbstractMO
+	  b parent class_ref 128773 // AbstractMO
       end
 
       attribute 128901 "plugin"
@@ -861,6 +912,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "Identifier of the Plugin to be used"
       end
@@ -870,7 +923,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 161157 // <realization>
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
     end
 
@@ -882,6 +935,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -890,7 +945,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 130309 // <generalisation>
-	  b multiplicity "" parent class_ref 128773 // AbstractMO
+	  b parent class_ref 128773 // AbstractMO
       end
     end
 
@@ -902,6 +957,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -910,7 +967,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 145797 // <generalisation>
-	  b multiplicity "" parent class_ref 139909 // LocatingPin
+	  b parent class_ref 139909 // LocatingPin
       end
     end
 
@@ -922,6 +979,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -940,6 +999,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "the kind of relation denoted by this Placement"
       end
@@ -950,6 +1011,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "Offset the actual position by this (time) value relative to the anchor point. TODO: Representation?"
       end
@@ -965,6 +1028,8 @@ ${items}
 ${items};
 ${members}}
 "
+	php_decl ""
+	python_2_2 python_decl ""
 	idl_decl "${comment}enum ${name} {
 ${items}};
 "
@@ -975,6 +1040,8 @@ ${items}};
 	  public explicit_type ""
 	  cpp_decl "  ${name}${value},	${comment}"
 	  java_decl ""
+	  php_decl ""
+	  python_decl ""
 	  idl_decl ""
 	  comment "place subject at the sime time as the anchor"
 	end
@@ -983,6 +1050,8 @@ ${items}};
 	  public explicit_type ""
 	  cpp_decl "  ${name}${value},	${comment}"
 	  java_decl ""
+	  php_decl ""
+	  python_decl ""
 	  idl_decl ""
 	  comment "attach subject to anchor (e.g. an effect to a clip)"
 	end
@@ -993,7 +1062,7 @@ ${items}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 145669 // <generalisation>
-	  b multiplicity "" parent class_ref 139909 // LocatingPin
+	  b parent class_ref 139909 // LocatingPin
       end
     end
 
@@ -1005,6 +1074,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1014,6 +1085,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	get_oper operation_ref 131205 // get_repr
 	comment "human readable representation of the condition characterizing this allocaton, e.g. \"t >= 10\""
@@ -1033,6 +1106,8 @@ ${inlines}
 	final 
 	java_name_spec "get${Name}"
 	
+	
+	
 	idl_name_spec "get_${name}"
 	get_of_attribute attribute_ref 128773 // repr
       end
@@ -1042,7 +1117,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 145925 // <generalisation>
-	  b multiplicity "" parent class_ref 139909 // LocatingPin
+	  b parent class_ref 139909 // LocatingPin
       end
     end
 
@@ -1054,6 +1129,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1062,7 +1139,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 130949 // <generalisation>
-	  b multiplicity "" parent class_ref 129157 // Meta
+	  b parent class_ref 129157 // Meta
       end
 
       classrelation 161285 // <realization>
@@ -1070,7 +1147,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 161285 // <realization>
-	  b multiplicity "" parent class_ref 128517 // MObject
+	  b parent class_ref 128517 // MObject
       end
     end
 
@@ -1088,6 +1165,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1097,7 +1176,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 131973 // <generalisation>
-	  b multiplicity "" parent class_ref 129157 // Meta
+	  b parent class_ref 129157 // Meta
       end
 
       classrelation 138501 // <realization>
@@ -1105,7 +1184,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 138501 // <realization>
-	  b multiplicity "" parent class_ref 134661 // ParamProvider
+	  b parent class_ref 134661 // ParamProvider
       end
 
       operation 131077 "getValue"
@@ -1121,6 +1200,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -1132,6 +1213,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1140,7 +1223,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 132101 // <generalisation>
-	  b multiplicity "" parent class_ref 129541 // Allocation
+	  b parent class_ref 129541 // Allocation
       end
     end
 
@@ -1152,6 +1235,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1160,7 +1245,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 132357 // <generalisation>
-	  b multiplicity "" parent class_ref 129541 // Allocation
+	  b parent class_ref 129541 // Allocation
       end
     end
 
@@ -1172,6 +1257,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1180,17 +1267,17 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 147845 // <generalisation>
-	  b multiplicity "" parent class_ref 130053 // Wish
+	  b parent class_ref 130053 // Wish
       end
 
       classrelation 147973 // outPort (<unidirectional association>)
 	relation 145797 --->
-	  a role_name "outPort" multiplicity "" protected
+	  a role_name "outPort" protected
 	    comment "the Port this MObject wants to be conected to"
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 147973 // outPort (<unidirectional association>)
-	  b multiplicity "" parent class_ref 138117 // Pipe
+	  b parent class_ref 138117 // Pipe
       end
     end
 
@@ -1205,6 +1292,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1222,6 +1311,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       classrelation 138245 // <dependency>
@@ -1230,7 +1321,7 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	  a package
 	    cpp default "#include in source"
 	    classrelation_ref 138245 // <dependency>
-	  b multiplicity "" parent class_ref 134661 // ParamProvider
+	  b parent class_ref 134661 // ParamProvider
       end
 
       classrelation 138629 // <association>
@@ -1251,6 +1342,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -1275,7 +1368,7 @@ ${members}};
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 138373 // ipo (<unidirectional association>)
-	  b multiplicity "" parent class_ref 134789 // Interpolator
+	  b parent class_ref 134789 // Interpolator
       end
 
       operation 130949 "getValue"
@@ -1291,6 +1384,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -1305,6 +1400,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1319,18 +1416,20 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       comment "An element with value semantics, which actually implements the placement of some MObject by positioning it in some way."
       classrelation 146053 // next (<unidirectional association>)
 	relation 143877 --->
-	  a role_name "next" multiplicity "" protected
+	  a role_name "next" protected
 	    comment "next additional LocatingPin, if any"
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 146053 // next (<unidirectional association>)
-	  b multiplicity "" parent class_ref 139909 // LocatingPin
+	  b parent class_ref 139909 // LocatingPin
       end
     end
 
@@ -1342,6 +1441,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -1352,15 +1453,21 @@ ${inlines}
 
   usecaseview 128261 "config examples"
     //use case diagram settings
-    package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+    package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+    //state diagram settings
+    package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+    //activity diagram settings
+    package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+    show_infonote default drawing_language default show_stereotype_properties default
     objectdiagram 131333 "multichannel clip"
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
       size A4
     end
 
diff --git a/uml/lumiera/128261.diagram b/uml/lumiera/128261.diagram
index f5e5e9956..e1509e9f1 100644
--- a/uml/lumiera/128261.diagram
+++ b/uml/lumiera/128261.diagram
@@ -1,61 +1,83 @@
-format 40
+format 58
 
 componentcanvas 128133 component_ref 128005 // Builder
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 117 113 2000 204 156
+end
 componentcanvas 128261 component_ref 128261 // Controller
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 573 100 2000 166 82
+end
 fragment 128389 "Backend Layer"
   xyzwh 89 690 2000 632 188
 end
 componentcanvas 128517 component_ref 128901 // Engine
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 95 318 2000 487 323
+end
 componentcanvas 128645 component_ref 129029 // Frame (Stream) Provider
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 254 711 2005 180 160
-deploymentnodecanvas 128901 deploymentnode_ref 128005 // timeline
+end
+deploymentnodecanvas 128901 deploymentnode_ref 128005 // effective timeline (Fixture)
   xyzwh 142 3 2000 323 90
+end
 hubcanvas 129157 xyz 192 63 2005
 hubcanvas 129285 xyz 222 63 2005
 hubcanvas 129413 xyz 255 63 2005
 hubcanvas 129541 xyz 290 63 2005
 deploymentnodecanvas 130053 deploymentnode_ref 128261 // playlist
   xyzwh 148 389 2005 401 80
-deploymentnodecanvas 130181 deploymentnode_ref 128389 // proc
+end
+deploymentnodecanvas 130181 deploymentnode_ref 128389 // graph
   xyzwh 178 433 2010 97 69
-deploymentnodecanvas 130309 deploymentnode_ref 128389 // proc
+end
+deploymentnodecanvas 130309 deploymentnode_ref 128389 // graph
   xyzwh 424 433 2010 97 69
+end
 deploymentnodecanvas 130437 deploymentnode_ref 128517 // pnode
-  xyzwh 202 507 2005 56 36
+  xyzwh 202 505 2005 56 36
+end
 deploymentnodecanvas 130565 deploymentnode_ref 128517 // pnode
-  xyzwh 202 546 2005 56 36
+  xyzwh 202 544 2005 56 36
+end
 deploymentnodecanvas 130693 deploymentnode_ref 128517 // pnode
-  xyzwh 202 585 2005 56 36
+  xyzwh 202 583 2005 56 36
+end
 deploymentnodecanvas 130821 deploymentnode_ref 128517 // pnode
   xyzwh 318 505 2005 56 36
-deploymentnodecanvas 130949 deploymentnode_ref 128389 // proc
+end
+deploymentnodecanvas 130949 deploymentnode_ref 128389 // graph
   xyzwh 294 433 2010 97 69
+end
 deploymentnodecanvas 131077 deploymentnode_ref 128517 // pnode
   xyzwh 318 544 2005 56 36
+end
 deploymentnodecanvas 131205 deploymentnode_ref 128517 // pnode
-  xyzwh 318 584 2005 56 36
+  xyzwh 318 583 2005 56 36
+end
 deploymentnodecanvas 133125 deploymentnode_ref 128645 // Frame
   xyzwh 309 800 2010 70 36
+end
 deploymentnodecanvas 134021 deploymentnode_ref 128517 // pnode
-  xyzwh 442 503 2005 56 36
+  xyzwh 442 505 2005 56 36
+end
 deploymentnodecanvas 134149 deploymentnode_ref 128517 // pnode
-  xyzwh 411 548 2005 56 36
+  xyzwh 411 544 2005 56 36
+end
 deploymentnodecanvas 134277 deploymentnode_ref 128517 // pnode
-  xyzwh 466 548 2005 56 36
+  xyzwh 466 544 2005 56 36
+end
 deploymentnodecanvas 134405 deploymentnode_ref 128517 // pnode
-  xyzwh 467 586 2005 56 36
+  xyzwh 466 583 2005 56 36
+end
 componentcanvas 135045 component_ref 129285 // RenderPathManager
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   xyzwh 505 222 2000 165 65
+end
 deploymentnodecanvas 136069 deploymentnode_ref 128773 // State
   xyzwh 703 226 2000 83 52
+end
 textcanvas 136325 "Render Engine carries out the actual processing by pulling output from the aprropriate processor "
   xyzwh 615 363 2000 135 89
 note 136453 "Input for Builder"
@@ -65,17 +87,21 @@ note 136581 "Output of Builder"
 note 136709 "optimizes"
   xyzwh 616 286 2000 75 35
 packagecanvas 136837 
-  package_ref 129029 // Controller
+  package_ref 129029 // Control
     xyzwh 486 68 1994 326 228
+end
 textcanvas 136965 "Builder is instructed by  Controller and transforms given timeline into a Render Engine, i.e.a network of processing nodes"
   xyzwh 326 196 2005 160 101
 simplerelationcanvas 128773 simplerelation_ref 128133
   from ref 128517 z 1999 to ref 128645
+end
 line 129925 ----
   from ref 129157 z 2004 to ref 129541
 line 133765 ----
   from ref 130949 z 2009 to ref 133125
-simplerelationcanvas 134533 simplerelation_ref 128261 geometry HVr
+simplerelationcanvas 134533 simplerelation_ref 128261
+  geometry HVr
   from ref 128261 z 1999 to point 653 188
   line 134789 z 1999 to ref 128133
 end
+end
diff --git a/uml/lumiera/128389 b/uml/lumiera/128389
index 49db4297c..33a85e013 100644
--- a/uml/lumiera/128389
+++ b/uml/lumiera/128389
@@ -1,48 +1,48 @@
-format 40
+format 58
 "RenderEngine" // ProcessingLayer::RenderEngine
-  revision 18
+  revision 19
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   deploymentview 128005 "Engine Parts"
     //deployment diagram settings
     package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-    draw_component_as_icon default show_component_req_prov default show_component_rea default
+    draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
     deploymentdiagram 128261 "Overview Render Engine"
       package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-      draw_component_as_icon default show_component_req_prov default show_component_rea default
+      draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
       size A4
     end
 
-    deploymentnode 128005 "timeline"
+    deploymentnode 128005 "effective timeline (Fixture)"
     end
 
     deploymentnode 128261 "playlist"
     end
 
-    deploymentnode 128389 "proc"
+    deploymentnode 128389 "graph"
     end
 
     deploymentnode 128517 "pnode"
@@ -57,38 +57,37 @@ format 40
 
   classview 128133 "Engine Workings"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 128389 "Render Entities"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     classdiagram 129669 "Automation Entities"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     classdiagram 131973 "Render Mechanics"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     classdiagram 132357 "StateAdapter composition"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -100,6 +99,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -116,16 +117,18 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "TODO: will probably be handled differently (see Cehteh)"
       end
 
-      classrelation 132485 // renderSegments (<directional aggregation by value>)
+      classrelation 132485 // renderSegments (<directional composition>)
 	relation 131845 *-->
 	  stereotype "list"
 	  a role_name "renderSegments" multiplicity "0..*" private
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
 "
-	    classrelation_ref 132485 // renderSegments (<directional aggregation by value>)
+	    classrelation_ref 132485 // renderSegments (<directional composition>)
 	  b multiplicity "1" parent class_ref 131461 // RenderGraph
       end
 
@@ -134,7 +137,7 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 136197 // <generalisation>
-	  b multiplicity "" parent class_ref 131461 // RenderGraph
+	  b parent class_ref 131461 // RenderGraph
       end
     end
 
@@ -146,6 +149,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -156,7 +161,7 @@ ${inlines}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} * ${name}${value};
 "
 	    classrelation_ref 132613 // pipes (<unidirectional association>)
-	  b multiplicity "" parent class_ref 131589 // ExitNode
+	  b parent class_ref 131589 // ExitNode
       end
 
       classrelation 136325 // <dependency>
@@ -165,7 +170,7 @@ ${inlines}
 	  a package
 	    cpp default "#include in source"
 	    classrelation_ref 136325 // <dependency>
-	  b multiplicity "" parent class_ref 132741 // State
+	  b parent class_ref 132741 // State
       end
 
       attribute 129413 "start"
@@ -173,6 +178,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "begin of the timerange covered by this processor"
       end
@@ -182,6 +189,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "end of the timerange (excl)"
       end
@@ -195,6 +204,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -204,7 +215,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 132869 // <generalisation>
-	  b multiplicity "" parent class_ref 131717 // ProcNode
+	  b parent class_ref 131717 // ProcNode
       end
     end
 
@@ -218,6 +229,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -226,7 +239,7 @@ ${members}};
       comment "Key abstraction of the Render Engine: A Data processing Node"
       classrelation 136965 // datasrc (<unidirectional association>)
 	relation 135429 --->
-	  a role_name "datasrc" multiplicity "" protected
+	  a role_name "datasrc" protected
 	    comment "The predecessor in a processing pipeline, i.e. a source to get data to be processed"
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} * ${name}${value};
 "
@@ -234,24 +247,24 @@ ${members}};
 	  b multiplicity "1" parent class_ref 131717 // ProcNode
       end
 
-      classrelation 137861 // params (<directional aggregation by value>)
+      classrelation 137861 // params (<directional composition>)
 	relation 136197 *-->
 	  stereotype "vector"
 	  a role_name "params" multiplicity "1..*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
 "
-	    classrelation_ref 137861 // params (<directional aggregation by value>)
-	  b multiplicity "" parent class_ref 134533 // Parameter
+	    classrelation_ref 137861 // params (<directional composition>)
+	  b parent class_ref 134533 // Parameter
       end
 
-      classrelation 152581 // predecessors (<directional aggregation by value>)
+      classrelation 152581 // predecessors (<directional composition>)
 	relation 149125 *-->
 	  stereotype "array"
 	  a role_name "predecessors" multiplicity "*" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 152581 // predecessors (<directional aggregation by value>)
-	  b multiplicity "" parent class_ref 142725 // WiringDescriptor
+	    classrelation_ref 152581 // predecessors (<directional composition>)
+	  b parent class_ref 142725 // WiringDescriptor
       end
 
       operation 135685 "pull"
@@ -267,6 +280,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 136069 "process"
@@ -282,6 +297,17 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
+      end
+
+      classrelation 166789 // <unidirectional association>
+	relation 159621 --->
+	  a role_name "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 166789 // <unidirectional association>
+	  b parent class_ref 142725 // WiringDescriptor
       end
     end
 
@@ -293,6 +319,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -301,7 +329,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 132997 // <generalisation>
-	  b multiplicity "" parent class_ref 131717 // ProcNode
+	  b parent class_ref 131717 // ProcNode
       end
     end
 
@@ -313,6 +341,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -321,7 +351,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 133253 // <generalisation>
-	  b multiplicity "" parent class_ref 131717 // ProcNode
+	  b parent class_ref 131717 // ProcNode
       end
     end
 
@@ -333,6 +363,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -342,7 +374,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 133509 // <generalisation>
-	  b multiplicity "" parent class_ref 131845 // Trafo
+	  b parent class_ref 131845 // Trafo
       end
     end
 
@@ -354,6 +386,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -362,7 +396,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 133637 // <generalisation>
-	  b multiplicity "" parent class_ref 131845 // Trafo
+	  b parent class_ref 131845 // Trafo
       end
     end
 
@@ -374,6 +408,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -383,7 +419,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 133765 // <generalisation>
-	  b multiplicity "" parent class_ref 131845 // Trafo
+	  b parent class_ref 131845 // Trafo
       end
     end
 
@@ -395,6 +431,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -403,7 +441,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 138757 // <generalisation>
-	  b multiplicity "" parent class_ref 131845 // Trafo
+	  b parent class_ref 131845 // Trafo
       end
     end
 
@@ -417,6 +455,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -434,6 +474,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -442,7 +484,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 135045 // <generalisation>
-	  b multiplicity "" parent class_ref 133253 // Frame
+	  b parent class_ref 133253 // Frame
       end
     end
 
@@ -454,6 +496,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -462,7 +506,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 135173 // <generalisation>
-	  b multiplicity "" parent class_ref 133253 // Frame
+	  b parent class_ref 133253 // Frame
       end
     end
 
@@ -474,6 +518,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -482,7 +528,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 135301 // <generalisation>
-	  b multiplicity "" parent class_ref 133253 // Frame
+	  b parent class_ref 133253 // Frame
       end
     end
 
@@ -494,6 +540,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -503,7 +551,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 136069 // <generalisation>
-	  b multiplicity "" parent class_ref 131717 // ProcNode
+	  b parent class_ref 131717 // ProcNode
       end
 
       classrelation 141701 // <dependency>
@@ -511,7 +559,7 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 141701 // <dependency>
-	  b multiplicity "" parent class_ref 136709 // Media
+	  b parent class_ref 136709 // Media
       end
     end
 
@@ -523,6 +571,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -531,7 +581,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 152453 // <generalisation>
-	  b multiplicity "" parent class_ref 132741 // State
+	  b parent class_ref 132741 // State
       end
     end
 
@@ -543,6 +593,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -551,7 +603,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 152325 // <generalisation>
-	  b multiplicity "" parent class_ref 132741 // State
+	  b parent class_ref 132741 // State
       end
 
       operation 135557 "retrieve"
@@ -567,6 +619,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       classrelation 152709 // state (<unidirectional association>)
@@ -575,16 +629,16 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 152709 // state (<unidirectional association>)
-	  b multiplicity "" parent class_ref 142469 // StateProxy
+	  b parent class_ref 142469 // StateProxy
       end
 
       classrelation 152837 // <unidirectional association>
 	relation 149381 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 152837 // <unidirectional association>
-	  b multiplicity "" parent class_ref 133253 // Frame
+	  b parent class_ref 133253 // Frame
       end
     end
 
@@ -596,6 +650,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -616,6 +672,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -630,6 +688,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -638,7 +698,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 152965 // <generalisation>
-	  b multiplicity "" parent class_ref 142725 // WiringDescriptor
+	  b parent class_ref 142725 // WiringDescriptor
       end
 
       classrelation 153093 // <dependency>
@@ -646,16 +706,16 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 153093 // <dependency>
-	  b multiplicity "" parent class_ref 142597 // StateAdapter
+	  b parent class_ref 142597 // StateAdapter
       end
 
       classrelation 156165 // <association>
 	relation 152581 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156165 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156293 // <association>
@@ -663,11 +723,11 @@ ${inlines}
 
       classrelation 156421 // <association>
 	relation 152709 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156421 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156549 // <association>
@@ -675,11 +735,11 @@ ${inlines}
 
       classrelation 156677 // <association>
 	relation 152837 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156677 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156805 // <association>
@@ -688,11 +748,11 @@ ${inlines}
       classrelation 156933 // <unidirectional association>
 	relation 152965 --->
 	  stereotype "creates"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156933 // <unidirectional association>
-	  b multiplicity "" parent class_ref 144261 // Invocation
+	  b parent class_ref 144261 // Invocation
       end
 
       operation 136581 "callDown"
@@ -708,6 +768,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -719,6 +781,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -732,6 +796,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -740,7 +806,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157189 // <generalisation>
-	  b multiplicity "" parent class_ref 143749 // PullInput
+	  b parent class_ref 143749 // PullInput
       end
     end
 
@@ -752,6 +818,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -760,16 +828,16 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157317 // <generalisation>
-	  b multiplicity "" parent class_ref 144389 // ProcessData
+	  b parent class_ref 144389 // ProcessData
       end
 
       classrelation 158085 // <association>
 	relation 154117 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 158085 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 158213 // <association>
@@ -784,6 +852,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -792,7 +862,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157701 // <generalisation>
-	  b multiplicity "" parent class_ref 143493 // OperationBase
+	  b parent class_ref 143493 // OperationBase
       end
     end
 
@@ -804,6 +874,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -812,7 +884,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157445 // <generalisation>
-	  b multiplicity "" parent class_ref 144645 // FeedCache
+	  b parent class_ref 144645 // FeedCache
       end
 
       classrelation 157829 // <generalisation>
@@ -820,7 +892,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157829 // <generalisation>
-	  b multiplicity "" parent class_ref 143493 // OperationBase
+	  b parent class_ref 143493 // OperationBase
       end
 
       classrelation 158213 // <association>
@@ -836,6 +908,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -844,7 +918,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157573 // <generalisation>
-	  b multiplicity "" parent class_ref 143493 // OperationBase
+	  b parent class_ref 143493 // OperationBase
       end
     end
 
@@ -859,6 +933,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -867,7 +943,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 154757 // <generalisation>
-	  b multiplicity "" parent class_ref 143877 // ReadSource
+	  b parent class_ref 143877 // ReadSource
       end
 
       classrelation 156293 // <association>
@@ -887,7 +963,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157061 // <generalisation>
-	  b multiplicity "" parent class_ref 143621 // QueryCache
+	  b parent class_ref 143621 // QueryCache
       end
 
       classrelation 157957 // <generalisation>
@@ -895,7 +971,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 157957 // <generalisation>
-	  b multiplicity "" parent class_ref 143749 // PullInput
+	  b parent class_ref 143749 // PullInput
       end
     end
 
@@ -910,26 +986,28 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 153861 // <directional aggregation by value>
+      classrelation 153861 // <directional composition>
 	relation 150405 *-->
 	  stereotype "array"
 	  a role_name "" multiplicity "SIZ" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
-	    classrelation_ref 153861 // <directional aggregation by value>
-	  b multiplicity "" parent class_ref 144133 // BuffHandle
+	    classrelation_ref 153861 // <directional composition>
+	  b parent class_ref 144133 // BuffHandle
       end
 
       classrelation 153989 // <unidirectional association>
 	relation 150533 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 153989 // <unidirectional association>
-	  b multiplicity "" parent class_ref 142725 // WiringDescriptor
+	  b parent class_ref 142725 // WiringDescriptor
       end
     end
 
@@ -941,6 +1019,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -954,34 +1034,36 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       classrelation 155781 // <unidirectional association>
 	relation 152197 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 155781 // <unidirectional association>
-	  b multiplicity "" parent class_ref 142597 // StateAdapter
+	  b parent class_ref 142597 // StateAdapter
       end
 
       classrelation 155909 // <unidirectional association>
 	relation 152325 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 155909 // <unidirectional association>
-	  b multiplicity "" parent class_ref 142725 // WiringDescriptor
+	  b parent class_ref 142725 // WiringDescriptor
       end
 
       classrelation 156037 // <unidirectional association>
 	relation 152453 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 156037 // <unidirectional association>
-	  b multiplicity "" parent class_ref 144005 // BuffTable
+	  b parent class_ref 144005 // BuffTable
       end
     end
   end
diff --git a/uml/lumiera/128389.diagram b/uml/lumiera/128389.diagram
index 94ca2c897..1841f8e8e 100644
--- a/uml/lumiera/128389.diagram
+++ b/uml/lumiera/128389.diagram
@@ -1,160 +1,167 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 131333 // RenderEngine
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 175 325 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 187 314 2000
+end
 classcanvas 128133 class_ref 131461 // RenderGraph
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 267 165 2000
-  end
+end
 classcanvas 128389 class_ref 131589 // ExitNode
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 417 444 2000
-  end
+end
 classcanvas 128517 class_ref 131717 // ProcNode
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 462 257 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 463 257 2000
+end
 classcanvas 129029 class_ref 131845 // Trafo
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 496 443 2000
-  end
+end
 classcanvas 129157 class_ref 131973 // Link
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 648 444 2000
-  end
+end
 classcanvas 129413 class_ref 132229 // Projector
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 417 561 2000
-  end
+end
 classcanvas 129541 class_ref 132357 // Mask
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 481 561 2000
-  end
+end
 classcanvas 129669 class_ref 132485 // PluginAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 506 621 2000
-  end
+end
 classcanvas 132229 class_ref 132741 // State
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 36 374 2000
-  end
+end
 classcanvas 133765 class_ref 133253 // Frame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 269 612 2000
-  end
-classcanvas 133893 class_ref 133381 // AFrame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 228 737 2000
-  end
-classcanvas 134021 class_ref 133509 // VFrame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 282 737 2000
-  end
-classcanvas 134149 class_ref 133637 // GLBuf
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 360 737 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 267 612 2000
+end
 classcanvas 137221 class_ref 133765 // Source
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 741 444 2000
-  end
+end
 classcanvas 139781 class_ref 135045 // CodecAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 599 621 2000
-  end
-textcanvas 140037 "the »low level model«"
-  xyzwh 600 318 2000 105 18
-relationcanvas 128261 relation_ref 131845 // <directional aggregation by value>
-  from ref 128005 z 1999 stereotype "<<list>>" xyz 178 278 3000 to point 216 200
+end
+textcanvas 140037 "the »low level model«"
+  xyzwh 566 345 2000 105 18
+classcanvas 140165 class_ref 142725 // WiringDescriptor
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 568 257 2000
+end
+classcanvas 140293 class_ref 142597 // StateAdapter
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 41 514 2000
+end
+note 140677 "note: as of 6/09
+it is not clear if we retain this hierarchy"
+  xyzwh 543 515 2004 212 47
+textcanvas 140805 "(concrete representation of Frames is within the realm of the backend)"
+  xyzwh 268 679 2000 168 28
+relationcanvas 128261 relation_ref 131845 // <directional composition>
+  from ref 128005 z 1999 stereotype "<<list>>" xyz 188 270 3000 to point 225 195
   line 137733 z 1999 to ref 128133
-  role_a_pos 175 178 3000 no_role_b
-  multiplicity_a_pos 240 211 3000 multiplicity_b_pos 202 300 3000
+  role_a_pos 180 181 3000 no_role_b
+  multiplicity_a_pos 240 203 3000 multiplicity_b_pos 211 296 3000
+end
 relationcanvas 128901 relation_ref 131973 // <unidirectional association>
   from ref 128133 z 1999 stereotype "<<list>>" xyz 362 375 3000 to ref 128389
-  role_a_pos 377 393 3000 no_role_b
+  role_a_pos 377 388 3000 no_role_b
   multiplicity_a_pos 404 419 3000 no_multiplicity_b
+end
 relationcanvas 129925 relation_ref 132101 // <generalisation>
   geometry VHV
-  from ref 128389 z 1999 to point 445 397
-  line 130693 z 1999 to point 499 397
+  from ref 128389 z 1999 to point 443 389
+  line 130693 z 1999 to point 499 389
   line 130821 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130053 relation_ref 132229 // <generalisation>
-  geometry VHV
-  from ref 129029 z 1999 to point 516 397
-  line 130949 z 1999 to point 499 397
+  geometry VHV unfixed
+  from ref 129029 z 1999 to point 516 389
+  line 130949 z 1999 to point 499 389
   line 131077 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130309 relation_ref 132485 // <generalisation>
-  geometry VHV
-  from ref 129157 z 1999 to point 668 397
-  line 131461 z 1999 to point 499 397
+  geometry VHV unfixed
+  from ref 129157 z 1999 to point 668 389
+  line 131461 z 1999 to point 499 389
   line 131589 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131845 relation_ref 132741 // <generalisation>
   from ref 129413 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131973 relation_ref 132869 // <generalisation>
   from ref 129541 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132101 relation_ref 132997 // <generalisation>
   from ref 129669 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 135045 relation_ref 133893 // <generalisation>
-  geometry VHV
-  from ref 133893 z 1999 to point 252 704
-  line 135557 z 1999 to point 306 704
-  line 135685 z 1999 to ref 133765
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 135173 relation_ref 134021 // <generalisation>
-  geometry VHV
-  from ref 134021 z 1999 to point 306 704
-  line 135813 z 1999 to point 306 704
-  line 135941 z 1999 to ref 133765
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 135429 relation_ref 134149 // <generalisation>
-  from ref 134149 z 1999 to ref 133765
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136965 relation_ref 134533 // <unidirectional association>
-  from ref 132229 z 1999 stereotype "<<vector>>" xyz 279 441 3000 to point 306 465
+  from ref 132229 z 1999 stereotype "<<vector>>" xyz 277 441 3000 to point 303 465
   line 137093 z 1999 to ref 133765
-  role_a_pos 318 587 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 124 427 3000
+  role_a_pos 315 594 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 128 443 3000
+end
 relationcanvas 137349 relation_ref 134661 // <generalisation>
   geometry VHV
-  from ref 137221 z 1999 to point 763 397
-  line 137477 z 1999 to point 499 397
+  from ref 137221 z 1999 to point 762 389
+  line 137477 z 1999 to point 499 389
   line 137605 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137861 relation_ref 134789 // <generalisation>
   from ref 128005 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137989 relation_ref 134917 // <dependency>
-  from ref 128133 z 1999 stereotype "<<uses>>" xyz 285 323 3000 to point 306 403
+  from ref 128133 z 1999 stereotype "<<uses>>" xyz 283 321 3000 to point 303 400
   line 138117 z 1999 to ref 132229
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139397 relation_ref 135429 // <unidirectional association>
-  from ref 128517 z 1999 to point 432 264
-  line 139525 z 1999 to point 432 294
+  from ref 128517 z 1999 to point 433 264
+  line 139525 z 1999 to point 433 294
   line 139653 z 1999 to ref 128517
-  role_a_pos 414 276 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 445 296 3000
+  role_a_pos 418 279 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 446 289 3000
+end
 relationcanvas 139909 relation_ref 136965 // <generalisation>
   from ref 139781 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
+relationcanvas 140421 relation_ref 148869 // <generalisation>
+  from ref 140293 z 1999 to ref 132229
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 140549 relation_ref 159621 // <unidirectional association>
+  from ref 128517 z 1999 to ref 140165
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+end
diff --git a/uml/lumiera/128517 b/uml/lumiera/128517
index 6f5c8ce9d..d88352c6d 100644
--- a/uml/lumiera/128517
+++ b/uml/lumiera/128517
@@ -1,50 +1,49 @@
-format 40
+format 58
 "CommonLib" // CommonLib
-  revision 14
+  revision 15
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   classview 129541 "InterfaceSystem"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 132869 "Layer Separation Interface"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -58,6 +57,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -73,25 +74,27 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 161797 // <realization>
-	relation 157189 -_-|>
+      classrelation 169861 // <realization>
+	relation 159877 -_-|>
 	  a public
 	    cpp default "${type}"
-	    classrelation_ref 161797 // <realization>
-	  b multiplicity "" parent class_ref 146565 // Facade
+	    classrelation_ref 169861 // <realization>
+	  b parent class_ref 146565 // Facade
       end
 
-      classrelation 162181 // <unidirectional association>
-	relation 157573 --->
+      classrelation 170117 // <unidirectional association>
+	relation 160133 --->
 	  stereotype "uses"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
-	    classrelation_ref 162181 // <unidirectional association>
-	  b multiplicity "" parent class_ref 146949 // C_Interface
+	    classrelation_ref 170117 // <unidirectional association>
+	  b parent class_ref 146949 // C_Interface
       end
     end
 
@@ -103,25 +106,27 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 161925 // <realization>
-	relation 157317 -_-|>
+      classrelation 169989 // <realization>
+	relation 160005 -_-|>
 	  a public
 	    cpp default "${type}"
-	    classrelation_ref 161925 // <realization>
-	  b multiplicity "" parent class_ref 146565 // Facade
+	    classrelation_ref 169989 // <realization>
+	  b parent class_ref 146565 // Facade
       end
 
-      classrelation 162437 // <unidirectional association>
-	relation 157829 --->
+      classrelation 170501 // <unidirectional association>
+	relation 160517 --->
 	  stereotype "has_a"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
-	    classrelation_ref 162437 // <unidirectional association>
-	  b multiplicity "" parent class_ref 147205 // InstanceHandle
+	    classrelation_ref 170501 // <unidirectional association>
+	  b parent class_ref 147205 // InstanceHandle
       end
     end
 
@@ -133,6 +138,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -146,25 +153,27 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 162053 // <realization>
-	relation 157445 -_-|>
+      classrelation 170245 // <realization>
+	relation 160261 -_-|>
 	  a public
 	    cpp default "${type}"
-	    classrelation_ref 162053 // <realization>
-	  b multiplicity "" parent class_ref 146949 // C_Interface
+	    classrelation_ref 170245 // <realization>
+	  b parent class_ref 146949 // C_Interface
       end
 
-      classrelation 162309 // <unidirectional association>
-	relation 157701 --->
+      classrelation 170373 // <unidirectional association>
+	relation 160389 --->
 	  stereotype "calls"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
-	    classrelation_ref 162309 // <unidirectional association>
-	  b multiplicity "" parent class_ref 146821 // ServiceImpl
+	    classrelation_ref 170373 // <unidirectional association>
+	  b parent class_ref 146821 // ServiceImpl
       end
     end
 
@@ -181,48 +190,49 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 162565 // <dependency>
-	relation 157957 -_->
+      classrelation 170629 // <dependency>
+	relation 160645 -_->
 	  stereotype "opens"
 	  a package
 	    cpp default "#include in source"
-	    classrelation_ref 162565 // <dependency>
-	  b multiplicity "" parent class_ref 147077 // C_Instance
+	    classrelation_ref 170629 // <dependency>
+	  b parent class_ref 147077 // C_Instance
       end
 
-      classrelation 162693 // <dependency>
-	relation 158085 -_->
+      classrelation 170757 // <dependency>
+	relation 160773 -_->
 	  stereotype "creates"
 	  a package
 	    cpp default "#include in source"
-	    classrelation_ref 162693 // <dependency>
-	  b multiplicity "" parent class_ref 146693 // Proxy
+	    classrelation_ref 170757 // <dependency>
+	  b parent class_ref 146693 // Proxy
       end
     end
   end
 
   classview 129285 "StreamType"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 132485 "Stream Type Framework"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -234,34 +244,36 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       classrelation 158469 // <unidirectional association>
 	relation 154373 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 158469 // <unidirectional association>
-	  b multiplicity "" parent class_ref 145285 // MediaKind
+	  b parent class_ref 145285 // MediaKind
       end
 
       classrelation 158597 // <unidirectional association>
 	relation 154501 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 158597 // <unidirectional association>
-	  b multiplicity "" parent class_ref 144901 // Prototype
+	  b parent class_ref 144901 // Prototype
       end
 
       classrelation 158725 // <unidirectional association>
 	relation 154629 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 158725 // <unidirectional association>
-	  b multiplicity "" parent class_ref 145029 // ImplFacade
+	  b parent class_ref 145029 // ImplFacade
       end
     end
 
@@ -273,6 +285,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -286,6 +300,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -299,6 +315,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -307,7 +325,7 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 158341 // <dependency>
-	  b multiplicity "" parent class_ref 144773 // StreamType
+	  b parent class_ref 144773 // StreamType
       end
     end
 
@@ -322,6 +340,8 @@ ${items}
 ${items};
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}enum ${name} {
 ${items}};
 "
@@ -334,23 +354,22 @@ ${items}};
 
   classview 128773 "error"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 130181 "Hierarchy"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       comment "Lumiera Exception hierarchy"
       size A4
     end
@@ -363,6 +382,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -371,7 +392,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139781 // <generalisation>
-	  b multiplicity "" parent class_ref 136325 // std::exception
+	  b parent class_ref 136325 // std::exception
       end
 
       operation 131845 "what"
@@ -387,6 +408,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 131973 "rootCause"
@@ -402,6 +425,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "If this exception was caused by a chain of further exceptions,
 return the first one registered in this throw sequence.
 This works only, if every exceptions thrown as a consequence
@@ -415,6 +440,8 @@ the original exception to the constructor"
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "a copy of the first exception encountered in this exception chain"
       end
@@ -428,6 +455,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -436,7 +465,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139397 // <generalisation>
-	  b multiplicity "" parent class_ref 135557 // Error
+	  b parent class_ref 135557 // Error
       end
     end
 
@@ -448,6 +477,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -456,7 +487,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139269 // <generalisation>
-	  b multiplicity "" parent class_ref 135557 // Error
+	  b parent class_ref 135557 // Error
       end
     end
 
@@ -468,6 +499,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -476,7 +509,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139141 // <generalisation>
-	  b multiplicity "" parent class_ref 135557 // Error
+	  b parent class_ref 135557 // Error
       end
     end
 
@@ -488,6 +521,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -496,7 +531,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139525 // <generalisation>
-	  b multiplicity "" parent class_ref 135557 // Error
+	  b parent class_ref 135557 // Error
       end
     end
 
@@ -508,6 +543,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -516,7 +553,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 139653 // <generalisation>
-	  b multiplicity "" parent class_ref 135557 // Error
+	  b parent class_ref 135557 // Error
       end
     end
 
@@ -528,6 +565,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -537,6 +576,8 @@ ${inlines}
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
 	comment "the base class of all exceptions thrown by the standard library"
       end
     end
@@ -544,21 +585,20 @@ ${inlines}
 
   classview 128645 "Service Components"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     class 140293 "Applicable"
       abstract visibility package 
       nformals 1
@@ -570,6 +610,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -580,6 +622,8 @@ ${inlines}
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
     end
 
@@ -591,6 +635,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -600,6 +646,8 @@ ${inlines}
 	cpp_decl "    ${comment}${inline}${virtual}${name} ${(}${)}${volatile} ${throw} { };"
 	
 	
+	
+	
       end
     end
 
@@ -611,6 +659,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -620,6 +670,8 @@ ${inlines}
 	cpp_decl "    ${comment}${inline}${virtual}${name} ${(}${)}${volatile} ${throw}{};"
 	
 	
+	
+	
       end
 
       operation 134789 "apply"
@@ -629,6 +681,8 @@ ${inlines}
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
 
       operation 134917 "dispatchOp"
@@ -639,6 +693,8 @@ ${inlines}
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${t0}& ${p0}, ${t1}& ${p1}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
     end
 
@@ -650,6 +706,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -669,6 +727,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -683,6 +743,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -693,6 +755,8 @@ ${inlines}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "holds the single instance and triggers initialization"
       end
@@ -710,6 +774,8 @@ ${class}::${name} ${(}${)}${volatile} ${throw}
 "
 	
 	
+	
+	
 	comment "perform initialization on first access. 
 A call is placed in static initialization code
 included in lumiera.h; thus it will happen
@@ -722,6 +788,8 @@ ubiquitous very early."
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
 
       operation 131589 "get"
@@ -738,6 +806,8 @@ ${class}::${name} ${(}${t0} & ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "access the configuation value for a given key.
 @return empty string for unknown keys, else the corresponding configuration value"
       end
@@ -746,21 +816,20 @@ ${class}::${name} ${(}${t0} & ${p0}${)}${const}${volatile} ${throw}${staticnl}
 
   classview 128138 "Posix Threads Abstraction"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     comment "C++ wrapers for pthreads"
     class 128138 "Thread"
       visibility package 
@@ -769,6 +838,8 @@ ${members}};
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -782,6 +853,8 @@ ${members}};
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -793,6 +866,8 @@ ${members}};
 ${inlines}
 "
 	java_decl ""
+	php_decl ""
+	python_2_2 python_decl ""
 	idl_decl ""
 	explicit_switch_type ""
 	
@@ -806,6 +881,8 @@ ${members}};
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -817,6 +894,8 @@ ${members}};
 ${inlines}
 "
 	java_decl ""
+	php_decl ""
+	python_2_2 python_decl ""
 	idl_decl ""
 	explicit_switch_type ""
 	
@@ -826,21 +905,20 @@ ${inlines}
 
   classview 128266 "SmartPointers"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     class 128906 "SmartPointer"
       abstract visibility package stereotype "auxiliary"
       cpp_external cpp_decl "${comment}${template}class ${name}${inherit} {
@@ -850,6 +928,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}${final}${abstract}class ${name}${extends}${implements} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${custom}valuetype ${name}${inherit} {
 ${members}};
 "
diff --git a/uml/lumiera/128773.diagram b/uml/lumiera/128773.diagram
index 5cca14aaa..fc42c1a89 100644
--- a/uml/lumiera/128773.diagram
+++ b/uml/lumiera/128773.diagram
@@ -1,32 +1,32 @@
-format 40
+format 58
 
 classinstancecanvas 128005 classinstance_ref 128005 // 
-  xyz 65 271 2000
-  end
+  xyz 62 265 2000
+end
 classinstancecanvas 128133 classinstance_ref 128133 // 
   xyz 221 249 2000
-  end
+end
 classinstancecanvas 128389 classinstance_ref 128261 // 
   xyz 332 249 2000
-  end
-fragment 128773 "seq"
-  xyzwh 175 235 1994 282 93
+end
+fragment 128773 "effective timeline"
+  xyzwh 168 226 1994 282 93
 end
 classinstancecanvas 128901 classinstance_ref 128389 // audio1
   xyz 70 101 2000
-  end
+end
 classinstancecanvas 129029 classinstance_ref 128517 // video1
   xyz 71 156 2000
-  end
+end
 fragment 129285 "seq"
   xyzwh 62 63 1994 94 155
 end
 classinstancecanvas 130821 classinstance_ref 128645 // vid_A
-  xyz 237 399 2000
-  end
+  xyz 241 395 2000
+end
 classinstancecanvas 131077 classinstance_ref 128773 // aud_A
-  xyz 339 399 2000
-  end
+  xyz 343 395 2000
+end
 textcanvas 131333 "Video and Audio Clip of length = 5 frames positioned at frame 2,  starting at t=4s in soucre.
 (Values for PAL and 44.1)"
   xyzwh 457 335 2000 175 87
@@ -35,17 +35,17 @@ objectlinkcanvas 128261 norel
   no_role_a no_role_b
 objectlinkcanvas 129157 norel
   geometry HV
-  from ref 128005 z 1999 to point 107 282
+  from ref 128005 z 1999 to point 104 273
   line 81 z 1999 to ref 129029
   no_role_a no_role_b
 objectlinkcanvas 130565 norel
   geometry HVr
-  from ref 128133 z 1999 to point 267 167
+  from ref 128133 z 1999 to point 267 164
   line 81 z 1999 to ref 129029
   no_role_a no_role_b
 objectlinkcanvas 130693 norel
   geometry HVr
-  from ref 128389 z 1999 to point 378 112
+  from ref 128389 z 1999 to point 378 109
   line 81 z 1999 to ref 128901
   no_role_a no_role_b
 objectlinkcanvas 130949 norel
@@ -54,4 +54,5 @@ objectlinkcanvas 130949 norel
 objectlinkcanvas 131205 norel
   from ref 131077 z 1999 to ref 128389
   no_role_a no_role_b
+preferred_whz 647 538 1
 end
diff --git a/uml/lumiera/128901 b/uml/lumiera/128901
index c6bc6940d..aff57d5cd 100644
--- a/uml/lumiera/128901
+++ b/uml/lumiera/128901
@@ -1,50 +1,49 @@
-format 40
+format 58
 "Builder" // ProcessingLayer::MObject::Builder
-  revision 18
+  revision 19
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   classview 128261 "Builder Workings"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     collaborationdiagram 128517 "build process"
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       comment "This figure shows the process of building and starting a RenderEngine"
       size A4
     end
@@ -52,7 +51,7 @@ format 40
     activity 128005 "building the Engine"
       activitydiagram 129413 "build flow"
 	package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations no shadow default
-	show_infonote default drawing_language default
+	show_infonote default drawing_language default show_stereotype_properties default
 	size A4
       end
 
@@ -172,7 +171,7 @@ format 40
     end
 
     classdiagram 129285 "Builder Tool (Visitor)"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_parameter_dir no show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition yes show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir no show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -184,6 +183,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -203,17 +204,10 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "Main Operation of the Builder: create a render engine for a given part of the timeline"
       end
-
-      classrelation 162565 // <unidirectional association>
-	relation 157701 --->
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162565 // <unidirectional association>
-	  b multiplicity "" parent class_ref 131077 // Assembler
-      end
     end
 
     class 130693 "ToolFactory"
@@ -224,6 +218,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -240,6 +236,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       classrelation 137221 // <dependency>
@@ -247,53 +245,7 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 	  a package
 	    cpp default "#include in source"
 	    classrelation_ref 137221 // <dependency>
-	  b multiplicity "" parent class_ref 134149 // BuilderTool
-      end
-
-      classrelation 161797 // <unidirectional association>
-	relation 157189 --->
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 161797 // <unidirectional association>
-	  b multiplicity "" parent class_ref 134277 // SegmentationTool
-      end
-
-      classrelation 161925 // <unidirectional association>
-	relation 157317 --->
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 161925 // <unidirectional association>
-	  b multiplicity "" parent class_ref 134405 // NodeCreatorTool
-      end
-
-      classrelation 162053 // <association>
-	relation 157445 ----
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162053 // <association>
-	  b role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162181 // <association>
-      end
-
-      classrelation 162437 // <association>
-	relation_ref 157573 // <association>
-      end
-
-      classrelation 162949 // <association>
-	relation 158085 ----
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162949 // <association>
-	  b role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 163077 // <association>
+	  b parent class_ref 134149 // BuilderTool
       end
     end
 
@@ -305,6 +257,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -322,12 +276,10 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
 	comment "TODO"
       end
-
-      classrelation 162181 // <association>
-	relation_ref 157445 // <association>
-      end
     end
 
     class 131077 "Assembler"
@@ -338,6 +290,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -355,18 +309,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
-      end
-
-      classrelation 162309 // <association>
-	relation 157573 ----
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162309 // <association>
-	  b role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162437 // <association>
+	
+	
       end
     end
 
@@ -380,6 +324,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -388,7 +334,7 @@ ${members}};
       classrelation 135941 // currFrame (<unidirectional association>)
 	relation 134533 --->
 	  stereotype "vector"
-	  a role_name "currFrame" multiplicity "" protected
+	  a role_name "currFrame" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} * ${name}${value};
 "
 	    classrelation_ref 135941 // currFrame (<unidirectional association>)
@@ -408,6 +354,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 135941 "allocateBuffer"
@@ -423,6 +371,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 136197 "releaseBuffer"
@@ -438,6 +388,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 136325 "isCalculated"
@@ -453,6 +405,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -466,6 +420,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -478,6 +434,8 @@ ${members}};
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
 
       classrelation 146437 // <generalisation>
@@ -485,7 +443,7 @@ ${members}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146437 // <generalisation>
-	  b multiplicity "" parent class_ref 140165 // Visitable
+	  b parent class_ref 140165 // Visitable
       end
     end
 
@@ -502,6 +460,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -515,6 +475,8 @@ ${members}};
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
 	comment "This operation is to be overloaded for the specific MObject subclasses to be treated."
       end
 
@@ -523,7 +485,7 @@ ${members}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146565 // <generalisation>
-	  b multiplicity "" parent class_ref 140037 // Tool
+	  b parent class_ref 140037 // Tool
       end
 
       classrelation 146693 // <generalisation>
@@ -531,7 +493,7 @@ ${members}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146693 // <generalisation>
-	  b multiplicity "" parent class_ref 140293 // Applicable
+	  b parent class_ref 140293 // Applicable
       end
     end
 
@@ -546,6 +508,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -555,7 +519,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 137605 // <realization>
-	  b multiplicity "" parent class_ref 134149 // BuilderTool
+	  b parent class_ref 134149 // BuilderTool
       end
 
       operation 129925 "treat"
@@ -572,6 +536,8 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 "
 	
 	
+	
+	
       end
 
       operation 130181 "treat"
@@ -588,6 +554,8 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 "
 	
 	
+	
+	
       end
 
       operation 130053 "treat"
@@ -604,17 +572,19 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 "
 	
 	
+	
+	
       end
 
-      classrelation 139013 // segments (<directional aggregation by value>)
+      classrelation 139013 // segments (<directional composition>)
 	relation 137221 *-->
 	  stereotype "list"
 	  a role_name "segments" multiplicity "*" protected
 	    comment "the partitioning of the Timeline to be created by this tool."
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
 "
-	    classrelation_ref 139013 // segments (<directional aggregation by value>)
-	  b multiplicity "" parent class_ref 135173 // Segment
+	    classrelation_ref 139013 // segments (<directional composition>)
+	  b parent class_ref 135173 // Segment
       end
 
       classrelation 146821 // <generalisation>
@@ -622,17 +592,17 @@ ${class}::${name} ${(}const ${t0}& ${p0}${)}${const}${volatile} ${throw}${static
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146821 // <generalisation>
-	  b multiplicity "" parent class_ref 140293 // Applicable
+	  b parent class_ref 140293 // Applicable
       end
 
       classrelation 163461 // <unidirectional association>
 	relation 158341 --->
 	  stereotype "create"
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 163461 // <unidirectional association>
-	  b multiplicity "" parent class_ref 146565 // Segmentation
+	  b parent class_ref 147333 // Segmentation
       end
     end
 
@@ -647,6 +617,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -656,7 +628,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 137733 // <realization>
-	  b multiplicity "" parent class_ref 134149 // BuilderTool
+	  b parent class_ref 134149 // BuilderTool
       end
 
       operation 130309 "treat"
@@ -673,6 +645,8 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 130437 "treat"
@@ -689,6 +663,8 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 130565 "treat"
@@ -705,6 +681,8 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       operation 130693 "treat"
@@ -721,6 +699,8 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       attribute 129797 "proc"
@@ -728,6 +708,8 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
 "
 	java_decl ""
+	php_decl ""
+	python_decl ""
 	idl_decl ""
 	comment "holds the Processor (Render Engine Element) to be built by the current build step"
       end
@@ -737,22 +719,12 @@ ${class}::${name} ${(}${t0}& ${p0}${)}${const}${volatile} ${throw}${staticnl}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 146949 // <generalisation>
-	  b multiplicity "" parent class_ref 140293 // Applicable
-      end
-
-      classrelation 162693 // <unidirectional association>
-	relation 157829 --->
-	  stereotype "create"
-	  a role_name "" multiplicity "" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
-"
-	    classrelation_ref 162693 // <unidirectional association>
-	  b multiplicity "" parent class_ref 131461 // RenderGraph
+	  b parent class_ref 140293 // Applicable
       end
     end
 
     classdiagram 132868 "Builder Entities"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
   end
diff --git a/uml/lumiera/128901.diagram b/uml/lumiera/128901.diagram
index a4a7e4365..cafe0529f 100644
--- a/uml/lumiera/128901.diagram
+++ b/uml/lumiera/128901.diagram
@@ -1,63 +1,63 @@
-format 40
+format 58
 
-fragment 128005 "seq"
-  xyzwh 176 409 1994 282 93
+fragment 128005 "effective timeline"
+  xyzwh 172 397 1994 282 93
 end
 classinstancecanvas 128133 classinstance_ref 128901 // audio1
   xyz 71 275 2000
-  end
+end
 classinstancecanvas 128389 classinstance_ref 129029 // 
   xyz 223 423 2000
-  end
+end
 classinstancecanvas 128645 classinstance_ref 129157 // video1
   xyz 72 330 2000
-  end
+end
 classinstancecanvas 128773 classinstance_ref 129285 // 
-  xyz 66 445 2000
-  end
+  xyz 63 440 2000
+end
 classinstancecanvas 128901 classinstance_ref 129413 // vid_A
-  xyz 239 573 2000
-  end
+  xyz 242 558 2000
+end
 fragment 129029 "seq"
   xyzwh 63 237 1994 94 155
 end
 classinstancecanvas 130309 classinstance_ref 129541 // 
-  xyz 69 79 2000
-  end
+  xyz 63 79 2000
+end
 classinstancecanvas 131333 classinstance_ref 129669 // refPoint
   xyz 224 70 2000
-  end
+end
 classinstancecanvas 131461 classinstance_ref 129797 // 
   xyz 230 158 2000
-  end
+end
 classinstancecanvas 131717 classinstance_ref 129925 // vid_A
   xyz 386 71 2000
-  end
+end
 classinstancecanvas 131845 classinstance_ref 130053 // 
   xyz 361 195 2000
-  end
+end
 classinstancecanvas 132229 classinstance_ref 130181 // 
   xyz 562 71 2000
-  end
+end
 classinstancecanvas 132357 classinstance_ref 130309 // 
-  xyz 551 197 2000
-  end
+  xyz 551 195 2000
+end
 fragment 132869 "seq"
   xyzwh 172 46 1994 494 102
 end
 classinstancecanvas 132997 classinstance_ref 130437 // 
-  xyz 352 573 2000
-  end
+  xyz 354 558 2000
+end
 classinstancecanvas 133125 classinstance_ref 130565 // 
   xyz 345 423 2000
-  end
+end
 note 135941 "actually the same object"
   xyzwh 635 341 2004 148 41
 textcanvas 136197 "Video Clip anchored at a Label, with an attached HUE effect starting 3 frames after begin"
-  xyzwh 524 565 2000 175 87
+  xyzwh 526 555 2000 176 51
 objectlinkcanvas 129413 norel
   geometry HVr
-  from ref 128389 z 1999 to point 269 341
+  from ref 128389 z 1999 to point 269 338
   line 129541 z 1999 to ref 128645
   no_role_a no_role_b
 objectlinkcanvas 129797 norel
@@ -68,48 +68,48 @@ objectlinkcanvas 129925 norel
   no_role_a no_role_b
 objectlinkcanvas 130053 norel
   geometry HV
-  from ref 128773 z 1999 to point 108 456
+  from ref 128773 z 1999 to point 105 448
   line 130181 z 1999 to ref 128645
   no_role_a no_role_b
 objectlinkcanvas 131205 norel
   geometry HVr
-  from ref 128645 z 1999 to point 108 90
+  from ref 128645 z 1999 to point 105 87
   line 81 z 1999 to ref 130309
   no_role_a no_role_b
 objectlinkcanvas 131589 norel
   from ref 131461 z 1999 to ref 131333
   no_role_a no_role_b
-objectlinkcanvas 131973 rel relation_ref 128645 // <association>
+objectlinkcanvas 131973 norel
   from ref 131717 z 1999 to ref 131845
-  role_a_pos 428 170 3000 role_b_pos 428 150 3000
+  no_role_a no_role_b
 objectlinkcanvas 132101 rel relation_ref 129925 // <unidirectional association>
   from ref 131845 z 1999 to ref 131333
-  role_a_pos 304 104 3000 no_role_b
-objectlinkcanvas 132485 rel relation_ref 128645 // <association>
+  role_a_pos 302 105 3000 no_role_b
+objectlinkcanvas 132485 norel
   from ref 132229 z 1999 to ref 132357
-  role_a_pos 613 172 3000 role_b_pos 613 150 3000
+  no_role_a no_role_b
 objectlinkcanvas 132613 rel relation_ref 129925 // <unidirectional association>
   from ref 132357 z 1999 to ref 131717
-  role_a_pos 460 109 3000 no_role_b
+  role_a_pos 455 104 3000 no_role_b
 objectlinkcanvas 132741 norel
   geometry HV
-  from ref 130309 z 1999 to point 261 90
+  from ref 130309 z 1999 to point 260 87
   line 81 z 1999 to ref 131333
   no_role_a no_role_b
 objectlinkcanvas 133253 norel
   geometry HVr
-  from ref 133125 z 1999 to point 391 341
+  from ref 133125 z 1999 to point 391 338
   line 81 z 1999 to ref 128645
   no_role_a no_role_b
 objectlinkcanvas 133381 norel
   geometry VH
-  from ref 133125 z 1999 to point 391 606
+  from ref 133125 z 1999 to point 391 583
   line 81 z 1999 to ref 132997
   no_role_a no_role_b
-objectlinkcanvas 135685 rel relation_ref 128645 // <association>
-  from ref 132997 z 1999 to point 600 432
+objectlinkcanvas 135685 norel
+  from ref 132997 z 1999 to point 597 445
   line 135813 z 1999 to ref 132357
-  role_a_pos 612 276 3000 role_b_pos 443 540 3000
+  no_role_a no_role_b
 line 134149 -_-_
   from ref 131717 z 1993 to ref 132869
 line 134277 -_-_
@@ -120,4 +120,5 @@ line 134661 -_-_
   from ref 132229 z 1999 to point 707 55
   line 134917 z 1999 to point 707 464
   line 134789 z 1999 to ref 132997
+preferred_whz 817 684 1
 end
diff --git a/uml/lumiera/129029.diagram b/uml/lumiera/129029.diagram
index 7ca7da511..739739720 100644
--- a/uml/lumiera/129029.diagram
+++ b/uml/lumiera/129029.diagram
@@ -1,92 +1,93 @@
-format 40
+format 58
 
 classinstancecanvas 128005 classinstance_ref 130693 // 
   xyz 79 75 2000
-  end
+end
 classinstancecanvas 128133 classinstance_ref 130821 // audio1
   xyz 435 172 2000
-  end
+end
 classinstancecanvas 128261 classinstance_ref 130949 // video1
   xyz 280 172 2000
-  end
+end
 fragment 128517 "seq"
   xyzwh 232 140 1994 367 113
 end
 classinstancecanvas 128645 classinstance_ref 131077 // video
-  xyz 287 329 2000
-  end
+  xyz 293 329 2000
+end
 classinstancecanvas 128773 classinstance_ref 131205 // audio
-  xyz 443 330 2000
-  end
+  xyz 449 329 2000
+end
 classinstancecanvas 129157 classinstance_ref 131333 // ouput
-  xyz 287 386 2000
-  end
+  xyz 293 379 2000
+end
 classinstancecanvas 129285 classinstance_ref 131461 // input
-  xyz 290 497 2000
-  end
+  xyz 296 484 2000
+end
 classinstancecanvas 129669 classinstance_ref 131589 // 
-  xyz 306 442 2000
-  end
+  xyz 309 433 2000
+end
 classinstancecanvas 129797 classinstance_ref 131717 // vid_a
-  xyz 292 556 2000
-  end
+  xyz 298 544 2000
+end
 classinstancecanvas 129925 classinstance_ref 131845 // aud_a
-  xyz 444 398 2000
-  end
+  xyz 451 398 2000
+end
 classinstancecanvas 131973 classinstance_ref 132229 // 
   xyz 117 492 2000
-  end
+end
 classinstancecanvas 132101 classinstance_ref 132357 // 
-  xyz 653 353 2000
-  end
+  xyz 650 351 2000
+end
 note 133125 "render state proxy passed on"
-  xyzwh 123 355 2000 104 53
+  xyzwh 123 355 2000 100 45
 textcanvas 133253 "Video and Audio Clip of length = 5 frames positioned at frame 2, producing two output streams (frame sequence)."
-  xyzwh 445 507 2000 175 83
+  xyzwh 433 486 2000 164 63
 classinstancecanvas 133381 classinstance_ref 137093 // vid1
-  xyz 172 431 2000
-  end
+  xyz 170 430 2000
+end
 classinstancecanvas 133893 classinstance_ref 137221 // au1
   xyz 556 289 2000
-  end
-objectlinkcanvas 128389 rel relation_ref 131845 // <directional aggregation by value>
+end
+objectlinkcanvas 128389 rel relation_ref 131845 // <directional composition>
   geometry VH
-  from ref 128005 z 1999 stereotype "<<list>>" xyz 101 154 3000 to point 117 205
+  from ref 128005 z 1999 stereotype "<<list>>" xyz 102 150 3000 to point 118 197
   line 81 z 1999 to ref 128261
-  role_a_pos 188 183 3000 no_role_b
+  role_a_pos 192 182 3000 no_role_b
 objectlinkcanvas 128901 rel relation_ref 131973 // <unidirectional association>
-  from ref 128261 z 1999 stereotype "<<has_a>>" xyz 301 284 3000 to ref 128645
-  role_a_pos 339 304 3000 no_role_b
+  from ref 128261 z 1999 stereotype "<<list>>" xyz 305 284 3000 to ref 128645
+  role_a_pos 344 311 3000 no_role_b
 objectlinkcanvas 129029 rel relation_ref 131973 // <unidirectional association>
-  from ref 128133 z 1999 stereotype "<<has_a>>" xyz 457 285 3000 to ref 128773
-  role_a_pos 494 305 3000 no_role_b
+  from ref 128133 z 1999 stereotype "<<list>>" xyz 461 284 3000 to ref 128773
+  role_a_pos 500 311 3000 no_role_b
 objectlinkcanvas 130437 rel relation_ref 135429 // <unidirectional association>
   from ref 128645 z 1999 to ref 129157
-  role_a_pos 339 361 3000 no_role_b
+  role_a_pos 344 361 3000 no_role_b
 objectlinkcanvas 131205 rel relation_ref 135429 // <unidirectional association>
   from ref 129157 z 1999 to ref 129669
-  role_a_pos 340 417 3000 no_role_b
+  role_a_pos 344 415 3000 no_role_b
 objectlinkcanvas 131333 rel relation_ref 135429 // <unidirectional association>
   from ref 129669 z 1999 to ref 129285
-  role_a_pos 341 472 3000 no_role_b
+  role_a_pos 344 466 3000 no_role_b
 objectlinkcanvas 131461 rel relation_ref 135429 // <unidirectional association>
   from ref 129285 z 1999 to ref 129797
-  role_a_pos 340 531 3000 no_role_b
+  role_a_pos 344 526 3000 no_role_b
 objectlinkcanvas 131589 rel relation_ref 135429 // <unidirectional association>
   from ref 128773 z 1999 to ref 129925
-  role_a_pos 494 373 3000 no_role_b
+  role_a_pos 500 380 3000 no_role_b
 objectlinkcanvas 133509 norel
   geometry VHr
-  from ref 133381 z 1999 to point 140 442
+  from ref 133381 z 1999 to point 140 438
   line 133637 z 1999 to ref 131973
   no_role_a no_role_b
 objectlinkcanvas 134021 norel
   geometry HV
-  from ref 133893 z 1999 to point 676 300
+  from ref 133893 z 1999 to point 673 297
   line 134149 z 1999 to ref 132101
   no_role_a no_role_b
 line 133765 -_-_
   from ref 128261 z 1999 to ref 133381
 line 134277 -_-_
   from ref 128133 z 1999 to ref 133893
+preferred_whz 730 663 1
 end
diff --git a/uml/lumiera/129157.diagram b/uml/lumiera/129157.diagram
index 81552e7a1..8b415d348 100644
--- a/uml/lumiera/129157.diagram
+++ b/uml/lumiera/129157.diagram
@@ -1,109 +1,109 @@
-format 40
+format 58
 
 classinstancecanvas 128005 classinstance_ref 132485 // 
   xyz 85 80 2000
-  end
+end
 note 128261 "render state proxy passed on"
   xyzwh 139 319 2000 104 53
 classinstancecanvas 128389 classinstance_ref 132613 // devnull
-  xyz 610 558 2000
-  end
+  xyz 616 558 2000
+end
 classinstancecanvas 128517 classinstance_ref 132741 // video
-  xyz 610 329 2000
-  end
+  xyz 615 329 2000
+end
 classinstancecanvas 128645 classinstance_ref 132869 // input
-  xyz 488 497 2000
-  end
+  xyz 493 497 2000
+end
 classinstancecanvas 128773 classinstance_ref 132997 // video1
   xyz 602 172 2000
-  end
+end
 classinstancecanvas 128901 classinstance_ref 133125 // ouput
-  xyz 485 386 2000
-  end
+  xyz 491 386 2000
+end
 fragment 129029 "seq"
   xyzwh 254 147 1994 477 111
 end
 classinstancecanvas 129157 classinstance_ref 133253 // HUE
-  xyz 477 444 2000
-  end
+  xyz 481 444 2000
+end
 classinstancecanvas 129669 classinstance_ref 133509 // 
   xyz 151 399 2000
-  end
+end
 classinstancecanvas 129797 classinstance_ref 133637 // video1
   xyz 478 172 2000
-  end
+end
 classinstancecanvas 129925 classinstance_ref 133765 // video
-  xyz 485 329 2000
-  end
+  xyz 491 329 2000
+end
 classinstancecanvas 132229 classinstance_ref 133893 // HUE
-  xyz 600 444 2000
-  end
+  xyz 605 444 2000
+end
 classinstancecanvas 132997 classinstance_ref 134021 // vid_a
   xyz 387 602 2000
-  end
+end
 classinstancecanvas 133125 classinstance_ref 134149 // input
-  xyz 299 498 2000
-  end
+  xyz 304 497 2000
+end
 classinstancecanvas 133253 classinstance_ref 134277 // video1
   xyz 289 172 2000
-  end
+end
 classinstancecanvas 133381 classinstance_ref 134405 // ouput
-  xyz 296 386 2000
-  end
+  xyz 302 386 2000
+end
 classinstancecanvas 133509 classinstance_ref 134533 // video
-  xyz 296 329 2000
-  end
+  xyz 302 329 2000
+end
 note 134661 "Note: because the Engine Components are stateless, various calculation patterns are possible, including all sorts of parallelism "
   xyzwh 569 45 2000 240 75
 textcanvas 134789 "Video Clip from 2 to 7, with an attached HUE effect starting 3 frames after begin and overlapping by 1 frame beyond the end"
-  xyzwh 145 553 2000 175 87
+  xyzwh 152 523 2000 140 75
 classinstancecanvas 134917 classinstance_ref 137093 // vid1
-  xyz 410 291 3005
-  end
+  xyz 411 292 3005
+end
 objectlinkcanvas 130053 rel relation_ref 135429 // <unidirectional association>
   from ref 129925 z 1999 to ref 128901
-  role_a_pos 537 361 3000 no_role_b
+  role_a_pos 542 368 3000 no_role_b
 objectlinkcanvas 130437 rel relation_ref 135429 // <unidirectional association>
   from ref 129157 z 1999 to ref 128645
-  role_a_pos 539 472 3000 no_role_b
+  role_a_pos 542 479 3000 no_role_b
 objectlinkcanvas 130565 rel relation_ref 131973 // <unidirectional association>
-  from ref 128773 z 1999 stereotype "<<has_a>>" xyz 656 263 3000 to ref 128517
-  role_a_pos 661 304 3000 no_role_b
+  from ref 128773 z 1999 stereotype "<<list>>" xyz 661 260 3000 to ref 128517
+  role_a_pos 666 311 3000 no_role_b
 objectlinkcanvas 135045 rel relation_ref 135429 // <unidirectional association>
   from ref 128645 z 1999 to ref 132997
-  role_a_pos 446 567 3000 no_role_b
-objectlinkcanvas 135173 rel relation_ref 131845 // <directional aggregation by value>
+  role_a_pos 456 581 3000 no_role_b
+objectlinkcanvas 135173 rel relation_ref 131845 // <directional composition>
   geometry VH
-  from ref 128005 z 1999 stereotype "<<list>>" xyz 127 141 3000 to point 123 205
+  from ref 128005 z 1999 stereotype "<<list>>" xyz 128 137 3000 to point 124 197
   line 136965 z 1999 to ref 133253
-  role_a_pos 152 186 3000 no_role_b
+  role_a_pos 174 184 3000 no_role_b
 objectlinkcanvas 135301 rel relation_ref 135429 // <unidirectional association>
   from ref 128901 z 1999 to ref 129157
-  role_a_pos 538 419 3000 no_role_b
+  role_a_pos 542 426 3000 no_role_b
 objectlinkcanvas 135429 rel relation_ref 131973 // <unidirectional association>
-  from ref 133253 z 1999 stereotype "<<has_a>>" xyz 282 261 3000 to ref 133509
-  role_a_pos 348 304 3000 no_role_b
+  from ref 133253 z 1999 stereotype "<<list>>" xyz 300 260 3000 to ref 133509
+  role_a_pos 353 311 3000 no_role_b
 objectlinkcanvas 135557 rel relation_ref 135429 // <unidirectional association>
   from ref 128517 z 1999 to ref 132229
-  role_a_pos 662 419 3000 no_role_b
+  role_a_pos 666 426 3000 no_role_b
 objectlinkcanvas 135685 rel relation_ref 135429 // <unidirectional association>
   from ref 133125 z 1999 to ref 132997
-  role_a_pos 416 577 3000 no_role_b
+  role_a_pos 359 582 3000 no_role_b
 objectlinkcanvas 135813 rel relation_ref 135429 // <unidirectional association>
   from ref 132229 z 1999 to ref 128389
-  role_a_pos 662 533 3000 no_role_b
+  role_a_pos 666 540 3000 no_role_b
 objectlinkcanvas 135941 rel relation_ref 131973 // <unidirectional association>
-  from ref 129797 z 1999 stereotype "<<has_a>>" xyz 529 262 3000 to ref 129925
-  role_a_pos 537 304 3000 no_role_b
+  from ref 129797 z 1999 stereotype "<<list>>" xyz 535 260 3000 to ref 129925
+  role_a_pos 542 311 3000 no_role_b
 objectlinkcanvas 136069 rel relation_ref 135429 // <unidirectional association>
   from ref 133509 z 1999 to ref 133381
-  role_a_pos 348 361 3000 no_role_b
+  role_a_pos 353 368 3000 no_role_b
 objectlinkcanvas 136197 rel relation_ref 135429 // <unidirectional association>
   from ref 133381 z 1999 to ref 133125
-  role_a_pos 349 473 3000 no_role_b
+  role_a_pos 353 479 3000 no_role_b
 objectlinkcanvas 136325 norel
   geometry VHr
-  from ref 134917 z 1999 to point 174 302
+  from ref 134917 z 1999 to point 174 300
   line 136453 z 1999 to ref 129669
   no_role_a no_role_b
 line 136581 -_-_
diff --git a/uml/lumiera/129285 b/uml/lumiera/129285
index 96ad397a7..117e269b7 100644
--- a/uml/lumiera/129285
+++ b/uml/lumiera/129285
@@ -1,30 +1,30 @@
-format 40
+format 58
 "ProcessingLayer" // ProcessingLayer
-  revision 25
+  revision 26
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   package_ref 128133 // Asset
 
@@ -36,33 +36,39 @@ format 40
 
   usecaseview 128005 "Renderengine Use"
     //use case diagram settings
-    package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+    package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+    //state diagram settings
+    package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+    //activity diagram settings
+    package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+    show_infonote default drawing_language default show_stereotype_properties default
     objectdiagram 128773 "EDL Example1"
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
       comment "A simple example showing how the actual objects are placed in the Fixture (=definitive playlist). It shows a Video and Audio clip placed on two tracks"
       size A4
     end
 
     objectdiagram 128901 "EDL Example2"
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
       comment "More complex example showing the Object graph in the EDL and how it is linked into the Fixture to yield the actual locations. In this example, an HUE Effect is applied on a part of the Clip"
       size A4
     end
 
     objectdiagram 129029 "Engine Example1"
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
       comment "Example1 (from EDL) continued: here the RenderEngine to be created by the Builder from the Input shown in Example1"
       size A4
     end
 
     objectdiagram 129157 "Engine Example2"
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
       comment "Example2 (from EDL) continued: notably in this RenderEngine the Effect has been partitioned into 2 segments with constant configuration."
       size A4
     end
@@ -286,13 +292,13 @@ format 40
       attributes
         end
       relations
-        relation_ref 131845 // <directional aggregation by value>
+        relation_ref 131845 // <directional composition>
           classinstance_ref 130949 // video1
         end
     end
 
     classinstance 130821 "audio1"
-      type class_ref 131461 // Processor
+      type class_ref 131461 // RenderGraph
       attributes
         attribute_ref 129541 // end
           "7/25"
@@ -306,7 +312,7 @@ format 40
     end
 
     classinstance 130949 "video1"
-      type class_ref 131461 // Processor
+      type class_ref 131461 // RenderGraph
       attributes
         attribute_ref 129541 // end
           "7/25"
@@ -406,7 +412,7 @@ format 40
       attributes
         end
       relations
-        relation_ref 131845 // <directional aggregation by value>
+        relation_ref 131845 // <directional composition>
           classinstance_ref 134277 // video1
         end
     end
@@ -440,7 +446,7 @@ format 40
     end
 
     classinstance 132997 "video1"
-      type class_ref 131461 // Processor
+      type class_ref 131461 // RenderGraph
       attributes
         attribute_ref 129541 // end
           "8/25"
@@ -482,7 +488,7 @@ format 40
     end
 
     classinstance 133637 "video1"
-      type class_ref 131461 // Processor
+      type class_ref 131461 // RenderGraph
       attributes
         attribute_ref 129541 // end
           "7/25"
@@ -534,7 +540,7 @@ format 40
     end
 
     classinstance 134277 "video1"
-      type class_ref 131461 // Processor
+      type class_ref 131461 // RenderGraph
       attributes
         attribute_ref 129541 // end
           "5/25"
@@ -568,7 +574,7 @@ format 40
     end
 
     collaborationdiagram 132229 "Render Process"
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -620,6 +626,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -633,6 +641,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
diff --git a/uml/lumiera/129285.diagram b/uml/lumiera/129285.diagram
index 90c337f61..06e94864c 100644
--- a/uml/lumiera/129285.diagram
+++ b/uml/lumiera/129285.diagram
@@ -1,181 +1,190 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 134021 // Buildable
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 87 207 2000
-  end
+end
 classcanvas 128133 class_ref 128517 // MObject
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 81 349 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 79 365 2000
+end
 classcanvas 128517 class_ref 134149 // BuilderTool
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 306 207 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 309 207 2000
+end
 classcanvas 128645 class_ref 130693 // ToolFactory
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 555 217 2000
-  end
+end
 classcanvas 128901 class_ref 128901 // Clip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 147 525 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 141 510 2000
+end
 classcanvas 129029 class_ref 129157 // Meta
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 25 613 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 38 587 2000
+end
 classcanvas 129157 class_ref 129029 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 106 593 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 111 567 2000
+end
 classcanvas 129285 class_ref 129925 // Auto
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 87 703 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 97 677 2005
+end
 classcanvas 129413 class_ref 129669 // Label
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 25 703 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 38 677 2000
+end
 classcanvas 129541 class_ref 128773 // AbstractMO
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 83 447 2000
-  end
+end
 classcanvas 130565 class_ref 134277 // SegmentationTool
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 304 483 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 307 493 2000
+end
 classcanvas 130949 class_ref 134405 // NodeCreatorTool
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 372 590 2004
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 375 593 2004
+end
 note 134277 "{ provided_tool.treat(this); }"
   xyzwh 183 312 2000 159 39
 classcanvas 134661 class_ref 135173 // Segment
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 606 492 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 602 500 2000
+end
 classcanvas 134917 class_ref 140037 // Tool
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 370 53 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 369 53 2000
+end
 classcanvas 135045 class_ref 140165 // Visitable
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 86 53 2000
-  end
+end
 fragment 135173 "acyclic Visitor Lib"
   xyzwh 69 17 1994 578 150
 end
 classcanvas 135557 class_ref 140293 // Applicable
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 474 53 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 478 53 2005
+end
 note 137861 "mixin for each concrete type to visit"
-  xyzwh 491 335 2008 137 53
+  xyzwh 492 326 2008 137 53
 relationcanvas 128261 relation_ref 135557 // <generalisation>
   from ref 128133 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 128773 relation_ref 135685 // <dependency>
   from ref 128645 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129669 relation_ref 130309 // <generalisation>
   from ref 129413 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129797 relation_ref 129669 // <generalisation>
   from ref 129029 z 1999 to ref 129541
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129925 relation_ref 131333 // <generalisation>
   from ref 129285 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130053 relation_ref 129541 // <generalisation>
   from ref 129157 z 1999 to ref 129541
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130181 relation_ref 129413 // <generalisation>
   from ref 128901 z 1999 to ref 129541
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130437 relation_ref 129285 // <generalisation>
   from ref 129541 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130693 relation_ref 135941 // <realization>
   from ref 130565 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131077 relation_ref 136069 // <realization>
   from ref 130949 z 1999 to point 454 417
   line 131205 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 134789 relation_ref 137221 // <directional aggregation by value>
-  from ref 130565 z 1999 stereotype "<<list>>" xyz 543 530 3000 to ref 134661
-  role_a_pos 547 506 3000 no_role_b
-  multiplicity_a_pos 591 539 3000 no_multiplicity_b
+end
+relationcanvas 134789 relation_ref 137221 // <directional composition>
+  from ref 130565 z 1999 stereotype "<<list>>" xyz 542 532 3000 to ref 134661
+  role_a_pos 546 515 3000 no_role_b
+  multiplicity_a_pos 587 538 3000 no_multiplicity_b
+end
 relationcanvas 135301 relation_ref 144261 // <generalisation>
   from ref 128005 z 1999 to ref 135045
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135429 relation_ref 144389 // <generalisation>
   from ref 128517 z 1999 to ref 134917
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135685 relation_ref 144517 // <generalisation>
   from ref 128517 z 1999 to point 389 187
   line 136453 z 1999 to point 527 148
   line 136325 z 1999 to ref 135557
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136581 relation_ref 144645 // <generalisation>
   from ref 130565 z 1999 to point 388 404
   line 137221 z 1999 to point 527 337
   line 136965 z 1999 to ref 135557
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136709 relation_ref 144773 // <generalisation>
   from ref 130949 z 2003 to point 527 463
   line 136837 z 2003 to ref 135557
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 137989 relation_ref 157189 // <unidirectional association>
-  from ref 128645 z 1999 to ref 130565
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 138117 relation_ref 157317 // <unidirectional association>
-  from ref 128645 z 1999 to ref 130949
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
+end
 line 131461 -_-_
-  from ref 130565 z 1999 to point 302 530
-  line 132101 z 1999 to point 265 528
+  from ref 130565 z 1999 to point 303 524
+  line 132101 z 1999 to point 263 520
   line 132229 z 1999 to ref 128005
 line 131589 -_-_
-  from ref 130565 z 1999 to point 302 550
+  from ref 130565 z 1999 to point 304 542
   line 131845 z 1999 to ref 128901
 line 131717 -_-_
-  from ref 130565 z 1999 to point 301 570
+  from ref 130565 z 1999 to point 304 558
   line 131973 z 1999 to ref 129157
 line 132357 -_-_
-  from ref 128005 z 1999 to point 296 635
-  line 132613 z 1999 to point 383 645
+  from ref 128005 z 1999 to point 296 634
+  line 132613 z 1999 to point 371 634
   line 132485 z 1999 to ref 130949
 line 132741 -_-_
-  from ref 128901 z 1999 to point 295 655
-  line 132997 z 1999 to point 383 665
+  from ref 128901 z 1999 to point 295 650
+  line 132997 z 1999 to point 372 650
   line 132869 z 1999 to ref 130949
 line 133125 -_-_
-  from ref 129157 z 1999 to point 292 677
-  line 133637 z 1999 to point 382 686
+  from ref 129157 z 1999 to point 294 667
+  line 133637 z 1999 to point 372 667
   line 133765 z 1999 to ref 130949
 line 133893 -_-_
-  from ref 129285 z 2003 to point 288 699
-  line 134149 z 2003 to point 381 706
+  from ref 129285 z 2003 to point 293 684
+  line 134149 z 2003 to point 372 684
   line 134021 z 2003 to ref 130949
 line 134405 -_-_
   from ref 128005 z 1999 to point 260 279
   line 134533 z 1999 to ref 134277
+preferred_whz 720 820 1
 end
diff --git a/uml/lumiera/129413.diagram b/uml/lumiera/129413.diagram
index ea370d758..c8fd505f1 100644
--- a/uml/lumiera/129413.diagram
+++ b/uml/lumiera/129413.diagram
@@ -1,7 +1,7 @@
-format 38
+format 58
 
 activitycanvas 130437 activity_ref 128005 // building the Engine
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   xyzwh 147 27 2000 581 532
   params
     parametercanvas 130565 parameter_ref 128645 // build Request
@@ -10,125 +10,130 @@ activitycanvas 130437 activity_ref 128005 // building the Engine
   end
 end
 activityactioncanvas 130693 activityaction_ref 128645 // activity action configure Tools
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   show_opaque_action_definition default
   xyzwh 529 71 2005 136 41
 end
 expansionregioncanvas 130821 expansionregion_ref 128133 // establish partitioning
-  xyzwh 359 207 2005 205 102
+  xyzwh 359 208 2005 205 96
   nodes
     expansionnodecanvas 131077 expansionnode_ref 128005 // segment Tool
-        xyzwh 460 202 2007 33 11 label_xy 460 180
+        xyzwh 458 203 2007 33 11 label_xy 456 183
     end
     expansionnodecanvas 132613 expansionnode_ref 128133 // segments
-        xyzwh 460 303 2007 33 11 label_xy 460 318
+        xyzwh 460 298 2007 33 11 label_xy 459 312
     end
   end
 end
 activityactioncanvas 130949 activityaction_ref 128773 // activity action define segment
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   show_opaque_action_definition default
-  xyzwh 409 235 2010 135 42
+  xyzwh 409 236 2010 135 42
   pins
     pincanvas 131205 pin_ref 128133 // inFixture
-      xyzwh 399 248 2012 11 11 label_xy 350 235
+      xyzwh 399 249 2012 11 11 label_xy 315 241
     end
   end
 end
 activityobjectcanvas 131333 activityobject_ref 128005 // activity object Fixture
-  show_infonote default drawing_language default
-  xyzwh 176 235 2005 53 35
+  show_infonote default drawing_language default show_stereotype_properties default
+  xyzwh 177 239 2005 49 31
 end
 activitynodecanvas 133509 activitynode_ref 129029 // fork
   horizontal xyz 585 147 2005
+end
 expansionregioncanvas 133893 expansionregion_ref 128261 // build Processors
-  xyzwh 359 350 2005 271 152
+  xyzwh 359 349 2005 272 152
   nodes
     expansionnodecanvas 134021 expansionnode_ref 128261 // build Tool
-        xyzwh 581 345 2007 33 11 label_xy 581 323
+        xyzwh 581 344 2007 33 11 label_xy 573 324
     end
     expansionnodecanvas 134149 expansionnode_ref 128389 // segments
-        xyzwh 460 345 2007 33 11 label_xy 460 360
+        xyzwh 460 344 2007 33 11 label_xy 460 359
     end
     expansionnodecanvas 136581 expansionnode_ref 128517 // complete Render Engine
-        xyzwh 460 496 2007 33 11 label_xy 496 499
+        xyzwh 460 495 2007 33 11 label_xy 496 500
     end
   end
 end
 activityactioncanvas 134277 activityaction_ref 128901 // activity action create ProcNode
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   show_opaque_action_definition default
-  xyzwh 419 390 2010 114 42
+  xyzwh 419 389 2010 114 42
 end
 activityactioncanvas 134405 activityaction_ref 129029 // activity action connect
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   show_opaque_action_definition default
-  xyzwh 420 443 2015 113 42
+  xyzwh 420 442 2015 113 42
 end
 activitynodecanvas 134533 activitynode_ref 129157 // activity_final
   xyz 543 527 2005
+end
 simplerelationcanvas 131461 simplerelation_ref 128389
   from ref 131333 z 1999 to point 400 253
   line 131589 z 1999 to ref 130437
+end
 flowcanvas 132101 flow_ref 130309 // <flow>
   
   from ref 130565 z 2001 to ref 130693
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 132485 flow_ref 130565 // <flow>
+  decenter_end 488
   
   from ref 131077 z 2006 to ref 130949
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 133637 flow_ref 130821 // <flow>
   
   from ref 130693 z 2004 to ref 133509
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 133765 flow_ref 130949 // <flow>
   geometry VHV
   
-  from ref 133509 z 2004 to point 595 179
-  line 134789 z 2004 to point 474 179
+  from ref 133509 z 2004 to point 595 180
+  line 134789 z 2004 to point 472 180
   line 134917 z 2004 to ref 131077
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 135301 flow_ref 131077 // <flow>
   
   from ref 133509 z 2004 to ref 134021
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 135429 flow_ref 131205 // <flow>
   geometry HVr
   
-  from ref 134021 z 2006 to point 595 408
+  from ref 134021 z 2006 to point 595 407
   line 135557 z 2006 to ref 134277
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 135685 flow_ref 131333 // <flow>
   
   from ref 134149 z 2006 to ref 134277
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 136197 flow_ref 131461 // <flow>
   
   from ref 134277 z 2009 to ref 134405
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 136453 flow_ref 131717 // <flow>
   
   from ref 131333 z 2004 to ref 131205
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 136709 flow_ref 131845 // <flow>
   
   from ref 134405 z 2006 to ref 136581
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
 flowcanvas 136837 flow_ref 131973 // <flow>
   
   from ref 136581 z 2004 to point 487 524
   line 136965 z 2004 to ref 134533
-  show_infonote default drawing_language default write_horizontally default
+  show_infonote default drawing_language default show_stereotype_properties default write_horizontally default
 end
+preferred_whz 768 616 1
 end
diff --git a/uml/lumiera/129669.diagram b/uml/lumiera/129669.diagram
index 756316393..8450b1e38 100644
--- a/uml/lumiera/129669.diagram
+++ b/uml/lumiera/129669.diagram
@@ -1,77 +1,87 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 131717 // ProcNode
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 56 41 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 56 23 2000
+end
 classcanvas 128133 class_ref 134533 // Parameter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 232 35 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 232 33 2000
+end
 classcanvas 128773 class_ref 134661 // ParamProvider
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 474 24 2000
-  end
+end
 classcanvas 129669 class_ref 134789 // Interpolator
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 396 161 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 400 160 2000
+end
 classcanvas 130309 class_ref 129157 // Meta
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 636 287 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 641 257 2000
+end
 classcanvas 130565 class_ref 129925 // Auto
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 547 373 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 563 334 2005
+end
 classcanvas 130821 class_ref 128517 // MObject
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 660 83 2000
-  end
+end
 classcanvas 130949 class_ref 128773 // AbstractMO
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 643 186 2000
-  end
-relationcanvas 128261 relation_ref 136197 // <directional aggregation by value>
-  from ref 128005 z 1999 stereotype "<<vector>>" xyz 131 48 3000 to ref 128133
-  role_a_pos 191 48 3000 no_role_b
-  multiplicity_a_pos 202 75 3000 no_multiplicity_b
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 664 168 2000
+end
+relationcanvas 128261 relation_ref 136197 // <directional composition>
+  from ref 128005 z 1999 stereotype "<<vector>>" xyz 131 38 3000 to ref 128133
+  role_a_pos 186 51 3000 no_role_b
+  multiplicity_a_pos 205 70 3000 no_multiplicity_b
+end
 relationcanvas 128389 relation_ref 135429 // <unidirectional association>
   from ref 128005 z 1999 to point 26 41
   line 128517 z 1999 to point 26 71
   line 128645 z 1999 to ref 128005
-  role_a_pos 8 49 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 39 68 3000
+  role_a_pos 11 50 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 39 58 3000
+end
 relationcanvas 128901 relation_ref 136325 // <association>
   from ref 128773 z 1999 to ref 128133
-  role_a_pos 332 48 3000 role_b_pos 423 48 3000
-  multiplicity_a_pos 332 81 3000 multiplicity_b_pos 457 81 3000
+  role_a_pos 332 49 3000 role_b_pos 431 48 3000
+  multiplicity_a_pos 330 70 3000 multiplicity_b_pos 457 70 3000
+end
 relationcanvas 129157 relation_ref 136581 // <dependency>
-  from ref 128133 z 1999 stereotype "<<implemented_by>>" xyz 310 104 3000 to point 321 95
+  from ref 128133 z 1999 stereotype "<<implemented_by>>" xyz 310 99 3000 to point 319 80
   line 129541 z 1999 to point 388 121
   line 129285 z 1999 to point 425 121
   line 129413 z 1999 to ref 128773
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129797 relation_ref 136709 // <unidirectional association>
   from ref 128773 z 1999 to point 431 86
   line 130053 z 1999 to ref 129669
-  role_a_pos 443 136 3000 no_role_b
-  multiplicity_a_pos 405 136 3000 no_multiplicity_b
+  role_a_pos 438 137 3000 no_role_b
+  multiplicity_a_pos 405 142 3000 no_multiplicity_b
+end
 relationcanvas 131205 relation_ref 129285 // <generalisation>
   from ref 130949 z 1999 to ref 130821
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131461 relation_ref 129669 // <generalisation>
   from ref 130309 z 1999 to ref 130949
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131589 relation_ref 131333 // <generalisation>
   from ref 130565 z 1999 to ref 130309
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131973 relation_ref 136837 // <realization>
-  from ref 130565 z 1999 label "<VAL->VAL>" xyz 564 225 3000 to ref 128773
+  from ref 130565 z 1999 label "<VAL->VAL>" xyz 482 219 1999 to ref 128773
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
+preferred_whz 780 466 1
+end
diff --git a/uml/lumiera/130053.diagram b/uml/lumiera/130053.diagram
index b8ef0a19a..d9c8bd7c6 100644
--- a/uml/lumiera/130053.diagram
+++ b/uml/lumiera/130053.diagram
@@ -1,97 +1,111 @@
-format 40
+format 58
 
 packagecanvas 128005 
   package_ref 129413 // common
    show_context_mode namespace color lightblue  xyzwh 689 3 1994 277 166
+end
 note 128389 "namespace"
   xyzwh 709 29 2010 86 36
 packagecanvas 128517 
   package_ref 129669 // proc
    show_context_mode namespace color lightblue  xyzwh 62 107 1994 310 200
+end
 note 128645 "namespace"
   xyzwh 81 141 2005 85 35
 componentcanvas 128901 component_ref 129541 // ControllerFacade
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 183 219 2005 156 63
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 183 220 2005 155 62
+end
 packagecanvas 129157 
   package_ref 130181 // mobject
-   show_context_mode namespace  xyzwh 16 370 1965 946 835
+   show_context_mode namespace  xyzwh 17 371 1965 932 606
+end
 packagecanvas 129285 
   package_ref 130437 // session
-   show_context_mode namespace  xyzwh 503 439 1980 440 296
+   show_context_mode namespace  xyzwh 502 409 1980 440 233
+end
 packagecanvas 129413 
-  package_ref 130693 // controller
-   show_context_mode namespace  xyzwh 41 428 1990 385 315
+  package_ref 130693 // control
+   show_context_mode namespace  xyzwh 38 409 1990 385 233
+end
 componentcanvas 129541 component_ref 128261 // Controller
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 87 546 2010 151 63
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 63 472 2010 150 62
+end
 arrowjunctioncanvas 131973 class_ref 130565 // BuilderFacade
-  xyz 316 456 2000 label_xy 230 507
+  xyz 313 436 2000 label_xy 248 451
 arrowjunctioncanvas 132229 class_ref 130565 // BuilderFacade
-  xyz 313 344 2000 label_xy 239 327
+  xyz 313 346 2000 label_xy 238 329
 packagecanvas 132485 
   package_ref 130565 // builder
-   show_context_mode namespace  xyzwh 36 770 1970 465 385
+   show_context_mode namespace  xyzwh 40 686 1970 382 272
+end
 componentcanvas 132869 component_ref 129925 // CommonLib
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 789 89 2005 156 63
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 789 90 2005 155 62
+end
 arrowjunctioncanvas 132997 class_ref 134917 // Time
   xyz 830 211 2000 label_xy 828 233
 arrowjunctioncanvas 133253 class_ref 130309 // ControllerFacade
   xyz 481 157 2000 label_xy 449 178
 componentcanvas 133509 component_ref 128133 // Session
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 694 526 2005 155 63
-arrowjunctioncanvas 134533 class_ref 128133 // EDL
-  xyz 591 603 2000 label_xy 590 624
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 695 475 2005 155 62
+end
+arrowjunctioncanvas 134533 class_ref 128133 // Seq
+  xyz 577 562 2000 label_xy 576 582
 arrowjunctioncanvas 134789 class_ref 128261 // Fixture
-  xyz 596 639 2000 label_xy 589 660
+  xyz 577 604 2000 label_xy 570 626
 arrowjunctioncanvas 135045 class_ref 128517 // MObject
-  xyz 610 798 2000 label_xy 601 819
+  xyz 657 707 2000 label_xy 648 727
 arrowjunctioncanvas 135301 class_ref 134661 // ParamProvider
-  xyz 684 1094 2000 label_xy 658 1115
+  xyz 657 893 2000 label_xy 652 915
 componentcanvas 135685 component_ref 128005 // Builder
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 136 954 2005 151 63
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 141 772 2005 150 62
+end
 arrowjunctioncanvas 135813 class_ref 128005 // SessionImpl
-  xyz 571 765 2000 label_xy 562 787
-arrowjunctioncanvas 136197 class_ref 132741 // StateProxy
-  xyz 535 978 2000 label_xy 517 999
+  xyz 577 707 2000 label_xy 568 729
+arrowjunctioncanvas 136197 class_ref 132741 // State
+  xyz 507 794 2000 label_xy 489 815
 arrowjunctioncanvas 136453 class_ref 128005 // SessionImpl
-  xyz 526 801 2000 label_xy 517 823
+  xyz 507 709 2000 label_xy 498 731
 packagecanvas 136709 
   package_ref 130309 // engine
-   show_context_mode namespace  xyzwh 16 1309 1994 561 265
+   show_context_mode namespace  xyzwh 18 1048 1994 528 218
+end
 componentcanvas 136837 component_ref 128901 // Engine
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 103 1401 2005 156 63
-arrowjunctioncanvas 136965 class_ref 132741 // StateProxy
-  xyz 535 1224 2000 label_xy 517 1245
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 140 1105 2005 155 62
+end
+arrowjunctioncanvas 136965 class_ref 132741 // State
+  xyz 507 996 2000 label_xy 487 982
 componentcanvas 137349 component_ref 130053 // ProcNode
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 376 1494 2000 123 63
-arrowjunctioncanvas 137477 class_ref 134533 // Parameter
-  xyz 623 1379 2000 label_xy 607 1400
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 372 1172 2000 122 62
+end
 arrowjunctioncanvas 137733 class_ref 134661 // ParamProvider
-  xyz 684 1368 2000 label_xy 658 1389
+  xyz 659 996 2000 label_xy 638 1016
 componentcanvas 138373 component_ref 129797 // ConManager
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 135 1070 2005 156 63
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 140 871 2005 155 62
+end
 arrowjunctioncanvas 138501 class_ref 134661 // ParamProvider
-  xyz 586 1094 2000 label_xy 560 1115
+  xyz 583 893 2000 label_xy 557 915
 componentcanvas 138757 component_ref 129285 // RenderPathManager
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
-  xyzwh 89 644 2000 156 63
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
+  xyzwh 63 548 2000 155 62
+end
 arrowjunctioncanvas 138885 class_ref 130437 // PathManager
-  xyz 350 346 2000 label_xy 368 322
+  xyz 350 346 2000 label_xy 364 329
 arrowjunctioncanvas 139397 class_ref 130437 // PathManager
-  xyz 350 458 2000 label_xy 328 479
+  xyz 347 436 2000 label_xy 359 450
 arrowjunctioncanvas 140549 class_ref 128261 // Fixture
-  xyz 494 749 2000 label_xy 487 770
+  xyz 507 657 2000 label_xy 500 679
 arrowjunctioncanvas 140805 class_ref 135557 // Error
   xyz 790 194 2000 label_xy 787 215
 line 132101 ---O
-  from ref 129541 z 1999 to point 301 541
+  from ref 129541 z 1999 to point 319 500
   line 139269 z 1999 to ref 131973
 line 132357 ---(
   from ref 128901 z 1999 to point 321 311
@@ -107,7 +121,7 @@ line 134917 ---O
 line 135173 ---O
   from ref 133509 z 1999 to ref 135045
 line 135429 ---O
-  from ref 133509 z 1999 to point 689 914
+  from ref 133509 z 1999 to point 770 900
   line 138245 z 1999 to ref 135301
 line 135941 ---O
   from ref 133509 z 1999 to ref 135813
@@ -116,20 +130,18 @@ line 136325 ---O
 line 136581 ---(
   from ref 135685 z 1999 to ref 136453
 line 137093 ---(
-  from ref 136837 z 1999 to point 540 1302
+  from ref 136837 z 1999 to point 514 1040
   line 137221 z 1999 to ref 136965
-line 137605 ---O
-  from ref 137349 z 1999 to ref 137477
-line 137861 ---(
-  from ref 137349 z 1999 to point 689 1522
-  line 137989 z 1999 to ref 137733
+line 137861 ---( geometry HV
+  from ref 137349 z 1999 to point 666 1200
+  line 141189 z 1999 to ref 137733
 line 138629 ---(
   from ref 138373 z 1999 to ref 138501
 line 139013 ---(
   from ref 128901 z 1999 to point 355 289
   line 139141 z 1999 to ref 138885
 line 139525 ---O geometry HV
-  from ref 138757 z 1999 to point 355 672
+  from ref 138757 z 1999 to point 354 576
   line 139781 z 1999 to ref 139397
 line 140677 ---(
   from ref 135685 z 1999 to ref 140549
diff --git a/uml/lumiera/130309.diagram b/uml/lumiera/130309.diagram
index 9a3886bc4..52ca9572d 100644
--- a/uml/lumiera/130309.diagram
+++ b/uml/lumiera/130309.diagram
@@ -1,218 +1,244 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 136453 // Asset
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 96 16 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 95 41 2000
+end
 classcanvas 128133 class_ref 136581 // AssetManager
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode class drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 290 16 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode class drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 289 41 2005
+end
 packagecanvas 128517 
   package_ref 128133 // Asset
    show_context_mode namespace  xyzwh 214 182 1994 610 571
+end
 classcanvas 128645 class_ref 136709 // Media
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 258 330 2005
-  end
+end
 classcanvas 128773 class_ref 136837 // Proc
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 502 330 2005
-  end
+end
 classcanvas 128901 class_ref 136965 // Struct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 654 330 2005
-  end
+end
 classcanvas 129029 class_ref 137093 // Meta
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 760 330 2005
-  end
+end
 classcanvas 130821 class_ref 137221 // Category
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 276 233 2004
-  end
+end
 classcanvas 131077 class_ref 137349 // Clip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 318 445 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 318 444 2000
+end
 classcanvas 131333 class_ref 137477 // Unknown
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 381 445 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 374 445 2000
+end
 classcanvas 131461 class_ref 137605 // Preview
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 386 529 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 376 522 2005
+end
 classcanvas 131973 class_ref 137733 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 476 445 2000
-  end
+end
 classcanvas 132101 class_ref 137861 // Codec
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 537 445 2000
-  end
+end
 classcanvas 132485 class_ref 137989 // Track
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 614 445 2000
-  end
+end
 classcanvas 132613 class_ref 138117 // Pipe
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 682 445 2000
-  end
+end
 classcanvas 132997 class_ref 138245 // Dataset
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 756 445 2000
-  end
+end
 classcanvas 133253 class_ref 138373 // DB
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 485 233 2000
-  end
+end
 classcanvas 133765 class_ref 138501 // CompoundMedia
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 244 529 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 245 522 2005
+end
 classcanvas 135813 class_ref 138757 // ProcPatt
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 637 506 2000
-  end
+end
 classcanvas 136709 class_ref 139141 // DoAttach
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 566 688 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 569 687 2000
+end
 classcanvas 136837 class_ref 139013 // BuildInstruct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 604 620 2000
-  end
+end
 classcanvas 136965 class_ref 139269 // DoRecurse
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 638 688 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 638 687 2000
+end
 relationcanvas 129157 relation_ref 138117 // <realization>
   geometry VHV
-  from ref 128645 z 1999 to point 292 307
-  line 129797 z 1999 to point 138 307
+  from ref 128645 z 1999 to point 289 293
+  line 129797 z 1999 to point 135 293
   line 129925 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129285 relation_ref 138245 // <realization>
   geometry VHV
-  from ref 128773 z 1999 to point 522 307
-  line 130053 z 1999 to point 138 307
+  from ref 128773 z 1999 to point 522 293
+  line 130053 z 1999 to point 135 293
   line 130181 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129413 relation_ref 138373 // <realization>
   geometry VHV
-  from ref 128901 z 1999 to point 674 307
-  line 130309 z 1999 to point 138 307
+  from ref 128901 z 1999 to point 674 293
+  line 130309 z 1999 to point 135 293
   line 130437 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129541 relation_ref 138501 // <realization>
   geometry VHV
-  from ref 129029 z 1999 to point 780 307
-  line 130565 z 1999 to point 138 307
+  from ref 129029 z 1999 to point 780 293
+  line 130565 z 1999 to point 135 293
   line 130693 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130949 relation_ref 138629 // <unidirectional association>
   from ref 128005 z 1999 to ref 130821
-  role_a_pos 222 217 3000 no_role_b
-  multiplicity_a_pos 259 250 3000 multiplicity_b_pos 194 194 3000
+  role_a_pos 225 223 3000 no_role_b
+  multiplicity_a_pos 259 246 3000 multiplicity_b_pos 189 188 3000
+end
 relationcanvas 131205 relation_ref 138757 // <generalisation>
   geometry VHV
-  from ref 131077 z 1999 to point 338 423
-  line 134277 z 1999 to point 292 423
+  from ref 131077 z 1999 to point 338 417
+  line 134277 z 1999 to point 289 417
   line 134405 z 1999 to ref 128645
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132229 relation_ref 139269 // <generalisation>
   from ref 131973 z 1999 to ref 128773
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132357 relation_ref 139397 // <generalisation>
   from ref 132101 z 1999 to ref 128773
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132741 relation_ref 139525 // <generalisation>
   from ref 132485 z 1999 to ref 128901
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132869 relation_ref 139653 // <generalisation>
   from ref 132613 z 1999 to ref 128901
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133125 relation_ref 139781 // <generalisation>
   from ref 132997 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133381 relation_ref 140293 // <unidirectional association>
   geometry HV
-  from ref 128133 z 1999 to point 505 93
+  from ref 128133 z 1999 to point 505 104
   line 133637 z 1999 to ref 133253
-  role_a_pos 517 208 3000 no_role_b
-  multiplicity_a_pos 491 208 3000 multiplicity_b_pos 386 104 3000
+  role_a_pos 517 215 3000 no_role_b
+  multiplicity_a_pos 491 215 3000 multiplicity_b_pos 381 112 3000
+end
 relationcanvas 134533 relation_ref 140421 // <generalisation>
   from ref 133765 z 2004 to ref 128645
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134917 relation_ref 140549 // <directional aggregation>
-  from ref 133765 z 2004 stereotype "<<vector>>" xyz 230 500 3000 to point 225 545
-  line 135301 z 2004 to point 225 365
+  from ref 133765 z 2004 stereotype "<<vector>>" xyz 226 505 3000 to point 220 539
+  line 135301 z 2004 to point 220 360
   line 135173 z 2004 to ref 128645
-  role_a_pos 216 343 3000 no_role_b
-  multiplicity_a_pos 231 376 3000 multiplicity_b_pos 229 556 3000
+  role_a_pos 220 345 3000 no_role_b
+  multiplicity_a_pos 231 368 3000 multiplicity_b_pos 230 547 3000
+end
 relationcanvas 136069 relation_ref 141189 // <generalisation>
   from ref 135813 z 1999 to ref 128901
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136197 relation_ref 141317 // <dependency>
-  from ref 128645 z 1999 to point 324 392
-  line 136581 z 1999 to point 447 392
+  from ref 128645 z 1999 to point 322 382
+  line 136581 z 1999 to point 431 382
   line 136453 z 1999 to point 471 525
   line 136325 z 1999 to ref 135813
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 137093 relation_ref 141701 // <directional aggregation by value>
+end
+relationcanvas 137093 relation_ref 141701 // <directional composition>
   from ref 135813 z 1999 stereotype "<<vector>>" xyz 631 569 3000 to ref 136837
-  role_a_pos 657 595 3000 no_role_b
-  multiplicity_a_pos 621 595 3000 multiplicity_b_pos 642 557 3000
+  role_a_pos 656 602 3000 no_role_b
+  multiplicity_a_pos 620 600 3000 multiplicity_b_pos 643 545 3000
+end
 relationcanvas 137221 relation_ref 141829 // <generalisation>
   from ref 136709 z 1999 to ref 136837
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137349 relation_ref 141957 // <generalisation>
   from ref 136965 z 1999 to ref 136837
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137477 relation_ref 142085 // <unidirectional association>
   from ref 136965 z 1999 to point 728 656
   line 137605 z 1999 to point 728 562
   line 137733 z 1999 to ref 135813
-  role_a_pos 703 523 3000 no_role_b
-  multiplicity_a_pos 703 556 3000 multiplicity_b_pos 704 688 3000
+  role_a_pos 699 521 3000 no_role_b
+  multiplicity_a_pos 703 556 3000 multiplicity_b_pos 703 685 3000
+end
 relationcanvas 137861 relation_ref 142213 // <directional aggregation>
-  from ref 136709 z 1999 stereotype "<<vector>>" xyz 538 659 3000 to point 595 388
+  from ref 136709 z 1999 stereotype "<<vector>>" xyz 534 665 3000 to point 595 388
   line 137989 z 1999 to ref 128773
   role_a_pos 556 343 3000 no_role_b
   multiplicity_a_pos 556 376 3000 no_multiplicity_b
+end
 relationcanvas 138117 relation_ref 144005 // <generalisation>
   geometry VHV
-  from ref 131333 z 1999 to point 410 423
-  line 138245 z 1999 to point 292 423
+  from ref 131333 z 1999 to point 400 417
+  line 138245 z 1999 to point 289 417
   line 138373 z 1999 to ref 128645
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138501 relation_ref 144133 // <generalisation>
   from ref 131461 z 1999 to ref 131333
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138629 relation_ref 145925 // <dependency>
   from ref 132613 z 1999 to point 714 509
   line 138757 z 1999 to ref 135813
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-line 128261 -_-_ geometry HV
-  from ref 128005 z 1999 to point 331 150
-  line 128389 z 1999 to ref 128133
+end
+line 128261 -_-_ geometry HV
+  from ref 128005 z 1999 to point 328 149
+  line 128389 z 1999 to ref 128133
+preferred_whz 855 805 1
 end
diff --git a/uml/lumiera/130437.diagram b/uml/lumiera/130437.diagram
index 59657b515..9601230cc 100644
--- a/uml/lumiera/130437.diagram
+++ b/uml/lumiera/130437.diagram
@@ -1,258 +1,270 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 137349 // Clip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 463 147 2000
-  end
+end
 classcanvas 128133 class_ref 136709 // Media
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 527 41 2005
-  end
+end
 classcanvas 128261 class_ref 137477 // Unknown
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 530 147 2000
-  end
+end
 classcanvas 128389 class_ref 137605 // Preview
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 535 215 2005
-  end
+end
 classcanvas 128901 class_ref 128901 // Clip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 96 206 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 95 206 2000
+end
 classcanvas 129029 class_ref 128517 // MObject
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 79 46 2000
-  end
+end
 classcanvas 129157 class_ref 128773 // AbstractMO
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 81 142 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 83 142 2000
+end
 classcanvas 130309 class_ref 131717 // ProcNode
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 265 278 2000
-  end
+end
 classcanvas 130821 class_ref 133765 // Source
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 390 406 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 371 407 2000
+end
 classcanvas 131077 class_ref 135045 // CodecAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 314 476 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 309 472 2000
+end
 classcanvas 131205 class_ref 131845 // Trafo
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 311 406 2000
-  end
-classcanvas 134277 class_ref 133381 // AFrame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 149 597 2000
-  end
-classcanvas 134405 class_ref 133509 // VFrame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 206 597 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 309 407 2000
+end
 classcanvas 134661 class_ref 133253 // Frame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 193 472 2000
-  end
+end
 packagecanvas 135685 
   package_ref 128261 // MObject
     xyzwh 24 10 1994 187 356
+end
 packagecanvas 135813 
   package_ref 128133 // Asset
     xyzwh 447 9 1994 391 570
+end
 note 136837 "the Builder implements each Clip by a source node and maybe some codec"
-  xyzwh 53 376 2000 219 61
+  xyzwh 59 390 2000 209 46
 classcanvas 137221 class_ref 138501 // CompoundMedia
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 600 147 3005
-  end
+end
 classcanvas 138373 class_ref 138629 // CompoundClip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 110 293 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 114 293 2000
+end
 classcanvas 138885 class_ref 136965 // Struct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 735 49 2005
-  end
+end
 classcanvas 139013 class_ref 138757 // ProcPatt
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 728 113 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 730 113 2000
+end
 classcanvas 140293 class_ref 138885 // SimpleClip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 32 293 3005
-  end
+end
 classcanvas 140805 class_ref 139013 // BuildInstruct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 694 231 2000
-  end
+end
 classcanvas 141061 class_ref 136837 // Proc
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 598 392 2000
-  end
+end
 classcanvas 141189 class_ref 139141 // DoAttach
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 656 299 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 665 302 2000
+end
 classcanvas 141317 class_ref 139269 // DoRecurse
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 728 299 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 727 302 2000
+end
 classcanvas 142725 class_ref 137733 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 564 480 2004
-  end
+end
 classcanvas 142981 class_ref 137861 // Codec
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 618 480 2004
-  end
+end
 relationcanvas 128645 relation_ref 138757 // <generalisation>
   from ref 128005 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129541 relation_ref 129413 // <generalisation>
   from ref 128901 z 1999 to ref 129157
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129669 relation_ref 129285 // <generalisation>
   geometry VHr
-  from ref 129157 z 1999 to point 116 161
+  from ref 129157 z 1999 to point 115 159
   line 129797 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132357 relation_ref 132229 // <generalisation>
   geometry VHV
-  from ref 131205 z 1999 to point 331 372
-  line 132485 z 1999 to point 302 372
+  from ref 131205 z 1999 to point 329 381
+  line 132485 z 1999 to point 301 381
   line 132613 z 1999 to ref 130309
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132741 relation_ref 135429 // <unidirectional association>
   from ref 130309 z 1999 to point 235 278
-  line 132869 z 1999 to point 235 308
+  line 132869 z 1999 to point 235 314
   line 132997 z 1999 to ref 130309
-  role_a_pos 217 286 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 248 305 3000
+  role_a_pos 220 294 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 248 306 3000
+end
 relationcanvas 133125 relation_ref 136965 // <generalisation>
   from ref 131077 z 1999 to ref 131205
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133893 relation_ref 134661 // <generalisation>
   geometry VHV
-  from ref 130821 z 1999 to point 412 372
-  line 134021 z 1999 to point 302 372
+  from ref 130821 z 1999 to point 392 381
+  line 134021 z 1999 to point 301 381
   line 134149 z 1999 to ref 130309
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 134789 relation_ref 133893 // <generalisation>
-  geometry VHV
-  from ref 134277 z 1999 to point 173 564
-  line 134917 z 1999 to point 230 564
-  line 135045 z 1999 to ref 134661
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 135301 relation_ref 134021 // <generalisation>
-  geometry VHV
-  from ref 134405 z 1999 to point 230 564
-  line 135429 z 1999 to point 230 564
-  line 135557 z 1999 to ref 134661
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135941 relation_ref 139909 // <dependency>
   from ref 130821 z 1999 to point 427 382
-  line 136069 z 1999 to point 427 24
+  line 136069 z 1999 to point 427 71
   line 136197 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136965 relation_ref 140165 // <unidirectional association>
   geometry VH
-  from ref 128005 z 1999 to point 483 77
+  from ref 128005 z 1999 to point 483 71
   line 137093 z 1999 to ref 128133
-  role_a_pos 469 60 3000 no_role_b
-  multiplicity_a_pos 510 88 3000 multiplicity_b_pos 471 122 3000
+  role_a_pos 482 59 3000 no_role_b
+  multiplicity_a_pos 507 72 3000 multiplicity_b_pos 471 129 3000
+end
 relationcanvas 137349 relation_ref 140421 // <generalisation>
   from ref 137221 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137477 relation_ref 140549 // <directional aggregation>
-  from ref 137221 z 1999 to point 648 76
-  line 137733 z 1999 stereotype "<<vector>>" xyz 634 112 3000 to ref 128133
-  role_a_pos 634 60 3000 no_role_b
-  multiplicity_a_pos 611 60 3000 multiplicity_b_pos 636 122 3000
+  from ref 137221 z 1999 to point 644 71
+  line 137733 z 1999 stereotype "<<vector>>" xyz 641 123 3000 to ref 128133
+  role_a_pos 603 56 3000 no_role_b
+  multiplicity_a_pos 603 79 3000 multiplicity_b_pos 634 131 3000
+end
 relationcanvas 137861 relation_ref 140677 // <unidirectional association>
-  from ref 128901 z 1999 to point 218 232
+  from ref 128901 z 1999 to point 220 223
   line 138245 z 1999 to point 377 48
   line 137989 z 1999 to point 486 48
   line 138117 z 1999 to ref 128133
   role_a_pos 386 50 3000 no_role_b
-  multiplicity_a_pos 510 76 3000 multiplicity_b_pos 149 235 3000
+  multiplicity_a_pos 512 38 3000 multiplicity_b_pos 149 231 3000
+end
 relationcanvas 138501 relation_ref 140805 // <generalisation>
   from ref 138373 z 1999 to ref 128901
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139141 relation_ref 141189 // <generalisation>
   from ref 139013 z 1999 to ref 138885
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139397 relation_ref 141317 // <dependency>
-  from ref 128133 z 1999 to point 593 103
-  line 140165 z 1999 to point 684 103
+  from ref 128133 z 1999 to point 593 91
+  line 140165 z 1999 to point 677 91
   line 139781 z 1999 to ref 139013
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 140421 relation_ref 141445 // <generalisation>
   from ref 140293 z 1999 to ref 128901
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 140549 relation_ref 141573 // <directional aggregation>
-  from ref 138373 z 1999 to point 154 263
+  from ref 138373 z 1999 to point 152 263
   line 140677 z 1999 to ref 128901
-  role_a_pos 149 247 3000 no_role_b
-  multiplicity_a_pos 160 260 3000 multiplicity_b_pos 142 268 3000
-relationcanvas 140933 relation_ref 141701 // <directional aggregation by value>
+  role_a_pos 150 243 3000 no_role_b
+  multiplicity_a_pos 158 254 3000 multiplicity_b_pos 145 274 3000
+end
+relationcanvas 140933 relation_ref 141701 // <directional composition>
   from ref 139013 z 1999 stereotype "<<vector>>" xyz 713 174 3000 to ref 140805
-  role_a_pos 748 206 3000 no_role_b
-  multiplicity_a_pos 712 206 3000 multiplicity_b_pos 733 164 3000
+  role_a_pos 745 213 3000 no_role_b
+  multiplicity_a_pos 709 213 3000 multiplicity_b_pos 734 157 3000
+end
 relationcanvas 141445 relation_ref 141829 // <generalisation>
   geometry VHV
-  from ref 141189 z 1999 to point 685 284
-  line 141957 z 1999 to point 732 284
+  from ref 141189 z 1999 to point 691 283
+  line 141957 z 1999 to point 729 283
   line 142085 z 1999 to ref 140805
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 141573 relation_ref 141957 // <generalisation>
   geometry VHV
-  from ref 141317 z 1999 to point 761 284
-  line 141701 z 1999 to point 732 284
+  from ref 141317 z 1999 to point 758 283
+  line 141701 z 1999 to point 729 283
   line 141829 z 1999 to ref 140805
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 142213 relation_ref 142085 // <unidirectional association>
   from ref 141317 z 1999 to point 812 270
-  line 142341 z 1999 to point 812 131
+  line 142341 z 1999 to point 812 129
   line 142469 z 1999 to ref 139013
-  role_a_pos 776 272 3000 no_role_b
-  multiplicity_a_pos 794 142 3000 multiplicity_b_pos 794 299 3000
+  role_a_pos 777 149 3000 no_role_b
+  multiplicity_a_pos 794 137 3000 multiplicity_b_pos 790 299 3000
+end
 relationcanvas 142597 relation_ref 142213 // <directional aggregation>
-  from ref 141189 z 1999 stereotype "<<vector>>" xyz 660 352 3000 to ref 141061
-  role_a_pos 645 374 3000 no_role_b
-  multiplicity_a_pos 614 367 3000 no_multiplicity_b
+  from ref 141189 z 1999 stereotype "<<vector>>" xyz 664 361 3000 to ref 141061
+  role_a_pos 649 374 3000 no_role_b
+  multiplicity_a_pos 613 374 3000 no_multiplicity_b
+end
 relationcanvas 142853 relation_ref 139269 // <generalisation>
   from ref 142725 z 1999 to ref 141061
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 143109 relation_ref 139397 // <generalisation>
   from ref 142981 z 1999 to ref 141061
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 143237 relation_ref 144133 // <generalisation>
   from ref 128389 z 1999 to ref 128261
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 143365 relation_ref 144005 // <generalisation>
   from ref 128261 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
+relationcanvas 143493 relation_ref 156421 // <realization>
+  from ref 128901 z 1999 to ref 129029
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+preferred_whz 859 632 1
+end
diff --git a/uml/lumiera/131077 b/uml/lumiera/131077
index 480e8aad0..08641bd3c 100644
--- a/uml/lumiera/131077
+++ b/uml/lumiera/131077
@@ -1,38 +1,38 @@
-format 40
+format 58
 "ConfigQuery" // CommonLib::ConfigQuery
-  revision 2
+  revision 3
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
   componentview 128261 "Query System overview"
     //component diagram settings
     package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-    draw_component_as_icon default show_component_req_prov default show_component_rea default
+    draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
     componentdiagram 131589 "components"
       package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-      draw_component_as_icon default show_component_req_prov default show_component_rea default
+      draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
       size A4
     end
 
@@ -52,23 +52,22 @@ format 40
 
   classview 129157 "query"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 131461 "Rules access"
-      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations no hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
@@ -85,6 +84,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -96,16 +97,16 @@ ${members}};
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 148357 // <generalisation>
-	  b multiplicity "" parent class_ref 140677 // QueryHandler
+	  b parent class_ref 140677 // QueryHandler
       end
 
       classrelation 148485 // <association>
 	relation 146309 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 148485 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 148613 // <association>
@@ -113,11 +114,11 @@ ${members}};
 
       classrelation 148741 // <association>
 	relation 146437 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 148741 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 148869 // <association>
@@ -137,6 +138,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -165,6 +168,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -181,6 +186,8 @@ ${inlines}
       java_decl "${comment}${@}${visibility}interface ${name}${extends} {
 ${members}}
 "
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -193,6 +200,8 @@ ${members}};
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
 
       operation 135173 "make"
@@ -202,6 +211,8 @@ ${members}};
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
 	
 	
+	
+	
       end
     end
 
@@ -213,6 +224,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -221,7 +234,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 148997 // <realization>
-	  b multiplicity "" parent class_ref 140549 // ConfigRules
+	  b parent class_ref 140549 // ConfigRules
       end
     end
 
@@ -233,6 +246,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -241,7 +256,7 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 150405 // <dependency>
-	  b multiplicity "" parent class_ref 140805 // TypeHandler
+	  b parent class_ref 140805 // TypeHandler
       end
     end
 
@@ -256,6 +271,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -264,16 +281,16 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 149125 // <generalisation>
-	  b multiplicity "" parent class_ref 140933 // ResolverBase
+	  b parent class_ref 140933 // ResolverBase
       end
 
       classrelation 149253 // <association>
 	relation 146821 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 149253 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 149381 // <association>
@@ -285,11 +302,11 @@ ${inlines}
 
       classrelation 149509 // <association>
 	relation 146949 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 149509 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 149637 // <association>
@@ -314,33 +331,35 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
 
       classrelation 149765 // <unidirectional association>
 	relation 147077 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 149765 // <unidirectional association>
-	  b multiplicity "" parent class_ref 141061 // YAP_Prolog
+	  b parent class_ref 141061 // YAP_Prolog
       end
 
       classrelation 150149 // <unidirectional association>
 	relation 147461 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 150149 // <unidirectional association>
-	  b multiplicity "" parent class_ref 141061 // YAP_Prolog
+	  b parent class_ref 141061 // YAP_Prolog
       end
 
       classrelation 150277 // <unidirectional association>
 	relation 147589 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 150277 // <unidirectional association>
-	  b multiplicity "" parent class_ref 141061 // YAP_Prolog
+	  b parent class_ref 141061 // YAP_Prolog
       end
     end
 
@@ -355,16 +374,18 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       classrelation 149893 // <unidirectional association>
 	relation 147205 --->
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 149893 // <unidirectional association>
-	  b multiplicity "" parent class_ref 138117 // Pipe
+	  b parent class_ref 138117 // Pipe
       end
 
       classrelation 150021 // <realization>
@@ -372,7 +393,7 @@ ${inlines}
 	  a public
 	    cpp default "${type}"
 	    classrelation_ref 150021 // <realization>
-	  b multiplicity "" parent class_ref 140805 // TypeHandler
+	  b parent class_ref 140805 // TypeHandler
       end
     end
 
@@ -384,6 +405,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -392,16 +415,16 @@ ${inlines}
 	  a default
 	    cpp default "#include in header"
 	    classrelation_ref 150533 // <dependency>
-	  b multiplicity "" parent class_ref 140549 // ConfigRules
+	  b parent class_ref 140549 // ConfigRules
       end
 
       classrelation 150661 // <association>
 	relation 147973 ----
-	  a role_name "" multiplicity "" protected
+	  a role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 150661 // <association>
-	  b role_name "" multiplicity "" protected
+	  b role_name "" protected
 	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
 "
 	    classrelation_ref 150789 // <association>
@@ -416,6 +439,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -427,38 +452,56 @@ ${inlines}
 
   usecaseview 128389 "query use"
     //use case diagram settings
-    package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+    package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+    //state diagram settings
+    package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+    //activity diagram settings
+    package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+    show_infonote default drawing_language default show_stereotype_properties default
     usecasediagram 131717 "when to query"
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       size A4
     end
 
     usecase 128517 "create specific object"
       //use case diagram settings
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       //sequence diagram settings
-      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
       //collaboration diagram settings
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       //object diagram settings
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+      //state diagram settings
+      package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+      show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+      //activity diagram settings
+      package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+      show_infonote default drawing_language default show_stereotype_properties default
     end
 
     usecase 128645 "use \"default\" object"
       //use case diagram settings
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       //sequence diagram settings
-      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
       //collaboration diagram settings
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       //object diagram settings
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+      //state diagram settings
+      package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+      show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+      //activity diagram settings
+      package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+      show_infonote default drawing_language default show_stereotype_properties default
       simplerelation 129541
 	---|>
 	  on usecase_ref 128517 // create specific object
@@ -467,24 +510,36 @@ ${inlines}
 
     usecase 128773 "load object from session"
       //use case diagram settings
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       //sequence diagram settings
-      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
       //collaboration diagram settings
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       //object diagram settings
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+      //state diagram settings
+      package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+      show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+      //activity diagram settings
+      package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+      show_infonote default drawing_language default show_stereotype_properties default
     end
 
     usecase 128901 "add new object to session"
       //use case diagram settings
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       //sequence diagram settings
-      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
       //collaboration diagram settings
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       //object diagram settings
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+      //state diagram settings
+      package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+      show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+      //activity diagram settings
+      package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+      show_infonote default drawing_language default show_stereotype_properties default
     end
 
     class 141701 "User"
@@ -495,6 +550,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -508,6 +565,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -515,28 +574,40 @@ ${inlines}
 
     usecase 129029 "ConfigQuery"
       //use case diagram settings
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       //sequence diagram settings
-      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
       //collaboration diagram settings
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       //object diagram settings
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+      //state diagram settings
+      package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+      show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+      //activity diagram settings
+      package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+      show_infonote default drawing_language default show_stereotype_properties default
     end
 
     usecase 129157 "need sub object"
       //use case diagram settings
-      package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+      package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
       //sequence diagram settings
-      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+      show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
       //collaboration diagram settings
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       //object diagram settings
-       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+       write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+      //state diagram settings
+      package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+      show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+      //activity diagram settings
+      package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+      show_infonote default drawing_language default show_stereotype_properties default
     end
 
     collaborationdiagram 131845 "\"default\" object"
-      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+      show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
       size A4
     end
 
diff --git a/uml/lumiera/131077.diagram b/uml/lumiera/131077.diagram
index 5da417c64..12db11942 100644
--- a/uml/lumiera/131077.diagram
+++ b/uml/lumiera/131077.diagram
@@ -1,92 +1,104 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 139013 // BuildInstruct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 693 369 2000
-  end
+end
 classcanvas 128133 class_ref 136837 // Proc
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 591 79 2005
-  end
+end
 classcanvas 128261 class_ref 137861 // Codec
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 581 216 2000
-  end
+end
 classcanvas 128389 class_ref 138757 // ProcPatt
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 726 255 2000
-  end
+end
 classcanvas 128517 class_ref 137733 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 550 152 2000
-  end
+end
 classcanvas 128645 class_ref 139141 // DoAttach
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 655 437 2000
-  end
+end
 packagecanvas 128773 
   package_ref 128133 // Asset
    show_context_mode namespace  xyzwh 406 24 1994 417 478
+end
 packagecanvas 129669 
   package_ref 128389 // RenderEngine
     xyzwh 20 90 1994 330 411
+end
 classcanvas 129797 class_ref 135045 // CodecAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 198 348 2000
-  end
+end
 classcanvas 129925 class_ref 131717 // ProcNode
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 79 137 2000
-  end
+end
 classcanvas 130053 class_ref 132485 // PluginAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 233 285 2000
-  end
+end
 classcanvas 130181 class_ref 131845 // Trafo
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 96 238 2000
-  end
+end
 relationcanvas 128901 relation_ref 142213 // <directional aggregation>
-  from ref 128645 z 1999 stereotype "<<vector>>" xyz 626 407 3000 to point 683 134
+  from ref 128645 z 1999 stereotype "<<vector>>" xyz 624 406 3000 to point 680 133
   line 129029 z 1999 to ref 128133
-  role_a_pos 645 92 3000 no_role_b
-  multiplicity_a_pos 645 125 3000 no_multiplicity_b
+  role_a_pos 645 97 3000 no_role_b
+  multiplicity_a_pos 640 122 3000 no_multiplicity_b
+end
 relationcanvas 129157 relation_ref 139269 // <generalisation>
   from ref 128517 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129285 relation_ref 139397 // <generalisation>
   from ref 128261 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 129413 relation_ref 141701 // <directional aggregation by value>
-  from ref 128389 z 1999 stereotype "<<vector>>" xyz 714 332 3000 to ref 128005
+end
+relationcanvas 129413 relation_ref 141701 // <directional composition>
+  from ref 128389 z 1999 stereotype "<<vector>>" xyz 720 324 3000 to ref 128005
   role_a_pos 746 344 3000 no_role_b
   multiplicity_a_pos 710 344 3000 multiplicity_b_pos 731 306 3000
+end
 relationcanvas 129541 relation_ref 141829 // <generalisation>
   from ref 128645 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130309 relation_ref 135429 // <unidirectional association>
   from ref 129925 z 1999 to point 49 137
-  line 130437 z 1999 to point 49 167
+  line 130437 z 1999 to point 49 174
   line 130565 z 1999 to ref 129925
-  role_a_pos 31 145 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 62 164 3000
+  role_a_pos 34 152 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 62 165 3000
+end
 relationcanvas 130693 relation_ref 132229 // <generalisation>
   from ref 130181 z 1999 to ref 129925
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131077 relation_ref 136965 // <generalisation>
   from ref 129797 z 1999 to ref 130181
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131205 relation_ref 132997 // <generalisation>
   from ref 130053 z 1999 to ref 130181
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 line 131333 -_-_
   from ref 130053 z 1999 to ref 128517
 line 131461 -_-_
   from ref 129797 z 1999 to ref 128261
+preferred_whz 850 555 1
 end
diff --git a/uml/lumiera/131205.diagram b/uml/lumiera/131205.diagram
index 822bc1982..51140cdfa 100644
--- a/uml/lumiera/131205.diagram
+++ b/uml/lumiera/131205.diagram
@@ -1,40 +1,41 @@
-format 40
+format 58
 
 packagecanvas 128005 
   package_ref 128133 // Asset
     xyzwh 52 6 1994 448 544
+end
 classcanvas 128133 class_ref 139013 // BuildInstruct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 375 363 2000
-  end
+end
 classcanvas 128261 class_ref 136837 // Proc
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 205 480 2005
-  end
+end
 classcanvas 128389 class_ref 138757 // ProcPatt
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 408 249 2000
-  end
+end
 classcanvas 128517 class_ref 138117 // Pipe
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 240 168 2000
-  end
+end
 classcanvas 128645 class_ref 139141 // DoAttach
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 337 431 2000
-  end
+end
 classcanvas 128773 class_ref 137989 // Track
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 328 168 2000
-  end
+end
 classcanvas 128901 class_ref 139269 // DoRecurse
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 409 431 2000
-  end
+end
 classcanvas 129029 class_ref 136965 // Struct
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 425 73 2005
-  end
+end
 relationcanvas 129157 relation_ref 139653 // <generalisation>
   geometry VHV
   from ref 128517 z 1999 to point 260 139
@@ -42,11 +43,13 @@ relationcanvas 129157 relation_ref 139653 // <generalisation>
   line 130565 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129285 relation_ref 141189 // <generalisation>
   from ref 128389 z 1999 to point 445 200
   line 130693 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129413 relation_ref 139525 // <generalisation>
   geometry VHV
   from ref 128773 z 1999 to point 348 139
@@ -54,31 +57,39 @@ relationcanvas 129413 relation_ref 139525 // <generalisation>
   line 130309 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 129541 relation_ref 141701 // <directional aggregation by value>
-  from ref 128389 z 1999 stereotype "<<vector>>" xyz 361 286 3000 to ref 128133
+end
+relationcanvas 129541 relation_ref 141701 // <directional composition>
+  from ref 128389 z 1999 stereotype "<<vector>>" xyz 367 290 3000 to ref 128133
   role_a_pos 364 301 3000 no_role_b
   multiplicity_a_pos 392 338 3000 multiplicity_b_pos 467 292 3000
+end
 relationcanvas 129669 relation_ref 141829 // <generalisation>
   from ref 128645 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129797 relation_ref 142213 // <directional aggregation>
   from ref 128645 z 1999 stereotype "<<vector>>" xyz 278 485 3000 to ref 128261
   role_a_pos 259 466 3000 no_role_b
   multiplicity_a_pos 259 499 3000 no_multiplicity_b
+end
 relationcanvas 130053 relation_ref 141957 // <generalisation>
   from ref 128901 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131461 relation_ref 142085 // <unidirectional association>
   from ref 128901 z 1999 to point 471 396
   line 131845 z 1999 to point 471 320
   line 131973 z 1999 to ref 128389
   role_a_pos 443 334 3000 no_role_b
-  multiplicity_a_pos 431 301 3000 multiplicity_b_pos 451 408 3000
-relationcanvas 131589 relation_ref 146053 // <unidirectional association>
-  from ref 128517 z 1999 to point 260 267
-  line 131717 z 1999 to ref 128389
-  role_a_pos 293 252 3000 no_role_b
-  multiplicity_a_pos 300 268 3000 no_multiplicity_b
+  multiplicity_a_pos 431 301 3000 multiplicity_b_pos 442 413 3000
+end
+relationcanvas 131589 relation_ref 146053 // <unidirectional association>
+  from ref 128517 z 1999 to point 260 265
+  line 131717 z 1999 to ref 128389
+  role_a_pos 328 250 3000 no_role_b
+  multiplicity_a_pos 379 273 3000 no_multiplicity_b
+end
+preferred_whz 530 608 1
 end
diff --git a/uml/lumiera/131333.diagram b/uml/lumiera/131333.diagram
index c53581101..75cfd6177 100644
--- a/uml/lumiera/131333.diagram
+++ b/uml/lumiera/131333.diagram
@@ -1,53 +1,53 @@
-format 40
+format 58
 
 classinstancecanvas 128005 classinstance_ref 134661 // 
   xyz 233 116 2000
-  end
+end
 classinstancecanvas 128133 classinstance_ref 134789 // 
   xyz 297 53 2000
-  end
+end
 classinstancecanvas 128261 classinstance_ref 134917 // 
   xyz 335 112 2000
-  end
+end
 classinstancecanvas 128389 classinstance_ref 135045 // 
   xyz 335 144 2000
-  end
+end
 classinstancecanvas 128517 classinstance_ref 135173 // 
-  xyz 335 177 2000
-  end
+  xyz 335 175 2000
+end
 fragment 128773 ""
   xyzwh 311 90 1994 83 139
 end
 classinstancecanvas 129157 classinstance_ref 135301 // 
   xyz 65 116 2000
-  end
+end
 classinstancecanvas 129285 classinstance_ref 135429 // 
   xyz 95 176 2000
-  end
+end
 classinstancecanvas 129413 classinstance_ref 135557 // 
   xyz 95 208 2000
-  end
+end
 classinstancecanvas 129541 classinstance_ref 135685 // 
   xyz 95 241 2000
-  end
+end
 fragment 129669 ""
   xyzwh 70 153 1994 93 136
 end
 classinstancecanvas 129925 classinstance_ref 135813 // 
   xyz 75 33 2000
-  end
+end
 fragment 130181 "EDL"
   xyzwh 12 12 2000 167 305
 end
 fragment 130437 "asset management"
-  xyzwh 221 12 2005 184 236
+  xyzwh 221 12 1989 184 236
 end
 objectlinkcanvas 128645 norel
   from ref 128133 z 1999 to ref 128261
   no_role_a no_role_b
 objectlinkcanvas 128901 norel
   geometry VH
-  from ref 128005 z 1999 to point 256 64
+  from ref 128005 z 1999 to point 256 61
   line 129029 z 1999 to ref 128133
   no_role_a no_role_b
 objectlinkcanvas 129797 norel
@@ -59,4 +59,5 @@ objectlinkcanvas 130053 norel
 objectlinkcanvas 130309 norel
   from ref 129157 z 1999 to ref 128005
   no_role_a no_role_b
+preferred_whz 435 373 1
 end
diff --git a/uml/lumiera/131461.diagram b/uml/lumiera/131461.diagram
index 2afd439c2..e6c661a0e 100644
--- a/uml/lumiera/131461.diagram
+++ b/uml/lumiera/131461.diagram
@@ -1,196 +1,216 @@
-format 40
+format 58
 
 packagecanvas 128005 
   package_ref 131077 // ConfigQuery
     xyzwh 194 34 1980 445 495
+end
 classcanvas 128133 class_ref 140549 // ConfigRules
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   color verylightorange
-  xyz 268 364 2005
-  end
+  xyz 266 363 2005
+end
 classcanvas 128261 class_ref 140677 // QueryHandler
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 217 237 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 217 237 2015
+end
 classcanvas 128389 class_ref 140677 // QueryHandler
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 264 218 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 264 218 2010
+end
 classcanvas 128517 class_ref 140677 // QueryHandler
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 302 205 2005
-  end
+end
 classcanvas 128645 class_ref 140805 // TypeHandler
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 262 88 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 264 91 2005
+end
 classcanvas 128901 class_ref 140805 // TypeHandler
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 215 98 2010
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 217 101 2010
+end
 classcanvas 129029 class_ref 140805 // TypeHandler
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 307 77 1995
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 309 80 1995
+end
 classcanvas 129541 class_ref 140933 // ResolverBase
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 451 223 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 449 223 2000
+end
 classcanvas 129669 class_ref 141061 // YAP_Prolog
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 554 155 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 557 155 2000
+end
 classcanvas 130437 class_ref 141189 // QueryHandlerImpl
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 439 280 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 439 280 2005
+end
 classcanvas 130693 class_ref 141189 // QueryHandlerImpl
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 439 360 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 439 361 2000
+end
 classcanvas 130821 class_ref 141189 // QueryHandlerImpl
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 439 442 2000
-  end
+end
 classcanvas 132613 class_ref 138117 // Pipe
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 84 123 2000
-  end
+end
 classcanvas 132741 class_ref 141317 // TypeHandler<Pipe>
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 18 244 2000
-  end
+end
 classcanvas 133381 class_ref 136581 // AssetManager
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 19 25 2005
-  end
-fragment 133637 "Rule Base"
-  xyzwh 425 67 1985 202 78
+end
+fragment 133637 "Collection of Rules"
+  xyzwh 422 91 1985 205 54
 end
 classcanvas 135941 class_ref 141445 // DefaultsManager
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 58 415 2000
-  end
+end
 classcanvas 136069 class_ref 141573 // DefaultsRegistry
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 59 481 2000
-  end
+end
 classcanvas 136709 class_ref 139653 // Session
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 19 313 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 18 313 2005
+end
 textcanvas 137093 "queries"
   xyzwh 201 414 2000 38 18
 textcanvas 137221 "invokes"
-  xyzwh 557 500 2005 40 18
+  xyzwh 549 475 2005 43 18
 textcanvas 137349 "invokes"
-  xyzwh 549 386 2005 40 18
+  xyzwh 549 392 2005 40 18
 textcanvas 137477 "provide type specific implementation"
-  xyzwh 83 207 2005 102 39
+  xyzwh 83 197 2005 102 39
 note 137605 "Prolog rules use TypeHandler interface to imlement predicates"
-  xyzwh 503 38 2000 176 59
+  xyzwh 497 39 2000 171 49
 classcanvas 137733 class_ref 137989 // Track
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 104 99 1995
-  end
+end
 classcanvas 137861 class_ref 138757 // ProcPatt
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 118 75 1990
-  end
+end
 classcanvas 137989 class_ref 129029 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 134 47 1985
-  end
+end
 classcanvas 138117 class_ref 137861 // Codec
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 144 22 1975
-  end
+end
 relationcanvas 128773 relation_ref 146181 // <generalisation>
   from ref 128133 z 2004 to ref 128261
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129157 relation_ref 146309 // <association>
   from ref 128133 z 2004 to ref 128389
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129285 relation_ref 146437 // <association>
   from ref 128133 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130565 relation_ref 146693 // <generalisation>
   from ref 130437 z 1999 to ref 129541
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 130949 relation_ref 146821 // <association>
   from ref 130821 z 1999 to ref 130693
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131077 relation_ref 146949 // <association>
   from ref 130693 z 1999 to ref 130437
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 131973 relation_ref 146693 // <generalisation>
   from ref 130693 z 1999 to ref 129541
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132101 relation_ref 146693 // <generalisation>
   from ref 130821 z 1999 to ref 129541
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132869 relation_ref 147205 // <unidirectional association>
-  from ref 132741 z 1999 to point 73 205
+  from ref 132741 z 1999 to point 69 203
   line 133509 z 1999 to ref 132613
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132997 relation_ref 147333 // <realization>
-  from ref 132741 z 1999 to point 73 226
+  from ref 132741 z 1999 to point 69 226
   line 133253 z 1999 to point 168 226
   line 133125 z 1999 to ref 128901
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133765 relation_ref 147077 // <unidirectional association>
-  from ref 130693 z 1999 to point 542 417
+  from ref 130693 z 1999 to point 529 414
   line 133893 z 1999 to point 589 403
   line 134021 z 1999 to ref 129669
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134149 relation_ref 146565 // <realization>
-  from ref 129541 z 1999 to point 491 182
+  from ref 129541 z 1999 to point 487 182
   line 134661 z 1999 to point 434 182
   line 134533 z 1999 to point 348 473
-  line 134405 z 1999 to point 304 473
+  line 134405 z 1999 to point 302 473
   line 134277 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134789 relation_ref 147461 // <unidirectional association>
-  from ref 130821 z 1999 to point 543 502
-  line 135045 z 1999 to point 589 490
+  from ref 130821 z 1999 to point 529 496
+  line 135045 z 1999 to point 589 487
   line 134917 z 1999 to ref 129669
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135173 relation_ref 147589 // <unidirectional association>
-  from ref 130437 z 1999 to point 543 337
+  from ref 130437 z 1999 to point 531 334
   line 135429 z 1999 to point 589 320
   line 135301 z 1999 to ref 129669
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135557 relation_ref 147717 // <dependency>
-  from ref 129669 z 1994 to point 588 116
+  from ref 129669 z 1994 to point 590 116
   line 135685 z 1994 to point 440 116
   line 135813 z 1994 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136197 relation_ref 147845 // <dependency>
   from ref 135941 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136581 relation_ref 147973 // <association>
   from ref 135941 z 1999 to ref 136069
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136837 relation_ref 148101 // <unidirectional association>
-  from ref 136709 z 1999 to point 105 348
+  from ref 136709 z 1999 to point 103 342
   line 136965 z 1999 to ref 135941
-  role_a_pos 117 390 3000 no_role_b
+  role_a_pos 115 394 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
 end
+preferred_whz 711 594 1
+end
diff --git a/uml/lumiera/131717.diagram b/uml/lumiera/131717.diagram
index b633daae5..145de3e08 100644
--- a/uml/lumiera/131717.diagram
+++ b/uml/lumiera/131717.diagram
@@ -1,25 +1,36 @@
-format 40
+format 58
 
 usecasecanvas 128005 usecase_ref 128517 // create specific object
   xyzwh 461 161 3005 64 32 label_xy 442 193
+end
 usecasecanvas 128133 usecase_ref 128645 // use "default" object
   xyzwh 462 267 3005 64 32 label_xy 448 299
+end
 usecasecanvas 128261 usecase_ref 128773 // load object from session
   xyzwh 159 259 3005 64 32 label_xy 132 291
+end
 usecasecanvas 128389 usecase_ref 128901 // add new object to session
   xyzwh 159 116 3005 64 32 label_xy 128 148
+end
 classcanvas 128517 class_ref 141701 // User
-  xyz 40 56 3005 label_xy 48 96
+  class_drawing_mode default show_context_mode default show_stereotype_properties default
+  xyz 40 56 3005
+end
 classcanvas 128645 class_ref 141829 // Serializer
-  xyz 40 255 3005 label_xy 38 295
+  class_drawing_mode default show_context_mode default show_stereotype_properties default
+  xyz 35 255 3005
+end
 usecasecanvas 128773 usecase_ref 129029 // ConfigQuery
   color lightorange
   xyzwh 337 211 3005 64 32 label_xy 338 243
+end
 usecasecanvas 129797 usecase_ref 129157 // need sub object
   xyzwh 358 61 3005 64 32 label_xy 352 93
+end
 packagecanvas 130437 
   package_ref 131077 // ConfigQuery
     xyzwh 304 18 3010 281 390
+end
 fragment 130693 "EDL/Session"
   xyzwh 94 40 3009 181 368
 end
@@ -29,6 +40,7 @@ line 129029 --->
   from ref 128389 z 3004 to ref 128773
 simplerelationcanvas 129157 simplerelation_ref 129541
   from ref 128133 z 3004 to ref 128005
+end
 line 129285 --->
   from ref 128773 z 3004 to ref 128005
 line 129413 --->
@@ -42,4 +54,5 @@ line 129925 --->
   line 130053 z 1999 to ref 129797
 line 130309 --->
   from ref 129797 z 3004 to ref 128773
+preferred_whz 615 458 1
 end
diff --git a/uml/lumiera/131845.diagram b/uml/lumiera/131845.diagram
index aa4bf61a3..22bf5502b 100644
--- a/uml/lumiera/131845.diagram
+++ b/uml/lumiera/131845.diagram
@@ -1,46 +1,46 @@
-format 40
+format 58
 
 classinstance 128005 class_ref 140549 // ConfigRules
  name ""  xyz 245 192 2000
 classinstance 128133 class_ref 141445 // DefaultsManager
- name ""  xyz 51 83 2000
+ name ""  xyz 53 94 2000
 classinstance 128261 class_ref 141573 // DefaultsRegistry
  name ""  xyz 244 58 2000
 classinstancecanvas 128517 classinstance_ref 135941 // predicate impl
   xyz 344 347 2000
-  end
+end
 classinstance 128901 class_ref 135301 // Factory
- name ""  xyz 439 206 2000
+ name ""  xyz 439 213 2000
 classinstance 129797 class_ref 136581 // AssetManager
- name ""  xyz 376 447 2000
+ name ""  xyz 372 427 2000
 textcanvas 130437 "recursive invocation of sub queries"
   xyzwh 332 185 2004 172 18
 linkcanvas 128389
   from ref 128133 z 1999 to ref 128261
 dirscanvas 129413 z 1000 linkcanvas_ref 128389
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   forward_label "1 get registered default object
-6 store new default object" xyz 92 30 3000
+6 store new default object" xyz 79 48 3000
 linkcanvas 128645
   from ref 128133 z 1999 to ref 128005
 dirscanvas 129541 z 1000 linkcanvas_ref 128645
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "2 resolve(inout solution : Query<TY>) : bool" xyz 94 157 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "2 resolve(inout solution : Query<TY>) : bool" xyz 157 125 3000
 linkcanvas 128773
   from ref 128005 z 1999 to ref 128517
 dirscanvas 129669 z 1000 linkcanvas_ref 128773
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   forward_label "3 run prolog code" xyz 335 248 3000
 linkcanvas 129029
   from ref 128517 z 1999 to ref 128901
 dirscanvas 130181 z 1000 linkcanvas_ref 129029
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "5 create new instances" xyz 448 275 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "5 create new instances" xyz 441 280 3000
 linkcanvas 129925
   from ref 128517 z 1999 to ref 129797
 dirscanvas 130053 z 1000 linkcanvas_ref 129925
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "4 retrieve existing object" xyz 436 403 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "4 retrieve existing object" xyz 431 392 3000
 linkcanvas 130309
   from ref 128901 z 1999 to ref 128005
 msgs
@@ -65,4 +65,5 @@ msgs
     forward ranks 6 "3" dirscanvas_ref 129413
     no_msg
 msgsend
+preferred_whz 602 522 1
 end
diff --git a/uml/lumiera/131973.diagram b/uml/lumiera/131973.diagram
index dda416518..954d4ba3f 100644
--- a/uml/lumiera/131973.diagram
+++ b/uml/lumiera/131973.diagram
@@ -1,85 +1,93 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 131717 // ProcNode
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 103 405 2004
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 89 311 2009
+end
 classcanvas 128517 class_ref 132741 // State
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 77 18 2000
-  end
+end
 classcanvas 129669 class_ref 133253 // Frame
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 264 313 3005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 264 236 3005
+end
 classcanvas 131845 class_ref 142469 // StateProxy
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 126 220 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 124 176 2000
+end
 classcanvas 131973 class_ref 142597 // StateAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 40 317 3010
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 37 240 3010
+end
 classcanvas 132357 class_ref 142725 // WiringDescriptor
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   hidden_operations
     operation_ref 136453 // callDown
-  xyz 229 498 2000
-  end
+  xyz 197 411 2000
+end
 classcanvas 135045 class_ref 143365 // NodeWiring
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 241 561 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 210 484 2000
+end
 textcanvas 135685 "determines concrete Type"
-  xyzwh 100 594 2004 130 18
+  xyzwh 79 499 2004 130 18
 relationcanvas 129797 relation_ref 134533 // <unidirectional association>
   from ref 128517 z 1999 stereotype "<<vector>>" xyz 277 115 3000 to point 300 136
   line 130053 z 1999 to ref 129669
-  role_a_pos 312 288 3000 no_role_b
+  role_a_pos 312 218 3000 no_role_b
   no_multiplicity_a multiplicity_b_pos 173 109 3000
+end
 relationcanvas 132101 relation_ref 148869 // <generalisation>
   geometry VHV unfixed
-  from ref 131973 z 1999 to point 78 186
-  line 134021 z 1999 to point 118 186
+  from ref 131973 z 1999 to point 72 152
+  line 134021 z 1999 to point 116 152
   line 134149 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132229 relation_ref 148997 // <generalisation>
   geometry VHV
-  from ref 131845 z 1999 to point 178 186
-  line 134277 z 1999 to point 118 186
+  from ref 131845 z 1999 to point 175 152
+  line 134277 z 1999 to point 116 152
   line 134405 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 132485 relation_ref 149125 // <directional aggregation by value>
+end
+relationcanvas 132485 relation_ref 149125 // <directional composition>
   geometry HV
-  from ref 128005 z 1999 stereotype "<<array>>" xyz 205 454 3000 to point 277 452
+  from ref 128005 z 1999 stereotype "<<array>>" xyz 180 355 3000 to point 242 350
   line 133381 z 1999 to ref 132357
-  role_a_pos 289 473 3000 no_role_b
-  multiplicity_a_pos 265 473 3000 no_multiplicity_b
+  role_a_pos 254 393 3000 no_role_b
+  multiplicity_a_pos 230 393 3000 no_multiplicity_b
+end
 relationcanvas 133509 relation_ref 149253 // <unidirectional association>
-  from ref 131973 z 1999 to point 178 312
+  from ref 131973 z 1999 to point 174 262
   line 133637 z 1999 to ref 131845
-  role_a_pos 190 293 3000 no_role_b
-  multiplicity_a_pos 164 293 3000 no_multiplicity_b
+  role_a_pos 186 238 3000 no_role_b
+  multiplicity_a_pos 160 238 3000 no_multiplicity_b
+end
 relationcanvas 134533 relation_ref 149381 // <unidirectional association>
   from ref 131973 z 3004 to ref 129669
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135173 relation_ref 149509 // <generalisation>
   from ref 135045 z 1999 to ref 132357
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135301 relation_ref 149637 // <dependency>
   geometry VHr
-  from ref 135045 z 1999 to point 78 596
+  from ref 135045 z 1999 to point 72 513
   line 135557 z 1999 to ref 131973
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 line 134661 -_-_
   from ref 131973 z 2003 to ref 128005
 line 134789 -_-_
-  from ref 131973 z 2003 to point 134 414
+  from ref 131973 z 2003 to point 107 352
   line 134917 z 2003 to ref 128005
-preferred_whz 414 544 1
+preferred_whz 385 602 1
 end
diff --git a/uml/lumiera/132229.diagram b/uml/lumiera/132229.diagram
index af599827d..7b8f49cf9 100644
--- a/uml/lumiera/132229.diagram
+++ b/uml/lumiera/132229.diagram
@@ -1,112 +1,112 @@
-format 40
+format 58
 
 classinstancecanvas 128261 classinstance_ref 136197 // node1
-  xyz 152 504 2000
-  end
+  xyz 139 468 2000
+end
 classinstancecanvas 128389 classinstance_ref 136325 // ad1
-  xyz 191 393 2000
-  end
+  xyz 189 366 2000
+end
 classinstancecanvas 128517 classinstance_ref 136453 // current
   xyz 188 92 2000
-  end
+end
 classinstancecanvas 128645 classinstance_ref 136581 // node2
-  xyz 388 393 2000
-  end
+  xyz 386 366 2000
+end
 classinstancecanvas 128773 classinstance_ref 136709 // ad2
-  xyz 422 301 2000
-  end
+  xyz 419 281 2000
+end
 classinstance 128901 class_ref 143109 // BackendCache
  name ""  xyz 692 12 2000
 classinstance 129029 class_ref 143237 // Caller
- name ""  xyz 28 505 2000
+ name ""  xyz 28 468 2000
 classinstancecanvas 130949 classinstance_ref 136837 // node3
-  xyz 625 300 2000
-  end
+  xyz 622 281 2000
+end
 classinstancecanvas 131077 classinstance_ref 136965 // ad3
-  xyz 665 199 2000
-  end
+  xyz 651 196 2000
+end
 textcanvas 133381 "node1 using node2 as predecessor; calculates in-place, will push result to Cache"
-  xyzwh 149 538 2000 408 21
+  xyzwh 139 496 2000 408 21
 textcanvas 133509 "node2 using node3 as predecessor. Calculates without caching"
-  xyzwh 385 427 2005 350 18
+  xyzwh 386 393 2005 350 18
 textcanvas 133637 "node3 doesn't calc, but fetch result from Cache"
-  xyzwh 564 329 2000 231 18
+  xyzwh 544 308 2000 231 18
 linkcanvas 129157
   from ref 129029 z 1999 to ref 128261
 dirscanvas 129285 z 1000 linkcanvas_ref 129157
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "1 pull()" xyz 97 480 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "1 pull()" xyz 82 455 3000
 linkcanvas 129413
   from ref 128261 z 1999 to ref 128389
 dirscanvas 130309 z 1000 linkcanvas_ref 129413
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "2 retrieve()" xyz 141 437 3000
-  backward_label "16 process()" xyz 236 471 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "2 retrieve()" xyz 150 398 3000
+  backward_label "16 process()" xyz 218 445 3000
 linkcanvas 129541
   from ref 128389 z 1999 to ref 128517
 dirscanvas 131717 z 1000 linkcanvas_ref 129541
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   forward_label "3 fetch()
 11 allocateBuffer()
-17 isCalculated()" xyz 128 228 3000
+17 isCalculated()" xyz 133 219 3000
 linkcanvas 129669
   from ref 128389 z 1999 to ref 128645
 dirscanvas 130437 z 1000 linkcanvas_ref 129669
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "4 pull()" xyz 319 369 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "4 pull()" xyz 311 354 3000
 linkcanvas 129797
   from ref 128645 z 1999 to ref 128773
 dirscanvas 130693 z 1000 linkcanvas_ref 129797
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "5 retrieve()" xyz 379 349 3000
-  backward_label "13 process()" xyz 469 372 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "5 retrieve()" xyz 386 312 3000
+  backward_label "13 process()" xyz 464 348 3000
 linkcanvas 130181
   from ref 128773 z 1999 to ref 128517
 dirscanvas 133765 z 1000 linkcanvas_ref 130181
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "14 releaseBuffer()" xyz 285 227 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "14 releaseBuffer()" xyz 288 216 3000
 linkcanvas 131205
   from ref 128773 z 1999 to ref 130949
 dirscanvas 131845 z 1000 linkcanvas_ref 131205
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "6 pull()" xyz 553 276 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "6 pull()" xyz 543 269 3000
 linkcanvas 131333
   from ref 130949 z 1999 to ref 131077
 dirscanvas 131973 z 1000 linkcanvas_ref 131333
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "7 retrieve()" xyz 615 236 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "7 retrieve()" xyz 619 229 3000
 linkcanvas 131461
   from ref 131077 z 1999 to ref 128517
 dirscanvas 132101 z 1000 linkcanvas_ref 131461
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "8 fetch()" xyz 449 179 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "8 fetch()" xyz 442 173 3000
 linkcanvas 131589
-  from ref 128517 z 1999 to point 295 24
+  from ref 128517 z 1999 to point 311 22
   line 134277 z 1999 to ref 128901
 dirscanvas 132229 z 1000 linkcanvas_ref 134277
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   forward_label "9 fetch
 12 allocateNewFrame
 15 releaseFrame
 18 isCalculatedFrame
-20 releaseFrame" xyz 487 29 3000
+20 releaseFrame" xyz 452 28 3000
 linkcanvas 132357
-  from ref 131077 z 1999 to point 515 211
+  from ref 131077 z 1999 to point 506 205
   line 132613 z 1999 to ref 128773
 dirscanvas 132741 z 1000 linkcanvas_ref 132357
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
 linkcanvas 132485
-  from ref 128773 z 1999 to point 280 312
+  from ref 128773 z 1999 to point 280 290
   line 132869 z 1999 to ref 128389
 dirscanvas 132997 z 1000 linkcanvas_ref 132485
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "10 allocateBuffer()" xyz 306 293 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "10 allocateBuffer()" xyz 302 277 3000
 linkcanvas 133893
   from ref 129029 z 1999 to point 49 155
   line 134021 z 1999 to ref 128517
 dirscanvas 134149 z 1000 linkcanvas_ref 134021
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
-  forward_label "19 releaseBuffer()" xyz 65 100 3000
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+  forward_label "19 releaseBuffer()" xyz 80 107 3000
 msgs
   msg operation_ref 135685 // "pull()"
     forward ranks 1 "1" dirscanvas_ref 129285
@@ -181,4 +181,5 @@ msgs
 	no_msg
     msgsend
 msgsend
+preferred_whz 799 575 1
 end
diff --git a/uml/lumiera/132357.diagram b/uml/lumiera/132357.diagram
index 5a7ffa76a..d7c671f89 100644
--- a/uml/lumiera/132357.diagram
+++ b/uml/lumiera/132357.diagram
@@ -1,172 +1,193 @@
-format 40
+format 58
 
 classcanvas 128133 class_ref 143493 // OperationBase
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 232 13 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 233 13 2000
+end
 classcanvas 128261 class_ref 143621 // QueryCache
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 186 252 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 189 252 2000
+end
 classcanvas 128517 class_ref 143877 // ReadSource
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 297 165 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 300 164 1984
+end
 classcanvas 130309 class_ref 144005 // BuffTable
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 100 508 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 106 508 2000
+end
 classcanvas 130437 class_ref 142725 // WiringDescriptor
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 82 319 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 88 321 2005
+end
 classcanvas 130565 class_ref 144133 // BuffHandle
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 169 563 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 173 555 2000
+end
 textcanvas 131461 "const"
-  xyzwh 101 388 2010 29 18
+  xyzwh 105 391 2010 29 18
 classcanvas 131717 class_ref 144261 // Invocation
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   color lightorange
   xyz 31 439 2000
-  end
+end
 classcanvas 131845 class_ref 143365 // NodeWiring
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 222 423 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 222 427 2005
+end
 classcanvas 131973 class_ref 142597 // StateAdapter
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 25 230 2005
-  end
+end
 classcanvas 132357 class_ref 144389 // ProcessData
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 186 140 2015
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 188 140 2015
+end
 classcanvas 132997 class_ref 144517 // Strategy
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 199 319 3010
-  end
+end
 classcanvas 133253 class_ref 144517 // Strategy
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 301 301 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 298 307 1994
+end
 classcanvas 134021 class_ref 144645 // FeedCache
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 190 80 2010
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 192 80 2010
+end
 classcanvas 134533 class_ref 144389 // ProcessData
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 238 125 2004
-  end
+end
 classcanvas 134661 class_ref 144517 // Strategy
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 250 309 3005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 249 312 1999
+end
 textcanvas 137477 "as configured"
-  xyzwh 308 376 3010 68 18
+  xyzwh 303 375 3010 68 18
 classcanvas 137733 class_ref 143749 // PullInput
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 194 198 2010
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 198 198 2014
+end
 classcanvas 137861 class_ref 143749 // PullInput
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 247 184 2005
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 248 188 1989
+end
 textcanvas 139781 "Policy Classes"
-  xyzwh 163 50 2005 81 21
-relationcanvas 130693 relation_ref 150405 // <directional aggregation by value>
+  xyzwh 167 54 2005 81 21
+relationcanvas 130693 relation_ref 150405 // <directional composition>
   geometry VHr
-  from ref 130309 z 1999 stereotype "<<array>>" xyz 177 517 3000 to point 203 536
+  from ref 130309 z 1999 stereotype "<<array>>" xyz 180 514 3000 to point 203 532
   line 130821 z 1999 to ref 130565
   no_role_a no_role_b
-  multiplicity_a_pos 211 537 3000 no_multiplicity_b
+  multiplicity_a_pos 179 537 3000 no_multiplicity_b
+end
 relationcanvas 130949 relation_ref 150533 // <unidirectional association>
   from ref 130309 z 1999 to ref 130437
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132229 relation_ref 149509 // <generalisation>
   from ref 131845 z 2004 to point 219 401
   line 137605 z 2004 to point 162 401
   line 137221 z 2004 to ref 130437
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133381 relation_ref 151301 // <generalisation>
   from ref 133253 z 1999 to point 333 274
   line 137349 z 1999 to ref 128517
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135685 relation_ref 152197 // <unidirectional association>
   from ref 131717 z 1999 to ref 131973
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135813 relation_ref 152325 // <unidirectional association>
   from ref 131717 z 1999 to ref 130437
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 135941 relation_ref 152453 // <unidirectional association>
   geometry VH
-  from ref 131717 z 1999 to point 63 536
+  from ref 131717 z 1999 to point 60 532
   line 137093 z 1999 to ref 130309
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136069 relation_ref 152581 // <association>
   from ref 131845 z 2004 to ref 132997
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136197 relation_ref 152709 // <association>
   from ref 131845 z 2004 to ref 134661
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136325 relation_ref 152837 // <association>
   from ref 131845 z 2004 to ref 133253
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 136453 relation_ref 152965 // <unidirectional association>
-  from ref 131845 z 1999 stereotype "<<creates>>" xyz 145 441 3000 to ref 131717
+  from ref 131845 z 1999 stereotype "<<creates>>" xyz 145 443 3000 to ref 131717
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 137989 relation_ref 153093 // <generalisation>
   from ref 132997 z 1999 to point 222 316
   line 139653 z 1999 to ref 128261
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138117 relation_ref 153221 // <generalisation>
   from ref 128261 z 1999 to ref 137733
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138245 relation_ref 153349 // <generalisation>
   from ref 137733 z 2009 to ref 132357
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138373 relation_ref 153477 // <generalisation>
   from ref 132357 z 2009 to ref 134021
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138501 relation_ref 153605 // <generalisation>
   geometry VHV unfixed
   from ref 134021 z 1999 to point 223 68
-  line 138885 z 1999 to point 275 68
+  line 138885 z 1999 to point 273 68
   line 139013 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138629 relation_ref 153733 // <generalisation>
   geometry VHV unfixed
-  from ref 128517 z 1999 to point 333 68
-  line 139141 z 1999 to point 275 68
+  from ref 128517 z 1999 to point 334 68
+  line 139141 z 1999 to point 273 68
   line 139269 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 138757 relation_ref 153861 // <generalisation>
   from ref 134533 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139397 relation_ref 153989 // <generalisation>
   from ref 134661 z 2004 to ref 137861
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 139525 relation_ref 154117 // <association>
   from ref 137861 z 2003 to ref 134533
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
+preferred_whz 413 655 1
+end
diff --git a/uml/lumiera/132741.diagram b/uml/lumiera/132741.diagram
index c3a8d44f4..68f793cd6 100644
--- a/uml/lumiera/132741.diagram
+++ b/uml/lumiera/132741.diagram
@@ -1,153 +1,174 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 145669 // Project
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 161 115 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 141 110 2000
+end
 classcanvas 128133 class_ref 145541 // Timeline
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 177 222 2000
-  end
+end
 classcanvas 128261 class_ref 145797 // TimelineView
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 163 323 2000
-  end
+end
 classcanvas 128645 class_ref 145925 // PlayControl
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 315 223 2000
-  end
+end
 classcanvas 128773 class_ref 146053 // Monitor
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 456 90 2000
-  end
+end
 classcanvas 128901 class_ref 146181 // RenderTask
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 456 32 2000
-  end
+end
 classcanvas 129029 class_ref 146309 // Sequence
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 41 323 2000
-  end
+end
 classcanvas 130437 class_ref 138117 // Pipe
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 317 294 2000
-  end
+end
 classcanvas 132101 class_ref 146437 // PlayheadCursor
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 452 222 2000
-  end
+end
 classcanvas 132997 class_ref 128389 // Track
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 99 611 2000
-  end
+end
 classcanvas 133125 class_ref 128517 // MObject
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 163 485 2000
-  end
+end
 classcanvas 133253 class_ref 129029 // Effect
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 211 611 2000
-  end
+end
 classcanvas 133381 class_ref 129669 // Label
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 259 611 2000
-  end
+end
 classcanvas 133509 class_ref 128901 // Clip
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 163 611 2000
-  end
+end
 relationcanvas 128389 relation_ref 154757 // <realization>
   from ref 128261 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 129157 relation_ref 154885 // <aggregation by value>
+end
+relationcanvas 129157 relation_ref 154885 // <composition>
   from ref 128005 z 1999 to ref 128133
   no_role_a no_role_b
-  multiplicity_a_pos 173 197 3000 multiplicity_b_pos 173 166 3000
+  multiplicity_a_pos 168 204 3000 multiplicity_b_pos 156 154 3000
+end
 relationcanvas 129285 relation_ref 155013 // <unidirectional association>
   from ref 128133 z 1999 stereotype "<<own>>" xyz 251 226 3000 to ref 128645
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 129413 relation_ref 155141 // <aggregation by value>
+end
+relationcanvas 129413 relation_ref 155141 // <composition>
   geometry VHr
-  from ref 128005 z 1999 to point 71 134
+  from ref 128005 z 1999 to point 69 127
   line 129541 z 1999 to ref 129029
   no_role_a no_role_b
-  multiplicity_a_pos 47 298 3000 multiplicity_b_pos 144 145 3000
+  multiplicity_a_pos 45 305 3000 multiplicity_b_pos 124 135 3000
+end
 relationcanvas 129669 relation_ref 155269 // <unidirectional association>
   from ref 128133 z 1999 to ref 129029
   no_role_a no_role_b
   multiplicity_a_pos 113 322 3000 no_multiplicity_b
+end
 relationcanvas 129797 relation_ref 155397 // <unidirectional association>
   from ref 128261 z 1999 to ref 129029
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 129925 relation_ref 155525 // <unidirectional association>
-  from ref 129029 z 1999 stereotype "<<contains>>" xyz 33 389 3000 to point 71 387
+  from ref 129029 z 1999 stereotype "<<contains>>" xyz 31 390 3000 to point 69 387
   line 130309 z 1999 to point 46 387
   line 130181 z 1999 to ref 129029
-  role_a_pos 23 401 3000 no_role_b
-  multiplicity_a_pos 42 369 3000 multiplicity_b_pos 75 369 3000
-relationcanvas 130565 relation_ref 155653 // <directional aggregation by value>
-  from ref 128133 z 1999 stereotype "<<list>>" xyz 265 265 3000 to point 263 281
+  role_a_pos 33 399 3000 no_role_b
+  multiplicity_a_pos 76 370 3000 multiplicity_b_pos 38 366 3000
+end
+relationcanvas 130565 relation_ref 155653 // <directional composition>
+  from ref 128133 z 1999 stereotype "<<list>>" xyz 263 267 3000 to point 263 281
   line 131077 z 1999 to point 303 281
   line 131205 z 1999 to ref 130437
-  role_a_pos 242 280 3000 no_role_b
+  role_a_pos 240 283 3000 no_role_b
   multiplicity_a_pos 322 279 3000 multiplicity_b_pos 237 268 3000
+end
 relationcanvas 131589 relation_ref 155781 // <unidirectional association>
-  from ref 128773 z 1999 stereotype "<<attach>>" xyz 274 147 3000 to point 282 172
+  from ref 128773 z 1999 stereotype "<<attach>>" xyz 275 150 3000 to point 282 172
   line 131845 z 1999 to ref 128133
   no_role_a no_role_b
   multiplicity_a_pos 221 180 3000 no_multiplicity_b
+end
 relationcanvas 131717 relation_ref 155909 // <unidirectional association>
   from ref 128901 z 1999 to point 272 156
   line 131973 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132229 relation_ref 156037 // <unidirectional association>
   from ref 128645 z 1999 stereotype "<<direct>>" xyz 391 226 3000 to ref 132101
   no_role_a no_role_b
   multiplicity_a_pos 436 247 3000 no_multiplicity_b
+end
 relationcanvas 132357 relation_ref 156165 // <association>
   from ref 128773 z 1999 to ref 132101
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 132485 relation_ref 156293 // <association>
   from ref 128261 z 1999 to point 478 341
   line 132613 z 1999 to ref 132101
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133765 relation_ref 156421 // <realization>
   from ref 133509 z 1999 to ref 133125
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 133893 relation_ref 156549 // <realization>
   from ref 133253 z 1999 to ref 133125
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134021 relation_ref 156677 // <realization>
   from ref 133381 z 1999 to ref 133125
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134149 relation_ref 156805 // <realization>
   from ref 132997 z 1999 to ref 133125
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134405 relation_ref 156933 // <unidirectional association>
-  from ref 129029 z 1999 to point 99 363
+  from ref 129029 z 1999 to point 95 357
   line 134533 z 1999 to ref 133125
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
+end
 relationcanvas 134661 relation_ref 157061 // <unidirectional association>
-  from ref 129029 z 1999 to point 99 364
+  from ref 129029 z 1999 to point 94 357
   line 134789 z 1999 to point 118 463
   line 134917 z 1999 to ref 132997
   role_a_pos 68 538 3000 no_role_b
   multiplicity_a_pos 104 586 3000 no_multiplicity_b
-relationcanvas 135045 relation_ref 145029 // <directional aggregation by value>
-  from ref 132997 z 1999 stereotype "<<vector>>" xyz 35 599 3000 to point 70 630
-  line 135173 z 1999 to point 70 661
-  line 135301 z 1999 to ref 132997
-  role_a_pos 37 612 3000 no_role_b
-  multiplicity_a_pos 91 657 3000 no_multiplicity_b
+end
+relationcanvas 135045 relation_ref 145029 // <directional composition>
+  from ref 132997 z 1999 stereotype "<<vector>>" xyz 36 602 3000 to point 67 628
+  line 135173 z 1999 to point 67 660
+  line 135301 z 1999 to ref 132997
+  role_a_pos 39 612 3000 no_role_b
+  multiplicity_a_pos 84 643 3000 no_multiplicity_b
+end
+preferred_whz 585 732 1
 end
diff --git a/uml/lumiera/132869.diagram b/uml/lumiera/132869.diagram
index 654d09664..f90a3a869 100644
--- a/uml/lumiera/132869.diagram
+++ b/uml/lumiera/132869.diagram
@@ -1,75 +1,85 @@
-format 40
+format 58
 
 classcanvas 128005 class_ref 146565 // Facade
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 66 14 2000
-  end
+end
 classcanvas 128133 class_ref 146693 // Proxy
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 23 116 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 23 110 2000
+end
 classcanvas 128261 class_ref 146821 // ServiceImpl
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 271 198 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 271 182 2000
+end
 classcanvas 128389 class_ref 146949 // C_Interface
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 136 117 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 136 110 2000
+end
 classcanvas 128517 class_ref 147077 // C_Instance
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 137 197 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 137 182 2000
+end
 classcanvas 128645 class_ref 147205 // InstanceHandle
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
-  xyz 171 277 2000
-  end
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 179 268 2005
+end
 textcanvas 130309 "conceptually equivalent"
-  xyzwh 165 11 2000 115 18
-relationcanvas 128773 relation_ref 157189 // <realization>
+  xyzwh 160 7 2000 115 18
+relationcanvas 131461 relation_ref 159877 // <realization>
   geometry VHV
-  from ref 128133 z 1999 to point 43 95
-  line 129157 z 1999 to point 103 95
-  line 129285 z 1999 to ref 128005
+  from ref 128133 z 1999 to point 43 88
+  line 131973 z 1999 to point 102 88
+  line 132101 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 128901 relation_ref 157317 // <realization>
+end
+relationcanvas 131589 relation_ref 160005 // <realization>
   geometry VHV unfixed
-  from ref 128261 z 1999 to point 305 95
-  line 129413 z 1999 to point 103 95
-  line 129541 z 1999 to ref 128005
+  from ref 128261 z 1999 to point 304 88
+  line 131717 z 1999 to point 102 88
+  line 131845 z 1999 to ref 128005
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 129029 relation_ref 157445 // <realization>
+end
+relationcanvas 132229 relation_ref 160133 // <unidirectional association>
+  from ref 128133 z 1999 stereotype "<<uses>>" xyz 74 129 3000 to ref 128389
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 132357 relation_ref 160261 // <realization>
   from ref 128517 z 1999 to ref 128389
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
-relationcanvas 129669 relation_ref 157573 // <unidirectional association>
-  from ref 128133 z 1999 stereotype "<<uses>>" xyz 75 135 3000 to ref 128389
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 129797 relation_ref 157701 // <unidirectional association>
-  from ref 128517 z 1999 stereotype "<<calls>>" xyz 213 216 3000 to ref 128261
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 130437 relation_ref 157829 // <unidirectional association>
-  geometry HVr
-  from ref 128261 z 1999 stereotype "<<has_a>>" xyz 279 305 3000 to point 305 305
-  line 130565 z 1999 to ref 128645
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 130693 relation_ref 157957 // <dependency>
-  from ref 128645 z 1999 stereotype "<<opens>>" xyz 112 281 3000 to point 104 296
-  line 130821 z 1999 to point 104 213
-  line 130949 z 1999 to ref 128517
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-relationcanvas 131077 relation_ref 158085 // <dependency>
-  from ref 128645 z 1999 stereotype "<<creates>>" xyz 88 306 3000 to point 89 305
-  line 131205 z 1999 to ref 128133
-  no_role_a no_role_b
-  no_multiplicity_a no_multiplicity_b
-line 130053 -_-_
-  from ref 128005 z 1999 to point 224 27
-  line 130181 z 1999 to ref 128389
+end
+relationcanvas 132485 relation_ref 160389 // <unidirectional association>
+  from ref 128517 z 1999 stereotype "<<calls>>" xyz 211 201 3000 to ref 128261
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 132613 relation_ref 160517 // <unidirectional association>
+  geometry HVr
+  from ref 128261 z 1999 stereotype "<<has_a>>" xyz 279 295 3000 to point 304 292
+  line 132741 z 1999 to ref 128645
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 132869 relation_ref 160645 // <dependency>
+  from ref 128645 z 1999 stereotype "<<opens>>" xyz 118 279 3000 to point 103 292
+  line 132997 z 1999 to point 103 198
+  line 133125 z 1999 to ref 128517
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 133253 relation_ref 160773 // <dependency>
+  from ref 128645 z 1999 to point 195 306
+  line 133509 z 1999 to point 43 306
+  line 133381 z 1999 stereotype "<<creates>>" xyz 114 308 3000 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+line 130053 -_-_
+  from ref 128005 z 1999 to point 215 19
+  line 130181 z 1999 to ref 128389
+preferred_whz 369 421 1
 end
diff --git a/uml/lumiera/5.session b/uml/lumiera/5.session
index 83fe86cc6..05da50f1a 100644
--- a/uml/lumiera/5.session
+++ b/uml/lumiera/5.session
@@ -1,48 +1,20 @@
-window_sizes 1302 1004 270 1022 854 71
-diagrams
-  classdiagram_ref 128133 // Session structure
-    853 742 100 4 120 0
-  classdiagram_ref 132741 // TimelineSequences
-    585 732 100 4 0 0
-  active  classdiagram_ref 132869 // Layer Separation Interface
-    373 417 100 4 0 0
-end
+window_sizes 1302 1004 270 1022 856 71
 show_stereotypes
 selected 
   package_ref 129 // lumiera
 open
-  class_ref 145925 // PlayControl
-  deploymentview_ref 128261 // gen
-  deploymentview_ref 129157 // gen
+  componentview_ref 128005 // Architecture
+  classview_ref 129413 // Project Entities
   
-  package_ref 130181 // mobject
-  classview_ref 128389 // Controller Workings
-  class_ref 139653 // Session
-  class_ref 128005 // SessionImpl
-  class_ref 145541 // Timeline
-  class_ref 145797 // TimelineView
-  class_ref 128133 // Seq
-  class_ref 128389 // Track
-  class_ref 128901 // Clip
-  class_ref 129029 // Effect
+  package_ref 128645 // codegen
   
-  package_ref 128901 // Builder
-  class_ref 131717 // ProcNode
-  class_ref 142469 // StateProxy
-  class_ref 142597 // StateAdapter
-  class_ref 142725 // WiringDescriptor
-  class_ref 143365 // NodeWiring
-  class_ref 143621 // QueryCache
-  class_ref 143749 // PullInput
-  class_ref 143877 // ReadSource
-  class_ref 144389 // ProcessData
-  class_ref 144645 // FeedCache
-  class_ref 144517 // Strategy
-  class_ref 144005 // BuffTable
-  class_ref 144261 // Invocation
+  package_ref 128133 // Asset
+  
+  package_ref 129029 // Control
+  
+  package_ref 128261 // MObject
+  classview_ref 128133 // Engine Workings
   classview_ref 129541 // InterfaceSystem
   classview_ref 129285 // StreamType
-  classview_ref 128773 // error
-  class_ref 140165 // Visitable
 end
 end
diff --git a/uml/lumiera/generation_settings b/uml/lumiera/generation_settings
index ef601c3bd..7ce8e827c 100644
--- a/uml/lumiera/generation_settings
+++ b/uml/lumiera/generation_settings
@@ -1,6 +1,6 @@
 
   cpp_default_defs 
-  cpp_h_extension "hpp" cpp_src_extension "cpp" java_extension "java" idl_extension "idl"
+  cpp_h_extension "hpp" cpp_src_extension "cpp" java_extension "java" php_extension "php" python_extension "py" idl_extension "idl"
   cpp_include_with_path
   cpp_root_relative_path
   cpp_javadoc_comment
@@ -22,26 +22,26 @@
     "double" "double" "double" "double" "${type}" "${type} &" "${type} &" "${type}"
     "string" "string" "String" "string" "${type}" "${type} &" "${type} &" "${type}"
   
-  relations_stereotypes 4 // uml cpp java idl
-    "sequence" "vector" "Vector" "sequence"
-    "vector" "vector" "Vector" "sequence"
-    "list" "list" "Vector" "sequence"
-    "set" "set" "Vector" "sequence"
+  relations_stereotypes 4 // uml cpp java pythonidl
+    "sequence" "vector" "Vector" "list" "sequence"
+    "vector" "vector" "Vector" "list" "sequence"
+    "list" "list" "Vector" "list" "sequence"
+    "set" "set" "Vector" "set" "sequence"
   
-  classes_stereotypes 13 // uml cpp java idl
-    "class" "class" "class" "valuetype"
-    "interface" "class" "interface" "interface"
-    "exception" "class" "class" "exception"
-    "enum" "enum" "enum" "enum"
-    "enum_pattern" "enum" "enum_pattern" "enum"
-    "struct" "struct" "class" "struct"
-    "union" "union" "class" "union"
-    "typedef" "typedef" "ignored" "typedef"
-    "boundary" "class" "class" "interface"
-    "control" "class" "class" "valuetype"
-    "entity" "class" "class" "valuetype"
-    "actor" "ignored" "ignored" "ignored"
-    "@interface" "ignored" "@interface" "ignored"
+  classes_stereotypes 13 // uml cpp java php python idl
+    "class" "class" "class" "class" "class" "valuetype"
+    "interface" "class" "interface" "interface" "class" "interface"
+    "exception" "class" "class" "class" "class" "exception"
+    "enum" "enum" "enum" "enum" "enum" "enum"
+    "enum_pattern" "enum" "enum_pattern" "enum" "enum" "enum"
+    "struct" "struct" "class" "class" "class" "struct"
+    "union" "union" "class" "class" "class" "union"
+    "typedef" "typedef" "ignored" "ignored" "ignored" "typedef"
+    "boundary" "class" "class" "class" "class" "interface"
+    "control" "class" "class" "class" "class" "valuetype"
+    "entity" "class" "class" "class" "class" "valuetype"
+    "actor" "ignored" "ignored" "ignored" "ignored" "ignored"
+    "@interface" "ignored" "@interface" "ignored" "ignored" "ignored"
   
   cpp_enum_default_type_forms "${type}" "${type} &" "${type}&" "${type}" // in out inout return
   other_cpp_types_default_type_forms "const ${type}&" "${type} &" "${type}&" "${type}" // in out inout return
@@ -103,7 +103,11 @@ ${items}
   cpp_default_typedef_decl "${comment}typedef ${type} ${name};
 "
   cpp_default_attribute_declaration "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
-"
+" // multiplicity 1
+  "    ${comment}${static}${mutable}${volatile}${const}${stereotype}<${type}> ${name}${value};
+" // multiplicity * a..b
+  "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${multiplicity}${value};
+" // multiplicity [..]
   cpp_default_enum_item_declaration "  ${name}${value},	${comment}"
   cpp_association_aggregation_declaration
     "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
@@ -162,7 +166,11 @@ ${cases}    default: throw new Error();
 }
 "
   java_default_attribute_declaration "  ${comment}${@}${visibility}${static}${final}${transient}${volatile}${type} ${name}${value};
-"
+" // multiplicity 1
+  "  ${comment}${@}${visibility}${static}${final}${transient}${volatile}${stereotype}<${type}> ${name}${value};
+" // multiplicity * a..b
+  "  ${comment}${@}${visibility}${static}${final}${transient}${volatile}${type}${multiplicity} ${name}${value};
+" // multiplicity N
   java5_default_enum_item_declaration "  ${@}${name}${value},${comment}"
   java_default_enum_item_declaration "  ${comment}${@}public static final int _${name}${value};
 public static final ${class} ${name} = new ${class}(_${name});
@@ -181,6 +189,64 @@ public static final ${class} ${name} = new ${class}(_${name});
   java_default_operation_definition "  ${comment}${@}${visibility}${final}${static}${abstract}${synchronized}${type} ${name}${(}${)}${throws}${staticnl}{
   ${body}}
 "
+  php_default_src_content "<?php
+${comment}
+${definition}
+?>
+"
+  php_default_class_decl "${comment}${final}${visibility}${abstract}class ${name}${extends}${implements} {
+${members}}
+"
+  php_default_enum_decl "${comment}${visibility}final class ${name} {
+${items}}
+"
+  php_default_external_class_decl "${name}"
+  php_default_interface_decl "${comment}${visibility}interface ${name} {
+${members}}
+"
+  php_default_attribute_declaration "  ${comment}${visibility}${const}${static}${var}${name}${value};
+"
+  php_default_enum_item_decl "  const ${name}${value};${comment}
+"
+  php_default_relation_declaration"  ${comment}${visibility}${const}${static}${var}${name}${value};
+"
+  php_get "get${Name}" final
+  php_set "set${Name}"
+  php_default_operation_definition "  ${comment}${final}${visibility}${abstract}${static}function ${name}${(}${)}
+{
+  ${body}}
+"
+  python_2_2
+  python_indent_step "    "
+  python_default_src_content "${comment}
+${import}
+${definition}"
+  python_default_class_decl "class ${name}${inherit}:
+${docstring}${members}
+"
+  python_default_enum_decl "class ${name}:
+${docstring}${members}
+"
+  python_default_external_class_decl "${name}"
+  python_default_attribute_declaration "${comment}${self}${name} = ${value}
+" // multiplicity 1
+  "${comment}${self}${name} = ${stereotype}()
+" // multiplicity != 1
+  python_default_enum_item_decl "${comment}${self}${name} = ${value}
+"
+  python_default_relation_declaration"${comment}${self}${name} = ${value}
+" // multiplicity 1
+  "${comment}${self}${name} = ${stereotype}()
+" // multiplicity != 1
+  python_default_composition_declaration"${comment}${self}${name} = ${type}()
+" // multiplicity 1
+  "${comment}${self}${name} = ${stereotype}()
+" // multiplicity != 1
+  python_default_operation_definition "${@}${static}${abstract}def ${name}${(}${)}:
+${docstring}${body}
+"
+  python_get "get${Name}"
+  python_set "set${Name}"
   idl_default_src_content "#ifndef ${MODULE}_${NAME}_H
 #define ${MODULE}_${NAME}_H
 
@@ -215,13 +281,27 @@ ${items}};
 #include \"${name}.idl\"
 "
   idl_default_attribute_declaration "  ${comment}${readonly}${attribute} ${type} ${name};
-"
+" // multiplicity 1
+  "  ${comment}${readonly}${attribute}${stereotype}<${type}> ${name};
+" // multiplicity * a..b
+  "  ${comment}${readonly}${attribute}${stereotype}<${type},${multiplicity}> ${name};
+" // multiplicity N
   idl_default_valuetype_attribute_declaration "  ${comment}${visibility}${type} ${name};
-"
+" // multiplicity 1
+  "  ${comment}${visibility}${stereotype}<${type}> ${name};
+" // multiplicity * a..b
+  "  ${comment}${visibility}${stereotype}<${type},${multiplicity}> ${name};
+" // multiplicity N
   idl_default_const_declaration "  ${comment}const ${type} ${name}${value};
-"
+" // multiplicity 1
+  "  ${comment}const ${stereotype}<${type}> ${name}${value};
+" // multiplicity * a..b
+  "  ${comment}const ${stereotype}<${type},${multiplicity}> ${name}${value};
+" // multiplicity N
   idl_default_enum_item_declaration "  ${name},${comment}"
-  idl_default_union_item_declaration "  ${comment}case ${case} : ${readonly}${type} ${name};"
+  idl_default_union_item_declaration "  ${comment}case ${case} : ${readonly}${type} ${name};" // multiplicity 1
+  "  ${comment}case ${case} : ${readonly}${stereotype}<${type}> ${name};" // multiplicity * a..b
+  "  ${comment}case ${case} : ${readonly}${stereotype}<${type},${multiplicity}> ${name};" // multiplicity N
   idl_association_aggregation_declaration
     "  ${comment}${readonly}${attribute} ${type} ${name};
 " // multiplicity 1
diff --git a/uml/lumiera/lumiera.prj b/uml/lumiera/lumiera.prj
index 212f6ce25..a0b1cba7b 100644
--- a/uml/lumiera/lumiera.prj
+++ b/uml/lumiera/lumiera.prj
@@ -1,6 +1,6 @@
-format 40
+format 58
 "lumiera"
-  revision 50
+  revision 51
   modified_by 5 "hiv"
   cpp_root_dir "../../src/"
 
@@ -9,27 +9,27 @@ format 40
   // class settings
   default_attribute_visibility protected default_relation_visibility protected default_operation_visibility public
   //class diagram settings
-  draw_all_relations yes hide_attributes no hide_operations no show_members_full_definition no show_members_visibility no show_members_stereotype no show_parameter_dir yes show_parameter_name yes package_name_in_tab yes class_drawing_mode natural drawing_language uml show_context_mode no auto_label_position yes show_infonote no shadow yes
+  draw_all_relations yes hide_attributes no hide_operations no show_members_full_definition no show_members_visibility no show_members_stereotype no show_members_multiplicity no show_members_initialization no member_max_width 127 show_parameter_dir yes show_parameter_name yes package_name_in_tab yes class_drawing_mode natural drawing_language uml show_context_mode no auto_label_position yes show_infonote no shadow yes show_stereotype_properties no
   //use case diagram settings
-  package_name_in_tab no show_context no auto_label_position yes draw_all_relations yes shadow yes
+  package_name_in_tab no show_context no auto_label_position yes draw_all_relations yes class_drawing_mode actor shadow yes show_stereotype_properties no
   //sequence diagram settings
-  show_full_operations_definition no write_horizontally yes class_drawing_mode natural drawing_language uml draw_all_relations yes shadow yes
+  show_full_operations_definition no write_horizontally yes class_drawing_mode natural drawing_language uml draw_all_relations yes shadow yes show_stereotype_properties no
   //collaboration diagram settings
-  show_full_operations_definition no show_hierarchical_rank no write_horizontally yes drawing_language uml package_name_in_tab no show_context no draw_all_relations yes shadow yes
+  show_full_operations_definition no show_hierarchical_rank no write_horizontally yes drawing_language uml package_name_in_tab no show_context no draw_all_relations yes shadow yes show_stereotype_properties no
   //object diagram settings
-   write_horizontally yes package_name_in_tab no show_context no auto_label_position yes draw_all_relations yes shadow yes
+   write_horizontally yes package_name_in_tab no show_context no auto_label_position yes draw_all_relations yes shadow yes show_stereotype_properties no
   //component diagram settings
   package_name_in_tab yes show_context no auto_label_position yes draw_all_relations yes shadow yes
-  draw_component_as_icon no show_component_req_prov no show_component_rea no
+  draw_component_as_icon no show_component_req_prov no show_component_rea no show_stereotype_properties no
   //deployment diagram settings
   package_name_in_tab yes show_context no write_horizontally yes auto_label_position yes draw_all_relations yes shadow yes
-  draw_component_as_icon no show_component_req_prov no show_component_rea no
+  draw_component_as_icon no show_component_req_prov no show_component_rea no show_stereotype_properties no
   //state diagram settings
   package_name_in_tab no show_context no auto_label_position yes write_trans_label_horizontally yes show_trans_definition no draw_all_relations yes shadow yes
-  show_activities yes region_horizontally yes drawing_language uml
+  show_activities yes region_horizontally yes drawing_language uml show_stereotype_properties no
   //activity diagram settings
   package_name_in_tab yes show_context no show_opaque_action_definition yes auto_label_position yes write_flow_label_horizontally no draw_all_relations yes shadow yes
-  show_infonote yes drawing_language uml
+  show_infonote yes drawing_language uml show_stereotype_properties no
   
   class_color yellow duration_color transparent continuation_color gray note_color blue fragment_color transparent subject_color transparent usecase_color yellow package_color transparent component_color green artifact_color green deploymentnode_color gray state_color yellow stateaction_color transparent activity_color lightgreen activityregion_color transparent activityaction_color mediumgreen parameterpin_color white 
   font_size 8
diff --git a/uml/lumiera/python_imports b/uml/lumiera/python_imports
new file mode 100644
index 000000000..4a1bd3a85
--- /dev/null
+++ b/uml/lumiera/python_imports
@@ -0,0 +1 @@
+// "a type" "needed python_imports"
diff --git a/uml/lumiera/stereotypes b/uml/lumiera/stereotypes
index 6d547e294..d127ffd99 100644
--- a/uml/lumiera/stereotypes
+++ b/uml/lumiera/stereotypes
@@ -1,9 +1,9 @@
 
-  package_stereotypes  6 "facade" "framework" "model" "library" "stub" "toplevel"
+  package_stereotypes  7 "facade" "framework" "model" "library" "stub" "toplevel" "profile"
     -_-> 2 "access" "import"
   end
   
-  class_stereotypes  18 "actor" "auxiliary" "boundary" "control" "entity" "enum" "enum_pattern" "exception" "focus" "implementation" "class" "interface" "metaclass" "struct" "type" "typedef" "union" "utility"
+  class_stereotypes  19 "actor" "auxiliary" "boundary" "control" "entity" "enum" "enum_pattern" "exception" "focus" "implementation" "class" "interface" "metaclass" "struct" "type" "typedef" "union" "utility" "stereotype"
     ---- 3 "list" "set" "vector"
     ---> 3 "list" "set" "vector"
     o--- 3 "list" "set" "vector"

From 6f00eb742bbaef64d01edb343c953f5c5e35c6b4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 8 Jun 2009 04:49:25 +0200
Subject: [PATCH 090/368] regenerate all immages currently used by the
 renderengine TiddlyWiki

---
 doc/devel/uml/fig128005.png | Bin 28164 -> 24719 bytes
 doc/devel/uml/fig128133.png | Bin 64556 -> 55303 bytes
 doc/devel/uml/fig128261.png | Bin 36477 -> 31567 bytes
 doc/devel/uml/fig128389.png | Bin 33051 -> 34960 bytes
 doc/devel/uml/fig128517.png | Bin 27088 -> 23925 bytes
 doc/devel/uml/fig128773.png | Bin 17086 -> 13355 bytes
 doc/devel/uml/fig128901.png | Bin 32612 -> 27658 bytes
 doc/devel/uml/fig129029.png | Bin 29330 -> 24561 bytes
 doc/devel/uml/fig129157.png | Bin 35457 -> 30378 bytes
 doc/devel/uml/fig129285.png | Bin 53559 -> 46235 bytes
 doc/devel/uml/fig129413.png | Bin 17100 -> 15598 bytes
 doc/devel/uml/fig129669.png | Bin 21189 -> 20441 bytes
 doc/devel/uml/fig130053.png | Bin 27516 -> 32907 bytes
 doc/devel/uml/fig130309.png | Bin 40215 -> 35429 bytes
 doc/devel/uml/fig130437.png | Bin 41996 -> 37004 bytes
 doc/devel/uml/fig131077.png | Bin 19924 -> 18837 bytes
 doc/devel/uml/fig131205.png | Bin 14434 -> 12681 bytes
 doc/devel/uml/fig131333.png | Bin 9210 -> 8673 bytes
 doc/devel/uml/fig131461.png | Bin 49580 -> 42726 bytes
 doc/devel/uml/fig131717.png | Bin 14266 -> 13151 bytes
 doc/devel/uml/fig131845.png | Bin 18298 -> 15777 bytes
 doc/devel/uml/fig131973.png | Bin 24292 -> 20316 bytes
 doc/devel/uml/fig132229.png | Bin 36167 -> 31158 bytes
 doc/devel/uml/fig132357.png | Bin 25627 -> 21611 bytes
 doc/devel/uml/fig132741.png | Bin 25229 -> 22552 bytes
 doc/devel/uml/fig132869.png | Bin 13284 -> 11353 bytes
 26 files changed, 0 insertions(+), 0 deletions(-)

diff --git a/doc/devel/uml/fig128005.png b/doc/devel/uml/fig128005.png
index 4cae19a1d4140edc5aa47aa3c86a6a3db9368b21..42f9f58d6a35826ef0b629d2eea5e740cac303b2 100644
GIT binary patch
literal 24719
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

literal 28164
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

diff --git a/doc/devel/uml/fig128133.png b/doc/devel/uml/fig128133.png
index ca5e20d4ee1ef62dbd8c8a511a5ad013669ea218..bd2f6fca4587824de5379fff7357fd266f56549f 100644
GIT binary patch
literal 55303
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%0A?EIQ
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
aPOzIzMm<z>TUIb{a!XE4wphkE=>GxB!jWD8

literal 64556
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
G9`J9u_w2U-

diff --git a/doc/devel/uml/fig128261.png b/doc/devel/uml/fig128261.png
index 265fa442b5738623ed8e917dfda7ec4d7175a137..a3518d9ccaba221fa94aded1c759fe6accea9b38 100644
GIT binary patch
literal 31567
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

literal 36477
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

diff --git a/doc/devel/uml/fig128389.png b/doc/devel/uml/fig128389.png
index fa8dcdc956afe8eb24d2de7d8219adc18572c478..d14d56b24545ef3c300ec7eaf12a7aed9ca401ab 100644
GIT binary patch
literal 34960
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
F{x8Qc_pSf{

literal 33051
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

diff --git a/doc/devel/uml/fig128517.png b/doc/devel/uml/fig128517.png
index 61f1341a45ce097aec9df560e433a4f961e7a833..483057532679f43a41259387d22258f58c60e4ac 100644
GIT binary patch
literal 23925
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
Ga^pW4!|<X2

literal 27088
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

diff --git a/doc/devel/uml/fig128773.png b/doc/devel/uml/fig128773.png
index 282e0e7b169befde8612e3f747ee5e596051884a..c96a9d4bfc1aadc6d2a55764176f209fcfec9e73 100644
GIT binary patch
literal 13355
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
R1>d@XD9NkI70Z|g{V%MF>E8eV

literal 17086
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
JTk6sC{|j63bD01D

diff --git a/doc/devel/uml/fig128901.png b/doc/devel/uml/fig128901.png
index bd2b52fe12b0fa4a937241ee20b880912ef25859..6dc33458c034e16dc1ca3df562dd463f87894e65 100644
GIT binary patch
literal 27658
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
D=^3yU

literal 32612
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

diff --git a/doc/devel/uml/fig129029.png b/doc/devel/uml/fig129029.png
index 3e8223916ef1d7105a2e2d057eae4d4a81a38924..c76c4b2435734ca4c7234313663bb321ceec8e46 100644
GIT binary patch
literal 24561
zcmeFZ1yoht`!2cxkq(irEwbs9mKG7DyIW!-4brU=Dka?@ARyhHk_yt@(%s!>;`fX1
z|2ya0bMF~vj63cacMLye^X;|PTyxF&zR&wS&$~V<%1dIQlcGZ)5G<*e;>r*RVmJ8D
z3l$OkM)v&M5(M%HA|?Jz)ir5r#zR-lH2roTj^GiLE}KG|o!W^mgNL0M^jLu4r7Ut#
zZ(CH%N7;9-TvW^HW|Q<Wu8Y1)SdNe<1zRf$6kN|_968w5P$y7R9>{eLdnYH5L_Dae
z_V&r2-Znyd%zScu=zV@raZ+Z}r`>0^yX!qF7h$Re2Jx-y=O6+2*ZG4V0t7NF*#dsv
zpf&=3ABVF;Aiftbi6IbCFBm2S@<kZ$J_Mo&MMDCIh5i3u|9^32R$r~7$3?@WVhZ1#
z|0uOuXM{k=V~uGrsr;B@wQJE=9!VL+6e2>J)9j<}{p(?^+DS^0cP_LCMZbL!M5t9s
z3xS}Bx8RDQN}(T~`iRH0hl$*9Qc*E-ANyl7&xgWY=`EksGqd$+*v~^Cngn<q3Q@b4
zOd2<1LvNH(@H+GgmThLLmD1hiAdod>Y%j`ySdHL)8LgNi-Sb9+rb|CuHMLlYP+4?r
zc}z4ZW;T&*Sum_Ot1B1h?Q*FpG=B6<dFZHd>0=6EA$o<f{gb*mIh*hv?V(o`2`q<4
z>xa(+8_CI&_$)_BTaO>j)CDHWPb}0zAjO2G)DOgdIONRF9dCL>BP>#sI&C6qv0`D5
zCJQ%6#mMv}d$|1g{5IexBjbUk#R+})!1@Id0ZZ)i;7naC6HP&nnr@Pjdt64l>HYh{
z+R6uWrMk7Y23h-DSt^y)tgRwc;*-{dv+EE@;8MS&)bzA2R%=()!N-U2RBv~E$D=so
zPDU>;<7lPcUXjzIvkPIXYHJPC<@UWjDzOhr8HmvlqbsCB{Qa&hJ;ZEf>FNB;%%Z6K
zXN%s}3KNre<G+u6-J`0bGnNly-y5)Px=zGxX<fX@&1EUobwA!XnVwc{z1QJ_e7wJI
zpzI)qYX7^LA@gfRO;Xb2WM4=3(SiHk@9*eTZL6uNHXdE0qsS0nZo4(%;O6EWH8q`J
z8JN_@L|GkfdhuRGT%2P_M`l{u6Ct6-_KCxTm9|d!*G%id&4%a*fnEY!_ICE^1+COX
zo}NS=mZ1@~yfKfOYQ8F^^OIp*2t+2_MAF^eA10;lJ+a#2j~pg+0)6n{*>2PA#9-#`
z)p?&kg-$5UKQl9vp>-Mu31a9SIu&U2P+_M!Pg>i}6%oRR-zi7z2}OeRJCR?=DnKCp
zFUSjVT4}LEArQk&awa3<)KLppb`W3`DI}%-9c)6KL@+TTV9wl-=C}QUM%Z05jUl_|
zSP)+?Y9q&|i-ymBKp=dmcoJhAA^3in5MSy?MviHtE%&Iv7*1aj>t${e-+g7A7f&MA
zT*3E|2?Vl5jFur&zS^S7s*emAe}X5W@mfF>mkk0r3Go~7*A9Bnh5_-N0jFmfVt-Z-
zPLBwV<qXBY`}O-rMse@)m_HCfAf3<tKO7(Lf(C?wN-82V57JEeCv1$f;N7=U8}nj)
z8POJq{TubHU@((U8YHLxWg@WBl$V!RR8)NV@};O~b5}G|UT&^LC^-o^IXNDlvc5j6
zAD`2Ps-fW*{i0MJYtq<E1mCCjGfnY!LC8)FmqR^0+h_ZW!otE86&04F`3#JVT|GS`
z>y9HMBM)h1>6w_w1YP$MZ5v5QNNV7HDL;PvaOOb>LFPlf8Lz_^7?X8{=E+Q?wzs$I
zR9fZa<P2C;JbChDu_MIN%1V{i&e_?<%F5B+zQ%qrKq8~Y?Jz4Z&(b5oHwKX$#b;OV
zlZSgt!1iPX6B}FK$jI^4`C(&YBPAu}ix)4DP_XNrx3!g&!f{)MhRVKvg>i6{mY0_c
zVJt1)hYX9g_+lL%9Sv_D@9gY2IXQvh-Q3)OOOu9VrKM2`3F)DR$HwwnPl7|Z3=HN3
zSVLS9AdCyt6?yaq8Ubu9i?&5uTU+3?L8HAZPLHs_iT4rhM6c#u7@Tc1lxC~JNec@L
z7Yyb)>$3$EX8fK7K|((^U9+~2<Wih2hKUsFRPFqV=d_M;+?~~{NmoWq(^VoNAfWN9
z_B=o6g!<^Jstykio5YQm-(!5N5Al5(&d$FuUGwJW&!2rFw^u@^)0~FQzJxNEW_>Ao
znws=}e4b}}1v*vETjNxIYhy)o;2Qe+`ob2&->PQaH=(y@fw(Q@_w?@WL+?e0-o@_i
zjV%<K8cC;6sr0zJwE8;3ZFja|U|>M(!)l6$O=l=YfYPUni;JE_-Z`J!>&`H!ZNa@P
zRkzK98x(SKD5BmcsGZBU&+VxXuhqDsvN9e40Rb7AN1xDXTnuUkrx5&CTzGu^M1#la
z#)bu$!pTYP*4>qjjg9H)>7vF9Mt=T_^VQTbi;66om|0z>%q}c`w?icCQ2k%5?Y-My
z0s;cUgfHktL`0aFy8HV2%G*A(s~2diDJt4s9IZDuH&<6zlW>{|UaVzYp6=c*MJixZ
z3Z8W_6=72FtDZMb7aKh<!z&NyLxv=G(n-a>T6I=eQHd-odox9oo_T6702dEB(}ncA
zc}6%gI2Xq639A!bJ``Qumm18hj`?@4{eOs~{%p+?U%C;eIH%dN`1{+iO)K>{5;P>m
zz&{DSQZk~2S<hd6;0uLWPY?Q=1$wl9Be4t^g!%RULVH(p`imfDorm8(nE8LfL0Yru
z36+`~q1x!^pk*tH8zm$I@qW&ys}-jyF8<tmmB~yxX8G!B=KcNlO~*(S>|hcR?}4hh
zn*t_v6FBD7)MUU=z8x+M^NS_O@`EKLRo0ik`q*~1CYmaFp1HYszj$%8np&h)ZKon>
zITquz>5Naf!@{V2Gos-i9i1p7bSamdFhIams=>k|)PvsnT?tQAZhpRulSBXH)Mx2E
z4z}mb`T9s6+<BMM`^t4^IEO^Lprf<%d3=8E#$Y!ad}NGQIzqFKhvAW-sFv19FiD=S
zZc<``O@TqGpvjNs{l(Uf5VEv^U=IDpSPfaV5yIAgV-IcJEL^dOmX%-e#V))1^Q}%b
zH4LVvYA*R7IW(lZ4z;wPNkVnYbGO&AVyJX<*+)lbSy?(=x&dgOo`TaeGZq#Wt*!4%
zOYvX~ThSURLheVhUS7}jXQ!#2-)9_Zx^fr|r}pvQD!CmmrmDa=^&Zn~xL6D!yEUwj
zze7_htUOBhWnJ=d#a_E75QNGEXcgy;m|9<|pi*^b0<htBXj#-i$kLs8d!E|bbX6*P
zjyL#sh@x^IWm7(N7S^4)+S?#t@<UXMb!7cwcPf^lJF~r=#M?WJUPi@?7qi=89UvgA
z<@-8StmgLdT_yws=iJ;LQOo7ov|YO3o2;z8ytX@>`pIQwk^A=;82VEAN|a(`nr^*g
ztG(P-XB$YsXx_lxMVle5ZP^O8wccK~W!6d(nKNedv{xD(YTPrji_WjDJ4q8#%qq-A
zPo!SK*IFUNM_XlKC@6GUUj=VZn+#5my)+r}^XrKzg~d^ySg3wccG%L)EV9k#xC?c%
zoUi<va33=>|Na$Uq@&ZAn3!jzc}_24zpyo=&=(X+X<RGoU$omAa4A`lP5Wse1F4|_
z%I|*kYccGSY4c*g)8}O8x_tlM?bT{eem;)-=}zVVA6Zwb>#NVWj~|QOPQSsx@)s7S
ztn|Ri>sJ&R>QVhswaa8$YmBwb#Y9fHY6P*k!$aT-hbz{e>zSy})4~*PBO)G(eLzBy
zXP}{^Jk?OM4qqP3)2Lcq$wH^9ucs7rT$7<{`~IF_b{40i@@jIj){N%u+b~A>Mm(#E
z(G^91N&<aSQqoFaYE<0W==q_BA8wV+jCQSK-oATsQc`+GY`%7MvGaC*TN@l}xhvvy
zS7d$p*f7Yc_$iA`7H)cF<qp8NUB&C6YW?|kCPzjP#-NXAP+l7&XXo@Z7@MuUr>BJW
zByGd24g&+TCkrjDUWWZ^b8}gRFd{L0{Ca-l4n_d%a@N(Kea|ak5oEW^-AC}C@`FhU
zc{tnJ$7fBdJbaJ#FvZRxq9a5{)nKl_41W6c>wd=^tJsI7rG2msFHf#Bt4^Qu>-j8C
z2D;2$A03Y!Zf<NG9<Ek;q-t>w^~lP3Q3(q>j2Dw+NMNaFJ((#%2Wwe2qQ;|M>m^>D
zw%ll?2#wSN?NH0wRp*I9YD`QPrp`#nLvuxA=b`+p{O!oL-u^&@Zu35<vy#%luJ@@x
zfx3=?L6gIB*AwH8xU^Rj6BANWQWPo4iTBDEy)iRaz6H9Qs~Cm#pmRPlYIX<7odWE<
z`9LTu8(Ua#@YPD9?XTj&rKP1_7^X0M8^;>m5fkp7UIvqrmXizl@PYWLgNdD;9Y7>*
zZZ$^3An9FSU1cexvVuy32?G_ifAhGcL?n4xUrlXf0TdfKWoA7N4i1d0tc5u_`=_TO
z&RcQ&M`Ea^7em<!I28O`e0;8>`C0*oz2FMc(g(-KAt51N`|U(d{Cc{&x|W+9g+{8X
zQMd~S%iT|(K7ID=85I>30s;b)Mj_W&<2}gbcPe_$lEn<K2p9noQPX}0Sxrq1e{x}M
zt$T|fnyIO2*SAlfKHXej*45Q@mu_ut)`1ibkdBbYiMWJBS1ABeg9~6Ax6jYdXDg)k
z{``5qRo1uDbbABPMR75E>rn&@i-hBAe!kU@&s5zpEM%N!zrg7_gGn;BOr#=m^YSi_
z)`#*mia_?f+^OrEnGxdSI}7E;uhIc%>%Rc7cwXCC3KzsCM}cMwobjPA$wn1D7G0qt
z@dXF~ZEc--F-s|{sHlKdPD(}=jR%LrO*JFF>QvcCMSQht3<~NFA>-vD?Ey(&PfyQO
zYt)>JrFUd_7(A?Ur_Ir|HFK)AMz72CjEtts9f6^BZqgo++jE5w2^Emx3v_rFqx!9y
z+uN5zxw(ER>+05<cE=<nkQS(uJ$!ihi?eUqo^H>77(x9~P5ixczz9zsgTReR<$ZFR
zx9DIS3JMD5=H{AcHM$>L*w_>r4L9jm?5Zd$KlbCZ`|YbdIH?Pus@MmA3?fQFSH+00
zD3q?Ec_X9>Y<`Marw0f8u6ti_7Y_SGZ0jPnbJD&S>eU?_95@4f2v+LHhjg>s*a#52
zEV^MOO-<s54>JbLNl8fuhlX^LXxZ4<0EA^>kt-Ujf)`fJc?(ccJ^T6a{QSIQ2!o2!
zeT|B$ElVyD`~d(acWhHnchX&?Dmy?7RY9RoCYIIB-F@TO-Nog!wzf7n*jb3^6BG6p
zCKkFQ9)-A>m_br4=H;9D7JpE9X^M-tUG6qDIj#?aiR+8WQ^<LtZatJ=DUf`B8#B*Z
zUB#2bh2etTaH=Def{cvpGPdbzc|a06Q*88}Wb}t59;6%v4XM)lY;PXGY3@~0Q!QE(
zNHc|f7M<N#)Mul0ZHTWLpnWLPUi~n?CGn@EWTU?YH-KE=T&_Gm>}Yv&1<;&VPu!Cn
zFq+aLTPrE4c--{b3+cWT<LGrF<{v7Vx#l>e_=<K>_tqXALRrr*HczA9CM6{wA7gdx
zr9CGI6WM997ztDmKGy^(I9vXjhQnbtnhAQ_cYEcu@@qAQHQAzaW8P-qOR?<{sJIS{
zW4)a&hh8a2sEuTXQ%Amg|M0mOUUzpNgMS1*kBd!Vs=@Tpx|Z07($ZXCUk3N<qw(=&
zm%71?4W<__B=y~vwU(E&Q*T}mfBQ}?ai$Qr=ZCuhX2t(N?>M$eceY})IB%0!q^VjZ
z`(`k{$I*_9zW)gfvn=8Z-sVJn3rwJ+vq-nhY;?ZWlGipx#A&1NbTE$V^{>0nR^v2&
zAA)qkQ-qJt_NM_7k)4GZb==C%y<lM21ox3U9hIN6J_=wp7isJh<A9^>%kI{|ri<gE
zRXDuqv0wG6{;7sR@>!VA*7>$A^}^zmlMGJzhx^F<0U0o}c4SnG@cb1E>`dAYs>SgV
zX@j{`%I%e{t2ZA&svT$7`WxAh$WpvL#eTJ}a68oBzqWh(;Xrv^iAao#i;I@F@p#6?
z$LDlr&doyv=Jz4=X5HxY<Hx3Wk=s*>Ik7;=_lOkFp#e{SRB6>dR@4f5*7+YS#NtP+
zR$<|58EJV`Dr|B-)6!p+-Ul|*n)nYN+PLN%eZ!zqFSyuyi*jK#cawEs4K5L)cQXO^
z!4o4FP+wm?wOi#GP8;|l+6mHtqoU<Cy}y4^d)rq_E><k8koEO_mfplzUOHi6Y8LBA
z{oNTWRWcDbQ>~j;Xrt?458tw>$`A{cpTy#0zq6%CV|d>UH(Sw5lH=pC-M&O33Zkl4
zv-KgQAu>kumM#r$)gfT=I<#vO-qyX^&w%wXKC+Ko$1a(ilKE#WTS$eSgk->)^%hmo
zAUlBVoTgYn{<ABp1wfT=j`Ke!H}zNrE~(YBl;VWPboPGO9;QEgd-A(hU>s&yXHvdR
z#wDdZPGLJYobnpKs43;v_I9-UtY-EPyqKw<*gId%P7JvKx8QTN7^{By!#1yh`ytjO
ziTcz(vZURZov7*4rve!0Cytw0HQv`9Z67n5&K8)c+LpWLtmnMV7du3%>*_!}4G2Ur
zHKjqNf-x}DET0276!rSzxNbMJ8~UVW4q#_up)noQ{q<}g?eaAmI6T`dBTCX6ZtAtS
zmVsk6do}sxS&Clyh;#5?E6umdtgjc~i|xa{F-qb3olzFI&QM1x@h0z6z5285m7c?<
zvsW`|&+{}2F8bNM#Kk`!7>}JzeGBO{jTatEl=OCCAjMxJzF>z$ThHCBl$!2>($k`X
z^~sY50SEnxP5*{#3L@@~hpS#eJkVIv3td~v^O;O@#V^J$iG91AxA~J|c{@kcJZ`QC
z4CbmQCmW>Q9FHO}h-Np3vR#~x2^NPS$w}I4(pD#&V`rCAZiS}-SRx`4y6Z}|_NrD}
z2XS$GbScEYsG9`-+?OB1w_ihLsrn)_GYyh@dR`J8j+sk?nYNLUoq>UUJ5#5z0M)HK
zUUPEJDad(!cP*5OZS>mvZot4cb@p>=t7dj&WETyLF#2wUd?AE9KPP)3t44Da#uY>q
z{r|{}lfqJ40DJ(Z<iF75N$Y6eGA7y)i=99;k%D20B6rXQvFO*2zvF((2+nu-cXDM>
z*>D_I_^L@~>&fNN3+oL<TY|tz&BF{Fq++QEm{f$xx^^@6&(dEy7`cy(AeEoy^w%Ey
zVSan(hcFIXK(58NWp|_mTzo$xKWD!YAm~MPP)XK^@$MTMpH&AwwXeQMA<+V{LL(ac
ze&yPo1|}Qg>zsCr>EaJgfafjO@~-+5!QBUlIh)x1NkHh2-xnS=qFH<ST;QM7zc1Er
zJUmS*%Fy?f;8$d#^}YlP)*tVFhERzA5GA`iXYYa?nk@KDUIz-V74ohc*K@#;ImS3t
z`+Y_*W{oL?_*U8_kyXAsWlTr|Ea6|$fg(wu%p>slM;16qD}y>?ML)AcHrwO`jW%78
z-h&~ni8-3_F@t*vIlD&j5c^>#d(_rKJ8_Ca*jbEFHZN1Wd3V6z3%H@(tHA3tIiux&
z&1^nuleEz(AL1GxI6ncEe)EofLii$>LCCL9ux)VBzx0e|#(rB&l(wna#=E<TNlS`+
z)?2J`H(m%89|x9XyTDxNK;S<$5lzZKnJpYNq+*z`8iGH#HxU$%7B^yFe|vIL#l0%S
zyRzsn;UuOljOWV>a@G<g@JM_|=J#owef<zL@294SPOZ(CIl(ZS5doFB1s+{7rgtjB
zcH4^?o=@N#kbOjR5u0eEjB4n8Nb}@_F6#$g#J*bl0+@FUBm`o0f7N6h7fgw81Z-de
z!!dxldz!IT9n8Zal|Cf*x57_a@bf<u8=dxfJWKHSf4%K{_Jzq#K7jj9)3G96HPHl=
zpCPs<Dxw|N-2jDttCNfdfEh1F5o~Om{LJoK*uF|($kTOQ&8&xU<>!asNM*Bt)@%f3
zDe<dgNcs4)h~#AJlMPYi@|@Z=;c`B2Lj)eFb&8z4yf;ox*7m9%=tgShD&r(XG8z!k
zZttu8P5_KNmVSia?n7?}w53jWX2yyP3=|dnL4MpED^f_}+Ye%E#1+$R^gJIgF`lV)
z@;LZOmz<m&{ZZuRY|)H{opW+H3h9K4Po5Qqh@_X!*~HeDEC8@*Ex>(Jk+dOD5&gW8
zgc$nnSXho^7$xAGPWSh73JUZ9!moEbj8dBOI-Lo?B0JfgyG@+CGCNrMc{=^3@AlH?
zwy%1LsOikVHZho|KdT@dNGdWcdKib{U)ej)Cuxizdg-lb)SR4ehO*=URe$pP`+FUx
zC(H&BUjad7Gf|qEl_ilk($Ur?2ykjgo{hP=>u$rTzSr@H<yawue?Wv@oij2rvXlFB
zdwBV4uwR^mGhn_K{6lZ|2W8j*+et%5C;8$<dq>CYn?9i|nvS8}|KKG7K^mY0z6fdu
z1FvH>2?+^VS=ll?AD`P^E9%KG9)II>5HKXLu&|(BM@rt_-s<Wxsi~>2KhB@-<f`SN
zqoV^t15|bk3kzny;`Y}v!gl7GZX*?hpSte-W-6-Za9mSd)(-@y?*N3Fc;NHI${z@q
z?1O`YQS)~)Q8}w#C|I2pSy@?Tbo=o!<!}k92v7uApL&XVh$WJ4inf?rSq-k!f-3q6
zg_^44l1o$fm<2b0eM}niP)@TCxQ_)cGroScXJO3^QHsD{0VstzXmiY#S(BZCbtk7T
z*TfQR$}KDno=NDX`B0r4@l>VPNe5XX6BAn{pGK;%l4Mw+&)IzA^786q>Q%499?6Al
z6{xoU3l9msYCEU?FK11+UM`nR6ZZq9iKp!`6eB}URFOsvk2k`cYJau{(ycj0swj`%
z;YKq-c5lz|SOY??#DQ)m2@+5te+udbe9!eY^r<tmB<cf#3Q<)1^8=SG4Bp_}+*&RN
z6J<NQS1(__ayx&zNYh>FIp3m2L<E0Mp{z2715Lrj=duPhGC-dX>3Y$r4h~)V;v=cM
z4=~u6g<Xpuv)Z%+3N;h=6-eRC`numPLQ4ril7JMW6R~;MxgB0LH%t1QrLD|*_#{V1
z8}f&gy}=L(R!F&O;3&2=Fq7|<Z}7gjKE2h^*0us^d3!vZRm$l4Vg_Do*ZS@A=Qbb~
zB^UZQ9Y>=*B#e!=R*cCqN$}WNud&gKFwz5J4GoQHo;pn^C55K4GLLCj*QZZc)z#U6
z6o^Wyw`unE0l1+lCucp`<s>lRf`D)b?31~i#tbWDKs|<d9cd%Q;E`^`Mjt-|94}YG
z3SDgZb?oxW$&j8R6Ju^PSF!Ef$Nfbja8&OJ^VJ`ys%bjT_r2T|VtTaJ+|?BXpf?6p
zOABIe(z!M&mDJ!n<j4RlnQCY2I^~pz(!%;H-7v}-LBSo{&MX(I=bgFdBFP|ZTYMlA
zg^NqF)!5B92z$9}Xc+wLz4@W2ucM=(cP&T8IXXJZKxI7N^3MBu2Ll7c_4iw0?Sd>J
z3?eaC*J%UQa?jt*D1~~LY2VgfPDML9I2-`ctUrxSGKAD~&(I(69%3H=;fF!E)UYqH
zHC<EFbbCz>c)${4=;gL;Y;PiONyv+d>t|{J6E-u#=)!PtQfI1m*#I*Ih&s4gV`{>M
zn5XAbu@R?42<dc3@Y}a4(K0f#-X7j!VwDlcfJI?61`McP?U8j5hK2+IVI$$g$ijhY
zfXlP8JLgJLkdcde<4U9ft7B2Crnr|YcNG5hpI!jmSIb?e9ibzA3EVadZM;FBLItmn
ziUFPTqi5zkan7%@g#7S|w!|<rO@&A?FdF)}<X|HWX)8l+`@owRM8(PKl5b#MZEU2=
zln85L+LUbx07N4g?}Q5(Y6WylY;^=+)rm8$z5ycF{eCTHA9ezEoWN_^N)15vmaR2F
zAS!p6fo5Xv`vdyBbQ$zy2T`})wFKD`am0Si?#p7-s*ZLoA;d7`C9!C>9hju@4>DVj
zz~<xflR%yq0$LjdVjze8%_`t{kIofQbm}EBfZu1lkm(0#NTS_q*(D<748J}CD9(+t
z-dqjD8lX%?4`i{^fm4FD0(6dJcP}6>fhs(zWoM=?F-Aj8Erk3j2Ol3F4ED9YUKcey
zGV&olK0Y2E9xiUN!?LuD&Hdp1tYSeD(YlG9RM{zRBC)NRI*pj+WC54^_wEs+%XPnh
z|6U<gn5Fxm=FMsVCduP&hcHT^#)}OmAYB_YHCj!Svd&^(1^>B`_dyRwed`SCR$VLg
z-bh7kY;FST0<at&CtDN!{f}&*Wwz>tfDr(sNKI05GN`<Rf`Y27CIDHIF=Ao->Q#!{
z3dy0>19O$~$V}mC*8`G%{Yo;n$;IZkNPyM>5(Ho%EHb8BTQk0WGymQEcC1j3iIEXc
zZ0o;I12GejxG!=>THq-)Z1L%%Qq6*WH)i0|P*}(+BGMFc(9+Tp7e^c-0ZPHoDJiUe
zd;e9bipdeu7E5d?-8$zbfxH(u`Bud@+E{08MPdEPd7%adQ5{N|q9j&WTv-`i;3|l2
zy#iUByoK2gUU^nlq?J77jg}~ym~IS^&KFv(7@f<JZjJDebU7m(@K}>4*5EEd1}{Ac
zCb%Z?c>rt}FEjh|5n&R)@?90J;Vq`Y%d3VdtV#UsP5_*^OT*wwT~)SZR_mWcxyu>y
zp)S*i+L`WqRaW{>4ksy=y2E&owE>j;C4HBXk>7m&$}Xev-P2qJfGZjV?RGXE$Qt`!
zHJhZAFQFZ>;VJ;ynk1U#=HaH6h!y==)l7g`9ZjFG-wCBSiTPR#NP++#>wJ1p%(Zr(
z&R&*ZGcCK;Gh){5hh9eV_=kWzYTm0%LCk9t^{q7N;NYr~PEj4iNgjsRNy^HK#qg^$
zb`bg17=7yoQ=GHqjDo;aBycL!qvE9MDJik|o&A1~#0f7X6m#6A)K^yr`udBaR7$cs
z-9M7Xk8r8)-#=1OeFSOD4;QEr&z=nhU?rxFDF7}!pCcZK7?w<3eRD!^`B3I=w))~T
zAoH8PP*TG1!;NM0$(B6?tUH<aL1p!)6V+ee3-qr`<ayoB_U<LyI7oN#XBKNo`mfvI
zS4}1J_)|n6#0BAs#mGeaB=R<$Oj-_<>RzPYKE3K@!-!&{bgI31@uJ(b#_@D#xvTB_
z_u8Rs-k%QZHE(vYNjMZ^WWfKwJTdKZcx`VVkUB@*HCSjcmxmd5^)`04*6H^I9Gc2)
zIem2=i8(}kqj7&@<0OQXyE<)NC9~g=U^^#n|Br<tW_DAryO>NxIYq?&RR(jc_w6<7
zqL-zhVJ#WfwtQmxrshUn3IIc<f|py1U}k_kaeKWx=H&%dM+ccdAQ0z)STHHUx2QWd
zVUsKmQ$Rp~VJMh*p3M&x1B36)ilu4PotW^mr!f*HrCn?|SZstgR%mToz%f(%THkg4
zBa4nS=7@RapXu@sxG**K>aTNQ3&}cvi+1i@6t`}}6*ZJqEK(onn;L(J{Sk2IfM0P1
zv;tcLz7hS=-~AVD|G|w=`NfXC55)Fj@Z)nWZkf8IGA#uv!KnH$pvu0#tLL5lkSxGk
z6>=e)BIvw1>IJBN#z~bYC`1$uCL_6i6_#)sT476Fkk4E$j@(Sg9eEkSW}^XNI_Ts7
zwh+)|0@6@kZY6zdM=V)X>?-i#%#N2_Xq9!yC7qcm4TNW>Qf37o9BsL*4_4s_pD`_G
zN-T1`9*pY~zElayGgoLQ*L65J+uNJ)y1W?#_XLoI*~(>34qIENBsLk3F<{cVxU%Y$
zo+Y-h+7F1_6(Uc2DYAwDR5ZG5bV0O6--PFEE`nXb+<LPk`umYVc|l3jeFE&ctTh;@
zI!HX7r$|Wg%>y`v5P%KAH1#_c<RnlSQxug`SYm|ra*%@D8oeA)GjU<|p-%+G(Ro5Z
z3}{utYxbldhWrNg++FDgtR~n!%CR34Qx~mr7Qe_1$j7+n0g9=!{g@g!P56c$Vuz&q
zLh>VPMc(q)l!tn$MzH^`1|?U1eDrijLF<_Dn}3?3B-==cA^jtK(yweht4J34kRh5P
ztusqI8zr?cObq&EOEpv~@i>^)5-DThK9XUbdcLa*c)GTY=VuyC8wF7>mE)RjsRPiu
zx(``YD^^|-7sIq-dTzZG>LG?1CR*OR4GP)vUI4#|BtAWS`n=}&E4pz~AOePpSU{#F
z0%WxN4uS%o1RD^cvcC#8Ic+xbWW|0h9v(i9z|R_zqZAf=mYtXsQQFJS$nd%Vu&#ja
zATscLo}EZeRFw{N(!U3l;anas;$p#|BNK>k0iWB!X;*U$3yn&axV!twL$M^G%dxje
zP{l4Rq9|5P+%l7&_*CM6(!qVT&^7?Xt((2)Jq@Qf{7g*G;>}im!DE@@2lK`v0U0vu
zGAFdNqi_v)T5eumwd_p;JulN1zjjkoGSwU&G$i%!f>iIxk(voX4S`NYN|re5u{*T2
z6&BUvGCOhFL1qtDe=?^;81~hwh^^T_Hettv>u@X1sWp$?zqG>q$?sU95zX3m)%PIU
zz#v8EH(s^d_L&OFv_>^XhKcb2V4JZH1zG^q*4AhMtj*UGV0yAYQ5m~CZ|?&HU@g`L
zcP9@Un_TS?TBGJqj<0`wK|=BkLB~vD^cyeDG&xwJi^daalJwrksG^p<neNd2`E#+g
z6)ti-oVPi)+y4jJ%}qxA#Zv--^X6jg5bD0BVWF1Tr~4)n_AyV5z^K4;`5|&GqQ}Th
zf7Xdy1Z=a$(p6hKf#cUTVBh)nhe{{M&;OFP%nEUS|K`8a{M@TZGyR#}P|BM8p%SkN
zu9j+eQj#o4ZNH@5IrsrP5cK-eTq(|-&IFfj=Npi7HimPw3r0ITB^k6D+>e3GJu@?7
zX<^aQ+FDjxnx3A1mk<nQ8@)Wrlz{LA>Pt{F*Lh!Gw0(TI+MCQIr7SJo^)r$VRDCch
z2N##QN^2c}-&ty-0R`fRAlla6&SKCg$id;zmm=iv?=SWth=|Q*w*DzQ`(7Z_yZUt2
z16=3M5hA7B<b5qG*^?r4`FFdHQVhw12TI_k!^8L69xC7y5>h^OSjx#xDP594tn7H)
zDXA*nQvA>;neXjU#@3d7fumQ|ldgdNxAv0J(a`|++!^I07--Vc(zLX+KqU?Iq8?fv
ziV81~cDiE#(P>^W85fsoBh2T1w3eOX&d9~3iu%Ouz~s;h)sQz>q#6^4vW(@3GEs*}
zPi8RQZ=j<-S<8y9!Z{O-KWqE>3t-9t@=8c>@N}KaE~s@Gx=Rxir+@+kJRmB1dP0WH
z5L10qs;mrv8#y>Rfo9d0Dzdw|siUKlCz~_04rD>G=g;3bH~>Q)_v=9zr%lQA;$G@v
zaf;vf3RoqJY($EJRL$Oq1{M$nkB`M7B1Q`-aB;r`C$PhN_ZvK%S_89}R@9@TO=XjF
z2P}kapaM;*YSG6B-C1vhQX@F1IaT7#;PSmG?-1pxY<LR|phETw8U~(JerG!e%g?8(
zZjBZtcwJ5>6B54c?fK>BBP%I&eIpwyN@OKGf&EQ(Vxj@Y9x$O`;*L*FM%NwV<Kuy{
znUazc%c{pgvAn*XGqwp<4_FEu92}TIJ$-!&FJJasRCKu!6Hf9$VxHaOsS-Fb@{>}Q
zu-{+doqY*}!J;9(oI-s;qn3bD4pUX{7wxy}bGHmGr^;HP$H&Q)p6C5Peq?x@{0a(Y
zj$Us2{F!jIi=Gu59Y-TZWVDCn^voUynp!(KxotTro5ZWI{!KGAf!}?hO%e&o()(<F
z>~uCyRheXD;Z<D%qZjej4^Bgkap)wzdZ;j_B|doI^*?@S8W=2RMjrN6Mfr@6joJCH
zws&<=-7TBusm@-eFbYfi!sdYttX5l_xtrcn(+X~GR&DFH?dL0Es7?L-IHjfT$2;3r
z4$}=4?b=TzZ?3HSDg_R15Df3bFfD;5>DUz5d61rtav%F@ezJo4#ft!?4&KjeyNhqq
zznYkvEaf1fL;)A4gTux7$zGt#c0y!qwv$tX!;NQB(eCV|cBZG4<B<mu>(S28s<hLw
z<iteB@oVc6_1^F%;a%4;js;}jLW!1Q<st&Ytj@M-bFL69to`+M7I{uOHa2QuZx!u?
z({1C`?fAUZ>{Z8x#=trcFTI(gV9d;=DVf*~I=Vh=oLkemMjSVf)3Np0zF(eH+-f8v
zDeWzj<qtSOD*NS&L;7a12DaT+0n26gLmNUE=TE>>4~6HoVDIC*zBdcYTNXg`odATO
z034MB=o>5IExrx&9>Y<k&&OFHzdmvb8QJEadkmKb+Wx9{wzNTon2Caj)a49q^VG1q
z{wN3G4+F-cKh|$Y^|%q;>hCl#h@lXmS-;2-r`&hbz%drrFkd`c{makBIfjD$P8f3&
zk5(!V-kVf7rhtaZ=ds|IX6FS0*WUclyLV=oWITFB8WP*ReSPtqk}=EeZ1sxvd%r(b
zSF_!oNm8{zd2E=u+=q+SIYjgu+)L$S**(upl5O;)KjFRto2C5A7qHkE5D<0?bSJi!
zGjnslhEqR$e<us}M#o}M<#u&t-Mc3{wi(;m!87HTTUu&%th(`8z{Msh)nN2!U9akt
z{BXDhWTu4Zm&%%=&G<gI3}J#CC0`8tC}R72-_Xix+!Oemlmz_L%{Jle`Mt$IeoQZR
zF3!4A8*ivSH&PUD6Y;s)Z;D~j@mcy2MI)mwAOG0Tm63I4<NR<lBJ$R&8FKr8x<fXh
z{5ILe57z?&qqFfynXLQjWTE{$k+<k_A!r1E#%hab+{f^ftub_rG4Gr6+Sb5jovMTe
zT@t8>WlusyAWq+0y_QxBn3tUO^_tGGz!2zM{teT@Lc)m36SKju;2XP>#c6rYNg2}e
z`j*<7`Y8rV;Y~h1X3|}?0<80$P?7b$Plgp;U0sNXh)3>TTidA!zy<)qLu(+;*t#PF
z1B2LyZ{O(e1g2Oy$>pV`d&tQCet!4v-OJalQ3gDXGN8mXHOKqYo(E!)5k7dZU)6No
z<1mFn)~tk=$GP^A&JXwE!w3I9AvirIxzNQc)6Cls55zwB78e)wB|Q*(8Nv1X`#V3Q
z)=GoAtf(RxsizwHvjvi2mqLP*npx|{s)<5&6%*Z8bJv9vWomNJO$$S91^;~&BPDfp
zZeVU9B3cFf%;p#!4yZ@KaE!X5X}f%3{tX9RWs+ejIYqWVx)Y}sxc*rj0pFsRzWx*7
zf5y!FY<k|}pU287B7~t4(V`5>4~L~bpg8u7P60d<9c>HzTk2k38L*EPmXU~v_f=I@
z6%tS8B49Ojb=Fgr>^#mjrRjMZO|~T~pd{ht;b}M?Wip!yGY6)RX<+rBrlvmKnozm(
zPFB0_FRb(=A|W9GdNR;sw}F?5$r3mqBVfmyV||XpTN7nrP?4R*MHL;LI<p>9)A$Du
z9ss{Iu#GAR?u#24&4*J<rnqk~$k@R0$<SIilKAZ&(F<NJ-CX0iyOE#+FA?R@!Noy;
z+V>0zHFCkT&s9~p3&4;#`wqFpwmw|IWhZIwcJ}Ab^^y|f*qf88hpRo79`RXWO4cXM
zBPEe^WKCRNmAUK2dRVfXIcv49Y0MLq*x_yM1)3F%_JE*^h$v-HQCC-8s^Zf!St<r@
zyq!rW*Nx#|mFxpqy73Zfy@(bdFe;$hA1v(xC)3-oKjh*}U*I_P<97gMXzSW~UUmHk
z3wbAvhd;UgNOzxza7PHtegJ{c`O-9DEbfB`_>`1iduQL0GBPo>wzm4?X4u?fqGDn7
zbaida)K#sVC}1EBDNR+`8dO?o0auTDUdYFfO6Y*pzaCam@DB(;r=nFzu}Z;uyZzWm
zGg)EIi}&_;Y;$vCW#zWJsy7cAInV5u-GI3bH+O@!;v+v-+hytN@sdTe9``p3Z6MOO
zrg&d`M0@DGvJ!B!!fVYobo3;*hq8K7)4=x1!MDk$44#)DJX#Urp77SX9fL|7XzdTE
zul#Y1j1b_xp4Nh0t~x1yv!3ZBb~FRyviUpZAvAz+t*je5L)9)WZiZubwzgn?-@fq?
zk#5lW#R<Auc~}U$I~r~#Vqom;?}HuqF*sPz?h-EQ=y>!mU;;!BYr&HBZ$LFzUS6)L
ztxXZ}nH?Les;pE;od=0)dD-b`ZJ@uuAJ|?%h?Gm<`gxUjU*}m%G5;YtMq)I5->c)%
zP2O2yd*uh$la^i0yR%*zsP>zq1)P#$p$Y71I;T6<Y;U?EXjEdDU-R@-`v|4hPjrJI
z7h>R!jJ&L&O5ZBAd9(bo>9r76qM_jL-+#H`x|K5SLj^VGx352^)mK&))?Sdcb_4sI
ze;~^CoX=qQ=J(O8C#<~KBw1i!+B!vno!5Y1K*9F>Jy`+$^eL2{TM&3C&A%DQ_x6Hu
z%O-GTZ6^pkwO5XH`q|wb6c(l+BQrF2Ljr;?IVI&Rc>K1uw#o9b0L>&MY^<-ltq;-+
zDFIaD-Y^SfT|jtIQ@0k6UtIx#>Ry5R=FU!|^%M_=HMtd%f*m_=%IvJX^ZAjpR7BLQ
z|6(T-{Fi3tKs9k{54)2^M~QJXaJ2RI-n@K@vzQs%k@ED=3CP6yv*Zo4Q;wumZ5d(m
zlT9Lr-%)%_`EXk83Okw#`DJ5dbaabg{$4ldlS@k#z<2Qcxv{(ZRos*3p%i(tFEukq
zET(5Xtfng0Qas!lnQEQ40|{gMtwJL3WA2=BZz?Q^<{t<aJJdhx0UZbOC&}!Sy!IH+
zo;iWcw=Hxkp4<2sFJMFVP~1Zrf&uKkR&m?jDV2wW_+}opfs9NJpCt=5KQVV(H_cn0
z_92`A7_VbGG}d@v8jNjD4eAC%f4-*}Ji%eAe55ocTud<iW`3Yv>X>Fga|B1plZW%^
z-n$~?y#Oh`^DNP@WT4F0x9-*2&qw;r37|))vNNl%8KRnY4`Ts2pTr9k#ac1a4Q4uQ
zO7|&5aT06xFYB)P;QBANs#u*gT=+|#M&NfOqELuJ18VjIC#AMTA;oB*u)XUW0L1Ta
zY|L0;dmPttD5ytCl3Eb!hD&t5;uBDiaM9nCbm~)b(R<G|t|)Nc&qn~)GW1wjP$w6v
zy_pZZjEPMR3Qjuh;e~3|N{GIJVUA<=?)%C8!(aP*X9om7GD^y*=;%kmDN%WtQPFC^
zW}G%+0gSsl7Ek}m0e-mh^2+x1T8>BNKDUyg6x|QR!1sFMO1j$HYk)83;`rzD08B2u
zB96}y2UkBM;Q$@e+!abwmDcmX0lmE(Teh)DMkAH4mxzzc{w41ej~oFssEEq_L$qOQ
z)O1<v-%!gFwz5yCt|nMtR|$jmQHTg{6~?>)kuv(N*Chwwn2W{~piep0r)zAZOj&hK
z3?xJI4N6VAq8ON_z8Q&&_lJqhYSub#gi~)Cc-jvGPjP6NL5*2Yerw>E&8(mgh{K`Q
zeEpbUj=p65-A}<wX1W%b_ixATZ#|aIo*p%lZ{NP@SFuW=mi$|m`L7a8ZTm4J2veRL
zIU3KOU;E)k(uEO-0qGLaU{2FCzl^g<Fbx}Ygg{(^-eG+V)pwY0@$kAhDlBY_NWMN?
ze^623G%_+r{|{G?xCFM4-S1&Nmh8$(c{CCXBEq9h7XwYrW+a@W0Sj(1RJI}%9EuAE
zKpUapsJnWI3@^A704tupJ`SajJ1y5R8yy^8q%Q>2A2vp9VY}Z*V};j>s*d6f$q0cG
zExr}h`puR9EAb^?Hu7&KA}@_@G|Z&jq`>`?sl$hOrO_fGS64M+AKtyw_$vl*anCT)
zyQ*ouEITG$T5U@BTr8b8QeAgCUTLj#dvi<oH>d6Hrx`?)HaKrS1=@3htqxYxQx_}{
zrc?rIpujC5jHxNmNMxkL@9cwNY25i1&Fs$hz`Z|%NzVr-9t}!#MfBYUj50*k5Q-uR
zAqZzT%;e*Iz|(ftVBz|b`1fxBq?ulTPNPJi(gWu}1~sW2>bA(na7WZ%<U#HzhVRT{
zqvj2}`w|+8G)DbgkjXGWoB_LAX^u*^MTIsL3e7Y*-WVa{wQ+QDDay$~!@=phllVU2
z-D&A=mnYjj5&+u)dBkyZbo=6X^C6vll7LGgObVnQI)#+{yu3)*&zTu7u<k(-Ub&`@
z$j(OMi)4Nork6bg`Z9i&)&rH>v@0qq3LN^Q^y>O_j%>x+TJ=8!6AsfZATNJ^kK%K&
zo?XgpJ6Zl3sQh|0UXXljuN2?s=9iGb|IQ;iTVmV^*oN^s7uyht$mHvxhm}$OaiPGD
zJ6mch^UvJxwh|AANdYuE2x`_>J=JNDe4tI*p<2^n0tq}*CKd?dKp8syNtYUBIsuB;
z7Jm$|WOE7&DcKEu?OWI>qCbEB93Q{FvEhDm<@Q%YiK#TmEkHOTB~6HoyferG6G6Ov
z5P~N0s!_8x{V6Klfwnm4g7Nh91SE%kk%n|cWF&wqU`98$w+n{W0cQZ*utGvYY<jgO
z{9QvsDn(<!#XB}KVrpVSOqd7+_|Koej95e;vNM<4Lzv%#<$_VDvZlPH4>9YYs4^sQ
z{SjX~Stc^E3aP~h6xy?=`{RQZ#n4jbDvC#IgMgF-DyWymU1W#EA)q0}NV<3ty?*lN
zBg$9=AJ^u&1+R`A`F6J&8c9F_tv-aE3@;!fa#{IKB!Myf8dNKWJXg5Cj|keXqV5&@
z9Bh+$>(oAmkfQ=q$+7b3ZzZ}|2~h+)jhDoB%z*w;zfZ`bZ8DKi9vMyE;qVJd7Q+8N
z17@yOW{cn2{Z|JGA)JAcpTk`7$~de+5d72V1ynguO=;`AAj<%bv`2=Ynr@>cDdRO2
zi&t4Uu_48Rc=xrP7bQNvp0Bh{JwI<x1{@?I{9};L{(h$|xj;<W>!JFek+DqvKYv>4
z+?~Y_cX|07bTM3>!n3~S*Cl>Jg5)EjA&H?rpcJl4PuE7>|BixU)~n0nw>B$OpP$bN
zuBk5~#B-8e{V!dAtUq&p2{^7}0gZHVDFS*CLUA86TD-mUY455R-DqYf3VOP}ljqfv
z!VFOQj~-Qcy@^%~n{G9*OXSx_{b6E(f8ZXn92t*QfWF9e+s87o51?u0&B_wk4lNi#
zIF$JS?(TPrcr*BoSMTEl5fM4}V80O$vMqCb0U5uKci#{9)!^4BpldQ7_Z5%=RI-H&
z@H^TIUMi%zgSMBmeIx0Qpgm*$a`yMq&p9R}z<{L)dx5SwVF#1Jnm2Q(RL)y3iNru?
zoof%818Lzlh;5XDzubK!7birr{Xb2rVarip+3B*w`-H0OjyK{1T0VUE0`<9CEj7J$
zTKaK8Ba<Z?U#g7yfar7>^ese2j$sk+?cVug6S!7@3jl)(9pkj|XmFf$Tt^)=9pOEk
z<EWRF^~@8>mb0@!_GN94PpSNFM<7a++;{tb*#%-qc34|e!-zycFtRyHgGP0-E%3zq
zDt)(c>UG>*>}T41KilB(nyUw?3m~$_#*(h$vctacs&-Ct$uMltPQv%Mz7c=i2pEed
z`|I&yKg+R7re$EW?dtA3UK{8Ex=h_TMrD3}er`$0PmteBO4i#xGRkP6K-OA|xg&Bh
zgSP+Y?H?6NnUj<JriQ>t@E(N;CguLeNYLS$@LvdKvoa6hDp0F<5hGKiKa-M}IC-)n
z@bsyhn~>{Tf2`OCaA<u46i*B!7wzIlyCJ-<R(pHYvPc9@O6G2yU+Ye*xJ)Kj_MAmc
zg;S$2^f>MrzR(<hMCG?0o&)^RKn4^O!$U&M%GW(l;aC*dop4_VNDBJp?!5q8Ah^%>
zBx1#kBSKDsg)zx8Y@h-5KR*1AMWVV8|9ki43vwp`D{;Afj)pcNjrDgg!v9#^q0d0a
zFbMi6HD<00ob5wHi@Tbu|CumROB|Lxj5{~rJ*2$$3yHvBo#O32?uVwZw6b&6V=E?5
zu3;50e+HT%+KD7V!7ORqf$4U8-DmdegLcV+-trGs!`~SqSBh_T8=88%q~nAHR?qfz
zq0lg(nsHlJ{#kb3d*9zC3k-3S3Zp~51=pcY1s7H?gYFJ>hdN{ez;IhGcBCI1yaBCT
zJrYvNns=PL)x*<Pb2t((;1=kh1mGx)SFv$Ee$@;5((D~b&wXxpBXC5R)k0-W;Xa_7
zs=eJ*r!wka9#udd&?-=RT)B=6WNdmIZ`gOLjgJ;08QNdjy~TBQADja=3BQr)l3b?Y
z(NPllcj2)0pLEbfApy{$NF_a{`d>_{%cInF&J?}fiHjS#LOwU2ifof`)4%*48Oamz
zzCOMJy_D_m$Pk-Z!`UDC>G@zyJ!#!%Xb)lwbw3)Ag7;df>nBjg18FXMOu@xvS4l%7
zHT;PX6_rlJSI|QA{J8<3*ZW!n&Na;iAmhLtVVH-xFNXFZCFL4ZN{K|X)I_>WD<YzU
zBmn;F1D+V4fPmLN@+lV*cw<9AMp^eFb*SiZKn4`UxArA5cF)<c($0vv4(dHfKKbb%
z+v1(&)PlSN(J<pB@fjNL(_*o^4|V^tR04dmSUAs<!L&n)-TD0z#W()n&dC4cZ;NPd
z`V7mdPy#4uB_9ovNc$7K-+=#%9_(X>SZBrU^-xDtJsLuJYEUK<r1=0)Tv_tTxg!={
zo}N(=BY7IO)71l@Ld?pd1#KZrOu$PaeP`!d-kz%BC5w)XRQbE_(0*sSCIXiE^=p!#
zTWMjTd;|>iVgL^4cxPrRT?ehX-eeq=6eD@y<WlngARgj*k8R;7F|`XNB8mmu+ng&Q
zk=GV<fOM7C8+V4{h+Ki5#aYr2S^)u_cnz%&>)!yjV$rDt>-LW-5(iIllZf~V?yx{T
zk9jnh482)<FVmFsCGlEt<($a>4e4Xi&xoH9^eS<34*jeB8Q2WFqWF_p>FDTyNeM`7
z8b$h%v~nDagh<8gy{(W(peJTwaS>>}NA3;E5&wI2dR|hXQCbL+A;}eUCCQP|7f#n(
z2s`IaAi{VW&(3RmjUk9=An=(Az`7l#5Z<w3LG(g^ktCZ(><-6}05ZF7<kgQy0P6s=
zzF}X2KPGVSmr)r(oO^Nqu;Rc<G%j*}g4M*L_W*+JCt!m>Xc*4)qNhfA5EF7IK$q%T
ztTQ?iNTHWG5<oO5|NhbeU@H02*d9d0gcL-`Qfeg!(L@JG$=_)u-ydKc*;vBAx@W1w
zWSQy5Ge#%nG)#&>1EB4dD-bK@%HVzIk%uNdc9T{?d734!`~lp(v%PA_nAcUx$;n|5
zv8tv-fnLtfi=AO)eNI(6qyz-qj%)qhv20bEk=Q?adw2H4K*ts^7Oew4XMVoK@cTRL
zF$9X%<9(j@i6r9>r6Pdgd~{@_uGT`JHmTSQ9!x6Ds$0zukl5U9W8F55Zj*Ngyl;m>
zQ)%j9_T5Vvc*X*iw6x9_g4kkWW0_h(n>xV%xMIV=Oj=t@O3T?gm$A-hqD9GN-d}9g
zTHnwBi2I2f8m>G~PA2ty&@?wy>y!sN=Yc;JsDGfrACNmy6H_Tw?a@5k+(3EcX4=}@
z;rKQ6*54C2c0qpw6sS&<C2ARwcOHOzk5fC)ljz@*oVdA4#OviAbKtP@YXn#&ffEOe
zL@kT!h?gGepByfo-`>HeC;C~;-9)UqPWJXZvZ)ER-e-G$U%tF<4e06L%qEMO01WPb
zAT~NcvVEiEKUy|wH4_*Abv`xc&6N*C)GkM~u9mykiTGds2nP37p}if?3HQT=dY>6N
zI+iN~@No)CDPLbmgFcjuEDvA(Z`Lw#G#b#K2Riy%1F(iRkEOYuXg0W4$Y+xYdsfS5
z%ScHnq0>kufKn<obq=)HMNcFaw2XtQ48$B|W#vkn84G%=QKf+eyr`}!^%5{`K-FXb
zEgEyTpuOJ4!h$13BjPI<&c^YDudlD!VP*9=Jk_gG3n~$G+2wc$r~@IeHh%y9tyN~m
zkofSfzn`5M&=LmNsHkx~)(PvquLlfn4q^dM2p;9d`FS$GQ*QE`XWSgM5t)gn2Ab~h
z-*7QhEmpOgk5d|jfZ!b)-g;6$UB~-8M#g1F76+BsP|!38X{>0MJBog%CVN$2x88=H
znY9;);D2v4CYC_{?|P9b1kVN(M0z5Y2SH!k_H4s+ar$VCB6z3DIC&;)n@47MJrvB=
z-D?$0wN6e?LBr=KWqQB<bw}`ig;Hi9MC+WtN5{q%_PQu%?gn}_8HdRS=5GFEo4H1>
zQf49|qRaDh5;h(hnq{D8mood@UY`auNm7Y}!$DQ3{Hhk+81#+SId4apKBcGsmYdsE
zd~fkBVeA*x#)?l;5ySochP6<?0WZ0eof)R?gWhBTBt*pE>?e9wK~TU-40)N>p1*zj
zmWGA~jAp8;Xu_ER3G`PsdSAPjsg>_Ps{$R1VDHxbVHu6V%T}@op2wyyHdvCl1n9)T
z{0BxyThBt$$bCP5E!L^Rei>ons%6k*kYQirR+a|uE5X7_CCviG=+D<*IXuWDr4k5u
zxV^GQLL2Qf#53%Hc47DC(k&kJW`~4`T$?#LJ6l*?{c2xEGwm`9;*R3g5mOn0cQh>U
zctwe$?$5Z)0bynf_~Jn`dzVHsXlsYT;j8~OZ{+{wKt%h?fe3VpsMo-$I5RyB@Em5)
z%w3^<+thH0^J$^+mhVREw<s6Ycn43#OZE`gC}?^!m3iYpgzwy0K`)<FlhSkarQr|a
z_~;hWAz7~yOvF3!9-(IwMi$Xtn>9N9qJQ*+<8|~GC9x1#IM==<w|tgdkl|T+@tg>c
zP2Wu2p=^u*UrN|dlbGxMiM}2C)x^G??akvcK;T<*#8+BPJT`!y@9yr#!lY{MeX%Lr
z5u3T1tgtjPGTNXZZn_vLO7S|;vcH~u%iImD?7iB>yY-F6f4$cuI5=3<o0);3M7sc}
zDAL_snqs!LMT0BWRWoKy1vjn~`rV&l438d(z9~EkwB?8|)U8P`C&b5x&AHl(mmRP)
zWPy4eWW9!lhN^OcMw-G1$b0`4iOSYM1#~KG3VtJ=z&y^nI*-Xo;Q`yJnVH2}d+-*C
zvZwVq>t0lC;nW36N-lXpk00+?*cL@ESF!1PX5{87qJqPq0w-^A(@PI<>RfogS@K&x
zdo$qm4K(8hPgt=sGpn+N(}Tv>&CN}J+&~<t`U-H}&>N!>vFYdM=HiLP^{jwYes=*$
z;OyAqHK?|m2bxlMclY7J!Pe?j)6Rw7H}D*XMXrH60U(2d8zwNinbFaeT4W*$oqAV$
z&|V$Q1bWaxOm$t3*6==Sg<6~xmOHQYQ<Y6@nU#@VyvY>tESvCL`tg9O4ea#A;s=4e
z9@4y}22sh$*P}YNXjBP_iHi#hx{f$VZ*B7s-w)>%@x(+89~~Wy4&yVu$se6yV5oWh
zT4mUYRu&b=PRg!lrw{Q6E2_q7ZTii0q7&;TOwiXhH>)Ppa}Hg0bR*-nEI5#L8{7-Z
zhZ+68<!Dt{O{_GFs=T~wZ%$EiS;|MAJ3Lzq1EsbdFrl1qf;<Cw{930?X2Kv2IEV^>
z`lpRt-x$dQdYKq%VoywBq9sQ>c(I5TPvZ3o=&_bnP=E?J=N}Y=$R+X+5E5FP<jwi#
zR#x&bG0DV-1_jkEh6;pI3MC{Y0Im$Q1A~qR-KyW|#&@rqVPJ^odOi5z0rk80?}3<S
z{NLKS@^`4)wm(u+O0-zU9eI=}Df_-Qatk3@Lbh>dUn^s0C`)Av89Ui`QbNTb`!d!P
z#=djgw-JW-bU(*?9PbbBKkyvK^UL)EGuIs7>w8_-d7hv1^Z5wI347wU`W~sOsCamI
z0NONUr>lS~+5`?v$&;4I^H=}W<Hh^>79YCD^JBgPZy2aJYz|ipWz&2BfP+W~7?Nn*
zeOMUhZW-F+MUk`xcd*e<?$I0W#U>n>4fVK+5lV0epQMDH%f_W9Vu(#{i@|mv5m8fD
z?`UoY3~U8hK5*?X`6Zc+@du7uYsgi3Z_bf|-(1%52?-@0P*zfs#GfW|5@Utul@@HW
z)%(P)5wZ;plh>v3%b4acr1G^;KYp7Z*E<)jK(r3oGgSRgpFEjr<EvhbgGnD?+zc!%
zcEPrZhp{nEDCNY7I4*V8Y~HjyRNzh!%gdDYt+Vv^)YNp69g(B*0pk)D&n-MX?X`al
z`}t)7TX3^UF3gRxRnC0dt7~94QaJtnn5DUSv7(ZazkkTW;-b2S2G7mMS-h>CxQdds
zyTB?-P97;M)8NHJ{`y-r2EVm!9L1?=Ot>O@001y60wMPP`)cAv?y{Q~0iG+ae3n!C
zW4G~=8aVL0FM3a>d$=AGcS%&5!@s%t-UT$T-l{wrJq6v)-@_{%nmn`|_3P6cqIPZ*
z+oZ#)^vOPfzt9Tk%V6trSeVBX@|tC|`{{VM(y#JT{zmbf^H1q&$~7@=9XXmNa_;1A
zC7hu5t`;bn$6^Ii<#uXa`xrN=XXvHhI!(78Mn_kPdTcInMO9PMJeOJW<E$KHFJ9W)
z(%RprcrTD%5}FPO5+Xp6_o878oOO03Usr5|X)K<*VK4!~s+^~Rj2&=BY=4^XaI0!1
zba}2~Owya@%0v-m4=40=q5^z)_6{gYp^K6TMER>~XBln|OoSw5XOhLSYHOs@ojmNE
z54vb&jl%{7`og@Nos`(vwFJ>6Y+2U2_Dk#D^_h0}-Q{o9j`y?uFpU`Dxqqcft1pnA
zgi6}>ieSUvP)RD{_DG|by;f_XW!T@ZH=T+>Ex287teJ2}p*Wjouu*kZU3bv0C9pyQ
zeQL}5W>!C0-fL+;e7K&p;+6gWJpfTrkkAsG#$S{y)ooO$OmG-~DRg|xAXd{Q=r~dd
zr2yCuC`W>}2<k7m+Z51fNhzt`-rly>cdL(Y!1I@sK(<+uot<4+NHi;9U}grOw6we&
zvL5*I&dyG2t4ab9E@#L^KSQEBF;UFk$)nt(r6GfbBR4WK0+t2!_4Uv@1KS@+k-(q{
zaP9i~yOgrp+S=!{9gOHiIh-snFE2P6K#c6O%M>=&)^>(y4RsR8!nU_v)QSxZ3;@++
zK%r1<Y=sirpf__Ml@Sk2`<#0}eE8reu4t1$9>rDnq`;jRg*eYHP}5>lm-HdHYjYWA
z_NvKf;_(D=nQQOjHUAt?x8Yw8c6UQ9X>N{IKH1k46visC-U)}Ax9x~OCPPm2Zi_E{
z=zTBO=kZg@Wz6UEL9cTs8fzW~QGMvRV3@?VSd(-m)OExiB+rDhvh5i@Mx+c<{Up;P
zW&V3k(e-NE+$vvKK~W<c6qmD0<LzYy)7snHgV%zosi}oUmf*3}f&%56eL?RQ%6010
z`(z~V-|st#mptR!$6Wzqv}2`;+1QPT36Ol*7#oiOQ4~0O3zB!wDg@33$732ud@E;B
zb*PTxjxOX^mk#A)%-unj2Pu1``EQ^qpvjh1l=>>5XEg>vE@p(E{<q~4*aU@zg+Y88
zEH`}gh`VhaJSITd@I)W}D(gJ=mbYzd3!F7d=*k(t3eZw?cM0>JV0e)of?*YRlHUj(
z-!(ls!H}DbJNRvKxce(UCOto2wef9(H;P(yrsQPJxmk6tJTyDIB<B0^;09pifw{s4
z6fJ|r|9)CY(ob32A4yhP-o=KT6_V2Z30Vm~30fJFPGdFDK+rQXD%{_h&rUhb0pA@Y
zk&>2}fsUG;Eab*R3pcTX;WZX*H;Ex<kZgFaTti@T{s<XuK86^bDJktq4O=(6mmY=;
zJaJ%!9K(cwND?ur`Tvc+R6`n)6l7dZytCF{!w)CLjNIkFy-5uqwfSNERw8MI$(^fW
z&3D<lVpi~fRL{5WXWeN)Arbq*oXY>yc)V)>dWW+=vSean0xccawQGPo=<za{YpSZM
zdU;hgn6-3tlsVS=q(PSr2%r$7fF@$%^E>n06>)JreFH;7R%T{07*?I;7#th~)I$<%
z#`gEUi2n+TcZg3++y`5%6d6z5$P73hpmw<}A@L<MQ?d7Ebe&@Sa&D-UlvB{n{BKYi
z-B(eG2UV4q*Zvv4O4I5W&w79xXwi`<0Ta&mW~WGERZf*a5*!;F3x^5D7cY)|rZC>r
zt#53!u(SlKq#PF)&~TM{cf`CD#}$p;btMq=lW<g0Rb`@!n_kVmyw4W+&V~!H=AQok
z>uu{{Y*Hg$8)^f$jq7EpL^wE72?S&ObYLKo5}ettU+v><Z@;v?M2d=va$W4ld>Rn7
z>mTDc)*0t@?;H33MC~e?>coV|PZsu$&D*<E&=F}Zpv|9ng7!>^(KqE351u0KS4bq%
z=Ec#k@?;y}%^`8q$M<0uT{+r5%2I8CJ)O!VRCDpns`|6A!Aa0y!r^ebx<A3}<B9(5
z+qaVi&ELox>!fzt_PKTv<ml*!##<L|C!VOu<GywM`n`);3zCFBp9zqE(nUcV#w{a^
zYRtTHV3^Z6H+y~SQ#QRI7WI(Fe-1p$?Co{RA%loC{{s0O5I4#$34L%hWOD?S<d15-
z)<ghkZfIp?WM*!W$=sk~%E;Ixlcho)>4>X>Z%MK@j`eayU9?WeG1ESp|MR?W3r{1&
zx-ydUHt%H7DX0|c+JYwyV4&-Nsi_e^nztRJriN=6_V}b-wv@{vV1g}>-|#Z2%KL6d
z>8pvU-MhECu@S`yR(nTm+DK03wLCgz>#y0O%d0g>g#|MO3)H3}H|OfKhw06*5%+^R
zKuut(H^%cip%R-03zYz6Y(zu}WT4>n0xgQcI<_&f<AHzCQX>u;9_MC**0vQ`6_C^c
zLkjk-d8eyy#UoT$8Y7Bn=M1B7(3&)u$eK#?{O>5{6cK-C>NtY@)S3y!G*nGr*APF{
zPF3R#r_kwbaVmZIgR9(|!JEI&t8g`hum}l9uquEYM$^n};zzF5l90Gp`|pie&|6gv
zpV<+1lvz0A%l*aY)888+i2+LDhEx2BX@Kdmw+L`1N@96nyPoR)^=o#CKwAKmMY#7z
zNmag`X6+YIOok?7U9+|or^37Vo}tt+>{H{l)FL(Dl#1K!P3eF-9dJV6<3N=HRz3_2
zz&?PqC&=I5*~KL*J3A&inudc@xwW$s`1v5tU7Vk{wzd7F#|zdyz(QVHT8ie(t*n%m
zl{L1n{P?lQ;?t2L7>m87_rVknUA%}!vb6PQ0}6!#J=sd&vFr&It3$B-n*?&^oSZq>
zbU^9V(a|X^EL6qwf=1aLKL?%9&4fi#`3g~NbhC9*jGx!7u#9T#PSNP%uGd-Mn(Qie
ze7~^?ONIvP7{IlbI%ChldUQ}8Jn(*>qarktZUR(=7BQkNwx3WTP@p5^JLMF$G201@
zwUHg6Q_UaSQAqy#6_@L*tgWHuf{K|bI5RB`jh~K;jHK+5Z;qdbdms4Qz#xx^hzO!%
z8!WR=u!yLxt|nS&tzQKW^|R;CqlZB=KvH_<9~kJd{<c~Gnzj(#0d?65xuGBk4b|sD
z48l;fUA&$rTEw#A4m>&$+pkf-Yy{&rmu$Zqh{P4qiG2Y#9@xx_-%g@h&gh&)gu`7!
zkXo)#V2OG#`zj&yZ!4}%zce1ATey$fr-1?pJkoAm1hu^ot)L}ak2DtfXBEm2My;%J
z{)yFpCdtSv-liFQIrQ7$hKUT8OF&?)j$ZCZr>h);Hv9Fwo~Z!!cwyyF7Fg_7<TX|B
zabX64$RV>u9NSG$iJF%Lzd8yRfMs9{bpg%E$q6rObUp5v;lx$ss#^T9?_1#?$|1Q2
z(60d0HzYQe)tFo`gamX5l;mSBe&Zpt7z9BXZ*HkEn^EaxU;E+&kw}!qxqkm_`wNm5
zz!g`P!fGtn?ojUt29Y_|i>h;vTn#xnr;5HUue&HAyWoxTnGjf6Smyuvpg#4EcxJ|j
z!|HO+<8Wvvk*nSd(-%fo5YmBr{D@I*lS5>BxzsUJ6o!_1^$%u=d4==rT!=+Dk~IlW
ze%m{`)}kVX>qtfj{tBn);|K&Q{4`iKpu+Px5g{c2jF?ZvSthSJXdq~ja5`T`%#;N>
zy2R8$8Vf#<T-<y~(gTBCPD5|QsC*MpbqHj7F(L18J9KJF8n>v|AVUt3!9tBNkPq>H
z6t^czRig&ejKm}#1poX=$5C%v%w|mR%0G&9RhgMGvIjK5(=CgOqv9l|zkeQvy>3xa
zGXe!IC}krBd+iP+n_D|I^73ux7Z;PE93m2<(Xa6M?Tn0TP^B`pMKy)v*x2*v-u8nu
zK^Oca!M&&F-MgWXkTkyP%ApY-hnaT9-mGbGA$DE(F+e4L7U6Z85jp04R1l0*K{f2M
z;-FVLC-*K+LZUMUf7^pRoCkgFal5)s*>9z`zk1<b0EWV2F-ISxIQNNq7xT1KjMifk
zH~cmT0L4AGi&YY!1G_WV{pReYWVeae%!bZ4u3nvApDq@4Fa%yw!~Sn;AhMPjnCvV$
zZXE73ts8wyHZGl0yc%}Nmv54XX3TqIhC(W}c0X}KZm&u1tJz;GnifD+)A#U5J9p*Q
zt=fS=@-Xuw-R;4-?(&5D2Mg_>sJMQyu#k<fsuX>yyUS@mLMa)rU%5nyjR6W-;{v)p
z_WWV($&^8{On2j-)byOvn_YQ(%fT1XPt1w%-=w{^{(d|2+-f;oBBFvumJ6}+ZK-Um
zzu!~0cw~Dc#WF`IJ-zAIFLq`$tE^YgK;Ri>hyF@;eRp>s;}L1Bg{y10V2MlNQgei^
zGT6@T8JoUWK0-&tM5_4w#h+z}@GLm&sR6oD;y3`toOX2Jw?=(Luw;kTe)Xy%zp6?X
zKT2?03(d<zE6}m}(nDxLF$fCvvirC#;cvMwBrYsm$=_-Kt4Tdx&5kmIFY6JTn<gP_
zo|aIhg8eJ_u0Gb=Nui+$9wgZYoU7g&?rp={Ya+RAY~BQ%6D8#h4H3Dt<iUfESf*lK
zZ<CZ18JU0=RqS<BBj%a6iJnBpqtSmZ4{WsWtjRUE^NPeBD>AOqHLwxcr$wv^OhqD$
zuPR6K$%uGCH?mc@6S^Wtd;KNH9}D9`)8~Et<O8VO*blX-S7nAk<BtewLLtZ06gGEH
zA%+-We~E09_47+Gh_Oo*M;^N&N&(R44Qbjqa_v}ynGlG^^dmCRf5-oT71+aF(U@`j
U`tCtEyfK8bqWaw;wCRig0Zu{QYXATM

literal 29330
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
H3%C9YvEMky

diff --git a/doc/devel/uml/fig129157.png b/doc/devel/uml/fig129157.png
index 7ce020fc69bff2d06b1458860bb377efc0a4a694..4dcbb89015717089e6ff0cab2603b4ce3da9c1db 100644
GIT binary patch
literal 30378
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
Q;&t8mLrFFpW%TfW0Mobo+yDRo

literal 35457
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
R(AF!&11W`j1xSPE{{vQ1H~jzr

diff --git a/doc/devel/uml/fig129285.png b/doc/devel/uml/fig129285.png
index c42d770d3d69538b18a4a9eefa8bce43845ea628..9aa187cc128561a0f85d0f3e89a26ef82454c761 100644
GIT binary patch
literal 46235
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
QHv;ikTvjaap|0ou0PHlu82|tP

literal 53559
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
aUZKnSJi9fzPS**aB4i|=O5};_z4>3s?l_bH

diff --git a/doc/devel/uml/fig129413.png b/doc/devel/uml/fig129413.png
index 2d44734a8f39748be66f7d627cd294b511526679..df8722ad204d59d46078e4734bbade67ba738c37 100644
GIT binary patch
literal 15598
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%0ATs?pO_vR+0()lp%`4NBeYXNUE^w;YSXo$Y?{$dA
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

literal 17100
zcmbun1zc3!+BQCjh@zB~NGYkL(nuL}cZZVF-3$XN4I(YAQYtOdF@&^$bPSE;&^6S+
ze~mupInQ~{dH>(}zL%e|nc1`VT5GR$-Pe8H*P2ijC24%Tn|Kfi1YcH0LJb1BFc1Dd
zxO@S;a)Gmt6au*gk(GF);hDNV>E)}gd3L_tYd0o`#bz=VMnu}8MwIU!p!QTkCEyY1
z>g78TS0Aure-yvd{8|z#ShZfA|LDRxM3Wp>#ZiKo@?G}5d$)wIsoZI&x7IataDl-L
z;P+#*tooU|Wp}*AJhx;Vda6)A`8%MfRF};mS3?TW2ByHnYAo=73;ieXuUoVR1ma&U
z!wP{sG-M=$K;Ci2fVQhp$l^dCAH%ais|O|3!1=3xJ)ISE34i|&R>?&vM9*KG5<tO6
z{ey9iqK8Ul{36c&pD&DQ2U(RfnO9~6R5pbvIY&|g^E2VpMuUHoSEthPJuYHJWx5_(
zR~I_--pS(<#2?ox+441eVg6EUB$ei8jS?=aQbv0Exw)3`*7+yF1We4#<fNo=b%9Er
z)-0axntowops62%2x#;w>?g@N^r!_LALe_@u@g2mHAUcxpB<XY$;p|SnZ3M(FBL^=
zIDyw~v70TQxH??GMxU#kvGL>mlT4{d6H`-<%_$Cg92^|@$>ion{fT{S$KFQG=D6$V
z4Z<}W4#VobMqE1E(c)+Gt&tS$I=AS1MNz3CjEsz)rWqF*XdbnWYzjgGdex1!=zO;V
z#%%pilODpZ%TL)$M9k3-CDhc^j9}>f6aj~+YB!tqH@Eriimj$rhw|JEH>c`+?ClE+
zk<)%B>kLsMACTS|Vo)QW^)e~}d!3?h7WxNeP0h_w)IuMS$Dt%F>E5e%Q^>u|#1C<l
z>x_IFr*cUd^Mh@7_eAK*FFtJGv0{#**5y^K@jY_hUmfBys?`A_gB&T+Z+&D-`#f2z
z%z8*YS7|6;S6#yIbh}Nj%zEXu6zsdjt~4E#*Q!6OIhZgwIM}$xz55Q)&6|2UIyzv0
zYHMq2HmbY4nfMW3isEBpb_SHi-PXs;+>pajV#gn|Sz6VDwG{_W=X?-ZN$gRgR2;0H
zj)p34wv)EQJ%k{Fq}Q)szj@R8XnVLo|G+%|oYsY#OaP1?6VpNqg)u2{>6kCLT5<6`
z!;#)JVHWzpz`%s++qcj8gqyyop6GQYa0om9lyP@I82qH}FjZS+(VeUYSA$zX-`#i5
z%-zA;)wqz5V<mN+B?q#lewBiA&<)y?D%8=@K@V>1e6Tj=P=C}~|1(xuOvvK<Tm1@q
zGIDaIRKdQE2W(pT&-qg%8HI$rHYTd*zc?>+Y8!b;N<45|HG^MIi5wpZd;Pl5sP1?Z
zc7Eb94fPnvQB1(6)W4$C`o2x@T0GQ_F&-izg++8@XLlD2b4GkTpK0qgV#<3@AKKd5
zy1SP{J9JAe(u7=c{Lsg!DIW(g6;q22z~my29xJtkfoA{~!`laLpG(dN#ZQ0e$b#|y
ztX*VJT0Zs>T0qPo#mLOeZ#}qN0Y|T&9_>b&aOjuY4(BIX9=w>|(J*?JF86LbkysHD
z(5b$w;j0uq@Dh7ozm9zq?^xr4+|%0kSP-n%WrMqhhB0z8w{jqmIL+1K$7)xIzL7$<
z*vW$YE-0)t;mI-)5vfBUe(y=21!m2mLheE!;&b*oxBozuQz{y;mf`bS6?lI@$z0pA
z3Krz>?nsSh<&)cxhGr4x3W|n@09-s{jQ94Fd1H;gk~A$xotrG<LS{w`s3Cuaoc~LN
z`q$IHWhK$t9KY3PTF(<1-n$=b;p`E3pk^$aCT8KiGHlwfFnqp|=a`|N!YN;h1u;@<
z9KrV&PvUlv+ZX=q^ZD%)`6Vv9(}(i{15@mV`+8+Ib@2zoT;g%Q!9C|{2^QFp+E-#^
zAt45E_qtwFXtIVi_sj~GHm4zR9>FDKPfTA?)Y;P}+~KlI+1IM!J7}ozL7m@vwRu(c
zTUj0^KDkvyiNio~4qZL!y{h@s-T;(#J#5S6C1QGH>WjsbqAVkN=hLn2#F~0r_A0ks
zEjY_DAHK~4k8uOyDkpSnNTL*P-V}R|l)`G>CxOE0Vz1kL^wuJ%P8ay8&yi5Y_)OLq
zlRX7whKUihF;&#<pszeiY;tL(NDIb?oYZY0V`Ihqd^r_Frs-yIo!3fF)0Wto^rk;R
z7LSgpTMD0*XBHw?Vh1G64&uhn4}a42)*gNrjocLSTFdG_7T4Jc2$A3mlS@gnU>Ayo
z<xG;S18guJIAf)E$>}-rZCT<;>^^<EjhkTsec-aAkithT?mNMK%mW6=zN}HURDOaJ
z(jb2W9T3t!>9#@pz;8MGg*+R#mRV7+d&#gk{4h5pB3-Qdm}V&PyY9|BN_;%g>PO|H
zbMb>-g<g^E3=;Y;+jLZtW_uaZ+IgyWE2r7whKC*1j_9C$$t<-6IX9}oG7Xs3sC>8u
z2lr=(>96S3_&hjl71dgb5OAm%GtkKV7y&c85!IX*nD_yoATO@c5aOTsMq`UjaX`W^
zZR$O;Iz-3g!{|M{8)c6lQ=@tVgM#$L^)+<Nj`}=1g;G|ZX*S;!|8dx?Nq19R>q?%9
zdOf%;iodR6&Cb!I1_I%FwuehkPtjv|h(y4kO9dVhSzweTvaHKKTkiCpa-bb@ca<o#
z*;ck0iIYx;e^QcI8VGtc#^Z~|?1h9VPzo(@nVzc|#Dk}k3KN;0Ri~+T74+Ksd1iQW
z?lL0|hyJW!qbT}%*YRj>A^W^$aHnXd?L~iC<K+5<Kj!9O=;zqd+m@C+JuE(ALXLwE
zi75rGXCgv*hB=L?bh-My3Bt+(GB44N!OSFE!xEf07?4tau!EE90=%|O#iqDXP~OeV
zpGqB=u{3sxqVV=j-d~A}R=42rxM#R{q@5w|y|w%iEA#Q=$7)7OUhC&|7V0y>yW&~(
z$<{|DM-1KaeL-rr6#ktG$#<1|*?cGuUs<@$G;cmnUW}sqJf?1uA?Ea8Av-Q4nOIqD
z&#b$~#$Kp|=`sTHE_Li8@sjw5iMPD!p+c|v=;HFE$3?y@8T+K$p>1>DDiMn9Jw5K<
zo3X|AcTUJ%8Z#hoeDU^!;IYPOe8#~ih(Dq3<4`pA;YBEbqtnhD%fPpD6aXFkZ<$<S
z`$h_T1n}n~1;aZc^-~<nyVwwsca=w<J9ok_k>tJt?B@<m3Ip^UiiQrpd1z4@`;w>f
z4IoS#_X#p2Vx6Cs#zu<L*?I+n6CGd5@<glpwv6sJ@>9H}EQ3I_iPbfJz>Hz=w`TKq
z|4FURSX@kUic(aRFc5W^{XI0P@s0Mc;}U;Dwtt@YKT<HKX*!6%@v+6I0FE?X`q61p
z#M^6xM)Ts9k9$J7ltS7IG8{BNYspH`9!_GHG@BTHLXIW;g4x6DSfug+VnA8KX!Pg>
zt~SE^F>;thFI-0JvDW6q6s-Y|TrlX#R<_NwF+#+8cY!34ZRq2mg<6VUx6S08%IK7Y
z6LjIGB;yxNv!=JNSUt2lLOP!FWev?{2UCen-Sg8pZ50p*YhQwjZ^jIntFC>pgnPQr
zQ&Bk>)s9ul&x`IJ+@PUKpd~=!M%C{x_YFx4_pDS3x$X8&qYZ>UIH$<kS@RdH)J7jD
zUMD`03X_?l@T#%g;H*{s82Fs9?o1_?R<X8x=>^U%cm(xv!a@R{?KFytd|C*iCi%@%
zLVnh#Q5mt+E@_MU6l{_iv4{w8jNH*>%h4K%s-ZnQEDrgaF=ZrCZRU1Aef*%O{G@t%
zWVb6_(?;8^UdZKr72=CMg4rRQh86){m9>%;ns<@2&oYb+voSjuU2E&7L+)!9v5<>7
z?c~K~PuwkjoPh^vNbLEUYIUNdPaJAZMRw$v6_PsT`@sB(oXqo(5Rtv{CtY;L_Hp@C
z+5%Z7Ayw_R@E8|FZ`p~9FmY7{qAuab%#W8)+H0R~I5RIPoCW!shLV4XAC);_Ua^>b
z#*i74SzcdP_NeAkGzWul&)V{;(Zg-bOfl~7u4ZC05cMfji<SFu?h)|8*pJ|o&YGZq
z;khwQ&ET_ov~fqyV;!8#)2qV9mkX#_s}0U)tFIQgPB5M@t>;$2edl(L43|(n)B3J?
zALrSd<aF;JV}mFEAZl3X%Nz(3lkWUJ3gsb#4*Ia(3DIiZk?!LP7kH#Kh31@`b=$C5
z`SIHj>XWs%=I_Zr7{VRVYX_wSU35n7Iuc5LP;MVz_fTYogPK#M!4V>!teK5}rH|2F
zXYD9$$#5LU@fQW>VtOq<ky`CF-2{!_{5Zi}5Lse|%qr*-=A?*j*NP4`C6PCf1=B3j
z!G5CV=_XWp+EUjO)_WqZc(iwBx#>~ar^vv+-aAT1PMILWHx@57&MQ0O7944NrnXxK
z9S)Oup8bPAcD(Wn?o8@|O%&y6SdNvKcY2XN)~(97ys^n6S3Axhz};=vJBi~RNGA?|
zb|@eJJlJ*%uVrIkHf?%!C4ufFa&xJsJT6q0C;sh|8)!gY>eSCg%FZ25!tKdu44k(L
zmuq|{sXea)hBJfG!?$;HM~t;Zv5W0@e>zm%uD2%;3H8FTAZ@-c)`?7pzLR*KI2auI
zFH$Xo_}nG)Z)S(pWQ{$G7s{}rkbqcCyvbck;*AaY=%tHpu=w`vUD(~n0KY1`Dp%e{
zYqMYGoO(L&lFXK}1;eW1g1S{*9)G{swxDvUP=e&VPV{|vW#Sk3oKYvlm-810LC%#}
z3n%20vgV4wydr&Mv`q%@xpOH-?iRx*hzfpmw(rG<4@+)+y2uTZ!t=+kom6k(L|>2A
zxIhVdEZ3ctbcm-Jz$P2W1_v49|63}Fna}^laQttt{?H$j=EMakW8fQ$Q@PiLR^oRk
zsyJxi0I2(L#^t(J$lWl|amb4o&Bc!uROvt`iP&wM@b0&8VLtZg8|I9&7XTwKb4oqD
zopX2<49l%$5IQdZ!Eyh8(q)Key7Y!%``yQ^@09<UTemC|0zKfqBgwsG^}lD?e-6#V
zdpqqo+A0KpzVP2=>HoXaKQ?70MZoIqWoCHXxogI`G`8HZA&_#x7Z=FEaH%Mzr!OIy
zFA9EnM+e9aMB~{-QWH6$r`jjPf71^FtURY@hs9sty!TmBBAlF<Lm|1t^Pb%xFNJnX
zKEdIe9AtG7!oU9qZzQqStu3%JbH&D63NYu2QlJh$Ypz~yr&#b%NdEMV8iTl=Bgxq|
z55z`G6r1@wB4ZOdbeQRvlrntkn|Ea+W2#%+g^N%8LjXtJBu8+3QjO7Zd-|4l;H&Du
z9I_?K54u+@){Hr#;_Z3nmg(rN=lvM{>Iy9N7X8Z%Dt3C&>)wJ6`i+D*FV!wFNii`?
zF%ig7YHU3TKwsxtCvTA4`*g^5tO0@b<?EG})eQ4n_b=DPPDj!Rx;KvFV5igGa~y0)
z*ybQy7vh~;AkH{L4glJoIw4dw{l-s9;l9`;bN5%@uANIcm#*xSBsl2O4&7tzh;!XL
zP(4|dn*Gkjy%|*{{z<jJ4<X%BCKex1cWD@&>$f_n(P!2fa@SHRt<P=JqT{<c5B8Un
z+qaD4rk%2tLG}e!uRr`o9QSg+a-!eBzCcNVslLeg<AJZsTg%9iLaN@NpdeZfk()HM
zb@QjMKM#E#XN;d;oKMct6>lHdUCW~ijG7QpD^Zi|!Wxaw>Ia=G$gLO-`FNW?5s$OX
zYE()9$uECkI7RUWci-Pv)vql+t0{gO(okc;nUdte=pcRYT1b6qqT0*mEcwWy^k}B+
zrDoIT<!Zm#2^`}4DcuA}>tu`FhC8<ElPcgY9taDUH}@#U_?!K%sPw$ey#Sfo_uQMG
z9cuPL*N=pFNZTU5DoV`7%zs(52yL&9M}kz1FCo9(V0I2~J&z){5@ObO)^Pw*lJGFh
zPyax_u<OcG__r1<ETi9(#D>Ahhk2Wl_>)2Q&ex*>2}V2j@gGx9mJ~CzYmC+@<t;+m
z5j@khaoo>0zE&0H|ERBi(#Mf0%!mAXHsj5bmn>qrvpgcr!l!UOI#^#km0wuVwZ!nk
zA?dEhDcP=u|HCi#3)PiBD}^_!2eOhr4}C00^&1&i+}XOXEQynveGMX4n)>Fnd)$G%
z7CtlFtxw-CQeM@}{m>DlwEn$6SG=T%DEXaq4o1fMX8Y*5{aQWcvCcMdZ=koefqI73
z{NOby>IQAwh9*{~IAjKwU6gHD@b!gDU}+tuE9%_Nf&5y7FPQQ{3T}g0j)BA~A$R@x
z3QsRVj5NYrA|?wSe|hv2fSJFCka*dn0Xae30WU1%2^JPsXdm6*Wj+w3I=}fH=k7CU
z>8cTsdSz$pm_W%W7jZHL4HT!1o%o=K<Rhn!s-YBDxlSVV{D`xgeROaP6zTl6x5x-L
zXQ%p#0gs-cHNmUxoHcwy^!+#VeE*08*<{_Gvo+^}T)YPw?-^agV1BI-iys8j8QRyG
zTl`a|#Zn+v{Y74^4CaxUwX1D=8VPXrm-wjS7XgnCM$s5muO@_@cH>_p+&GypsvN^T
z?dzrzVAK9&uu9^@K^D31S?wk_!@l6$T&RVG0(Zc!F5H|f8JUgAd8UXfE}$df&A2D%
zaXhh0ldfzXH^@<r2$;l;h+*#LbvUl==@y2?9Ld)BAj;}<-PAI(jy8KKh~*_sMY-Jl
zwvoN{{904>vM1-%hf!#}-Pb=2t6W>EnGWP3cV1^*XfU;(s;u&z-Pwq8H+}%Ka+2>)
z%n5JroQR*l6h$Ru{xg9@e@g$*2&Cu<@uX9n2Bj|DO_W!sJx?N2PgBYCwLp&7QvE?S
zUtTWJjcp{f9W=~ZV(|I($!~svAVm~G9FNI1GpC8T_kT2pU-X~*JyROAsSlFQ57AK|
zvpsemN=!@N7(6MPigsgIPt;kxc`h9+Z47sx{78HAruWyakE&14dr$I$v^iK=k3D+e
zQ8W+SpP~XJOUWtqzuJyxCAp(3^IQ~`K#NvPb4LobYXE8yXzOU`d<C=p``&kuoN?j%
z+^sjPMaS%nyKp{}dE9BkQk<vRuuSOh{KaA=xuujMDwW%L`S88eof2b{W?O!`TK9X(
zy~6fl=`O5oUuvyAHHj&=_WXx*^N<olUi$^wH1_vDSV)v=b(cF#oh^LkszDd(JF#6W
zAUf74%C#tZYxv$IP`vJdC0HKvF#?P<_A&lS#d4RVO+w)c?Fe+`oU_ge9fZD)+_5MX
z;uPYvu}=ue*RSH-kJm^cvncAN6?5`DVL>d>bdV5t85>%Zj;ZB<QHDpHgs=FigG4hd
zq?v4EvIJFd=1@0|9%`!=J7`JgqUOYU$1MdrCCe0783=TtAn(@uYTETWA7A%CKH}_v
zv!HsS*2x8+{u3WUQPgDB_`Y?o4tM4(6u;&36F&edNh?VnlThs%mT^0sn%gB$=0;I%
zH_1lm3>-*ne7AQP%IK1!`Q|$;Gf1OP=a2Z=PM4db`12>XcD54d5iL{|4CTfjZU!-S
z;@9Zm6h@rA0l*`R!^+0Wj#ogm>MOg&+sr{N)`fZZyE@hk)qzz5%hAJV3&Gh=rnSoN
zG%u)Sar}J*9lhT;F~`MTXgu-|-@LDb0R%3gD{PIF>JTb`8(a5-p9Q|Xa09H@iRRe>
zD%&QxH*IlG{nm@6!K!4^!Td_va0#%RUjZKPX~BykDoEKK!G&}OyP?BL<5Rr)yfk%q
z<CGuv;iS(sBT2OY4#VkXB=f1<!1zh^l`V08>EpAL<CBlKvAQe>V_9c3!EFPY1z%iO
ztnIcSq^e1)y}$)TL&vBuxQwwD^qGgRN)V!gW|?a~*Tf#F1*~$jSllE$22320@X-7l
zX$BHrB)%&@gP(c==m@4Zp~4=_@*eO8S)Q_x=g*FovWi2lZ3<6>E50&ePkU$n{%lP7
zjxs>iJHzjh!PJ~Ze$xAZSybwH4#jA0a`{a+bG&SdC~k7(5D5gOffnnV!x|WBD9R!F
z-mmGExRRrh=TXxFAOxZ9g%gI#ZQ_O+I=qKfjr9Et?}K&F?`_dfr}n(kQar@|4lT7u
z$tp@B{Z$tLJ@jYO6B#!dI?xQa<RXt25#8*}W^29iMwSP9Zx&m=BpvNzROPxrmvL%(
zI<q~nsC>16D7l{3P(o|5klnsJu;S{-ngNgfR%Nuh6i`MM>H;^j>yz~eiY~L7>T%|S
z?CqUdD9v>?t<PY&nw>5??nz7VD*B+BJu<A12H6~Honhb6h4~mBLdK>!u``qa<Ue!v
zEBN^P8l_klAu)LVF`D@reJwFSw*;@EInQh6@Fwcr5XWtwXEi0i{aVSzayn#&BV4I9
z4IPCLcA(hF^A<oQBq+MXyB-Gzo*bkZ_;Ea`a&b12nq6;-E{ZTXJZi$OA^d6oy^LKT
zr5huy@1VyvEBs1_>P-xs4TdM!iFGTS4OiJdCDh<C2yP>S`HnSaVuUv?!#$k}x|@(A
za917Aj+i2HF4}dp)FYsY_k`L|p;RWGY<`DY0%n=9ewr_*6Th6$mzM0N2XjR4Vy6S@
zw_c^4URv~)U)b*X=KI~8-aNyig9s)biEo$LhDF(^>-=XVGVtWM*z*UP0?%b+lWx&h
zRpHLfpR4HT>`l0kNHX4@B{UgYF+o2)-plSzIX~N5xk~fkn$6&H)#xZzjR)Pn<gO|=
z!yTQu7YhN+vaDX-Q#1EpN-NWG(BCI)^L3laV|}J6VYXgah9oSci2gceh3K*MG3}>1
zV5`mD7G-nMwihjP8!Fet-?Vw|HO!p0+_JkTkNXZU2G78GrC(Fg#^E&O-tFcuwXky*
zPQ&Ws4wjTlglA9BPKn7_UvU~fFp_X~v81T@jHn2A-#B&Lnjy?l@LK;CnthexweS8A
zs&kg9LA}%E(v{|ijiI`7#jVSP26Mk>#mQE4g<iSuQKW#HiHX6357#Jn6td;W;K$ZW
zt3zY0F+WtU^Msj;U;D{Md7qNNfn%?`*a7b~smSgTPYan!cg~<<hk6Wj60ZR)<+!12
zdGX+&pr1<_T!jq<=VBuaBDG;5Z@U+5Mur0eHHY2M6IB@oV?;20T%LH?3Cl>vT19R~
zNNw>hj&Vf`Q`-nN%cq8@HySF;6%G{jJDolmFfq3u?+E$rCnoEm@}^Z|wggu&KSDkS
zZK6J}5!wn$e$O{1dV}zhRn7~GN4w&n@+23EP@65X4v{%RIo{A`KQDIPo$D@ea1gCP
z8vq@^2j){0Vjv20b6H)?fS*)3ODq6sV9-|2Wj=*U^5<@ShDXQhmpksNK<VQ#;nu^q
za`Rl74T=(opd)iIZuxRn%eCX)J7MUVsdBZC)*JnvSu}Z+qTczqvsHk9s@AjADY4aO
zasB?WEw>4GGQ9tEc{LN|TDf#Egs`m0ushUges%u}L52AMZDym5PtkhJP<ARR7fHGz
z`I3IwO*%;-?N}92&M`Mfn<|Xz4#1v<`=N6}zS?>jms+4D%^Lg*OG>c6l%mG9Q$>9a
z+vs4E?;aI>QWsCYZz>}sK;`!>7`FiQw!l|<ArAj;Z=uh@K^cPni``E7=xm87d@U(1
zA&y5(T4G$;fs3AB8m)J~tlDp4f2%E+MysTqHU+J7Y+6^py8o?-Maj>t|JkhFrfp5p
z2^4%(x6EA=S&cu=w_N@eF>4;2a#m=C(bIJOzIBx6Bj$@6{X3V{1LUcd)cW=#6WR#H
zea{21;S-CdBZcRDwBOUwt)P|`(w-&DHKt)TQJEgATjAeW0n^VoTUs$PM&W(BK~K+d
z{$pn*=B1@`&rgSTf%KurU*}kdBlD=#?te2dBPV9j{P1@vtaz(xeQ6wBl@>CASf85s
zYRsidGRCd;)tF9jI>F5c0)GPdXu5MaK|S4tAGUPJ>a(UEipOlhVVondN+SbNhKU=g
z8dl<UXdrU-Za#o}oK1bum!z?D`^t5SyfVsPB~$97a*F97#f{?tK5?Iu3zx6gN8P1Y
zwaauz_j2yql~%Ra`V89>f1=Sp+4|B<@4SPI9h)yT)D4YgWrNjxG4X5xv*a5=xF~$L
zwz;Xy)P_zUsvz+i>YmSz`0_plb%Vn5A6|f}3;3s(fG`xNZlKWj)dbg|_VzQ|$32Is
z=5SqdJ*K@zF~TsJxyo;UQM`t-2P{Dk{#EP}WKX@v{0z)#6z8bV^Z+W}Tz?oys#Tv)
zKGSCGJ7%N(d#wx*eacqJi;-|a#pDj}gV0_py^|{>%r~MiYS%#d3<c|+`zR1g;FSrX
zH9PR0A{zY~uwJNe1jM{{V#TVUzLWHpV4Abj>D+C$Eccx<wXTnS8TqG1=9YH6^a%|^
z7`x^zgJ<d?IlX{fgot4jDYvql6RT_GrQvkCzN;zf+nICFN$Lh%kN`G_y1q@!{T!`X
z!+xdOCS!~CC5Qw6G$urxH6-Meq1;H`@%Fs+uh<4}$KaiX?^iro{H6ek*boRtgZRx4
zMP0j^5uQ<vH#5cWkdM3yr0W>iy|B++cGd)BH2+*6<XpVWkRNi{D?1hFYay5K;}`)A
zZH6|!x9i?bi=SjyUxc?&_I+!br<7bk-RJ}&(8G5nLXJuyNi&tya$WJyo3`$Y0LA~-
zk3FjC-eYPXDJBR!C*HHd{G;puueUVTQYG^n<wJP~JW~bMdsaEuT`tSE7z3Nd2(fNw
z0Q@59)tE3m8P)*6Wj*nPTFLw<B;+L2RIy~4-b8E6u=&E95uHn-t-`uEg^Xl{s#pJN
zz;Gm_S^SSVQ`=(U1OK+)<MLPcMuTW-B9_Cv=p{^&_!rd(FhefvsaBtB!+#TrP>x2I
zY9moM^8e-w*_f@p=1KLNLH<?hn`ri;{EsaP-sPV8XBMXkDyk6whgt-a*x$t^f9Itu
z)f+!`6$d)i9u9o%uTao5<I*t&Pw^f3;-`k281lNaCqlruMH_4JK^X_r&WYB5i$;$X
z0z?--LGF;8oRM`!x9(`%<GPC*R@=|LK{tQb1aB?=UhLJ*e%{C^-gjcL7CQ$Kdi8j6
z!Dm!tafevMQZO*5I{(^bi@^*29`T+|<zFZu7j6KaTN@&j@{kgvhW{ty%U?hGH=XO(
z>HZD8wVRH{0$5vsQ9&-|Xv%9HRbTPP1+%W9W|-Y@V7u|P-OX}Y`_x+7Ms8xEzcWS&
z#&b`<icxzYWlfz7_%L^yY4BR*SY_t4jD*vnkC&f8gD^(|&r_R$UbOdh@73`Yk~6_a
z5|{o+Z;PiN%oy_;jzA|b#RcV9O&nd@y4wAjPrt^-E|WR3UifHoG{BT1-|!wNzG6$`
z+fq*N{78SoU_`sU0vCf;A-g)#VoyMV^?dk))5})M4EtCMy?S#mZ1tDmPF)r3QPwx&
z&Ey_<pL~P@`D~FQ3Dq`{F?eTXc|Ef=MntsN4=FZ9(|PY8sz{%B?YC&Bwyn)b)?j>1
zj?#4{S027{oH9CG!a-~I-b&Bab8p{fB+~N9lP6K+w2=f+Q%-);L)Mx_MpZY}8CqjB
zUZ+IaBwL_wDfgBFdxMzsu1t#@83*pu`2h4V^ea`|6E#(!KW9Ha;>Cfy7zVl+NX*yU
zr|w&>rs@kgbQ|+b|0{33MGx}7JGQZm?BaS{6-D+Rbv}Jy(?=a%)d*ud%B<ub?vlp8
zQRY6TM_lE+f~o$8%S?;!(QI#ARxZOTG)>3okMn&|!P<nI`zJ;WQ#2)Z1N_9H@~^v+
zQ<&(HT7~jZrXig#^e%xRr_jD>d4u=R{kgZ@7AFPsKlYz6C3pcsjxv}iU7AZ@_0SNY
zt-PT=<FtoSY3lgr$}F#E5Jz`vvMQ&DD@ycR<l?W3x`NcA3^|luVipuqE4sV>=<dr!
zr4&RdtoOS1bK}YPzj?1W^e2*EpU{&eSjnKq)(#}KXZ!PT{!n`p9%^QK#pdLjgm`}J
zH+F;XS5djJX%_CSh4&^@F210{YrRIjyO|0LZ*MN3Q%Z?vrstR6$al-tHZ~+ONe_dY
zq~j6E3>O$sBvN}U8G4+#&gQzK$`C$QMMe5QixiTrCUEDE&r8lzKe_P3s)THwBtX^f
z(}GfMVjL$iA46;JjUp?(@f52hSoha+BRk?glin85*7^Tg*Q7){(ePMfgZjc{#!p3A
zQ-(_$w@rhyl$EAS%%z8e*o`aNjgxo>>bp*w@`8=)J%tMGCqP=4${1h#`I%6zGrhG`
zh)iP?4&jLRsF#|RR>9ctfWD2yAW^hDPU1MPZDxvF3eySaCc~%79w1_hfE2jy8A-4?
zER6<;qh|yA^Og}PH<t^KWMpKXKmWMUhN!SdB$lM-u663F^0#TYM34D}BJd?;0TRsk
zxUG&Hoeab2I7E(*HhSrvpZOQ1%ugq985AOqV}#^^f++zkOFvIarybB1dC(4b<?<9U
zi{o|uig3Je3k7!f)+kA!P2?&oasBdO$SKQj{>XlbzTOK@e}~DyFUIj4Szcdd$?ws#
z+fx!1pE<HGnRGYXEapn$XIno_+TGrtkKI%(9C>FHYLgB`%az&zS^U_To6KoKZp?P>
z$-ghvCPD^l0e!u5)gtzzKc*xV5~8z_qtVKJ2L=Me!x<i>11B|qPI7Y$>_2Lh1rj4h
zY=K-RCuqjIFX@CiiKqlqFyF_V(b$5ig!lzu&Uo;v5`wb<L{B3P0+xE`O1?M~?Hc_+
z!*vqyu`SLeit_%i*9#j~YW>+f@~+UXt@?ihRgZu57-CvS`&68#j~n&lPfUL|-aE`9
z<kD1%a^y0HwbaGEzfhkhuQ69((k0d%YaGy6Q8O+k-bjWiVS&^=`<XA-ZuYeshwPq&
zphO&Z-MAali3Q@f6;Mf8I$c&38ZZH-Ht!o-P<$Qa+UlBh%2D|pOc4jQg+`KB9FU!q
zvrkOAt=YjE|Fwk}eu7;%6Fc{pLO!NI@9)#;{Qh$0##Vi^y!ND8bhze2Xsx^`pa<_x
zsjK~DB(ykmH8HYft2g8#Hn<VtfE#r4bsa$>FR<|ZAtJO@4J@T^ZutVu5j<UjHL<60
z0Q9{EmfY;8j$*$nk53{B_eBe0Z!&emVD%w7tT&NfCA;Cqu!FLaodd=3^Q8vZn)X`{
zMvSH~%u!-|;UVUMZ8$kgH3NY(k;`BT-M0ZeOdR&I$NjFvx=A(86EjW>xe*i2CS5*P
zr{$r1LtkQ=5P>%Cg}Q>Kvs4c7=-7->ldiD447obmykTy#D?spmKrB>z@-Q;wrs9W`
z(V{Jdvm{G>abc^`tk^cCn`LW>5Tm9l@pQE&j^g+1_WK0cr~g@)Y(F<78$1+$AaZ<M
zhLqa>@#9BkpmgMg6WEk7U#+#OY9HL?47&EC1PBN0$z|=H75bd4*8K`KeiK7NIW9_m
zJ$oesHY0hH4l?4wZ0xM;dO$$1@V1cX4oM8EBc0})@(Wcyc>5&1&UzI*mTBYD`rKi1
z&q}ERyg!RbggT|J-E(8%(n^#<uBR#taid%%&-haajfCIkF3||k^$NwC>KgIYeh#_j
z>D{oJKjijdwf1;8kD%g)D$fVqJPY6(ItO~|q~AzEC0UTxW$5P-^-}Hcg(@XY8Ad0u
z%}fEG2X_M?*&yy$w#`!Fql5PJ_ZB|z$&a{3A?x>GiBpw+&3>V7UZrEyiPVXF0`d|7
zWfPC(K6m4lj#v_A2-c!w*Fi7~4OuASEFH7GJHV9PW!#ExafN?coaB@IHj9Va7(LNC
zuP|CaTQxPLJ2B~{AV~B?{CjomK;3#LYRMyfotb_Uy&~F0%m3dniu|1YQ3slZmo6}o
zz&<({s8jm3cx4>@T?wr=)N`xynqPcTb~WgL)_bGI<#)7_YCgHCSLFM@*FjP3WyWd*
z$(lCh?jz$;iZ`JiJ2fTPZJataPa6iXFTK7w%3Z(kUNl&$R%C7f20eBjNsJX{Q9hi1
zCCkGS3Ceuj?PdRE#f?LFzz?~w`*~<-y^l^R(O|Z7neZ2NpJ6NXJtrq457fHsR-Z+E
zr#}LOVNSH`ihv=E1o5D}C6j|!u{1-C<ad3|Vkl+3rj{#5DuU?~wE*1+Z})LP>|HTw
zd)iNcZtUBp|Kdptr#tbI|D-Pu8ypw9M#S*rU}7q{l)y3fT{xzK!KV#GR{P0XK3KP}
zshnbbF>7_9v7pDJe5o?qm{$wZ$c2L;d?4t#nj>jp0gfSW=k5YE7_#Xta=g8@I$P&A
zZS$>$q1<kq`E}0VH>S3Nc7xmWFylScb?s%}uqZw-v*2zG@E^ZQaN{8(>9W3360F*v
zMC{IZiDgsL_`jll03f1Nx0d+1p5#C%N6AP(3}tL7DcVqR?OImqeo!a2<Cao@eHQ4&
zdKTuzx<w{6UH5FV)6J>F3B+K}C6q8?a>RZ!yN+q((bzpu9mBNmd<&Gu4%R1F=qX{{
z&uI}8Bi&e}e+|YQ^hj|-aZnaB7Qj`xoGE@5)<<`1>z<KH`Y3{R#`+inX@LKkp-ePS
zDnPWiWVcEGm6C(xhjaFBVFbaw7c=m~EKiIP)tBK{>0dCCoCutJ_$C$<`mwHI(DIo`
zQz>;2nTZ_a518M&pMrT4lL<AT*fBEs=q;dA6Sk>x-FIiN5qP?lw-<+3Zx38tLCFJ`
z2d&6(_3i+3z^xFSC4Y?MU3lBC!P_`mZ{`W+`r8Acq^(Ygu5%BNQ1dlW*lFF#n+!iS
zQVBIIqC<t`&<Hj1)~Wd)S2LbUar_RB{yv9!Hyv>@NR=_BT7!6@`#c!ehJL`zFVjbG
z@rxbs;Tc*t&O<CZ`uw;M<uFWo`&T>v#%#o;1~OkYOv3utgvOE3lDFaZ)D8a8+v%8#
z#gSE9e1XDbDY5+7_N*leQVLSQ6{hugIOdQkue#^~(9!Pl#}UUm-9x_HkK!C=Z7EM>
z$Z5#Kq-D+bJF4bwUMK40sFlgpx%i-Z)+bpiluth%rpgLsBZdRuG?l83nXYc4fp68Q
z-NSQ#SqUDJjnu=-y#^P%SU9ymtA6Uv;x9`cxgH(yHbQ#Zdk-jRG)u0)Aat~}=~qat
zS_R(cOBoiaK3=XUh4WD)ml3Tu))Vskl#Kl{osCb~AmGzeImOK!$>HBCil+Fd`Sl$>
z?!M@$vZ|WiJT{V`*Oz3Dki9p}j}TCh_+T7yhQd9!7cD6>4-~+&9~~UxwL>EGd+o$2
z^zQCWO;54WYxf$vW!n|r%6Uf(MrMYhD%K@)T#7GcdTlRf0Fh&h{E`)3GGXw11IR?6
z4Xp%Gbu}%Mz?Ao;&BDWQe7|81yCCSR^+fje(5|-l%BgHAMM_!5l$fcZRAN3S)mdd@
zPVs(_J=(X68&AE!sO;Nz=rGkdud}-6<W{=z{vfYi+a3*Q{o>=&<{;6n32Ym+;nU*H
zV7>crv&4xC7rWIknFV3iTw57p#k2h>xP%$vr=8OH;sf~WyREL;aK9^!FG0af6zg=s
z5BSRv9^+v$8i<eW!3-Q-bZfg$Wm?|w2wCn3{G^iqN~9=J&9Qy}?0r%Bf;$86Grk8}
zq-c(jmRm%ejS4i3{#fbGRp-xo^(rW&{YjDN*VFBVYF&@f;x|9uRH`~5rp68i=W-*M
z2v*5g>gqSh)b2}2=$*Y^Xk@}otLWxPotl$?z|=Z1wjsawDQ;cSC#z$5@yQz8wAz>R
zZqZj4!i#qUe{{b8(6vuj7~URqo9gp$p|^6d&nnZf@ZR?ObG>-OXWBQYuA|}lnpw!|
z`JhmlH0f21JmYmRQO>o;%L{d+i3|4ZT-sq#-^|#>n<DfehmvX1NNQat35gzi;S^D3
z#Nya^Nf{xRFgra9Tr5dcOkbksXSx+%r6#(3pDV4BamPmPM|U;!*~rkp+1?gvpGDQ~
zw^z8-a}?TxK{Pxs?eay~a&m8`mmy}a-c19T4vRtogV}cP2>zoE;O3c0hnzVpQzv2^
zj`e{jtkbGhih5KhmI9HZU&T#fI%YaMgJ#55d>@A_?`CLz(#`fuIp(ALSOpzFsEl?3
zbKPJFs@XP1V~1BW6j2ac&be7>@M{vkR;-1tm&XPLju61!jbIClkFFGh-5|iPn1Hs>
zeIEY<_e5lQD=;pZSnI+ehbs9RxpJSYAy*aYV5ZegI_w5X=I%k@OEs=&+5`%i!rOa|
zJErh$bOi1zvbf|wb-cJxV?yjln2kLfvu`i@ydv{iBl-nIBK}ynJg<N!`D=ergXrnX
zwaOR&CG^bIi$f;nqbzxK3guh*_T^a^n4d`Gb7e<eKbmKeR0KDB)F^1HqfB$FOwclm
z1e+2^41<pnJA1XjDBC)J<vxk;IQfu}GD`x2<ib>IT^yPWr503lu_4lh;~7r2l-gZY
zh_6~F7E0|B1Xr*#fmoPm0b_V*Y<JGjhPAj|Bt5+NJDfD+z2I*ol2%DKphVvWww@R~
zBG0#D{!g1hCIXq6{snCR7FT?m<Kb0DHPpWXfx4Jzi?hIoxqFSnMcXyInCNpD@n=BU
zV)|8D)xl7};3N`SOA?SW1qA#asJ{dh|LYO{Ak5f0@<CxOLwf;VGGS9!>Yu3)7*r*T
zfo>2P<PXSV9LOU?L%N%H)UNu5fEc55BiN`vG(6uUt_0c6wsi&E8+Eu6r;Mqf#wC{^
zPxrJp+15CfpZz14{Nri4KF2KuLzzUv11dP@4J<9{7)=XBq@|LMIjA7kQnCNl_o4p(
zA*S|0{*RB_&sKev8KZ(>Hj^EefZza1!Tuha7z^1UWzTcRjd9cnf7H0|(YFOTKGw3N
z!5pn!JpjW$a~AyINFU-*Te75k%<ntXG=b9mFXb3ezmP9XhgbjIHf#l71Wr-X=(4&I
z_m0&$gf_kpChUQ<a4Tz~qYB9O-q1-lch9x*y9fzJ)cVBMgIQ7d>X;3*2pj>FmFoCs
zRfNN>Akj9Zmc!lCwwKF?Ih$!AqSvW%@n8TE4)o%H$X{0l*g0N5pe6BPTuM@m`YwI0
zK!(!T8?bAMo}RGo;Kxo|A{7&|bqN2{4HHgo{Z&0Kp;#AY*pvDagR6big_M^sVV2f?
zE9UC5G=Mt9>=HkJV<Nz~tEA{17a2)}ksXrhU$Ifxh=;TlJT#0ORr&Mo^E3vw*CFj=
zc9x}WX5lgb$57uVfyObJ4--ZqKDw(G=H~*7YjYPtczZ{YvPD#{d!@xo`{8i?D?|{C
z<4{@d?*L`mF)XW}=wZM~A6-CC(#Bj}nf{lu1K-$evSgOUKr$c&tJ}JSMRm6t+IS6F
zB2JhT2bQ%j8d&x#pi%oMH?~uKDTUToS4h~!4}ebYVfV=Yw-^o#O@B3fq8tTC{xd^i
zNyGY&8Mk02)}N#Z;)Zd<Kf0~l%X8MckbIo|hB)>%{cvJGZYMq_J3mE5T*_P+hVEpM
zvqZR>+{%o5aqg$40g6LJ2LFmF*#J`}(uo#=eD0pG0Wl*kkSYJ2s|@SbW$;VG?uGe?
zO9Wrd8>d_(pZcn4U<@y}%!MZU;dAsC@O&|>Z<NdfLeO*Z33Y(=+uXS#P}H~x{0wuM
zku!~dBFgWM{|hM-o9}Flz^296H6XsNzu|=Z7rfvq^*aBOSt6&?Fubmz4MR`yo`N_1
zH^*LK4u6@hm_5BiF-EWp*uR;gKkF|*$;XV$)(5rIXY2N4F_FoKbr=Hd?-TI|uRhRl
z>9m|VS*r;>l1lM|w_uM0`xN6en~+k#N_`p>W{Kg}TQ^L?+Azj~J$B>Hy)Td^Fa0TS
zLly7V#4p`}5A!ojLgOeTjjU8SO3u*EQwgZJe@O2a|0%uCz~xT;FJlb*f6?9jd0M*5
zDW^Ot+1&IczCI`J`*1|lO+v-UX<Ru`YUfz5+9mE_i?a|!Sq7OgWHL%ESi|u(`NOT@
zl>~&-X&0xc?ZeUcroD_}14vX|?c_aVWc31&SZN)ub-u<d&krJ^MXu)tMK*O+yOupD
zuY6^bm)|fRuNt&I@!iAsPgOeKef#(g`~kTfp5GlJ;#iAherrA7x<jyEi+0#j2OMD}
za2qgffgOrvP}%cC3rQOR4G(#`Fm&UHpqB+~-2zU7h7D|b?tl0}(CP$9-HU9Ag%ZP&
zu9f_zH7iyt!0O3->hvOn^i=2G9di|1Gh5IU@u;)XSUuoOKu*-Ugu*YU>@WSpv)b<i
z^X~1B@8`|`1eK*QzEz9al@VY%@y=;I!y3LnI1D@>O4JWjC8W-uxz=6UFHar)vhXv(
z8-F#DQn2;TQA#2F$h9q3*QNBBV6DdcWHq0#l%4I9Zr&o$LTgYP_W6$_TJdQGoIBe&
zSjuZFw(178)g>9BR@EW--wmzK<H|t$e;H~fsk|McUeN-j2=wJixU_!$c)j)ZS_?h5
z`^+ftKJuVkHx}npVD&qoFTXu1^NyJbumfbqVOyx^2?_{I@@XF*9MtqxXYEpiI5+5a
zo`tEC1o&%*b%pTd4cnfKtpnSqo8kG<PVdm>$Ekm_o?1*VK$*K;CwvVCc#*gXdGl)^
zwXXF(TnJAjS!JQF^lr#XYWf^x2yAYn63?G6_cdiEEJ_ATBgD=7=syJBCo<(v5l1f%
zoG0yxQxP~g>a=7fz5c`OYVD%5ATbz06#atkDsADuqm$j}`R*C8yU^GVT3C+f!`hB$
zH1jm;ycet$B5!or2o%PcsP}hVm7uJ0PT&TU`j#Up8JX2>xPmp<__i3ZNH|J;>AR%G
ze1Q3eyi@E`uo>$6qA^}d_u|VD0<bR(Y{v!q$(c=Hi@14ddEs5dY2R%{7EM;I&(FPV
zCt2s6oXTuX!bpaZ6}7y<T+=yOY+OWB%|MB~)49m{u~6oD#@2Rilq93&lb&;*mGe-U
zf7gzmgtF<@J607U!PBRe_5P-F{jc&;XA#3Ki_)sf+%?UQI*skPg&I~UvzistoauVE
znvccLTfb3q4m%qfI8TIqC!^m%Ny4~FvT!TH)i9Rz3vEAzVuSZ-_&0lZH$Hl``COgi
zNr>=+x~erZ5_?tdH(Qks$Qg9>y_B9uwoH?Gjev4YBolZM2tyBm!Sc65u36{CBzLuX
zsnXS9&SKbSLB7pG-HCDAtZq4=Lh{x7`RWW6pFKIQ(dlwr=qF3ziCxEiIhB5N@GkC=
zOK$i27(92Ezoy>M^U5Di+*_(W0(DnoeAWtp=Z{lpqo-!$bfrmoeZ!{Ww<T8wxK|+%
z>O+flfvZ!-j>yG=2)G4rl-&k$v4IlMlRE{ZrJ9{4M~iAkQp50TDT3@L$Ti@b-p?qc
z6F03bO2M}L!<O5~AR}c)^a_Mt|A#6)ldS$~fGEx2US_+j2SWMp>gpkGwI)$2hDrU}
z)UZY6ns@8+pGw7y^0L;WVvx=IpM$`^gZJVhK>bs)XQRUhFTl40_+Y*l0H^UC#$yM$
z!*mjTi?cea0R$_ExG9aa?T1h(m;8|#g~z6XM8gXtxCxQq8sX7G?3IYAwCmdTRuSEb
zE4+%k*1Iz!m^a%~J*wj@xgDKH47!{*t`quzR$iu`qT+DwFEFufd61*?K=oQeuB)Ly
zI(<<CW?MsJ-h@<mzK`Ns1|RuNbM|LA_dwi%z*)PVM>pG(As^8#5let&Sp2vG52Kkp
zESaF;_;Q7<u#HrnvI)-?b8;c;{_|)g_Jf4tU#>#`ewWdexs3%)2n%LVdheNpp?^fx
z@R&u~lU?%1#4<={Cvzr*7SMc194#fz6vhr5cYRk?h2XL8BnTUD`d|6?X?!8_fPx>?
zo`HLMm?Fb1&777~_D-=-6<HiG1N>1=m~kug$a5SM07}i_{Y(CkJ3ZVG#zILVr2Hn&
z9?7Ty^)Y69LPMSbAt+@CN~mo+xaL8&t`0wI5i8Q+az(u;-;yr$_;`5)P$SQjzDFid
zWaHdxwY{7M+KT*Z7k$gI4sqn^io4&p^+z>n>)vzBdm<^riuJPiLPON(HT~UvGLeZ$
zuqWpV<16qj1D$fj>aQrv0$z=Q?SSU-oH>_enHq?+AP_uOHw93Pz7TU?ATs(EaD-FB
z#1omo_+23P0$YimnD=5f;rKHYfze6I<qiwTx=xy3bR=U9T9vxbF54@0HAe2otlSU;
z618iTiWx<~gc7*_R#f@-FK+mAV*bSo05SvQId&G*-5M%J$OEnfk(E@ED17|%#s3Ea
C4Pfa2

diff --git a/doc/devel/uml/fig129669.png b/doc/devel/uml/fig129669.png
index 36073fe33126c4e0f926550aec854da655a3af92..40f79983880689b6a593b58fc7804b94238cd701 100644
GIT binary patch
literal 20441
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
T!T*iG`kKMh)z4*}Q$iB}XFj$<

literal 21189
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%0D^V3wc+Y`
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
Nygg5Nu-(sp`72^7Uv>Zh

diff --git a/doc/devel/uml/fig130053.png b/doc/devel/uml/fig130053.png
index c25a4871d528404c3756d325be7941dba38b0ddf..4e6870854d72f550fb603c67acb971fdee47ec8c 100644
GIT binary patch
literal 32907
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
P1VZkXvUIl8gO~pUb92iq

literal 27516
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

diff --git a/doc/devel/uml/fig130309.png b/doc/devel/uml/fig130309.png
index d2e8f3f81bb102e17c4cd177dccfde893e57c67a..13a1d2dce5177456c409dfe399f3fb0cb998572f 100644
GIT binary patch
literal 35429
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
Q=R`<|$~?>z(Ruy90Q_4o7XSbN

literal 40215
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
SdIE=sh~Jk%Wr#j|{r>>>RqWUR

diff --git a/doc/devel/uml/fig130437.png b/doc/devel/uml/fig130437.png
index e9cfd85120172e50128dfb21e6daeb096b9437fa..395b022991c9feafae7e76dd2db9c7b03ff9f40f 100644
GIT binary patch
literal 37004
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

literal 41996
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
AWdHyG

diff --git a/doc/devel/uml/fig131077.png b/doc/devel/uml/fig131077.png
index eb1cfb2cf881f25212cfcd02faef57538fc3f10b..3963eca09f85a6743a9afe121f1a51abb63f5d23 100644
GIT binary patch
literal 18837
zcmdsfWmr{R+wDR{5EPJ>6iG=H5H>B+DUGy%bax4;AR&#EG)PMcNVDk<>F)0CI&=Fx
z&)e7e-ap^@as1=OUVE=K*IaYn_qfMB#`1e5BYF>w2n~Xud*Wh3@(^_MB?R5Lk9q@q
zf)c*F13?cVaiJHAPH~%)&KgSgbJx2)NX)wQYV(oU$(fo$zeI%12VPi9vw8$ds!+>4
zjcRX1HjlYw`?!sX;8#BSH{8gG2sMlOXY~G&@>xdAIC{)6sY%~{Oiq&<E_IU*p-*hu
z_N<@o%+6bJb}Uc0c2`^Sb-?_4jc~#BLqcLx(ZT<o5|7%DAgI-!3Iz;@A&dlk^j*vb
z9QpD8`~apX0R+*@%HfI<AUV8cBO=wjRa+ji0JR3@J8V8IyV=xR0Vea`2I*<*d_3vM
z%fpkW4cA&_VtoCh(SH$XrW2P7{bop1O4*oCbgz-yUK=g9{TeP7))V8tZ|&xdhg$d%
zIb;N{@B%cEAzGWc#ykA{@W%@2cgguQq-}P0ch`q<bCh$(CMz9%?hz~JC^PMoqueEY
z@}}NvVnRb$E|NuiDqTAE{Y?}!3TEw^jrsZcl~g1h+lzNM1$6UN#BuQO2CH3<4HKMc
zsHpTCKHZb$*%b;TV(;tgyK(cTt&L42llsxoxMl2hnf>~ZmzS4vu9{|<)$HkVBEQ2%
zv{h4-@M3lgvLdnyGUQi2qT=fAUK1P~oaHm2eSJ1OT4cCAQm6+`J32a=kdQDtJFBIo
zwZxA>#74)@udO*XIjI@%P#D$Js1%HziKeE4RQq~ktRzRX(m}n{0#DHG`ttZD3PwO+
z;N@Ni%kcNt^NWl2yK_xRNlCuGsQcuX7Z*P*CeIpiWHl-sq&4q*ri15D``T=zfa1|3
z!FUV|j685E6BCpDrLLEPf>qVk+tYAz0)nX6Sko&#Fm(+L4fb4`T3S;R<+g+Nu^g5O
zF)^#_>+1!SNIEP7iZ??DyUf4VkKe;>xm*B?O<y?dCRmhs;usJlpnL#>9zGS8BhkDC
z72rt<66vWRwFdHwB9&30U(2W2;~~C71p_~O9s2J-{{Q6wSr9Y0!{-@v{;3Y;U^A4M
z8X<w{NxCC4&v(A9C?~iHS1>}$&H0C|I-~?aW^~V=E5}E(n?~wM-iQ*4CxHYipFMkq
zN3D3NQo7~Y*l0<j`6x*@GyEoGG&xl*iH43|Y9Sr}-2APO5V<G;N+z@h=2VS<XpDxf
zSXxZ1_9Ke(96z3YZ|@yS(Qbb0xs0FY+5@ZgYQ==Rhr^=YSm(zX=jWJUs~BEiu@?QX
zA<=X&B1H_;-XD8yYid#_n)lt=etOL7*Dy-aqaa@=TF$anO#biWd{sVmPtNN;R_)Fc
z5Z!%aY<!1+MN3*{YOz-L<_E;BbjO_vpvq;)bbY!<{<KS@Q1^$A&v}+YR9Ki+|N6Vs
z)O$~#`bDu!b2@JA{Yswv@ZoC$U;IMZqnp<vh`U}taM7-w8s=%fL&3u{;f=+le#WF(
z0i&d}t@{vcGMv|2X07RQEz;Ij+27A{3pr4&`iubu@4-na{a_nxXO@=kLq;9s$wWod
zO~PvMB1ieY^jDs*Vb3}`I#~JK+oPXuGpil!_RBgxA*?6S6flaHkGPdYr=&(YR8Nf5
zHMij7jVo+D&|jget2<!4MeBoBxU(OKxT}9&v=K$q-a>L;hH}-31Dm-Wx2g{MBo#7b
zavSm6%?*@~b<cJe+QOA5I6+tr<a7<gxo%TZ$<r{Ns&b|d)9^l$mpk5?EOHSCr)8vi
z5r!j37}(69l6P`)f=U6NI*n9xNNj8lUHjf*$9S<ZrPnLmw`T{d({B4+3bMQrAt6>9
zBZY-}EiNuDw{PFhR;M%11tD-@c{!@A|IzrxtPgo}5b65X))d(7$I~9#x&Ap?)fK%)
zj6d}K&Tl}RkttqW6{wzvuyakZPRrM&*7MD?4L*)r6EF&jWThNs0%i@TtJCFRQtou-
z$b^KcZ{j$XmX@i#gt)i|-Q3#;>%*4kN1K;thpa?_X}KkOEkRn<E_mfn6I@;i{~QGu
zJ>6eE-Wat7H_7XI#Kx3L1KX#ToQTTRrY3SumX5n9z;dK`Z^wAy7XGj;tCG|G!s+_z
zGGDVYy?<4z#As`4Yppni&fDADKP9un)yZk1(or^}pVw)p7Cc5Hw#c8#FJ8QljaBzU
zk=Kvqir)hFIJ|0CUS2+!t;7(v;LrHlP5a0>0?M5Q&r{4MBq(Q6HqU(g=WxC@f#AvM
z>05n$FyT2W`5?we<3Gt)LBD$!1iTC^-R-IBwYa_^8(W5TyeHG?TKUs(4>;D`Ox?$~
zEU(9EAgBPJtmsw*$>o9<mVe5?_ty%jq0!NVWMp~$t9yHUOWpD6bM>Y}-~9pt0{r~$
z+_@vS{G~F|+43j0DF1hDxcfwzH3;|=6cl7+Z>udLzhFU7(pp@#{h)Kz;gC8hm)*)_
z<uS-lOI@*!YXgr(qgLQ-ha%7t=jj`Y$7(8{gQsFSty6q_L|?q9YmZ<UFEKUbOJI5W
zwAY9YpIncCoE&a3Sz$7mJz4GQI8yMYx3~8>zu3s9oRT~)jYPh8=~6LstE;CVf8}eG
z_w_a*L1jtzDMd)Q?2N$F3HtV?iuNS(^Ru(tcgMl>ngisPJL9=In3&9WX6n}VLPJA4
zBAK}DR$j@=_klF#jn$tnEh#0%<FqrA{L%-6BvL2F0?f4q4J6B3Y@fr)@x#(&@)~<x
z!INP(8EEb3DAMPd4kG1#ZZ;AUAHTV}`hbk=YNM!U>;QVhjqhF~-Y<&*d1i;qx!VYf
zjFEC$J!E7w11kdw32Bah{`Bl{9o(%YNK+swH<p+VgIq`Nb@H#7FfNY7hXi#aJzG4e
zkX7ab$BiLjVFHcd)U}0nb%Fb78rI+hh*^}$V4$N@EwzX*FyqnwmxO3I+3+4G#U4*U
z4qI~!8xJpN(JVJ7ogWT+FGmEjGGxW|R<Rx_LI9+{TC!HF0^}{h8<6MauiOVi!XS!4
z4!SM|rAamz%7Tc$j&#_Fq#ww{r@Lb)i6Vj=PTZ!u%|K5bJp!@~8<Iun>gkcHhCPyU
z4tnC#o{UJ9D5-^b5h955%SdT1N?hPMV?@-ll0mrCy=hExa<g8H&c8kk_B@q*F18Fq
zP1ps=)q06tYe^47LR~(Wwn#VghrYtyPo9gvFQL-A9QQSYBgY4Z{*>@WWKtptRC^e4
z|C9f*rfv3)&@${xAQuesq*3kDe?4YNs>EbCR+&_Ym-Y~#Otx<Uiu&2d^ixqXoLrrE
z_DCdNfMFSho)#5J+4?goRK4z>y_dfL!~Om77iW5UrWBZ=+M}L2ultw~Wd0a?Y(RaF
z>l@YS>8VR~O#m_gd^L8feFFmn8yg#QaP~>55d&neTZn;jCK)hLQ&V$to@|U3y=AoB
znkWbHs4JfP7=+q1riK~i!1)K5kbl@pUu0&c6*eB1p_$7EJX~DDK#_PEm1bt}gCdv1
zwMxhB?yu}Q6ZiT?)^r(pF2T9~_M7hT1+!xGy||7UV@(LUz+@8gxc$=T9s<x<;lp4s
zVH$d$I;^qZck=-k&jthzre|_^cR&5Qan^=JCy^qlo{~~OOYicttZ!6UFDGDy76qz>
zm&-He+~Vpfe}VwxUv(0eJC_Aa4nV#x;|x@3#jBH?)kWMP^rKICJsUlEde)K=qPvf0
z)0CyB=KNaYV>k^=Vd2M_vjN*y(bnzw_rGH_1l1xL0i;{TXp%6q7suOHZske`9yK1!
zcs<)0hwm6(C}d{#o$IOT5MxW^Ehz35p3ScthWX(*2AILNVwW1mn!h3$M>UT8Z=%%n
z7S4NhL|LlBrNA%*Q6GoJwaYngO;yKJcL)2cX&w1%yIHU7%;NF!9h$wOg9KoiAs<D=
z!WR_Nc?_G(r^@%w{qYhL`7VR8mlgA;BvF&;k^#J^t4nPO)~50z<lMPO(YV;b0TNiH
zee6XBfAvK9eg~~=f{KdDmtR>5Drgi5u3Pya^*dc(%Bq+6JFR6!sg?LgKYQzq^@#UU
zuq6nG%l_*~<?(@f=@#yEYepj3NCkUIQqnKQZ*#U_%v6##^rlMP@%-14iUWHTFLl=j
zvPJ<2#$JvNAne`$mAsgv{O+;W$d9*qSoJL#TKWqg-gap5+8H^^_pR%-G{@j?O;%P{
zL<h@OCwkN*d^tFqZD7D4aq`%mll8(%6@_zKPK^u<MBIL<YO<C!N4z@5ezMTE|K^RH
zWRyjBd;4Q+fRES|TVHTz+vSZP$QSC*<B{G?rt@EQw?QYcP=jBsWAZs&278#vjge4z
zrFanqp5sy%7g*(|(5(fhpK@ucy1T!x_*Pk|?tV2rppA!n(KT6JS+Nkwgu;KSKiz;i
z+_yRr#W-rlwza>r;=Vm46TdaxAT2TBi}i?w<vKO^s5827t%GH`#4?}7Iw&jT>C>lc
zY?NfL?6KdWODHOige%G19p<alIA78D=)D~p9;8|FO6hiK5XtEB)#XHHCf-dH2Qv0-
z%XlvK&pl7IYZ~bV_~D<_OKbKUae_4~kMeWX6{PnkC$7{-VQwdJl2Lrw+Sjw_1bLbB
zR0l58l%g_@tJoyu*TT7Km=R^6-~bhs+wOdD)Z83RvBjqL90+dK`nX2^6XG&T<vc2-
z7MmPXsKG(c&8Dh6ekGOSGr2tG9D$$2^(k9UP0+ILyXelD&d%D}a|KsbU6k8WN@_f#
zH?hjs>L+5)CdS%v%2AfaXPzi_*bIo$QrlR~+COrqqkgL#P7{nj+M2DTy)~V9)y~kv
zr20gQH}Cf%S+LN|T~S-g%@M}M#jU8UjNomtpjRVQQ+cC_tz;|)Cdmg+_Rc>{(icjy
z_E)QQSWUKJsk$0|l@2;@Ac2plTp`{J#d-L3;S`WStgrU3hXhhK^m`-_Co#9(K9f0t
z+x=Rla<edn&}FDL>&wvV(R2ydtw%FAG<e#wI`<I;dB?9;{4NMs?)ka*H=>^hVSezA
z#o#T1)MP}sEoy6RRs8a*AO8O4G?w7S)%iP*>o@V-aI>!k`U)JD2Jqu48saDdE3N?$
zhDpq}r>NJ2CM!z3v0`H2T2)SqBZas6y{L)Ht>=#pR(Jc;@0GlHfwcS*WSH7IqUUZx
zm%{)oQwSNY<Ouq1O{PlWfO8&i5^t`KraJG>x*oaFdX2#OC#OABOH6prj}v1eA}GBG
z*;be+yu9(8JUbq?MI^m0dSk*1&oB%g*1m>InAI7v4drqR<YTJ%yl!lyIy<>b?;3$Y
zN>g>Q*Vm3q08tTO?R+?6fjO6A=}y<A3HpZ94u7T5)x*ixhTE^ox7+sEvlALDFB1fi
z!++_ZN=izWIqjO*>@ia`E_D@oW1(O&JFX-{M<VMcavT;DHCD6j>-oVey{VhC4gB2+
zmvvRndJGkag*Q<Z^KRe30c_Na1QYv()+`KCwa7v@clWyEX>F&|#cLJs4>vu(w^z4K
zI8MiNThGz<CpN+__QuO?qkJ$n@o@(Z4pymRqcE*>F*3s$=4&h@BN+<~#U;K(MpAhB
z25bzMn69gpkfC8%(0c(amEj|L41(AvpPp*_bs49V3AK{5p{#z(CjTC9tl|9WwSL2j
z3`0zQc(Q0v9KIk4ugh3hSFYtW#`>^_rmCvb!AeXJsXD&)Zj`qB`V?<_e^E=)3(HA(
z;&`E6$7h0kyOk$(;IolJYm9dfpj!8%P428K1%AQL`}?lNl2J1ZDtwba-ddP#(2*y)
zTwMi*g*#?sXrrPLmAD+Lq*HsGGj(XC-H!WUTaqUtEDWnaoofwM5cEx#zDGtjIX@?_
zoS#7B#p!k;8sD9&oa;j)eb&($x^Fqv$>(Hs3g$Tasa^!uTob``4%qSAaP8wpoEksB
zX;g|J64+$6Qh1d1l}GIJO<w1{i_LLIZaY-Enz>B5ZJs@`TuZp-yUj5;nR8?1>!N0s
zniH*HGV|k2^&bXZKRvGYReWl&AsyPu3TfqQ-fK5AKlIL60%JBJa#ypRg|?0xH^>|v
z9X|&rhK2pecz13M?(OcUClp@6vb@^Uw_kp094T4xOdZX#KLnT))Eb8e2Y2t@Ra~yR
zzB&gO{^;naySsa9FlRVL`15TH5<0Ikx6?ht#CJbk4oxV8K!rP?-PF>OuU?v`R$}6~
zJw^K5Ox4Z~6c`HWQV1vvD3E+Q|I$)N35oUwOn!~S6f$0ybdPJ9j>zh@rF1qE#o>kq
zO;qcXoh$;a6;d3W-Eqs;+VAX7#!7mK*_=+meqc9Mz8;4EfS;}Hl$a(C=3nmwky@t*
z+O1&y%27EdVy{Y<m9=tobiLU9B&>XKIILdjKni!i+&?=cw;0IWq6~JLuCO=kN!UKx
zIJKCn3KT@OABJY?LBySt&Pk6+zXK-1<NEyB{@eQctCL`liymH4lcDcd`#lrhx4!CS
zaFrvF``@8@T%yMn?D6B(o!JHy3=-8Ur$Q`U0Nn*q$;rtNRRmG{^FfUf866FPd)-SP
z3_N`NY;{EC5zp-iDvzkIUrnA6$}1@3Xm!`u*B2MFl5+n%*f(8S9~bD7A0379UpZx|
zm(qG;9d9qAQOGOErlrOE`K$4nC{D-4or|PCrKH?%z;xuW;905nW&mGG;Bl^b=>uV6
z9)lUYEQP-#z#SNvoXl<YUrU#X<Gh~rsRVOp<%59)iclQEZ|Qj#I}LCenr^p)UVg<(
zUl2mkixlD~Vpt6UxTE$$MMqay1`zUXZ;CJ`|3v|S@;?gB7$_RYE#bM{r=X-*>Pbxe
ztHj9b-snwj>6hi7Op_#_5E2sdQfhZT+TaJQhgzwH0Us+9Q))p$fn<~pV$oGUR`|qo
z?Y8j}(^**Pz%P(=aWyOU$?PZ@Z#v)E3i;ez^Z7Z4gfwqNR8&5OwXg3=kxrc`DOWLL
zO^VF&?u4x-%3Y_+9uJH7MD1V6FD137&r(JCCrj494dq^PSh)4mi{64DjcECZj8J<2
zw473lNf$s1fMWW5Dc17rXw#I9$aEmndbKYN)H~W`R>`l64AOljV%-OmUVPkN?#Y3>
ztfocbGi$8;jr#)?k9`{;BEd3uT<xRg<EsIGP>KW;B-NhNzpIjwloQlL@EK%6AG3=t
z`W!g@{LyC1FlQy)#40Yb7WYtAZZNt9Zz$518gzYaZEcN?jt&XIvX@a*RLs|^CSo@M
z{Ohl5r5tZ`0-1QO66gJ;n3$Ngd@n4(Stxo8Ryps3uUlGfpC50xG+jErT3#E>X{fJH
zaN83vNsN0JgbZM;_(+yaH$JhfxOfcU1i*u2WVvZ?<4H|*rl*;bBG{@xo8i4Lf!;#L
zy__9h<X!g>1(S#^(}{x{Z<!9_q!7MiZ+9PxdSo4D>&UWBLn@LQ`UC~)ZkDsRIhuZ~
zL*8v~sIxBL5SJ<mXmK3|?BTZ8DNbD^9x>q0sM$Gj8C-PRJg&LAUSWVEF=oEy=9uJU
zQk$nn9(bk3fO4yh3V`M!-5Zph;0FZr8{*w+A7uw`E7yZWZbdEgb>X|~F_wks4M^sL
zd$p%M%s8y*kuCrOajU7(=WR$si{B{8zIzjbA$bPt){1D9gTj}vMcV+<AvYP;e@3FC
zz#O|EkrO!YZUgC{u=znpvp;fk+&(~_@iEino|tcH`80mYU_d$?Y~OAK34#Jk5$^$p
z6>gXY43~PqXd>f^#VeYR_lm{ibl)(MRJA~-D)sYi2t&_AEZ68$sy2&`CRI6_m@IrJ
z-(zxhq;PR<Q2TPH0WibqLCp6dPATfO*-jO|z`zm{YbelW^giaI{Fh(i;ZvA*9!#fq
zMbEeNd^Nz2c~Yv|v<xsJzTjPw5$Dsro=wG9kQD~egI~3o>aD_+;xeec`Pv!9#a^RD
zqQRuZhHZNwlvz$|v3MDcANgrk291~5K{JfF!W7d`w|IYU&SWM3W3QD-?gbVP=MFb_
z<3wcuUWRg1L{WQ_>KbBVhBsdcLRJrpM9p6FH*|ev?^qkZ#U|EoZ{vELfF-ywb(yQR
zZTdAP-1gdsoH?@0Emv)Dd(!oxSDEAX3jjh#GeRI84-;y{gHLk%niqb))4*$4Q+@>C
zZi#8?AS^WW5)>7L_(v_+QI^A7enp1Yqd(0*vl_Z9$G%3YrS1(uYZdGlXMSpJ5DL3K
z_UIq<Yx=CMOgj)8oO$izb39hQuL=r4hfOXrvZ)S>#aj?}5-rI?%FUm7Lz%Nmy-J_%
zty>?gtezj+29tIGR?$q39xC9!%?9oDS%g)(9>@CUrSv;9sy?~uj7cP5B;1~zwfHQL
z<T)8VJsCxaA|?SQDdJa3lU@+>4e-!|#gR2`10I&m=PpXwU2v5fo(@(j0BZuyTmUE2
z=cWcWII0mYLKco@1b8T@cJN6O(l3m)g$={AgA;(zMMY^jD;`1`B#wAU#UH5*X;)VX
zt`76LK@h*#EdAb>u#N^rG<e<?C@LPW$firquiBdkrOdFk-3Ppt#qic0`=u|BUxKK<
zxVY%*R7QY{o2T($FmDnEoToX^6*PJ*w}~D<w$y~Xo7Q^?mzSUVKZ;~YoJf~0Iyqq(
z${p9r{kpX^>Dut=FjHxrVxJsPz6{E4d{#P!6pgj-<D*!v-3GI>g4_Z7gkdrRb@kcB
zYrx&(`}(jAddPSk%;Jm<wx>3?Cr;m8T@WZJsC37$8gxb@Bj~B=cn(W5lQoHt6pZYL
zivLvKtyT1=H__76IPA>qz4TGW#V7iFLFYA6vhH+#<U%1d{!?~i%zom9=-pcTS9eeV
zL!E}QDSjNsCoC7x{O&piqpNE&x8Iq^DMY2nAhD{7cdhfo2e`A#QJJG<hRkwkY^+ME
z2;y^qrUqea6@S!nT$@{4k%`x(q})N~BL%G7+%5h6lsr|XQBfJE!99HEw2sGH<>i%=
zlaqV<=v7rNOUu_?*)4cPI5?>?Jz%l>tABbfZf7j1sK}rz@Nv^<IiRmQw7sMLSgbM^
zfc9!v*@Lw~_v0<gLl^CSDGm;f>Z#+}_uCEiS7ja^E&{dlf~eq=*3f><id!u$9&$ND
zFWuemm0G-8_M;`MblB8ZFHJ|IsJYnt^_9K9x{8NIs|p*Jjq6cL@M$m%Ha(E7bU9Ux
z0^ke$kL?88h(>A+X3>FYzRK8;yO%9@aSTtv6Du9ei%&1?*A1lN%2YG<>FDS*N-aKN
z>28iaV5u%1=~r0ZynH3m{+&je>>g%fPQUZQ;$lxc@nbI|P~=hRSCt;W1Sp`nDX^!j
zi{n}jwHK@=!=9@m^KpE`?u+lwi*9&&XL{XyMI>FC_ceX<;p5d<1{I5%qp_WGTaJ^n
z=ct(5Z<_-9E6~>eAbvtVICRr(l4MnZv{lSKmn?FR#dXVKq<~B`IHAUa|9GVE?njEw
zgv#3wNw?^4)C!JC+c<8!>-9{o+L58-2k_f2EhD2hgT*~=I}9xds?$Rq#ubTi@g+vP
z(W##yfgAdqP-MRaD5N;=jL9P@64~28Gdh6r%Vg`KhW(L?j7WKBA=S@6!{Sbt4FCso
zQ}TvDQQ7&&K-C=Y3heROd)_yV8QPFMUq)we)Et_(Bskt-PtHOKLbS|?b?I(Gv3*0V
zWE;UzsL#Sysv<Ho3)uHFPDUKz$<GqJG`PEa>W_W7V8rs%H}miXObLG_v8M+O^RV1M
z0<AZ*Cfu2UC(A2yPyx>27;Q6bA|F2Gax}`3t+K5I+C^>QQT$*bAMN>Le+>;aPW*wS
zEEFFnjhp3@YJg#7e%HuKFjb^FHpcng<yj0Uvx0(TGL@x|w<_mJH0f&3GQ*2%uwN3h
z+j{2AZL`sSiHInAcODu@JneRMx`hZAw26%lD_B-@jk4zBHJSb1B}Px@Kna0HArp5Z
zo{xFFxAx%vZcxQsSM2D!a}igUBcmy|lLX%BI}}ITvd72d0G{+*T^bs^UF6)$^b8AG
z`2Ibh$F81aCd}7bW~DiBT+p{xfd8=N>XMuHSYz1N*YU&0*sGlez}L7E-Yp{MY5g1!
z;JVkg1j<FrUo&s)+eStjL03Yv;>#XDVD~<ao}MDlx3I7g)`O_RtX1_juBt;$^wyV8
zLrSLdAJs;!1No<svSOI6nDq^n^R-AR8c+A(D~C0LzK84Z?zVD|wSly6--ZDIUom<q
zB{c_Vt(xnr`mvH;^D#E`y9eq8Gn8E^6aIf`0Vo>(tTD+GU#vN}pDvc#E;D12jxo_?
zuCDfrWAHpmVjF0C9bOpSXK*8gfZ)eI=;?|~*O1mXEW2NwP9tI>h^51MmpN}G;c1c_
zhWh%<sylL<W9&p6dBlV(phvs6S-L#sety$lm>(`$X?Lf_X0e}1eW|%QXm2-bd3%};
z=IrQl=AD!zm!smbI5L03pRx@}0M^Mc)@Jns@Z2JoXPErg7aP&hhx5(%PS&-x#iZh#
z_ZCi-b00mon27k@B(q&?&qT018=Q4)CiYWRVyV3+BYGccWwr3JcFF*8<#zGq%NO3w
z@!<VqOZ_Kau%jf;xiZ!Q^Ihy0BG~bz4s_W<`Jb9$JKePiZmL-5IDEd*!5zOw6mS><
za$pOEAXAb-GjKv33;|})^gUq#DWKIGwAj=#=+Km`Au0rcE}c5f0cC-dXM_<fZm$Gd
zk}Hn@DG+uuiNb_|ezi*pw#H0_0Db@|B~gIg%KV86r8Z(WS`o?%q*4jW4mQd;z(1Ko
z`u;)kjwd>0TSRaWfu{!HFGzqJu&^2^H;Evld*T?L>kk`{ei4Pm?fVA?D$xS?yEqaC
zbqBa`MvwKcM%}pgs7+}km|qJGjp!|(As}Fqlg-;z7mug6QIG@O4|+v0$TTeG`;flA
z{M27|y@_Ama~~PC<XQ#^2ekRvjrUeStJVt(RK7A2E?vW=FJhl}wQEtc?hk{4pM*P7
zC+fxx=AdO$V~tQXRhipHaX{ViFcH*?f-lE2BdjPWkihi-$r%$Gn)RD(1-)GDB7@k(
z=~p1J*so(mvl@QHdc=01L?Lv%B}XfBG4ONqGe}LJ@hNMr&N4p+-wFvl%XF<NF9~S2
zOF|8cV}JX0F@R*$b^PbR1J+ORyp^+E9NNBquUWiCN-eXn<`&vY?%&_Og~D+;>vP!P
zbNqzR07R1Il}9(9JtYcs^EM4R)r7%NJRccpmZak`(0~|vebB!c%s*B7?)-jguj;E;
zMm4qn-tFBvwp_^UyU`ttMi@AM3u+gRk7IXsDnqBBkybN!;>D!F`SeMFcqp>k&ja-e
zJ6jQvr4PvDgL#^%*7FrXbTkj|(d)4J5^*L8irEYiJQ%eEo8{ekHytA*uAoMR-QYn^
zV`B`Unk@(Eb?2KkA3rXts^TG4k*a-=#XC!)iN<+%o9~sJ(i-=7@4OcO6iyRWS1G9g
zuCB`k9mAlCVunI(CO5Ql9@A<+45|0e+%;@BIr-72DFNSah3}Sc6lh;r7h~CCXJ}u$
z2-GaKZ;T`dA6C>M{ciU7%&KcB5c;Bx+yLw8az``o?UCCw^;-UI#rxoc_+Jfbrl?zV
zvHcEtA?x3$!Ai`aycuC|rO7<(LrK5vk!aY%9c06~u!Z$Dd`mKsN`+5!(!24B8~OWZ
z`Uldpo3}|mfTgW`B0r2fWl>8ZX7eMZ<9-}g$+NLHYqO2x_lET<$dhqj8kQx-xs@Rk
z#D$*?BTujAb@9~hIyCtIvxdN|G&Gi@Xxh~>{M2he%;uRKD@lCIEKlck-b|dG`BEak
zXW+(UrG8I>FiX`h*RkS=pX058#HAUs!5oPpMB*|S={>LbL}qz7Y1zGxi5#&0S#4l%
z_Ft<FB*t66vX5U}e5$B)%vX1;je`+;VST(^P3^TZar(C3>m|mJnwSmt%sF<qpKYJ_
z<LlX#4+83-5(0F2-4oZdgJo%iXh9@sgY^EcjFnYCxw|UAn-k{8H%CDD@Gp@+r#R4T
zJd#VVxuD39qv~`C{pr(nZ>(639>CJ^lufX`*`6<^7vcHRGirfaZ^%IML0M6HR`b)#
zIN1JstQ48}ulI=gbibDCHt7QbLm`8inz}lD_*_JkSXURDMZ3m&Yhp3^WhF8)JMTNL
ztbo9SRh+%umh+#M{JLyJ=xAu0t^!8_VGM~4+q8ykM4#<s<(8w<H#MFc;TV2JpWnYF
zBba~8#Mh7Dn0kMtP4}h68g>%?H141NC$+=9PX+fWm#X&KZ2`X~<wqRDW<2VT7hdUb
zPpi`5{HM97)INd&WRokkFjprH+w85Nf3SZalfEe+RT4#|!8z^zT_Nv%$$yXdKo$Xr
zuY{w`meX^NXN2_<>QA5jnD)B!`RpiOPE{4qX?CmGf8*k!X*L`QpTA0bFQ!J=@(qYw
z))szCB@W%6ujObSnRb&86`)DVJg21)rijN%#IyQj+9Eey@Rs4~a=k1}^?<CmVohGk
z5=P#iNwPo79>>ERz(HX3fC^@;m>J|H=Hvg&QrP|z|Iiy@Hw=h5fNFWp*RBAI_7nPi
z7qSMSxD1WbDJL`8YIfO+GKegEE&HV7-Y<+WjZ;KJRZ0J<t-GZ<ve#>^-pLSY6VTTU
z7dM|ie?Ih{x)6CxtE8EydRMFRZk~2)N7I@FVqa1C+7Su7%toI#_pXZDXQm2b7HkSx
z(3f8z%l&zBlFl8UGbe3Fy<h{;fa=<+mGlOl@YBhZUpxk*XD{Qn?0(E^+A7&u-O>r7
zqJ94;aqQ@tBx6%azDhbTxz)a99Ici_T;^HOrEQ$p@&e(nnJ^~?q%ZHOXmOT}l_>gP
z#9T7v*i+I_BxPH&1R=$&YPwaA>DIHjWz6T0{KGc!mzQpiW3tX7Vk56Z-*<+ngc5P)
z5gGa0m0nm0Qo&%+D%G6k(X7dvgBVWYnjiPIyFI0?`OC8@+r*Pv4XbhA$OwNcVtzg4
z_~rfkOz8V(FvPjULu_vt-sEbwFY`{G*YSN%ywHU>O=I#ilV}D#q-Fi4EjyxBI+3ox
zjg{Ldwdr6BD!{Q9vg24)4u7i9Zs@$x?6V&hxWA{B0O`L73s10P%5Cb6$6)?Q#0fcw
zgxMl9V=XBPag{+bYS58TnC*RLoF&D8kSBn6_$#|62>}qG^nyGL4741B0Ns{eQbbH&
zU;p;4swA1~S<I>JYL2I%K;i1I53*Ziu5#G?+1gr0pzUS=ibi4gG`eKNZnvc2^T^65
z5X*-1uU*E9lOu8O$Xiu2U=+~qceEU+FwnPm^&)$+$J{Qipqlrf^OwJPa=fMa!>}g>
z5Rkm)W9|MHqvPkv08U00)}oManEjfWmE{`+IyjZyz*wNt03qf?A|J!>)xrd2Gm;f&
zSX_?v=93KheT~o<kdr}v_VT&~gb)007$_<G6<zb`k{>*XnRa*06aIXk-Q*w!W?RBV
z%YA;lu%Mal-O#Y?;&S8!0Qx}n#XR{i28o!ggv%u;lDQp7a0KHxcf+;Fw-yIkAI*{4
zcbE>D?e7x<5mvRuB$Dlt*%R}%7(=a`*F`;`|B6m=`<{y=YA<N5{%beKP>qv|>&-&z
z>2tT)SL`PDNLKH8DkR$vBA4s4nwCphGd*`u9F?p&nRDG7Uk?vQp{Cttwtk<dsm_0H
zwp{noP_x3W#JC?Jt-5jZ5|HN{I<*Smk3{FCEbs(q6U}O@=VKGye#mOR{R2K6Zj4&2
z4-FXiE7zPFlySigdmMOOf5tv%av#X70r3?B)oFI7ZZVvu+T-#pS29X|%HvuAgy;x{
z#B6lK-$10YJ^$ACwhQ^bF?Qq;1?q|$9Zm{L>JQt>X~egQHSoZre(05{kYUj9Dfmm7
z=W3dmEI-`A+z#L<FvdvcNews9LvvpfvaqP>HJT`RvpiaKZD+eq<CUpZJqB879@m%1
z{rLEdCt|3*8M3V{<lEylm%cy>MMuYGZgO#gB$DcMIQUj2Z-TAsVyn^?K&XXzR<TP&
zmqvkB`Fr#RkZ6`fAq{=2gZn~{qd9o3<HHs-A~%lj<z@CYldRa03HmarV@y@Wq;(q)
zeFtL9M5(U_QPQzj%5(HfiT7KA69M0uSn0@OGErusrR84fFb^KVE1e{54UKj{wD4Wp
z!7E0-iFbgD0m^D;tYo~@oLg7z-C%Y;kkpX7wB`T|#DDFkiHc}ExVr~el$V1lgn@~P
zlJ~L-(aUzPVDx&}3?sQIheW%)H|azF-ra^-27Pj=edwEbLq_5jr_;{&c<$gFTWsuf
zu;}JwJzQ3gHY*qNYTh(-w~*ybSD%NwR9n7!)el-!G_>1l<<HgtsX)pt1K40ig3kdP
z9B=AVYTg;*;^PC|tY$@a_jDoUW+2B9qvn~!;o6{^+uG^bbHZm-2LDzva7QI8BoUL$
zbV`t{8=OVNqt7d5E51pMKO-A0U*JxolUPg`I$X=?7%LqH1=D7%W#4TKxBX%5(hCp^
zhL|-^9iJD1R(f+|V`l$RRbreFtrXs8`rgnRL)61<+7`;;E2@l!v#vtx*)&GBcZH0{
zijAM!E@cyFMIVpo9jfFfn0zKgS<Wa4`sO*%Zm!+8=Lmu_1F9`es>mTJdv<>Aamw(y
za-krGa*F_{9(*vkhy)X1Mh`sNAbE!4v%w7l@O^bu+h4c|El^q5k9^%Ot$8X~7e(g_
z^no`PUoZ7hG?e@ZN}5IE`(<T5YozzYt(IeWf?H1F)mZ&NmGL@n7Yj9tTwXx2Bm_OK
z6JlH-n$}hZ<8{ay>@6-9lwTrWB(hXTD*m)S2`;scY8w)|`fYIonXQ$b3-vX+IEELj
zHMvzlk*@_wAY>uwQD<GuQ!G44;$>I^{QlC6V&?mszvaXE!`v0PVH9n%a8z5X+a~uA
zoM`QoyuAE}j~{yyc-L1xh<&OInek|~&w*L=&4%g2E+N%nplw6BNA#_KwOvaph2`=2
z!?t8Pzj~76aNBzmL};E^^?<zU6%N79&7pfwv}82<Ve{8L4Cwm@F4z~TOM{3s8w~8^
z+u#F0R($b(idDb`>bY8fF&jFRHyBFE7e1-zHv}-=UZ;sl%2^lZrMO`SzV|GeEk=T3
zQ)DpklMOKNQ^3zR{J3DM?RQL<*lfZv$~gxg+<=&aseI6^vY!}g1&oZSqC^UHNDW%b
z*eFAuLm>;Vp32}Y%~-|Vfi^x_CSv!>V&I7+!n$-H(nFlF^iAr0g^|`CDg-pY#ZpKa
zkLF7#^<r}B>*s+EIim69!(vYhD`;jx%qA1NqN|*$pSYbH9g+#6^2vVGSsw66w!~3K
z97;m1F_LKTMNvi4d#Leom!Cuv3n~~0qm~2`XB550o8Ld}zu-!<{}{fK`z15eQz3L~
z>~U^wAF1ymBM;l!f)4vYr?`&<Cv@bv+#Qd{pd82duHqyPXeHA!GSDgbu1@B~!)bsR
z(QbWcQ`X~50eoway1&1l+hJoQOCe*b+7+|~O=oJ~3;K3Mv5<2+e1CU-6whUkcIOVv
z{i3X*0Q4|3WDa+CN5R*CB+}S1(f!Og6edsER`(UvwmYD*4$0~}=oyI$3*US2>>Fs_
z0EV4`&#=+=e(ZB|Y(X=S>422<ABBBk72b$mVk`#>JNux{lW*zi7Nb9eQD^7pSzQiR
zfUq+oJsl9ThMmz*(|M1!CeIuFa6sX87abkcZN|#Vkyt6F!+F9>tzD|fN*bhj{x~lk
zu&X};4V@MJ5!_+Qb-TK@w$>7U`7;0pntgXLFhEujiDK3a5J~lE@o0GqBpbwmB94y7
zK(D{wm5rkN^?Ii6CMG6ke?A%-+Q90>#KgC6-#*<VPESjVc-}IqdO{{gi?Yrt&$>(k
zcESvgNDztf6T*~~6nqvfH=t9+UIsc%RysPPrOp^i(IDJE6`+|hG!zssP?Lw(gGpeI
zynKU$r^~EUjptpeuWH}l6!g73KSsHAD|)H2y!;LYvqss@*?PVQsQ9g|t#j2&nXQAW
z2zMd%SqiKmrHBrN-=eS^GEH*BGC(~KnyAA-25Z!tGBYzXXA2(ZQ=?x=pjkci{WXv&
zy_A!a1F}`nodwciAaq*>Gp_BjN-ZlZ3%Y24U*WP}D>mxY1^QWVn!jrm%Wd8QPFJd>
z3@ALo@Zfvx45Zu+ituRv9%~suu~5NA@M--fRd=25Vpp5~o^lMh1DLgm$;plcJ^6?}
zWg}4;Zz>eSI_F2EepAmtACMETJdd<o!juVglDj`x*ghBJ;DpqYx(E$nVI&*xpBUP&
zi4rGTKuOl%?04Se`TGylhR#9|0MD+EI+cjntsqbA&;=b8FIY#6N<HEb^`o}BDOB6Y
zBy0@mRs$)cK-kBdnQwx441>U)^OV@3^SEDod*E9=xjMZT3M8=jiWWt*&rFg5oC?Z$
z*j87^M!4kkhzY6%C7=}#lUMnpn{s~E&?{z_1XXa^jG3`FK>*RRJpz`A{Nbp=+Qao>
zuz<dTfAR5}P48Zx<QD3;g#n0H?2oH0r6f`5^%j@5$ywX}ZQ|*V(nN{hgnMn)$lRFt
z-`bJwBYV@=SI0mK&2Bzs*W`~E%zx#igywvG^^S!l-$qi&kCHuCcb3_#u|AB|0dL5V
zZOhi~z8Pq(c3k96JjH<M4M8*g<L!HWt9EZ0fiO1qsb2F$wQK1Fp-LX;hvsa;`ZHv&
zL60}VWi1OBM}XKHI7ooHaTAErfFp$4?W6!}4k*6)`1t%&q+*^?^Ya6{$214rL(s+L
ztju~IS9tg6NJd=z0lUc;;|OrhjI=cAIL_XNhSa1aoyGQu&9M>%6-K=bAp2F~DMm|{
z!B9@8^T!X<2xXma%0u?U5KTz|Yt&&l2(MJ*D1Bg>-aqUg<lU;NB7w!l#bA5J#l^kt
zi0q1k^%vh4mIKSTH%EnKA10Do2*i+J0|0l8tdtZGG+%+Px_ONN5LtlDHjyeC3={-1
ziF~}gyqfXaM>3mMC)b(*R4D6xYGJl*M4W!i=D(NRvaHRbMa!23fNuun-ioAJw*-+A
zKR0Xb?mhzI4opmsqfx^yz1P20-mzKRKVoBJdyNiuc0kiF!C5KglpY}wx3smj1)cIx
z&}->tam`TTcazjY!pqGOc-z?AoQ>0n3emlkk&yxBole^C-Blh(0MeBkbP<8a`I&&_
zHZt<!!a_95>e7+{{UGRU4;WW#c`USs0(8^Z(lVT_WD26>QqIcZ8F1Wqd3$e8!}%XR
zOv2_aVQ<c>|KxsoI8@YABUkN`Uty0Tl~8p7ED=AVfYLD_K&qn@?y&h>_zo$D#T%vP
z_WK4$uG{86+%h1jqXf)gtCuvp<rEJU)i>Ma?w6nL`hEVau&i%z)ieA86hav?@k9CA
z`B!BQn`4=onHgZcd}gUx0ZQ~xC7^=k0J>}t$g6joiGh&0$SUJVXr2ChXO(@4HXO9&
zho_w=F93rMsF-k?%f(5@mWXnTl^9lXz;5Gjt@n7i1JvF*F>zr!%(s7Vk;wNm(vqH%
zlJ((?H(CiQgM<-+7vlwT(hij`-a=77g@lpg{P(rFyR`+?i+1pmWH5e){qOYyE-Q!5
z$gj&BW&~V-WD|&W#tY|F{bJSro%5umRFD${rAf(G_Ve$myX9EAKwjvD1t7nM8+@()
z4<@Q~KL-W!q!zO&h#=;$K&JpT!vHx@DI9<%0p+8qI~W#c4VddbnA>ljbh__6WO?>%
ztBp36oTsen#Ydk(YQ6tiwq{=l3cUC4-K$+nh@Z@4Ei6n5`p(6U{baIl4tQhOW8t*l
zMWCxY6x%*jWLW9E-z*c0e|^4v42)GwUYt%=&bya?RYKz!`Gk;wuy@=dBClkr<OgBR
zU7TtU&~*RzEs6i34Y4Mb+FJ$?Kj?w4E)7Yeg2h|H?dZ-@lg0N=knhTA`e;)$Kt%7w
zi{vb``4-G4L`^yQ%#}8a>Ba_NoHz{1Qb#*hrMo%Ekic6IwAHizcY7GrUceaw(&IG<
zqrG4S1NU3ShY$5EHJplW3gI+Ntc3OW%yEQ-BaKyNK=>OGveN`aJM0!3D)IZEQffNR
zx$*~!3@bH|xqemHv#t$$oSZHjwlsbx=dh>+emp_lxz2Ffo>CLMLhJdwFJE43X(ceI
zh>*f;D)d_Jq$j8EF9{O`Hn)%w^EmJQ@bqi}P<U=W<J-3l<7xLexCiA&3MtgW|6D@R
z*MOqg9fyW-ZQN1h&6{MbxxTcVwF^@2z9}cYuD-N<Ag$?Y$w<hz{7CUq*MEEXe*Oap
z!mAxoQjH0peo%%@sq|TIBYQst0W7T(Ofwq8IAwQ9d<%hdtadc3$M{L&%YYoLFp^^7
z{A2qidf-u|_d>WqNwS<uH15B>R-P|IzXQZ8@+O~B3rp@IB%}}uL!p|?<`dBX24Z`g
z0=_>QnNZkMZy0;U)2%wdDyb%RU_O4BeZzC}SBe@%aUL+eW+bI^s3|gd0mUlx>dQ@^
z&tn$D%nz`{ftWq%7W0r&vl4gnuYa_7A_VKuS1e-U9GOng<1VBwd=y6Vy+`T%5#;$C
zz}??W&v34~Yg<?p*n6+Xbb&Xn-|N&8kNTi92Ga|x$wTSu-?<$;CaW}+FMvxQTGox%
z|4f;E<5yC(YZP$sfUbM>Ui&#U4a{=eM<Pz!7_>4I_;_ou-+%98X!iwD8z{*QkhgsW
zvy`An%~LP^iS-E3H3x>dDP9Kp`UZyA37|3P7J)<S-nZURUF9MoRHdMAy0!)+$-KO-
zJm(w4YrG3IG8!5n%)1;WX#U(_rDz1Q%{vraj_$8D|KwYmjw?MpD&W@zCW9_V+x)By
z3@vWL>NRBD0Ifh!JCMW*c0^KUNPi~hDvtHe5fW+UJ=Nd;h!VwNv}5ImZnrrG!qD~E
zVw4X^K4<$q!}Ig-k%HMk(18ph<E8W(sdD~_Fd;3j)&F6~W3CDPNB5mls(vV*CNaWP
znB)fL67=kVBzvsbFOF@M#b95udJ<Tqv{fsgS4hVifMA7=@22SX{!iY-y~rRCs2N`Y
zMSZ<ss&P&EA6*^LfW#l&{zt9sHwp6iDue+MS{yIkUZ{CTd%P`6AV}vA<SnQaKh0oe
z7L!MP%6IM_eEuv6gq5}c<iGGkr}Ni!NofF*(V`;TtE18;g$#_R!SCRgk!dnchz1Z?
z`qOYZo4u`r1N0X!QkC<svQPX$6Av+S!@1)NK)4KcjI_qY2`F+njQe(0Gq^FxcubeO
z=hJe3*t{J8+7)hxIGt=Uh6eJh86e0QsyK`;ol@g)Ju><S6=^h!vKxGNS3zF>sMwOf
zdm0{EhowB`pC^&k&f1EbCXv%X{n$UnyD;Z>-;!bSORLbIpgwKFwB?YmGwpokColuL
zgN<X+hXi@P3t7;4yW}Ady_J3s7&rmvf^c{IX}=y)8VSMGlt6+)2!LD%`r<ij3MgIh
zE9|l<O)*eE#v(j8|Fda(j+qLv&GKBvF$i7)<p4xI<8C9L^k122tqHKfj=iB$ZSM1#
z0&(pWP-7W${pQ18jQ-xGe_40^oezz@Rg|-fxu9jLKWk>)R8vto+<o$L9#A(Q|FN6G
z+I=mA-I0lZTa=bd^xLpS36dGpR}9#QvfkUG0&CQt{-pQqg_^9H_8jVNA2kw`^k>n<
zKvx$Uviq+KVc7(p$6jKxvIxI4KtwLbTkine`OCNM2CCL0u%>`Vj*4pGWOshe08coE
z%RW0exCdY)&~=fjJU{4{{oGl2GqpF94vi`MNEA$8EmwCUKRF&AyMAj3D6-gqRqrGY
zIN;32ip5bu5@-glN)ZteX7!&NpiBeR0ni)c2?hW`FwkgbWo6y|NCC`oe@bZ+5ry&}
zcDa{@zGo10M+os=fIqBrPd5tze4z#ER_8r^Rn?KcG|8eLKfJJj|C;Gp3*P`5l|r;a
zQT*glo@O(B=G+<-7ycV<d3S&c`51W3;g?6_&z68Kkrue2ngfXeI}19nWMtQ*jw@SR
z7HmWy836>`#gUV+kba6u#<R1t^W-u+DM=u{yQ@oDLc#=y*45P1jBWibhbp{YTf)XS
zg}E8s4iQ_p7VW>RlK<wDM5Q=zxeTQg^}+%sdjO``%r)|d$vLeAPzyb-uRJ}Wem5Xb
zqG$w2TFc||FqrR*j+r?RR5;Y#g|w7RxekrKD3I_US|=l+|F%YEW?``emM*}c@&NWh
zlBIfKb#--fGd?U#9xMucCbf;J>hrM@Qyf~EfmJ(XWMrU7H5<;0Kj}Gz|8tStps)*T
z8hz9Fk?APqF@B8;kRJRs8fj2xR93o<+LDw}o>RdTk;O3tsQ(ygZI<fs*sMhHZ+{;&
zGly_+CGBN~*fJtqUYS(7aScGE@Rt!j;)Qn{D`J=b`C<n805lja!bc{cK7gehkzss)
zJ`M#D4(>hmE};Je<Gh17i<;aw=3JXML1?fHgzi%SM?y+xptCIqL_p7VhSW#7f{0^=
zh}~b?6hREnj0yi8QwUTnUKJIj2ZCz|A&vn*-;%F2;C_&R+no9nY%gX5F<c|z&?kn@
z0hBv1CdAc<bkS_RScehLMKG%0NA_W?zu(~ieQCfiMa}y4yhAHGZdm}~$fwfzUFJ%p
z(<KKne@OqQH#z(cAWGPOPxHMG5oVVVaS@U96fb&-%vkkO{wwQ^7*_tMLIkaiOKmq%
z=DimDr?X}MPRFroiF|`HVw9~2am9Ek{M?7%DOO(1kMBgs@Z)VvkG-~<i3uKx#=pAI
zp1<#@l@^%X6Zt5BJLvL!8V-MVzU7C*Ut)fqB115g(&U>D=gVf^5BAXDwtC3>c=Zt2
z0XIjirBDG2qb}&%9k2ad`uppmt{%%wAkYNmTW3ts3$Tv=C5IQcfVKxn=@^7NE&##Z
z#320bhkVEY)cAtF+8)(-|DpFR==<*lL07CHIt4;0@^$223j=hD=3s53Cthi3)EZSz
z>@epjW9`i`UJ#0i5f+2KG*b+i>K9*xk+OAdIWZrd0)b)&vLwaD^H&dRdV4=bM>hgf
zADj8v3g8fW5-u}h)j24H0NmM{IITXxKRdW{dNTiRyp$Y74`gI-LEnE;CM`(@5g!L|
zfg;*+|K`UgL~Ib?10>_cQfx7R7!Ir08o<dP$%N>&#D#{I1FbtS-WpAmZSBqj!@}kA
z*5qek_@6o79tJK<_uVE6`^jndj%U(RUyD0+P}R$<baixa?9<^Msh~Cj3epcBL~^w*
zBaDOnQ%2_Ga54cjgrL3EA@jX{*`6|IR#(vF6ZHKLY7P#wkyAkES2}vg=O5ogGZ_Q6
z88FqrtmyWR`0fL2y|2Kt^JkkPvw9jJDI#)yYU;PL=STAwm&6b5z6s)c^(9rJr*Sc~
z!c+1OA)$a0o&Q{??7F|7pIk<HVjSM<lT*ZN2>x%0xs3G*1YyrSIHCiX6a;<F{oe^)
zI`uy%<yz#3p?BtOVO>W|sAiuLn;N~s(bCXwKQ$$Cyqv1wF=7Iq$^DBM8;v4}w8LoH
z9n3z?OTp$GTQ97^oMU+cpwvUfAmeqvc!bc>TB0IeVlrDc*U*mGL}KaMa2fDIh9bjY
zGVbRxs83xED)*P+(O)ZUy5j&H#Yp#K$M-%jCaGGD$zT+sZ?%L*0a`bs@Xmt!h+%}S
zPF;#q2yIVM0P;&5)q1J3$K%S@6j;cNV*4|$<@9HPo*a0^^pBs_%ly6~Q0n3c`c78D
z2iM<uW4Tms11lRkLgj~v>QvQQ4<0hytAH3`PxjR3yRhnswalyb;CI{{Gook&B^iL$
z-}{|`Q7=!OBXtA3aOAkHvubO7yq1~Ty9*InL!@-)r1r^Q3f>4J*Vfd3aJZ_KZs-<6
z(;Yu<G~ZX3hX_IfH0&l$!0=@C2obXMZH~7%fR;KA74dZb`Hdq@Bj8OAR7r?nb|dbO
zrx$HOIcMe@9VEO?|9^ezh`WV;{Dxy<p0V$egb>$?iwDMg>6YeZt^z8n=fA6^zh24H
zR8{}8o`C_pS;EuykF^H9q5vLuz*YZ;m*M=CG5+l>Isf$mp6s%k6guU{;Or26wuE@M
z5t~{L3G@nf!Fxxb1GkS5+}$^XQ~BTD#PeTY<BvJ`-+jT*75~nVcG<Gz+XQeUkhrjn
KP@bU9hyMdD;3Ta8

literal 19924
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

diff --git a/doc/devel/uml/fig131205.png b/doc/devel/uml/fig131205.png
index f80a5c619e000a6aa7f76cd2510da831eea07b26..b1007060f56f0070ee5dbcd8bd4a99b5889a8373 100644
GIT binary patch
literal 12681
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
VNbkYR;9o2ta#Bi?h2l?N{TC-nvmgKf

literal 14434
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
JM?HM;zX0<Y5Gw!x

diff --git a/doc/devel/uml/fig131333.png b/doc/devel/uml/fig131333.png
index 2b4a00db7cbdd08ea82b71dc399f5a013978c4ae..ddb0478625bfc5e8eace5162b2b0df85ae813866 100644
GIT binary patch
literal 8673
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

literal 9210
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

diff --git a/doc/devel/uml/fig131461.png b/doc/devel/uml/fig131461.png
index 87241bcda3c02f1b0ef2c1bf09a7249f6c613e77..1b6b2396540b1fa66c5c3963b11a382c5cf9cd85 100644
GIT binary patch
literal 42726
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%0A#f?@_N}OcN+SKt>CM$)smxwYRsk$2{jt
z&{0(-#KXIRfc62FDnQjRAYpE9Ze9S-)Ysdm2tH?^1VCRkx7Bb(qZ}*IND6@j5K91S
zptG-Uc{5iHro$v9%~)I#iSFf(WRVp0lI{TDtkGXU7kF;O`Dp;8XP|c$XWrY_Tg;P4
z8?c(LmCl6FUfaUi<?F9@$vGuWU3jT5ZV=4(kS_pF#6V_<?rZbR%uHLG(GM@A+qd*#
zRM#YgO_y85R8$;6+z9VIJW_bl;7}wItxy^=@{4+p2*yLXq3}@b1#(08d9y4Ps)PJZ
zr)J~!c89QeA&e$+yJ$X&kDni+0YRc6f}=7_(Ns0=A@zn@{WT8U2H~HU&saofzz$+E
zJJd_&3otr*GkXWp*%dmqaWFf|%|3&YiRpOA$odcX?w*lN`rQE(kNf=BBBl`=&pyA?
z1Zys12(kUBBQNjqtd&+-8HOMB3cpiK&ONKElodA>xOc0^Bkam~g81Pr2r1}Su{;T#
zLscq@RUrzz+?O$@xC!Wy52$+vGuT1yXz+biEziZr>#vD0xJW?6#Q$#Fr&i!%Z}~nU
z;hN2YL~jxW6(iUxOs484XZjT*rl#6xC<Ufe6|DbuMtEjr3Vjux85nayb^14vPhVRb
z^W9}6<=gj|F%#}^36{RfEkWph=@*T65t9!@#N7++u=htQvb6jJF6z`&2-|o@OP!a<
z&rOQBapSP1y--H(le}z@sfB^7v*qvFlPsVw<G3K<c6nwT6%MC&fD0ksE_N(c*<Gz|
zkhMi%Bed$>COe?zzkQnnOu4_caQVVAH_!xHv_)0|I59T*#g^_#pl^&!XAy*<gq;d!
zl$CiyS9EQ^eDsM18S(KWxI*1ZVcL|ud{k#?PY=_5eidv)Ufw>1ut(##BWN<fp8yh)
zyu9<g+%tE`?gllFqSkpi7z+^n71l@d^K7`}F~@p-NH_J8`-OViFo+(N;zF8N`g?HM
zf_{2&kqPv#*D|JvAtXwAdL}?VqnT}CSY&mz4j4P3HA;G-H(X}U3v&P7a>#lD0|hjq
zeZPMbAY%VVMM>auO&21{ohFf#-|ybs491&C9cjb~8~#h}xpaK|>bVhG0<$Kd{dn_t
zU<Wd^wF&+FsSN<v+?)^qw0p~v{VT;F5kkc-n4N|fZDXrJL0nZd?uPi$ueb*$w_CTG
zZS8_OxX?^}!n|7=MZ78EFX2^jV8RE8{}A;x8#_s2%!zOx^C|RGC%iUUQ}uO)<FF$?
z!4$HD=ccjPh$k^z(aeU#M7L|)PPigWA9f4|k#aqfLR#<cpe3CSKy@PIS~u`jl!U-s
zV*`PLd^kCmc=`9R=H+dE9VwnlseQUJ;-VZ>C-CNE)ZP4r(Ll5~%C>ZqV<R7zck+;7
zbCVl9!=@(iYMSO-ix3|ph05R&&>`d(+MXFG&+P6$`71zpWAou1EGz<jY3du7QfU1}
zdhc7bQ9Nc*MHuvkkj-v6$)RWMD%Q4&3<n6~p-DgL%vBN*8`<AMVb!^Sah)w?<^WSr
z!`La3ETQ;@ac#fTcTJE10B61_#{>)*yPgm8r#mNshVZ{#W{aA#(aiaUg)?R5s#aFa
zeHgBX>u^^8UzgU+SF=$cjV`tF>au9UIQOW;Me#`KK$pc%WQ7pH@dZcnK$>}#B<I}m
zZib5LST6YYa&iVNyCXmis-xrZw|@%>N!Y`j?3VuaLOVJlIj7U@bl=cwlLeL(nGnq!
z-i~t6HO&k2s9**FB+eIEQ*7D2p|-Z(f>(h>AtWFy><NQp;me>J#56E}2(FRX0-S%l
zo@#f4$cZ0GndDKXv|3@VfAitvMaROI0*9x%X4gdhMN6&oWZ~<X5qm!%bzxDft8c{R
zAN;QQxzu&UK|&V_c9)-BxzN(<&BZxhN1N~v&4Zd52!Dib6Uy{*4bP*_jt-a&`6$}7
z)YH`oBAYzT{h$nhk^^c0D1TUEp6ii&OW9n$2q$5r^i2<MaWX0`9!%os<l%B02VDXq
zqi}Sz>iGE0pPlOFCY3r>wuG>QqYytp?fCC%Nkj*rO2c$`zOO)}NUKSkb%4;dst@fk
z>Pw<XN!A^zIU3H+7VpJKlQ5mCJ$WK{5$4_agl$Rl1Y8FI;DByKuVh>f24*a;6zP>T
zoLLS2j6CaL;}Aq)OZxGn4s;}w9!4!fxHUlULwFcsc6B6oY6Ze|u*n4|qaox677NHU
z<G8KC1jPL{A}s7=6axak;F^N}!aWShU#YwVdJ8AAWqioQVrU<OTgK=@K}m7r2Uw9)
z)B2(!-RT|+)Pu|&%%YDT85ijM?$oU`G^Y5<Ww`-J5A=rrve@d>lxM^Z3}tZx7z9g)
zMd!=r_}*lWa-(+5PjDqfJ`1{3Z=BNN<~%_9M5Aw%=?X?Agp{<jHJ2wKL|{|^us~7m
zICF(h_@cC@Lu&1>QdXMe74;Z4*5_qj6t;_nb~D?z$3{wTpR_>U8|VOFwxG>76vU6o
zNhnMQ;`#iKkKfTmNM{X!GFePaEY@hy{wC<e_4V~(yF={k_V(KW(jY}nl0IpzIv<pK
zWe>%NUS%**uPt~}$9_S<c=pT?(GO;-|6?@uehJ#KK6T?k>V*i}LY>ODK|Mx5b=X=@
zHyz16%QylO0(5PkK7rU1Rld6F<iqy1esM8}a04;uR86QndsQB*xDPql+9v*QFKW5n
zvMJ(tlnV5fWl#1oZn8jRf)QkbQ%7Ty@rg69Ljt<ihYuep$2z;a7so?sN9WWVL2%U9
zr(lvnP)5Lfgh%+VRmm-=RTq2FP7xy{Gzko@{aR*r=IBh*8*%B*7_i^@ycc}+(#396
ztCr{IxO3Ct#-4+{e<;0u^<zXlf3(Z?te+9P=hdaY;nFfB!8Ke4s)1`j?H6mWrhePs
zsrn0Q#<fncFwFc+Y7s2A8FB!JpoDmQH9UJoMS+;z{HLLLNE3>hZ;fuB5d3JQ#u1yR
z+3{`yPtoBaBkaI8`q4-tCfVF^J>(oF{z<R#LA}V{z>j$6$`AI%q7u!4U%${0AQtk!
zy<%)_&8OeyFB@&OXONpZsQIdF3-C)&Zw;BSxxh;(6t1*MBQ*A#uB*92Jm?83N-%X?
zsa(p*PTD8HjE9ShBSH3(o8ZOmbkN{I>GZ2;?J;vCa{EX^lEjZM0Yj_MbAM5ziT(6{
zt5Zz<6P8vxMf=5$WM<j|jQ;4m7Sp#`qW=deY&}Fj8tP<pJVuBqu(1IuH;J64QUEpS
zq?n<4iDcCOJtc;EXSKw7rnp=Z9T4VFG^qQGz^n(~^UOEJ&LfgZKrld&o^tWOsyp*=
zsNa8$e~8e6L8K@q(k7D15))0BvXc>JOj)Nai5QLSi6q(gwKQZW%C4e?R+FuSY}2Sg
zStI(rr@p`Iob&zToa;LOobQ>x=9+7m&;C5m`+eW9d$V*wP}DN7^j$X11Rn3db?4G6
zIE$=3E&DZG=t1wXS;1Lb$K&dcaL_!Cn(9~VP2DJ~Cz08NuRI!jO^N%%dzs)7?lq=!
z6nkCLi%`K>=Z((Cxj=j&I3!FQm0jE4xNU_kfxj}CCn1eJ@LR7ZByjz@EGN6#?LR0>
z93q*ahS*{Z6JBB)s`K{k+mM9|FJUgNy*(d304XMR5`c;jnh_ex^-WZWFJVMuHc&8^
z^Ez3L58~h8g-G$D*-Jc_r~(=hD1_=jwQ6a>ibg_C+7sKcg`Kgyv0^(0_Xj~=hes=l
zs&(t_(9qC!qfD1GXDT4-7f@v+^>{D#UOqJ$Y)-~44hrgsV0&$~_KE5P%JK1Iu&1AY
zn|lm?VQANCq4j)qyHH%v{N~ZJgnK-uee*#V!E-p7uOZk|LLS>?b8m9W97vK3E*pQg
z^#)_|)tT}U2q@blnqeqro~eDT;I%xvUH|n(xS)1MFexAf5(bd$Z6=(tB5;7P(n4Nw
zL4xBl?B02mfX@C5GwU(maY|-5J1T-V$1td(K?&8$u8#k8RAc8UGMd8SH#g!e++DFA
z3m&n&F!-Mjxcx^r8LB2-UvxtG=LhK(5`C4nNO01HP{B_2ltNqYy5fx(uXIDjbW9$_
zY)V)bRfdiUuw36BMB~KmD-cgH(aYbDb!p#mG39qr0K_pSyqfI8zllwIcMaBBr=9V;
zaRJ7U?eI~qVB10K;}&tdwDkgiZ$D%`hN{W4zx<b86D!?wTJWz+!7Av}+K88qy4ZA6
zvn3N9$8=y4pinffPBdEpo6;Iats#IGLZS3QRNC}?vBvf=nN2s?N6l48*wYOR2halr
zmDt$GNa-nIIR&FE%z#PXsJ7k%wgY0#L(LF#(f>DQ1MTAGsVnCHd^^A$o>0NF!eI6V
z0LvEe)t>6TT6Jz1#$$eoo=7UUA@<_`y-*)+j0ZaA5DhpoxpjJikeApsi1}4NJ#>sY
z)C#51jJ<0S#;d%<qyU+2bF(ji!}J_#2?G;WdO8Da_*oiMZip;XMsEIRRlTn6v^&e~
z+faV;Mhqwzc=&Dfa5b$s#)LJb(28#H_hWXXIK8qN?yVnHni?GGy*GT;<?9bvWWy|S
zokUMzetuCDV+~Fi{8Z5E)0}K}{a<w^6r-L{^JZu6QI{8&?~z4;ebZE>{znAw?Y;Zi
z($c>r@J$!Llou2z7_HZ`ZhNBxUQ@RG!IOdJ=Js8=a3q%B-FD&Xp#TZWF0LzQonp_9
zq9R4_r1-;lTT1*zb`JyUC{)ovFWvQHIt_4QYF3&#(13JQ?6b-^vzeAMwu=1-V;i8f
z^SxQwR=)XRY>Qc@=H<M*YH<%YLW);Tb7bhv=F?l*>ga+$N^-BM!N$Lo<ee6U!p2U&
zUBD3{8G8#$G>!Z6j^r1!`)F%&%o$q8H>{SH+53CM0EIXE<GWImg9UFSH+>PJ4C=#!
z=`jpiZPEcW)lZxZC+ql~;hX1}=QwmsOa-9gxZ^5KCx^@(Qf8)TbA;F9w+}14p*1K(
zO;(FHLekq23*>S1&yyCXHzZNm4^wSDED-WwN%YR`&oG68M>~6HQB*wN5{`lj9zwFS
zi;Ig}g+QDzK%_k^ED~d4-a?fG4i?ZMU-r(ydqYD*n3BD0XR|5Ofhk#2;|l;`<ZEx`
zQxKf=_1W0kVjycvpGU4rrZk!}Z#)|m7A|@)3CM@Mu~O^%hM>CuVl3o`YI+QXW@h$7
zR3%InAsq||i$%r73WQo^r&kh6Vd2ry7~k(BP{7oo(Lw3`_tG0T7Z((O#y@{H$K!R6
z9gA2Ryd4E&bzt-^4n#8+rUjq64F=hT!9!LMKy_&Ue(PE<vV#NITio2-CVI;4IGWqq
z#=i|e9Z`cUW5|^OG;AK7DK0J!99?_0D4kVcfcY=W5)X-+%5l%wQwc1eyP;LHtw<|D
z60ZFG!ooU;42MV)1Oj(!flL+3Ck*$+6O!Vyi~L&-gGaRlYLDRCH8U`fS5-Y_W>yK2
zWbBmr*w|PYs%yQNrp8d-DFlv(eBi31zu0G3Q2WdidnJ%JqPK117zB<jU>#|6CQPV-
z6)J<5;ynX=QE<#MnM|n9>Ti!TqydKXN@yq&2(`NMa)?T}0E=`A<$+2xc2h(^S<f7r
zm-7}C&Us;Ww$ue*@NAxuUn{F4siUVil}cASPKdNRQqV5KzVi9}$EBf@CRGHwGabji
zd=pPk&&X5)3);asM+q-pidAbEu@OA)t6A9gCD~s9=D8ac;BGi(P*tW5o33|VM#Wfa
zdD&;=%35pcoH@h-Q!96ih&9RY*nvB~#uZ-;R(OzE(MFe7X7Me+fPzXfWT|&29!^N8
ztF1L0arfbs-Z>S(`gmFY<h<n5Z<C{1M+*&aITKJhrlC6%xX&My;$DSL)*qkB(U*ZN
z?`^!f&ABG!8_?vd{DO)@T?M`8!>o8qu9z2e8g993D)x}3swdtV$o($DsBhWh{^qt>
zr)+dm$Yl4{pB@vc0|S$peVz+_({)Xri?IIpu<K9RFBTU!o#o^csQK2<cxu|ywv6Ph
zrPTqf5PH8qt+;r<ii&Sbcwo2fuUSS`)&>-&=^|RmojBBZ*@2(GeUCiDAbF~NegGqd
z`FX9B{sUM$;_YEqTv4d4St<?0CU4iosF!}$ACC3*wrYHso&V)a%BDe4H0q@u-MeXJ
zv7&PNT9PgCW@>G>aed`9<|_Zm@Nlw$ooCoySviKTjw2V3+|uHcNWD|N;wRdDA>}Hh
z@&rdRp762C`o7!il<CT@t{ZE`R>17Aj^~MPWoq5F)Z0I@NhEg+4(rzcQ&XN5eaOu(
zV0qD2RAKHiBZCDcexN|eqZzNo5)+m+WMzML<gH3ORN7a~5-?Jrj6Cy3sb1VgEB~fL
z?3d%=cUk;=Yrx`U=VrX(b#)b$J&_T7DT<%u?yyR%W`mNFPJouQq=cv8T3VO#K_|<c
zTf=Vl_Qqab&kD@M8kZ(4aL<{6Nc8i#rvg1IoKtp8FMk}48XSCZaY>FsefndeB?A+1
z68rtT=C|)wtYKls#Fn^}AB@!0)e5DZ?u|9xb6*csRV7_dgJ`y#l8MxCiF6bX6G2vc
z;ILZento`_mHGAS4I0M7_1q?&=HzIig*J`D2`yLcADzmfGoSIic20hA$=Rh|8Z9h$
zL!CPJy~Y#&_3NW`?P+P&QD630DlScZYO{O#>hml(6ziyNEAd;!dwP3Iti=+Olj$Fe
zqoWAUHbmQBat*|Q*|XER$I_IPEK;hi@jg{$ioG8{lAo-*`mrv0Chv}kn_F-~0>l6b
zJdN5+u<@(7H&d9Qj-RK}5Q=7SaQ)r8d&d}ZFVmS6*88R;1*5`(ojqmJrL}4S@Gt6o
z>MAM$NbTe3(8|q4iBIYVl3rKmhE3Ika&%e#=Y^tEbp9<xJ>}b=#$Sn-L>1)ce{9sS
z!X7?+M^0uWdAj&)oA4?Q0qkY(RDm@K35>ehEq)89-}cqGUzb#Gdw9A65<g7dc8!mR
z)z%gQtR7$Dcg_-+uj+>mJ?x&3dh`gE?@rj3_wSEmZ*0*3qUyJnq2gjmH0V<17rqsB
zbd(-+eV>#l>OcW`ZvPa%wEKS5#pLQQBQs|$x@?Ds15TQI)#Cw(sBTn5b~eNo7411@
zKce?#!){JGU7-5@z&^hQL{Wr`i?YWid3<cHX<K(khc@<F<Uso~m3O_qJ}tb3;o;ef
zi%;(Nr^=%J{U^XX*!}?WRvY{KJ-&1+xVkqDkIjKk@p7pey5pS}z012OTt8L0q=5NE
zs&T*kzU6^m@uhy7QqL%Ik^MhE9KcA+$mA6lS7uA$upM-}*-OjuJ5LA+RS*cYO#+8e
zkg*PEqo%d|hRlfx(U>pY))JDoe0(XD_RqV%e}7MOV10FAvE<|lwXV=tf(}}xW2;MV
z#lX#PR3$&ty1LmrEI6GRDju&sEFEI8d@i{<SkZfIN)O!14TfuLz@Iwt`K^M+QX{9L
z6s+hZB#2~ZmF#YO^*s>=LoPxO?u^Sz2NUCOJ2{r{2?V@uZCx38?v5RaR2a8`Exa#z
zpba9wtKPk9h>6icpRv-#>O@!9_)Ip2_d)5z&UOXk_a?GGw5Cqgg-qT>3$hqfF11c#
zjgD5hr2L{~SzHZsYxJG|44C}IlQ}?)uc_&L>)}f#>ztobxYVF_du;EybB2m<6dGQs
zs%2ymZG9JKFt8$l!5Ki=_w00CNZE`Mf-a;p9&~(hf<O?+y>;}k2CbBk=HTi&yWlaO
zsS%NxNss#AKX=N&vIpSOLngOe^uL7b9cf<7Q17NtRPgw2_kJ5o;!03WKh<{K*P72e
zAM-qpsD71_y7kh=ioTB-re<p`O7ydo9ESQEaLWdK=nFr--!CcI?exk^Ib9uD#~t=&
zkfl*syU61yCM@(wNa)d}y#>V|ms(syg6rJ|R?<#KkR?$O;mNi{;_#<WHYO&UQTqa<
zsF;?Sa|_6rwlReWUQRe8S$U7{kuiXfdjl!h>oBK~sbF3K0m};ebNKF%)YP!}`177V
zPNaINq%~o(!H?d+K8}ve+^wN<kjhS3TRS+G6qLF{ZuYI#Nk04F(_s*~c=Sf)w1}sV
z)^kdh8a*pg9L<?RN|xRM52w|r)0Q3f#tR<N7#;*!&U>Dn9l?xwy_w9nQCY&xsKw1!
z%UNj$(wxooRn?G}e|cSl<AwILk0Td?ycW>nK#(2#W)S4E!`z3wRUy&4*C5D|2>3xH
zURiafIb8yN;p+Af&Uq8T4k3hOtO(yl;(7n$TYrCxi=%H#5$8pk2j38l2V+VRWZkB)
zEeH}Q^!vA%mx#}K{3SAO2nZoF32<_3OyD0L=i)|?Y^?GB@b-3tlLpDTgXuLk!HJLt
u$;>hM3(`&Y_W!rr^k;wmzNP=%Pnk`VV_vCb3tSTH7=k-yh%M131^)}kJt&m`

literal 49580
zcmcHhby!wW*F6evN<gHgyF{gtP60vb?vU>825BTkLRz|8y1PNTL%Ktx>nxt<J>U7A
z_x%0cmtGgw4eWdEwbz_;%rV9!R8Hn2>T|;95Cox$fBK*RL9mtJKQR(4cqb5bUL1nR
zA@L7FO0FpfOKyD1yN}SxXoaNSr!f9E8d4HtvDrq1lKX~cQc}~g`LXfhiZK}DK}y2&
zec4i?jdGy@ErGaLNwE^9vG&K;_jY>^){G5xM;+VudsF+1+bL%$+bJGPXZ53QBik6%
z;;_O<6ag5%7-dAh7~o6qFM2Rf@3gd)L*RYk&$?<)?`JSE)4vCA|Hi||B?oWspu9kN
z`tg4VK?qO3e*@bI3*JWZ`v3E<Q#M&c=45{4t_x5Mwc7#&K2sa96SiF>#;j?cO$h(Y
zd;%<|4q~GG?<z?zaWUZAz4O>C9=V-OslbmDQ{&@d=KK0qpWRt-KSNwxUtbrIww(VJ
zTFW4WMA2mjivfOPY<|kIut{4R?djgkQCp)JOsQV!lJ~QvMU8$0?=`@*prOo$BEQBb
zc>0{w-c~)BTNaoc6R~Ht*8D&C-0B0mMw>m7e<YXDy>;&y(U_mFaV??%8>RxwTmw~a
zJ>2Ih=9Rw0#MG(isC2REFE7s)|Gr4Z&qGN|JG`F@J{9Ye=e*|c<x*G)*?ndt<j}{f
z(}^!|IxsMd%gZ&rkygaq_P_lRjo1ji2IJL~mFeWi%nA!tG;6xXP5%W2MX9JHcX#`w
z2`p7*WPB_9(-|y=7~Ce{C6$vioRaD<;AwgXt`|eYyRl&`E-~_h|8`Wh%-ppx>S_0o
zJy76hml~sBbhn1m^Ai+v!_!!e*dX|4qzk{^xR0cShT)Zc4VPN}^+rQMp{eGg^*ikZ
zG4W7r98RfLy<`a%zAGQgsk?B;)@XXN_w8`4j}Nz>uh(tN(vnXqhxBN_+3nsGW-$6=
ze-X(Cu;oVhxJb+t6n>|IRb5^CknPE8Qj3>SPvjJj!<Lx-niFBfGl+sh(#SCT;!rZT
z0cLyxWpAHoXlPo2&e(AA_P7-tDt9W%`t@t_cSfV2_g$Baq`ML=sy_BIM|d>(nwOfd
zNi5pL)YQ<ZkNxRdYP|z0%<5u&ad((M6_u)@Ln1nTs!U!>W`VF6^;l6tU3~n&?u7TG
zq`3I0+gVeFh|TjfIE;69jbfkPpL$!u%wg$pN-(>+YlMb{%`YHYE)%aG`%Lzmc_?BJ
z|CTd(xa)^j4~S!9>=)*^ksx}82%iTxdZ<{3<Y*mRQ~5l;uzm3^k5)Eqdy}7$o}P$z
zdb96a*hJnwjBmnB%S7HgRMe%;4w*CSM-WYRM8_T|a>2Vhrdst_4c6L*@7v@tG4%`#
zmR47DSXmWxbWjAm?_T0KF>+rAW$LdmXcDWGRC+%?bowL88t5yWp9iB7zkXcnCW368
z)6|vz4RzC~efrclHnuouA*6_Xc)mYx(977{lbe(nvC`tjQg(?2j^5=7mz6D%TNtnH
zJ6Iunm)o?U$fd0I`Vu0W<)*|WWA9h6Tj^rMs~`P*RuNLua=-hy&uW4sv7|*9WXd1J
zBIL;Wdi#FXZ#tTKu2jmCKcna=lb92U$E5C3uC0_q^VkHsQcqb$o(G%Y#7PZ05PgP^
z{Sz%DENo(WI{w=?c?E^%FJ2fvQnC3w+);=Gz28r;bg;KK9{NE+M@L6RWngLPd4J;+
z$xcWSFgx+5&v&I0_KJ|;7e2AvCb-argp3Rt8k&rZOle7pw5+V4=asF30#@>V8jn+9
zT^&9o;Ca=?!^y;CGm^p`hR0M|TIzkaHM}=fWMyf|%=#Y5?sG3CTsyw~r_?KTmok%Q
z@K-0DBMU8Fw-5KX!DuAUA%8^l$dHhH@O$?+=i@n&U}KOW>{n7q=;+4_wM;@7EiEmW
zn3!kVqbtoGwbj+^kW>m63mu)Lf<k3>cGvj$-{E9V4i1iohX-o$o2x5$1cc#q!Swmx
zLy7OGsHh%q_L<(Y>b^k8eD#)&&dSOvUBK%t6B8K@PEJvg<nVJew8+p<f_KJ4Os#kN
z1_mN|6H}9um6esTv9YdBT^PcCAzxq2JC$y%5WSQSJ9#D=8U5{BK|ui~)=h5h(D=B5
zvNAg}b2NDfyT!DUk`gsFH3s~*q$D2ujZaQa=cDO@owa$+4i0CZy|25MmiYPj7Keu;
zsQY2yp7FW=`=oL6NTxqGIY~`RtE#GsNUztvSnn`X_Sr^P*Y<ds|KrErloVp~_}13e
zyu59}$2*6;$%3qpQN~6_Zf<TyhK9Ch7)~*5UepaNe&i=I0co9eIfBj3_xx+=rM~Uu
zzEs&cIbhRzkx)$8Gz<(3TD|YV9vB%J!Tik46_b`ODJ_j859#R<V_~T<HgPo1R4vnC
z`rLA`)ac^n)%@$1W0)RHgxL3l1fR<zlJWoq1qB6ERMbiRj*bp#Y3a%0%i|Rg+EX(#
z7G`E~2?=GNTXmF`r<Rsdi+b}N;E$-rBJ|XLXZ^y*eedx=jj&EB9QAieQb^kc^Gh%c
zVgf3e03RKlMMnVg<luU5RBv}T`)zUtDI)@;udiP+1)f9!a!(_N_uW;M$>{v-EcD*X
z%S%+Wdm>M^pa|{-c#itT%fEk<zj-4bW2mf*V*vB!%^PTEA}^}6^az{@*>r)3ENoCw
z+8?IiU!YuJ%F2xLoA-4jv0J31q{yW4aqD-5fG6nV^LV~LbGbXwJ37ilP7Xme)=TEr
z)(=bW;o;%nNGvTbuC1-*$4Do03@5P{fjxR>GE!Vx%E8I$^Z4N9>B+~g`sve7cNpH~
z(UL(iDFH#fe)rex?Ckvfe2483_9CB)gE?<+@2~%P5ihs}$kk5w*ho54!ok#G!%#%t
zp3i)4ZfY_fO=DnS;CK6L$jjTf;`8VQvIw{bWyPmgQGR|%NXV5nzn-3+yu7@*xq0}?
z4LAxi5)zp~bdjX|8sg$+1F>&dSXd^t@bK{X`J0J2t>u`gC@E!9xH2*`vGDQhEM^#|
zZ%l@hoKDw7LGX_pa0ur&N>cT6JX9#c={&CUHWBi_$LLvEvaTi2Y<nXvE-oe}_V@4K
zsi~=?q@?QV>f*s@>g&~Z|8G<uoqu}sqzc%sw%y&`eSt%CZm7_jG7!Y_MC!#Q51JMu
zW$p|^+IhUb%9h7Y<{&t$B=K7ZXS=?>9xQ9I$|Nc+O($#+po5AZKMM+WLB8k=LdCB8
z0Z~xb0eHl)BftKFr?a=Wx1)oSoLqOK?_2mEgcK}1yjuIs0mVESyBZCU2jO~qa3?1x
zL9)Y!KfO9#mr>c=*w{Ecl$OSZ7sBW&R<FuW@PCF%i6pG4+4w#Ay_Ln`z{|3QZWj>U
z)=Lc_(qq%p%d)aM=LQZB4?(DKI_)WqsDxn%Tdk_8+5X)S->WIYrj>E5ECdg;tLwv7
z%)x<W4E1LaNe6RPGAfZ6!ubRSe#{AR?BL(`cpWzV56jgS2gMzy9JVzbH3*G$a*ac?
zm-qWKE_ECZ>T?`Al~FuMS^_VJZRzQ`-2d(DjAivkk@>83A)9~bZ1%W(C7VVM&M^hW
z>4dBx2=VfG&#RO6_Vx^L6voHLM@B}-1U#A9*x-GG(aAv0{a&aJ0y#G~x2cJblQUsJ
z1qA||4B{yvIvN8HZ)RdbQdSlb@*|&|n#z++XMFR9;N{E7HGL4sxVX6BU{6m^gNHjA
zL0mli(|lrlT%*!3G%ye$FH!+fZq!Tn4jVJ^ITRVWAS#+SoKjyp$HtqI;@8xi)$lVF
z>0a>e(+RrsgLjUh;YhQG%h6J!Lv=N2qsy_a)8>^be5-o1k6`s+xR=Z6<+fAS6|6~z
zpUG%iPF|j-`qK*s7x&@V=Mm1AMlwD-FAt;u8fxm;_;?;JuJU;JXU|@N7d172XB)E>
z1|Wn!Mv)>wPEJlehk968SPcygb8~YpM~h=KGkMQdi`DFIFRTOwTRVf%!J~AUDpXc-
z1Nj0xDDjwoXJ;066~4Z{t&a~2BO@{*B3aql0UBY|1WIn;oQsQxhK3@4j8q6dKYr{4
z*l@D7uTL4W-T8g(eeXS6W#U$4=KMi4RZ>c7-IYo_0OPay3>j-l!ES3qL+)rgOxq9g
zH4)(hCr9(ot;?21Mj6GH8O2R=1BDmo7Up`>e|;n+wg3Gqo|;0xyQbZj)e#G9`{)0|
ztzvIr07o%bt*EGRXP3W!6w$Zn^whaCNWG}wJ~zYe;Wx$f^F&%TJmZpbs|TMuyX#pN
z=;y?4{M)x>>4JH0qvq?zgvI;+^pXvRh0T?{W9OJQKGCI9R<>|D|DKT%p4(%!WS)`z
zYoQYk+FNd#vovC_{VXVn6X#FF@yqUY5=mQWXJYv(2pmY)%uM{gJhznU1t}jsG+nCg
z0g~45-@n15tbBSjGcz;EiHXCB@A5J-D5$7Jq@_`zuI_GSB_;gx{r!Ct6O-+Y4dxC%
zi<#0?ZU=B2UvY5YLVNrB1@_>ip`)WKD=Y7*uuOM@8Um4Xak(zkSUrFKd{P6Px&fS*
zFBKFOQ&Up7>|=SPRBCF!f9F0Q9UIfqT)>4M?k}sGy`Zyy!RQfaXkWZ;en?0rbMqp4
zUHt|N&!dra?&}|piA`bgxJWP4nZhSzgae^LH+!u89?8k$acWwDBxa(!>!MU^_xfCw
z;P7nwzP_F}o_;qk6YH}|{K<j3AWq!x9La+E;>|{WJ}F#=uS|4`aw^t#B1(ZJ>;~JF
zMqzNUYl8#RVjmH?dEwfeKlWPn_n(fY9X2^L+#k0tETc>Zs?%96bj?*&jikc)t{oh}
z?Cp8A3ZzKo+N^w!i<_{ryrBQQte+YV_v!w&tOnfFa`j;Q3};4@r;V}k#(Z^niD?v3
zEfepp)CYJdfKmG`1Cvi><zH7bv(6c8bs`3vTgV<B@rdD-xWdPe+wJ~{;W0w~&*EZZ
zqp1_We|I=t>qfz2T&%NO?<MmY8XUAx$;{0ByV3t0)JjD<2?>cpfLP!&a&koZ8{?Cf
z%k?_JB_t&zWKwyIbaj8`<gnYVb%_L{U0+>EC9-z+^@V7pRb<xGT!2s#k8yN#w5<7&
zooxsrP+MF3c)1w|2dAj8@Ka0*w}bJ*@an6zg(iey>*qh-nXE;USo<R`<QJjWd3&iU
zVn?ue?Z^#8k|3X+CJXpj-yCwT#L+Pz!`4_wIJi7I&9m{-<{jqdK5J=-+}oSp+k+dQ
za4E|FckA3Z#EslCXG%Ayy9^ru54DRe!-DkbaJ<Y;$Mz~@^75D_J6p>AQl_~0fPoGL
zI%j8}HaFki-wQ_;7M3Vf=S~%qbiY=pbU6;XaersFYrJ5j^hp|YD74h>=Qmg9ZzzO2
zI#iRBI5gF#n!R}SwuUgVUx8;ZbCC3@N<s~f<6Dfmir&KQvfO8zqMSH6ofe<_n}@=}
z)`mvKxb(83{i(dsTbE<{*jUK7dc+tp+Fd+v>}aJ)T}SJVTJX`)l`E?tfsjbFyDOg~
z`I9(}lG3Naewg=5$(&WU7t&Pyxagu)aI-901DXKnH6x;vUftX%Xd{3Ot<&o5<?LKj
zR%Qb*o~><pTH3Nr>;1*u_1RpN2`8N$NPjLaql1IkpcYnDX@W`=gh~Yc1i<^(FC`HX
z|M>s_n6t8|pm0L=uW$Q@hY=uY>0xj@-tWt*8EX&y{>>~X=yNz<ZEtTMKIFKywZ*{U
zFAE;nC-FHM>B}RAg5qKbT3gF3EW9reHs|4Q{@K#fK6D@{mGsT-xb;y0YMU;J1h`2g
z_~_y4^m~$qkNLGR3t&1bZtS1kT%g21oZC?pZx+iUo7H!e3HW#k^d%7P{6j%SU5kmK
z7H=sjg!LUpM#hOEU23&kchz0Z>*?{WGEv_*RO)D8wg|KWdmEKodUT)6`A#-{x%)3U
zmhh*Lc_EJdMP`>$zskQL&dzgX1xZLpUgH^g4?REoqMu}4vY8r+Jlpjp4C!MeF$~1Z
z%L}l+mDM2tQY26$nc&g>KInD;a!XOKG6n#igx5K|x@&IEZFf9}k&*G@;vzCKQb$Jz
z(zUPvJ#|sFls2PC(2H*|F@)^qv2}G^%4>&*B|m?z?(Iorjk%xiDTDf@tvx)?G2Okm
zxR@)Q?7Z6c1r*^Pr?0rl?Sft1qSe*P1wKkrzcY23yQ+UFef^52_=raK@LlHdZ+Xjw
zb;TUl$DY=a0|enu?{|}vdakd>%-DD$aBH3RugaoO^ccvD3}Xq2P$0b4gdP!qFo(nN
zu2+`-G7t3ar1yP-`aVfKx3`D&6%0Z@20K>J++5ZA*!=Hb4V|9$kLr%&BrcB&Ou^Qc
zuV1|qNk7D3kx0jE2!8v<6BKkXljw0>*&G%1rNC@6>*Mc%QB^p_iPtvAqv--;NlE%%
zp7UHUwI<eYyy0MB2L=X+iHQNM5{n?r`T0{$MWtt7%*+3rQuy&f&~gcMFkx<Iug(v7
zH6<l;>bN2`e3K$WxYmza=oqd2>+14Tmuk-UeacGinO^U7t#wyPOZ_7usU1z`++7u7
z@?$3Dk`s965ET@(R=aTjhys7m7KVg`95ABw;ipQm*F8_yR5de*Z!wu4s|1)73`{ms
z7$${9$#F9?la@7=g&t=;hGUtt44P_8l*|&&^y>EOLj(@Ad7UjS;mhX+G&C(79H3Sn
z7v=AG{mYNZH8z)$`nNR<k-wt&v$JnuY1Xf$_Z06BwZDF;2d*q#&WxsOzNTYZX>>_T
zCd!(t($)rt@FC-KD>$+pnVH2-HLjR{t}YJ6JuU~{zTQdxvB=|M{V(>-ps+}?_LZxu
zHp#|;=VK3Qs7|xDlS|ae-%Liza?-EHh~);e^&!94TZZ4UvZ@rT$;-)+Q&O^mKK%D@
zIXE~t9nL)>t0)G@x2efL>mzSP5Q4Nco9t-$&dy5;iVV>(DL+50<RsI<_(KV)riW{X
z?}>9)aEK~{{o)IAR=my!f1BLC%cT9&E5!xuVFQhG2dqs0Cka9$Luv-5$I^xy7wKUK
z27a1=(Xris*KmlWL!$|gNsditv<44f^uD~ObiK@{20Y}RcO3yPJU4egD!y*5ok2?a
z$|LJLkusgl5ohke=}E`Sy(y}NnnMXmgO?Y-%Axd7UyU};fsY|L?7D%c_Z|4H9f4R~
zqX%A|50&Lygc!`G8-1uL-V#W7TH#>}jrKXmwdj;{XXo+fq)#lTTq8TLcvV_eV=4S;
zRf~kgpIYnF1{@L-a~m6To0Vd@-rv!*5r1$ZX#~XpnHK$X-_=G4(b{95^kf@l?@vRo
zTny<gYLMIl4=Jvr|1m;9^!uI6_u02zq1CQGnIYjrKLgPAy+Q+AVHY+&?g^F7($Bv8
z2uh*Jdv8Ok0DRj%3gM6yJ#s&cng5fTtwu-F+xHIFbd$ZuWi&K7Z`~Sw^y-Tq;q*@(
zuAWx9z}vy+Ku1W<7pq)R8nJG+dZKZ;M!UO3Ri0k)<VfcFOASr{1MN?j7|;V!)WF($
zWCQ{B#fOIZZgesY`c}t(uX&5|(s^)HwHB|9%d6_Aljf&p`CcA&JhV7=Piu-gzr0N9
zGijLnLfOx@M+R9w6vExkE-TCRdV0;Yxb>%EZK)q{s)>mOv1n^(fSz7cOG_$d1N6xo
zo12o7l5+*wbOO3de?=DNZ{vEdcx^Vxs$W1{H#Zl`N_SIB{1Mc7YU(g;%y9nSac~-X
zdhVwtgCYqWn3<v~24YrMg{VHV;%eeyXXR&%$%^K*CM7LIl9*8^Ufo^)C{V<SjYEte
zCa}A8CKRtx!#R(VA5GjdH;^0z56~+vHk^TBR7tgVRw>zOe*+OMrP=k=k%;K}3*0uN
z_JG>Y>Swie5*8@6uCJ4-yQUW!%Q7>AB1isYQf?V^Xqf!npXrH@uLQ_&U;yRu?t2AZ
zad5~vbIqyPozq%CVU4qo^3)gqXC<Lu^|vD)9`f>01QK_MhVpd0Z-ez<_RNR$V8ml6
zC@5O*{-UJHd@k1&djB3uj?-0Z%N+?u5Gp7Ljf?A`q#WAB-X03=8<3#t&-a5ZsW2d@
z(z?56V&`DRC1Q2|bvc$b8LIL@i7kQ}b$dh`i#SCr2F7F*jZCnmx-f~|pfWHpE^j+-
zG`)<2UER%{P*bC3cCtA!F?2Lt5u29o?T>{;4S!9ooa#VLzL&!qm6qEh7LE;Jt&epC
z?|wufTcj!$7aKP==$KnJ-R(}49UX-?>+*jn4z7sc1mI<_FYBWjHNj^Uj^&~7RL+~m
z^vt8^lJL>fz0i;YawG$>g&*lZXO}<HI7R((@yzMAc1R;OoR0rhL;z^3;~!}vE0dFK
zfHf&l%mZf-)OWx;*yqL_&K!tHVg!VTzks5t-!L#V8x7)m#4lbkl+LcfDk-xOTDAGY
z0JzV=&c127urSYNu`uiAM|mFo-oUSJa`yGxS3R!A<m`HsH0Ko=Uo;dxsa=^XVzbko
z-+LgxdDElsNO<@#oV?lHE&KOOHaIx%TekS|a-L4p&Qu=2kf=^h3aqRQDpSP-ubMq*
zRa7qG;}Cprk_au>tIwRAilv*y^049C`PxmZK9uP&aMX1xYb-QAp`_`w{}XK~Jl;mx
zNvZ9#eT$LE&ySA(4(HpzX=8kOD0vtd5UW%r(&di7;7awsVcq4@pw$(;XaGFE1zZ33
zldvkGl8}%-0D{l|{TrW{aKpzgkNNgZFMz4LyIb)7pP~iOAe6sRCnhG=+y3bQEvsE|
zhPITFRCsl?Ox|ZxQ;dXIYVp5T$~ajmUy<=ShEj`u7W3I%ST^rYfP067QpK>bZdm;e
zjoj*kB4sR;z1A1d0VK7sd(-nK`dn*vUPa@7jt4{Shfg6gd5RO0EM^%pTVkv>shb!T
zq&*x-4crtNYhziroYutXFYYF1@og{YldY`b(6|qFJw3<seVVM1);=;kT<vT?@3pm;
z1iWqlGg|R3&XI&CRYy~k*LL;&o>3TW45;956m#>7iuQMRH@CNIRd6E2ib_h9<>f;o
zB1rgL%L@w&8yehAO<zM@y}jr}98!SY6A@Yeogs2C)9>ZT;}!dD3?K(6`djSFjg86q
znEC{!h1)CqA4w_#?(h(`_#PoqI=?Lh{Vml&b+m<ik5xqTCeEd$*YECj*a%a_!WJ5w
zn(Ey=7KV)d7aEz@7e}N2Z#XiXR@tYK2Y^Uy?d7&?x~a5ug@8afjXFB!zMi3FYW4j8
zhBwD#gdDmyFd%W;Wh7_U)WlzR`D_g(a^ULJSgOB&@B8ITJD^dBNk{<8J)ge^7-fs;
z;?wi<>WT`0Y$t#JR;#zq$;vX&(OHhB5J}_rsBzp?Ktv3#+26pC)?N~&5`$0S-L^2m
zCc_$6l^<(7r#QV35D4pyj8m5T&B;Q*XRh=kZ@bXzwuVv5m6A(ML&o|rLj)>krOb>d
z%pX4N??bY4s#Z{h^ZkbX%2n*cui7~)n;ZiaMJrw{r7o?j;(XJV%r*4;8!MSlri~+U
zfBp!KjNnR0U^TnT8=$=YPrhSBLA5%JxUw2f$`QPWhxD<qEHX3aJ$`BgBm^`Pr$;g9
zhSUChMx-#oRpYy@aXl-w6>N+Vz;bKjQdNOq_0qeHfcU|ez3BTGHBTzY1g8v|HGG~|
z(QYhT0G7D3dp38`(bF&fJ4CP-dkXx=hkL*qasuYv?abKD&JOf>uC83-F`$~+th9iB
zek%YOyC;I^BSt`MtP+uvvu@On!B*ZH$O+mvg?s27nT2f%@x?G#4qG8V<PoWLy|Gc1
zYBLfR76w<4P2<yJy!*F{eJ0713i#UhG1RFtW%>E0C2s+j2{s-GI76wtmw@2`2Nlq(
zxyFD53J4A!?CS#*&`1({*gcP?e+Kv3OY2|+l-6AHn7Fu{SNWE-tgNg+GB~@qFm7?h
zCL~M((faLMg~PTCV{KI!*p74APo@Jv5wc!#|DAKr#f{+R@v%aNidwDCvjZCk$H)^C
z85tRrr?vTNiy;(z0s>JnG1&JC3Nebws#&tBJm>3Cf;ugpbAW}MocuR7Q`8OG;bXur
zH#ax8w)(icyEpC`2C~4&9`yIEI$<}!*LM14(W_eL%Qph96p-Vi0|U=dP_hPAn%o@z
zbRdX`bc%m}l`81-aJW#bWo?ePyYd(ehuGBAY(>WR+QI($-ne^a<_OKJT(C-*!2X9i
zF(IKZNw#)&V-pjNcI(g176Atg=t#gtf}J^<uP&Nv0H36!|Iy6M3=m)7+yen5oP;;N
z;Zc7wUp_4@4V?Y!-Mn-_{(&S$f`fCu#IxYb0#n9DWIStSdvK<tp<!-jcD*%B1YSNq
zJ~7mQ82(=>iG`I_YIL-&u5NT(TzB1Fk7ry(dHL_2o*=?NB4T3tSFg7I{DFZQoewj|
zOu<JIo4rk7`J76FWWc}>x3<Ow$*I<QKir*fkE$YdxbDcs6)1jGRc<EXcLxc0Tc^qO
zo$b%2@87S3P;1f!IZL$aIRzf(0ofz?$ak?SR0jAr-4a?lx{hH6Ho-?^@s7T4{=y<l
z4|iv65k!|TZHu0FplT6Jn2bJSu14*}^(1p*H9jC;UtG+gA!*4!UR#Taj)ow&qSDL%
z+Y12pY;x%gbj%0{2w7qg&ylYFPTyW#8Jd`+^Lt!0+KFxV;+~Woon{!BFxgtd=&$b0
z!lI)`iH70E#l^j$qf?}rY?}wgc4x;F5MNM8R1~6badGkVTLKPCHFb3Yc0grW8XA6(
zmQ7-N!_A$jD7}e@gHu*mWC7a1`~(`BQAvr1W}nC1T<I}`o)_XW%N)i-(bCD8E(f1Z
z&ccA|<@To|T{dObaevx>s)$OX*rfX_f2|GP^))w%K-0s~(#Il|Kr;RYOlWcn@xupK
zR#^uh69f_}W#Ti*qgcl_psfK06vz?0g=Bz}b%B9_`Sa(`w{PDj@f!f24{j1@JgUAo
zr11F#i<A76L|ryq&i-rF7BfIBfPrdiYOJlTA=}+?njUEZp!Qf!cV5Nfy?kkEZmuu^
z*kZ76Ddul&_&wExFnS<zx&@C*YxF`nAt4TSr^YYsSP+-1t@KI@t3j_h$R1QIr#um2
zaK0s)Bsn=bL1;_&fVaclXJI9Ddhk?nc0P@xbAbUQgOGHIAOyJl!u)?(Dtc*Re)*l-
zzJTVk0>sw!-%Y@Z19tKJ?_WYTQw)=Zpt=_Zu#=)(xVX$>JIrhD=DH=>+0^1O$|Xis
zH!AY-K!qb@*Z%yO3Ft%8Pcjt?P3ucjz%VH&)Sw_^0(OIjy2Wq|lzn~b2J?9DFd5p6
zoX?WOdv=bC-aEhD$jEL%-zqC!KOCpMo5qv4pWtuxvqM0px~sEu9V9ET7O#`lc3=mX
z(+Z;&_uVJ9e71%Zjx0CxXI2!RiYjY%R_*C-3}Sx)GMiogWllrGd}n88d;1sn0?<cm
zYD!AafV{FlBkjHQH7v~Bq6m$oup<N+A87qAppg-wH*acFQ~jZ~@p0E1M}Fw!@4U;6
zV{S%<huZ8e?tcHU7ZQ||B!S1c0V)3d-Ovy;KJKHQCr^~bFa32efAG45f4;CYzqk{?
zVW6K9_wz`3b_ZhdA+UD-fSle$p5q1t1_BPl3dl@jnW9SKA3g*`L`Z-76q1=qx&90u
zAPP(>v6n0~Uo*uHW2oQI(;on};DP=AdrOPAo?ZsvfuWbUxPanyC@k;<oMU@$RQgl;
zqFs?wI%qTs>nv2Bj)(w!Rw=*pfxV?=A?R2S7w~H9N^5JE#&a@COL-R;w=VW*<e!L?
z`;lqqo(hA6nbHV8xA9=Nq`})juAJ}Na3e+}EoduzbblmWU~g&Q^$yP1AL;f<|8SR~
z0)4u)r$SZ@q-=1uo0>eGoT>ryydLZwOd{Y}_v;s+Pg+4q18_!c1g_mr9Ss3x@U|N-
z6rpuwP29abo@jy~)lG|bd!F2tY(BD@;P}J)7g}C^Yh|qu19vfsRKZ?9NZ;sLSkT$}
z^dMEMh9#U~Vs&vnL#B)jL;$G(2q@g#+*BVU!-3j9Hn!`T3Wz08m8iw1r=}8r{BUd$
z4uIFV9N`)A@^f0D>VXg81;_REn>V063{$L@XMXvfZ>G~H)9JW0EbVTDa+1(f2}?M2
zb8StSrZI=~1Ss^4)=NB!iW5%z(=73)r>88OoF?0R)M|oyn8Hghdfh?8UU6}}((3c*
zedYXq1<<{{;RFUYHf4b7rNJHQ@88{c(;Doe{S)n7j~aFbYA39<?y#gkyePUXec$Ni
z7&(XD>wY6kfqXxk6}%THbzf{+)vl>^Kp*a~)!9KCihwB`!pls*^V2!CAJ9pg3*=ev
z8a8F*LlFvkckQVw$X6bk0L@N>kLySr#kx-DB0n7dk2Qo~g&OxRS9}s4FYP>B8xQH6
z4fM!epXZxWM(2t<S3aXqOirw#etmKT-S{muBLH@i&wc}mU0XpRv!I~fcsQx8?Y+zt
z0U;re^&(dcwS$8Lkax!Bw*JzPrL&pqPrNcfQyDCp{O4J^O^ur(_*mv~DM2bIFt8s)
z9^e`Zt{DFDjlu*dm3-cJt`<=m);6gC-2g1_myz)Y*n>vW1s^XC7i6k&D0Eh*>N*tj
z#>2waT`SE3Fdl*OC#RuNn3tDVTKce^?xO&g06OeEsl-fBG4k>f($mo)AeuqU;L;Ge
z_+Oyl0q+3-I{<$`7-VFEmb1+4?Chwh5r9#zRvULt9UB`nHa1rB7#bcn(AVdxcDV~B
z59hs(n(^>;4JQv55ngk0JSZvgf^^qD)XvUMw)<NtDVI!6m57MQ!nU<Owxn?kD~fh2
zeC!qAZA60J(iP=Nsb`d0m*j27q(8z#r2K{XCHGPF#?x4U0s-q^{qv{7bS$&7k`;*k
zg@$vLMxX+KFTp~9fcUgXbO?k#WV=0*8Wa>1icLF`%o%l4f4sBvBPHbyC}tqL-QQoX
zFvS1THnF#_{PqpA`W%248d_Qh^W!UQ@m#0BWM!A{p%YCRgvi^w#Q5Y!K>=@U$k0gi
zVE(+etW3nsP1tw~XrWXvZNpZ1iHSm@-Tl74-Gd3oFuq2E&d=cK8R^2JB6ao;h~c5l
z&9YZgwwe|CHsbxQO4Y?QNEBb%Dn0;@hr<79NMI9>`5zC0mY&`p5bC-OOBUT<aVRM%
zfka9`K;W=7R8Ux`QD^&Sq1Fa)z1(^o0e0&>nDBZ=MpMPvhde-0O%wE4ZgjDMKtuE-
ztQQpg>07Qa=g{)p9_fmsyX4S(#dHklbYtEk_UUm2vn-~|1;i<$+M>V5Q`4sv2&qkB
zQR#}im;o#a9_Nk!OxbSlFal0*FAIPz=EO*L!j$c1IQcRxZ1C(XJs>#!RsXN$W@()!
zE}*_L#Zd3>5gHl-Z-5jbp@2dh5()}CyEcMv?knK_>RE0Ux3~9FDK1apb9-qaPB*+d
z{1ew(=3Ov+(oYla4K*7W15apu1}9a<#?+KtJVqu@RY{4NX>oGW5ny~E_xh0o#{#eh
z05J_43#+5E6WlE<92`*m5ujokt4U<&{QNv7CT8*%fbrVeBzYG{jk&TjytZxoZ7@vG
z&dMXAxrS&C*$kntT(2ApOy^=fQ6xztfHvjs)$Gc`S!00#EuQkR39SK4K0$b&SR-Uw
zRpjkrl4vL?EzQhQe(X@aeOu{jXB!5d-$QRjd0SuK>n9x$6b^hEkfNdJ*jT_Mcd3E3
zf3CL|Ra3hHDGL;B>fNm^=Y!b_P)(nV7|YAcD=UKh{3MW?<a|Ch^z!9Pa|?@t7yv!I
z@9SJtNV)B!zkja>G9lDAaFLt4xtW99p(Z)#+#f^Y|BL}&&^r{E2G`aE_jl{F^YA?H
zuFSx9?Cq<lX-tOF?zf9nA6F`bVzR$0MmOCZAfgY{)u7~ydJ>Jfd>c$~@bWwW@+Jr>
zcwmf-h;TwD=0br~%eJ_=;9-5gjpg_C`9Q#R(%JteMB{WMH8>0xVJNW*NJ!}ba82qX
z3x_<~9X#tUFK4EsD*{lTN#j?@+t84Z@`?)3aL6ku87|WQEGps!_LB;OUZ7&Lj<+-F
zG|jfPkux)&<fVJVLdeLW`T4IQwJKxjsu+$v`nPY#XJ(k_>Diuy|Ben};DnJm)HaEY
z<x^GM|E!{-tfGQL-1I?RU9a7b0bs-AA3Mhj2?s|H`@hWGWn>mq%ObfvuVl^RqN4-q
z>ca3C;Un-fMkZ>qnA~Obg#gs4Fu<dG-Iw%ZCyJ1LcH*7oN{ccIo;50(00k|r*UoPZ
zC?rJ9%wU}e3#%-D_Hsww2AXYsOn2C>R4M)SbX==H{!h#f68$gRNciW&MaQd?KR_|s
zOWNETP6oLVk5Ow@biw=(*0!o0240U(*LU%3JJgZK?Z0>s_$3t-tS!t6{v9zSCg0}Q
zT%-VPOMa{>icBzqls|wxoQ9?wxDySHjcqS1--n&A&%(BM%+(fuZ^&l>v^gf`pBhOG
zn`e;>@0XrOGF+_z=Lx_o5fKpp_<~+)U8(v|A2c=Jz6oWG0c(`8ac*23j%?Bx2%p&K
z=-+GI6b@UK7}(hAtq(4RDNn%g%MqEN_swR4-S&vlQk`A;f|Y2#h#HkIhd%J?3a$gh
zM@B}5f)WNC2EZJ{8iZ$?SXWn<kf7@9%po2Fx>{Up>~-;X8nMZ@7!VtK9HUkr3=|Wv
zI|1-4sfXL)JC-pQ$3+2~<!pb%W=OXWW3%;fIkVupF}U~W;J~Y+qa?`shwGF1&%}<N
zUQR)w!D$~i&wQU58yj1PGs9?k*;z6nsG;G=)**SJDB**VQFZb{(@dE~6iFj7QL?!)
zhxhG8_hbw_OtZWA)zxfc9XuJ2<MN!Fv4zvxJM>1xA)auIH8Q}Fp;<Ubq@0d-=vM}I
z8=B9rtOO=;Ihr!C2ZcGgnQSLo!NceCayz|EZ8#^R2yjJ9{~3aDDOcbJQ-wwqaD{UL
z{HLB<8EtmXXaoJB*|`P9o%;Hj$jCF5m6Sc<b{FSP<rRrK>gpvKrwapd@k-Nw=v19k
zcoV8UuhTSZJHU@Wd)9fhL<c~4+IMVqod@&frl(GDdg*?q-5&?Ww;J9Ke!nF9liaGu
z4C523;CFM2BA7TjYW*4-%Br)q@d2<Hk8NM7uCHZ*;0)_4nQ$amKtD9};svS`v^t)%
z_|C*yZcx!cK2LUr?sbTS#DJ|WQnvkzs(5A-5;2nB2hJ3GG<d9Py2yx<7`G>su)>R-
zpKxCMaQYF2`B|Q+z_2*Ho}r}+%bO8qlJq|d2v=$^X5ME$*{Rj8B8N118h@#Tz{9q<
z9Qxs5@}NyT`*|^6J=k2W4lcp#wxZF`5z)ZyJ@U5C1^_Frw2l34wGThd%-_mm50R0Y
zyALO=fSx_#?djR=U;Og$aQ>kp3)9!eMxx9KTwFiu>xRr5vuQ1;klN1Rg&Eci)!G6D
ztAJ4hR5`#`CMP!n@0rZ>bpMJ%Dz}Ks`bUV|dXGarnEUVH7k(Hdr!?|&T)^^dbp)c&
zsg}Y+pFe*FQYklgz07oI>lMOFA^h5_Wd^MsmyN!l<I>1bghrSbuwWai+66|?xj`a5
z1?GXH#d<ghUdVE(L0Me9zZ1AifM{)HWRwFcMR75(zntHkTk!MqoA(3Az|G4G_g+fs
z#rbTf@jmQ(N5@}@i3IFc*4Cuh*qx_6R6?hJI=gWPqez>(M)vY#a^9uc&vl{_8FT7)
zWk!}Xx;q8@nEeL=UtR4kC)arC4@dcR7q|1XXOsavp`Ci|K=ardN%h$IodI&G0?m3)
z#NfyXFqA@1o+3b$#Ky&ec2`PN)CdT@Ko*eH(3l5?tItiYV8>9QI`4a)_4;Q+U}gV>
zIqdvq<JlV<h9exLr$jN-$BS;W`k~nyFCcQH^%BkX*jRc#K4&;6j>Y!wil%rDg26_q
z$p*gdwKaP<e?1aSe%{7Us;Y{@!t}h2b)9j)ko=(l*FdmP;FU0CBRunudqR@g*}%32
z4}q2z*x`V69TOK9D9|#}((EiO;*yes{r!o+U;E?7>|g>D&<lY|*xtbSR0jXg4%~{5
z^T}WL=(>a<a1L7Pot;>_b=;4lsTL&xtkx;c&KE5qA@2a%Yej}Y_~l#r8X29Ajaj6o
zK0c<se_KIrP@&!U07CLLlWgD6VxzMaH6#~`K=)P#fHOdR0WY|UGKjzq_*xvgi}=_(
zN##Ke%Gddb9(()f9)QugyY{(1>6D_#c=Pq^89E7%&*p%(A2Yx@AGDV=wC+q~N14sz
zHa3VlgC8m0@(fQ;GjU#i`_f*H$F!`Z)HFUr_6)MK!>g{g3JlDP#IJZwn|Jl6^SK}M
z#mOwc{YIw6%-?xa<YzGXlE~BA+)dqo%5_1n3J9C|dI#F9fa~3!;fFpmws~2>dnGx!
z==gXJvvF$BcmvqqH!yIqKNIDo4ds`WCB(*N=jLQ*@9phzEx2}}>ogb6HE|n*=Qo<x
ze78;Z7=k1_jkUFzCpD(5u(vSz!GN*J@r?`kJ}6D*u?7pF2+B$~BwV)BE03?KD#+Qx
zSB8ej+1c~E3-j6huxTS5ZIMzqM{jS=VW(qC`Gko@FnT6(-C%vcv@`QITJ7#4eEU`;
zlXA7+9mc7rmsc=?6+`WE<cNofiH5?93eA*m4yW!jP*FMU#U6JC<DjCFp}q(*F~L)e
z%g!|h>TXp{n)|^I7d^eiJQIB7{;49DJXtbc=VFzG!*+6r!n^GcMKCb@p(7&`fOkQa
ztE{xIst4K+;Bf)&2af)I70^Ke+bD2__Vx7*4GjSn*v-{-c447brQXj^*vg85eW*M)
zHwcp-iH+EMR?73P8XTR9ihZAJBVwFYkQ)sIhTqA}L7?!8#}pU3556{$rq3@fX7;$~
z0!6H&Qx;BAUx<Vx0=Fo09Ep%<zoGt6tBDKvCL*f?9D=ipUgD5EtfN1IK20o=*m1RO
zZ*uaWxLA1agMeN~$iYD-4BQ4KC0}4*V0Mnj`TivwWI2aLNBx2Nm9@OWp2x9{xQt8%
zI6D88!&wZ1l9Ea@;xqPa%rlKl@PK(wr?Ey+NT?<vUJeFknI!~6aP=-)#K>q<xkyF+
z5{0b_5ZS<71AI{61zc-#{?DYOq>%jN6cs^y-CVBt5Wu0R?e6d6;o>SxfMwj=+z{LF
zU4ApvXnZ(rXx1J91t<*9e|^1dZ@-b0&-Dn5flSBLSO7a7gE5@pR3|oyxmf|9w^l(O
z=f8iuQVa|Wett0pioGugGG9RNjKc><7&+J`L7=-o+&L*vEr@^jhW91nJSr-@P*vDN
z0sUB@z5O^Kbmrznd3gK*mu0=esGxlKS;_Io&E@5aW@S~_`M;nV5^QEL3~-<TE1cqo
zNqfsRr`g7J1dJ=g68WLPRu3GL9GZi`u{$+|^OP`>HY=?;^vulMuKyZ|h=@RS?&pO$
zIW&kwD=*eR@(E#d1{aZVt)5TFQXv5ZEh$Rwjr9DNeAcs%AIpjg-HAxO=NCPfriwC(
zX-Z0pii&_|I@4hrHpvLiQXX&!Y5;mFDwdTA(lei^fgy<P^xhWFYYvvvhLDhxXo`Wy
zhg<i%t3QzKtuqBAm6Qz!dEE|x{sDCR<DJ2qCZo%&EMv6dthC!1)#ooEeCGE@AV?4p
zWU;WuOFxf}jw~mnKN{|ib02UbH=<&!aSIJ->H>P&*jOxU3?hH`?rc=>@nC%T$+bCM
zBD1;4<mH9V%Z<SAis7*8n-CtZlwkdm<pn-@Eimz&{e;=VDqIg3^XmA~H^}=*nr-kI
z(#lqTTbCbXdwFC4F*D->dQDAB>*#=ZV~Ya>qZle`cV?yuq^tWr5J42uHNB#O4(2yo
z9L@5JEc#NogC=3o$y6q%?msRC0kfzEUczc1%Kg9dVC_1LyDjM@aO4Uk<`E2F16)5v
zcfbN|g^8)`KNezOBVV$7Pubf)aN%svis;)J%*5xe1Ot_pQULNHKE4NDueek|cb2&t
zbR@ttgHHCKsHHVIY_;A0-3(qxO;dKRc|ios3`r)>h@9x*3JO>%^bV!lbRosXGbDeM
zwp`l#B+YD$@Qe}dg_e}GrUp={2^A;8t?_$eCUPU*yy5O?3Qe<}LqUc=@Y7Ex4@7`|
z_w@NQD#)J#F;GQP5&<%0<C#*0fsBlleeU!!^Jh8V?xm!EPKk{*)L%Of2mn(Soc9;W
zHjfYX;bp2|bnBBGlA2nZ^d!T~|4_nF#tw)tq8EPcM!6g>gSyn{&Mqq^R`_Hmvt(fB
zq*^CU&;(v<Bq!1!gc1c+vgnvf?N1?c%7;u8V}B7)%smsMG5()1A|-Aeq4x|}*vUGo
zE@?Mh03y&*Q~z5Pl0w{5Z|2dzJZjzF8)4F_W2fEzQ)O~WZ2ekz2}MUpmkeAS7{{lk
zRjjP6LEtfH>eIa~gwX|X6zDTYM~wi1hk*g4IV;W9hf7o<%elGdTfl&xuhf3RzF*$l
zY}UJ{H^L*e#02JSh`;CwAr=&&_YJ&lvfl(iC}@A?k&%Kz<^Mep1e1Jj3HT<u<j^aW
z^>&yc^<aKJ=g-aVwE!uAOjl#=q@+m1?A4GLHdu^;R|(L_{uYNzFB&KGNv5U3dg-Az
ziVlzdM^f@_UweD(0MEf67BbL9Gu~Wx^LyWEX=<{+GEN2jW=%~=<87I0+454A$#v|T
zEVsHDBnlWmJ)uDjVxeKJ*NluwF_o!qM@LJf#UdCO`ZX>#<A7!ePXNFhq+&`cRe-3g
zWz}ZQP{R7b-JTq`+MuHFHX8&J#W~Hk>CP4?0ykl><`B=_%x9k$WTiE_?YN+<?*;YO
zRG}Hj;_Pvs$iQFdfx*U0L*pYb1o8~>?&BHiY(!+C6biA?Q)@Fw=CE3G!p67+;xrcY
zDaO!{q^9E3$(A{p-9lJe`W}clCPVn!dky~F`zLqT-@h~$cj7U6_7BrDELi~Xe*jQ9
z62-F@C_J#=fBhU;?JVv@a<Xwn_~Mn~qlCp77!(A!HDg0VX2Agh3W44}o+i_81+lRK
zRSv%=@|4L0*w6^s$|H(91@C_MPO)eI`iJl<)=5n?XQd<1TUptL_q!85MF4zV?J5`<
z0e$ID(y5*OeG3zlkNghcdco?!*8vd!%yTEKb59waT482eR(f(IN-i!gkZD0RoSwee
zoyY^C3Mj9jm7iP$RBd-p&qx}7V@t~eP!_>76bcH8$Ny)z=@HOt2@IMX7Sr@G)L;_I
zeQSsS$avGwv$C>=hlcW{larHsySiN6-D_Hhdx-g9ktl?|G!O7UUk+^(K)b~Ce7NK0
z<eV88cuP*+*4DPV-0T4yjDU}xTugjt($LsQ_vVd}vGKEK&%g$}rl+^;kD&oVKVSjj
zg}`8hF@VEBodwN$mGSVv=x9P*9N^5aK&PxuCnX~TuEwc+2AEPletupI+>?!uI6agl
z;*x{utVW_$9UhlxV3N+UxB~&DCWR*s^a+3{mL^6+SzKD`?&@OHZg2#*Q}{vc>XD3*
zQ?CQQkSI6_U{_dQFnKXBAOR3BbaHW_qNoUXx)mTTCnqHVNB_aW0ra!`Im+|rZ0zg>
zX27@V=Lb7-gtFEGf(DKF<OU2V(y1J<vl1Fv@WMes=&HxIf#H_EzM%-}x~^X_^Z`bE
zFCp<9+HrITR@ndQLCVVE_2H7dLo=>PP6xkD*+8>1mi5uZ&@e^7iw7X0>gT|~PD4XO
zumB3&`aui%(ZsY0$QIJFOb|pzXRy~kO-kB$dBCkKZ>ONH-abE1%iFk9yOMi-OQzkj
zNcrlOsFV~NpC?TmY`%J~pwl^wY<debCz-4=*p}q>CWQR$Haet({TN<Mz%NizQNaN6
zsK39z;4lyf6Zdy_pe=|H0}hFz`g(2%=!f@U9tcp!%5rk1CBg^@f%Eek<_!SOfvFSi
z3Z{_Te9WuxFaH2i0Fsc=@cpf<Y?>6xa}5PGwP&BxEw3-EQiFS~p`Wbx>YB3r&O?pm
z<wFzi!X;qqTx_s}@Ua6<f0?D7uvh51y9*g^6k^jpxSy^`gB0*K4kJ!Y?!yNz`UAG7
zM!?80TPF3d*Hw9DcbDIabtzIyf*J-zz?D|QVkpLcW+ws5n3<pN`fq2f25-66CLI6-
zpt?a)KbR>fDPbXC%UB0}5#aSW-cJ56{_4JT7O%?-XqrI!dbnCoIE5DpdJWe$m|z2j
zEor51>>fO+K%xO@DVdWA))$DQAW6bO3pFHPY~J0=U*4Z7>kHk*0n)-D<pm0UGaDfx
zA)vHNhOIcpz>(_e>M}+d92fwDfvh?;YQXxwxjC3nP`(PRz47t!DRZb@7U07p2;M14
zNyWO02O=aeZKv_X0n*|6#>q;wy9kGl9$LLVoB0nljW1L(ML&`5F9JNie?8;WqPH(m
z^|k!mUo~NW@q$em>6@SDp`!9{xQR|oG&3^l-p8dtySiMNiHn;Gr$vSJZMcB|DaG$0
zGq;cohP46)5FGcEZsw|L>FFOR#s31m3Cfl7A>trrW787L`#v|<9X@h5LXEpv$Fg@Y
zr+ITTucR;Jb+1>Pe0z1O=>34bWlR+iO^&tdC<eGyfd0TB47GTvPP2xTR54uKY80*a
zgrzPFVC|65LHaA)I|S(H3FJ_Ti`!XQRfB0<cJ{cKm>M9Xt3iO@DG8H20SWQurjt<%
z>ER@!A~!b;6PFna#oY8YE?xpJFJgWD@a;*4yog9eM3>)xxTc_?L<1xS8eGF=;#asI
zketx@8$Jh;Bk621%r?2bV_)JYjhpO8Yp7WX`TA8A%*N_8&(9B9z(8sm)^8cSz9l!d
zb|$Y^+N@X`=x_wu5Ki1bz+;%>dAH<KwBcdO$zr^86jq)x-{=z>Oc>3RI9m4N^Q<GZ
z(G0}c<ICh-I~Ur7U|K?a-Ted~t~Nn9zIk(=^RNsO*Jq6zrnpfsNw(uEfRs?x(5q|)
zoUNa;j&Ka4;|`aGTROIx{(oM8j~K!sWl!$UOUEcOY@`h97r>WV7rd=af}cP>nd9l{
znUCB~A_*oT*HBy=fRohw_e3WwAJHjt+GF?;&lQ0P5^^*t2`=*r$H2}t7<&(JrzhQJ
zKte?YNqnfUZx-~bHky9mQ)tnMxg;@q^z_6h2i2>lQBY(-Xu(3}=6hhe{1p=D;OGbj
z6-Pe+;{@oasXj6SicctPs<Iw`|7qqub(t2XXR!Q#$`qIYOJOq`zdqXrE%9Jy4;Y<a
z3k5FWpcnFJFZh;cuddtuE2~Uw7__dc;^Ut~DSU~bPMJVlc583X-rnCn+5&i7TYCt`
z-eqLK;U3!34<VpsqQrp51a5C^?C&u#`oIYPZ&%UH?HW+gKn(^2E?_2rOK5g>_UiUl
zvH9}9y4GX^@E8LB(3ADUQnryf3Yd-y*A_Nnktimuz@xvq;h|S6r{Ul@pDsZJ+%*yB
zynIz8X)_pr#Q@e8Y}!(Hj|JA26eA-KMYCZvvX+w_c~J}YDn>Dk9+BWesZ^c@aDI2j
zM9@h2F4ww~zrby#rVMdfmgC?){8da8%euYpW=~$2z3LyaUJ!g-OyZqk=DgGcLei4G
z+{<7O6ak-y6hMqw&Q$_-_W!YMoSdAf{W1mOb0W~m4E_Ml2aF4wyN_p!gXElICDq7m
zQbsL~1qTS;H9|>A17P+C&=K%dmL`{Bxw%*npT`9&e{<V_`PaCq*p80M$NREha~l6O
zdK7pEa<FL@XK%QHbzB|`E`e!(Fmm1Bzt9s-P-&+44~)cwEBpD&mXDw!aa~-l>^eKY
zV`F;;SeC&txVDd6#JF{hjbWjoppu#a)(u_=jB|jwWpt=iyV2Oj1|66*9({&$fBt;0
zsQ5i;dUBHf_3KqjgV`?P=ghFMh1nj|bpSRA0Eqm{D*5beyKL97q4qLiqU&^B^~q8&
z+o8|u=|S@6KZJ{lay1q<HfSias?9aEr2gyUD7LhD@^M5I6tshZI4JsuYib20`;w)#
z#DEoqgr?JAm0acLM<0w1v$A@UiUfo?=zZP<5g{Qp4b2lrP?#x^kMKkG*MBvqaGd=o
z`URguuNM+*YrMkP`vaW#FuEtYG^nVePdX}aYC%5>%tRP$*SeGi1!?!FGfM@?X^a}9
zF)|A0KMM;NSMz|yiHS*k+8LD9-%`X{=j;A$X|0Hj3IzlpLAqMjJKhZ&&qM(Q1XvCn
zIu)=GQBl!UUYC*o=up$c!wig!krhAw!+4Z{(P{{=aKM03Mn^aS15YOSx3Y0BK4IrI
z{waAE+8*%`7v@T%>dmT9Vp$p0l(OxO<JQgjZB<nmpl4uw!DvHG&7RA?r9s8@8SP5_
z+3z{-KES6N8nS{6M_9{Wo4Ka!{qP+qpqm@nMTHHA_}7e~E<mdMe+}e9Km!c>`V~la
zSv=^k0qX#`he=1^uK+F!Rkmlq_1>1z@ciJw*wms3SVSHkZXK`O)xS_RHQ|E4v;inH
z*XiPOmt%qD%5J@>xBE5Q*2|WHR`WmL5J$E)`BmiqB&<{r_x3Nt_AprjNxHb0eoOuF
zcI6R3G-@WM&)`shk_W?o{~vl_LT^YLVe$m_fE)a+5=Px4_7~4JuwMQOI8^`wp#fuZ
zY8V4!&ud@+nQw9%+Zqnj(DZdW`T}PH%1W)3L;Uyer0fIoz|g}xjKM{Wf-=v}6XmA2
z_0JD@i(Jvb$?R$w8hVsY+E^}TX0-0?2o!X176DWmpBwApYI_wWWd|@up`vQ{%-vkW
z_jdTz$ZmsS`r7jHzW#m!ZhJ#5t(3?}H089Uq_<!iF~(3^I~5FY<`GWl6??(q=Yn)7
z_>OJz&&Vo(u--$%OQV6Pr??4ep+B>;fvJjN+TI%p0d$@eA9ibM)f^!-s`vcE)fR4z
z&NQ&^KYh9bjwH7w;sA_e(AiwcySsm>sj+f&{2JK(8L)NL%_n{cnqULrTw^Tq3JYt&
zu<l^|{c{NXb&treJiVa!2e_7f6jUQPElK6YzC2KWI2$#H2p22JfBmcZ<ZvPI_QFkp
zw*H+-4NMzo+Wh_3^Q4J7<9ePK0<%|BlXq5SrK$PbCz)x6L6{%S_<U6aAJ_AXD#lfB
zJVQl)Kj(5wiK2>%tsQb2=%K(FOJK4%TJhoWxPX6)xeFcwa1`wC3vzKMg1#0op*nTH
z(Pixq6}0Y#`gT5=Ye-0dESOY#D8w(vIcPA=pGgetn^%!pS=S+${^R4$OU<{Y|8^)`
zj`*@C`eS3;0NMw=0VeeDz<d8Y<4j#0Q#PHn)p0lSOZy2JwLGDo(NR%R#IJomGj&hP
z$T+ZYK^|}g6NCWGDz}*&ExK_z7vn-38+^pPD*He$6%r~1n$Y<<DwSA1+<V)T(8C37
zko-ZiizH-M1A@fcJ>s;Dd5gb>+CBdOAu1C5wzh&<I6oNt9i3AU&0kxC5W2xwH$3!q
z)YRE|?CP`=hMeh`B@Qo@x__ZI?8S?q&kc@<;EuaJ!GQl?&|daFRmdy&AOx@?m;C>W
zv9}JWs_phgCtXU2f`ZZ^A}ydGAgMGW(kb2DDIlUC2uKSEh;(;{gdio|9Z~|)eFpFM
z?Q{3uXP<lT`Ue$ot~KL%#`x8k^8LmzHs2PxIqls$Oeqn`l^9M#Pwxs4P&nPeAK82N
z@1JZx{a|E^Brc4A*;QQjBi$`Z@4?2#U^r*k+h|ZtcvDOMovKv?z_Y1|)6#OVrlxJa
z)%1BWfOK$pv?mH5vn!9Po~PcHmc9U`V_-~-iT=Ft<MvV&QBhiM+dZ=>IMpMr6k0vP
z9xZDD9!UuI4IKYOFGf_S8(ZYQREa|J=suL*w?8M=#k&r5#p@0D`}wIA7uThvc!-MX
zZ%&2#Fg_|1@X~w)yC~TQirXGEd~SF0<G-iJ)YIGqKLoRIpr4zYs!tV`sOTLy?l9cl
zsZR+;s}BZN2k|hke4KZ*KfJ!vgE^E$c&b3t+bDcck(wXhSb#WUg@i2mI)+y}v4Ax(
zeDNoX2nbXh-)_<Egr}$9K<?{UHJ-`hp$o4(z5dCm410%UD;Wx)nH%VNru%*Y^KU(m
z9Y6=a_vDG3UChU@i&<W@)j~H1RiBCgx^|NMU;8pK&~i7IyIHCFXklo!-oC|7d6Y;(
zvn4Om`sdf|JEXpg@af(}0b;9DEa;c`&ifjt6@;ZQjxTy2GKmYQ5p-$zc<<MUh-21R
zVX*0mNWioH9ZaGXQoY2SR**h~yZ+Fz=L{TqBRY7c*r5b-UlMPU=&GPtbLdEYVQ^Er
zKrt6-oo~CCla#)>Jil+Yzx=(Ff3I>sI%t|e(+^GaP(dE9a6UW1qxHhZTMPzbfla4Z
zXXfX>e~+Rv60oum4izBZ)-0x-?&rg~nc*LdJfSzZg0J1QMp7!@<1u`AyN(IYy{4*<
z%bNtb`4El=n#!7*=aVgYT0h52nTZfMo%x!TKf`35k;sok2s%AA?Zu49lh9=qf1n%Z
z(z?BWd7n@0?wSrdW9{t7zY=bg`VmOz?BMbh@1!6*MphuZ91$YX94cI{J>MIq28tnq
zk?mskZ7h_QQBm=qB3Vf8kBD^1%GGhaYNl~L8U=v@(g1y;qXQ-g5L#NlLDioH+^}T$
z73_yR4!=djTaLoQ+6UBQR6oAhVhbdgjsL4PKuWZaS%?OqIVz@3<m4yt9A~7a5|LMX
zZBBjN+Tt3{-@HabLiTV=C97;?1h3rc4L6S$#p4kM1|uyer?9&70-$Xbo^P)vd7skL
zHHT2vL-VYqdh-M#bSy2aTY`))Kia@8P3*Pp(=ir~KQ627ehH()eod&S4{X%hLV!01
zYFGaAVGvay1S(x>1vi)h1I<fKMY&`jM+(?EwvRW)#i2X81el+ztDl1s*m~+p#79Cj
zpRKL_*w_m^JZV&9wL{>7j-+|KkZ`Vu1dD&Z^2=3$yZ4`<Ca26r`ugUSlw3y)j7d*U
zfT;ZUa-zGp8VCzJ4^Mx<)fa2S@=<Z6=Ful`3W4RS_pD}y)$F?Wxrexz*x}g;fdk(i
z1hxa<81A()xWuRykS~z8<|_&MTT7X%Kjyr7t0Xr)n5BULW!T~G>SO{x0fY&mAd=x1
zCpt`nk{=VaWZq!7A0*-u=;&GGxSxAO!Ma*ibwNfh)Dy?uIOHUuIne^~4`@E0KRY-%
zJ=dRKuC(V}SQ12Sl)r!Xi>9Wg0iZgDhB&@o7>05+jLpodKsDIPDJUoimAS>arPE##
zySB?8qp`!W%|hO1#c)vx865>rtL&F&D{R$~t%Y`b?$UG6eIoE?N?rjL46R*8>O81a
zM(ZyKo`z_GYUrkb8#Z#6nfdf^eg-;=v*YYv04we+S$>N8Q))3<!}LM|O^BXk{rSHI
zi3rHWJs~*e<>Bs1KZkxRuucEUiP;=2W@Kc1OIi12J6e=?XOj2&$rbf}T72BP1FhVM
zr!iF6;WG1@_Hi$s7v8_eCqqvHNUN2DLq`}bd6kuY7byGZ$52TBG|h>E-3tM9VScV9
z2&h!(^#Oqc<=Ud&_{}Yil=1oO@|b+Gei`{nXcIYKKfC|T0lQ!VqvLTlvlL%_It2yA
zWn>Kq*Dng4H@B6(UZ6Dy*-uD{(Opx!5!rVQH;v~;mDgesy?EvI(LT>=>awwG<Ffbe
zWo=Y_y{>gPYf<$LF4H2}jW<%H-Lcb@{fX0RSns}99@gk+*DgIaUWzsT_J}LVbt!h)
zb@z7|7`n$v*9W99>I9zB4z&26Qlknf$<ZXH@{vHm1yz#s{gJwR#M)Oi2du!n58)m>
z?Cj4ZC5edVyO^o5lcTU*VKGN8+O$UssYq?p{=NX}URfCm|4+=~s}H^Mep%uPvkA>H
z9}=QCUQY~l3B1tfWNo6on#@YIpoe09Q%9Q=9pod|5cq*otY1?hA2hmqeKpjQ<px78
z9QKC^)#Vp%2-n*a?*65%^VLH+w$cp687cmIaImagHYr?QMKMF{;9uqQQAq4b0(wt3
zHZ|QR5HQ^B=Fyq9z*qubkZFr4K~@74cxYJo{yd*3^?m=y{2+UT+qQ(=rc5PBeHv+(
zptXIt($5I0flYPV`oTAf@lOcF^z~B#r&uO=uFk|$Zy82qrlS&yuJ^0OUHiv*{u_OJ
ze|=^?a-9wOx_dIjleJ|&RDmDJd4b8h3=k3$N|M6C#~<qNhd_d&^72hcPr3|e+1P-;
zLzapMMBPAhVF$Pk#G)Wn^z<*av@Ag&3qpmwygIKlx650aT*#{i0Jhh!g_V^_PRQ=u
zzKt|AHyfNoSciNfI>Hc<nU@D3OSf90^4~|E$0Z;H1=(a&l(K<=L2*1>a!9`NI$mJ}
zZ$8K#_!8t;08bQ;eD4;jDJAvZp2tft@VSPK=M0ViM;n?qT5IFj2<VYy80^6z8o?l&
zq6m>g$I#1z!~f*?m<Lo|JUq|}jE#;$-8ItE@`kP*)chcaEwU>pFF)AbJ%u=cXf~ZF
zRxMoM7CWCwOVdhn^7F@Y8%NMUg=7WFM><JJ&X@*hyeld_(gWTom@1!zgOaQW)cx~w
z;DiUPmr*i2npKOFgF}yv!2Bu7lj7o1cgEB*1PQM>s`cI&*@2LNoE5N+wEz6Myu2Ji
zr>3cylaX<_KFVcfbwk9%FJJD3$IBQ7{|l0Wy>U%nD&W{*F)}wZgU$-z<R^s9CkLA#
zLxiN8=gP_qmklg1v4g$6ckkUJ1Gfa+34s1WI7lY84;8kl=?b6>;4VNQ4-AY8V9Ivz
z^b{z?B_axgn5u3XFg1jbi9vLa<Jrl9@nWks1!BTP>F$04umk`Fj-4?apbvQE7&?7C
zC*ZaV`VUxy=p~Et^5o>?LS9k~g+LY%*k<j^oHh*xNH*L95%xdsq%$22;yG_eb1n{8
zpP^U``||nx`*Uq!wB!Rk8`1vt8+-_#dGuyob|6)O!j1)?lbk$0JiO^RtKEhZX)xdf
z7#UOs&%!S?Fit?i7r`Y2;tL4*T43O%7fqRx;H<;1!-+RO+22SK@~#8#nFfh5`^^Vq
z!;DYirU6q?SJVe?@(&WA0Wme@p>B=f(cJi5lRR%sLP?nv!6>hYMhZ=Bsb}p)D@Xac
zY~|5rw53!sX4Kc#C<98>aQmRc{q=Vr6;}UP;vq9X!f5Fv1Kz%c?3TjI%pEwj95=6E
z`Vrl{X`-)>hJfe<=ov6nd<+l2cJi5=$KvqsqO`s~?cUfKcpSj4fI<ZuI`{)VGpFT^
zf>@IP7Z)<m;AL6%ICp`|;0Ga~uB4>Vxf<m~ZFh6otn~D3fA>-&&!nX6933r9lN5@H
z&~1VJP&OjA+Q{hJJgyJ1X5hAYZewGks;cTtUh&L?Yzwa|fXd6K6ysxbG&EFMIXNCc
zAMEeKLIV7UnTZL~5W}GlMic~CyIX(${84%#90hkkb!8>c`5>5i(Sr)#1-zN~_H95O
z+~%6!F_;773>r5RF#464_LHz_*TBVy>Y!y{7*Z4jMIMEK+k?xuDIq3SV!I88didzk
z#zZBk2wo2=gh4<g7LX7S5f#OzGu2@cxa@B?lakliQ(A$&{c-Dpy>7J3=dHU>y8-CP
zc|qt2x3wk{K|asZ!|s9&&%Wuwv2EX15oH*;bY;T*Z*?r63W$CAHcCn3a7&NR<c+BY
zAHlzuG*yiTF1Sa4iGkfKC&q_zYp3x&At_G3EvwA9uS;I_TMYP+HR_HI4!eIBe_jUK
zu|}o)1<eynz3vZLL%AT(qzkN?wZ_sX(xX2u4{$jdciNazX)2G<@C;<nYuA0QbyP<2
zwD!!o{>u-RJ09IlJ8!Wk=<muWRHUs{53fJ0<CEQfsTbG4OVoQYKmPsGv_gW{gQF1)
zrpc|Sl8Bi^u?%|9xjh!gWk0PK#kP(9Sk9umclP$6@pD}E7m4YBx5ThMh19%j5Iq$7
zaYKoch3a~b4`KBmMUCFCv?93Qs2Y7qx$+t&0~MJ4Ys!4m+IPm3>o%;Io_(41zAF+~
zeff_D<P?P5jiU`$OED<_a3m@{#4$;T@F5{jW~DtX#qe;s_B6vY&}hoH8e>{WhRC?X
z8;iBbWLz;rTs|oZ^tsV{g(_^Lfq{d?MzQ7m-$#pi4GkW%vI?Hn;<>r~!6gXQ_Z;X`
zoGfl@8yovNNiQrS|HB-wF7r+~eu6_eK!3Yk`CAfL)UThUFQYUR85R>zXs)c8gGHda
zq2YIkVT`p!&Ujt;?&kDzZ}Lklg1m_m)AM3uHXe(>!~Ito<ZFNQ!2Lq$s^y>m@Tt<=
z>3eUf@dO-Cn{SybgxBmy5bc@_*d25n9r*<WNLTq(l=nduVHg*O4=z46HF=aTU%r%-
z?W3K{eP)_eaC4(TK%rSxDSH*$1_S7KS0pf`E-RHwUd*7WHyMwU^DkI=fmKvg`pinh
zDg4w}+rxtl(X6mBKC}VHD$dxLeV(Qyme2e5t9^Yc5)xJ9yb^@|E!is8C;(QLf|{01
zhb(U4=+Kr)SoQF5or1?g*uz6zP7a(A0YN0A_tg#bjlN+a;H13ImS0plIgmZ9L}po&
zm1SwLuxKRRM`t{>AvcibFLdAJjE)s{x~^g<IAKkYm+z^xUxo+R&DFJ#WV*sOH7;&!
zYxeujPW?GMxI0@zDf2TkP5<R2j4K|MQIC7X&aMDFUt1d%0>Ja-wtJcNC3Lza3a(U;
z3X6(}jMS${X}o-CXl*_H&*pwSIzF!Q@}=!kz@dM2b#=|<3zRGa&A_(if(;M)thl!6
z>FL(iZy!Rds+Qi3Y>c}P=ip!=Z21c2=JS1h#p7kJr+<G^00)UbS=N=B@q0In)_h{Z
z33(#fp3R|O6U8#Fp?c`6{+a7dzC)Mb*Zv(kx@O1+{T!`w`{qr0TH2N6<?xSBoSn|Q
z8ugmmBgpOSgFHMBTwT_|aH9S!P(^8=DkViqsGe3O->5ULRBxuit1ToKbO)LhTh5T-
zwS&?yqN*Y-eFMqLUi-aU<Bxt^W=SC_c@V!KiD3g@8RQ;ZCrakH+4=qLJWi9Z1i6rD
zUq?g38)oH)5BV>m!o%-S)XfcK%HFs!2*O^wDF5OTt%7Mn9jbrIi;F}CtLZu|ZEZPO
zh*N_AfFdJcBn&xYHOj3L9++N><kW8sE-85sPFGx93;|tg_B`>D(p-QRgI=;QKaj2+
zRLqGFZGGw5VMB&^NQQU>0jcHw-kzn2iHU{9E*Pqdi_Lk;Ss6UAt|1>6x{NNy3Jd?Q
z<wEghd(M%f;}!vOdR}VKE@QT1XaHsi)`$gJ2Cm9)42g8sQqs~za(8HG9+-^=1dtnd
zAAY#Q|7uC5IG*>ygePr}+iUZDL3ACfbGc_2F2;y_F+7KK?eR-X-$#jMWdb@A1@IBf
ztBTI{@nm;u>*@q;*GGr|XR@BwrfH8y!`zMhbe*w1er>2L?U%{sG~-0o9v1TT+aC~G
z0)HtQ+iB4KxVF|9qG)T~Zb*mo`uRm84SQ>#4oR_^o*GYmt2ABrp3b$nU~2&wmngP!
zF77*+$kbHvL+Pg2;x88m+k>X>^KtwAx1866OZ0RNeW_w(7zQiixP@873B>@Qgt9<Z
z_5(Z-P~2ntf?hE%KR?|Lm{d~>i?2%-JjAzd#Tr5C?NKqv=1$&&RD%5`Y*}4BJzyjr
ztM?W<Q5k^z1{q*1;D$$PJWrG%#tt$(xyo5vv-g}5m&gtZJr3B>Wdm5icr!c*o1A7P
zr*ZdfPtP;RC-smwO6c<=Ji*53?)ED!@nUF?S5%D1%9=AU01F1h3|1y4MtvIi%4^Lk
zB`NulPEGCTo3)O(GJd|!u#4-PrG@KD%TLQc_4Sce=Lmi7=2sXch=D|2kVrn&ooU)z
zTdsB6E0a%B<KsKq`I|yVcmJi*^=rh=3dMWtOq1!MB8q*GN%=>sHqQ3qJfc0~>10i8
z+P7~?sxC#}mTJTMuDs~i<F!8LuuZXs>Oxsr%+>W}y;m`>wf4-W_ilGWEg-`4o%TaH
zA82Sws+|u|d{XtFc$`j`mTm)q4*T#5S5TvFz}tL?Aq&dR-YYTH?@p?B+%*x=oUk4m
zVvv;z|NME7&iLivl*Kr+i>Uh6e_SvjF_ZZ`V*zuMm1MNN>XdJ>GDc8!N`}iY6ql5g
z?7=DpW$$Nu7O37HLp&$+7s`2>qfuRY>^E~47*w&rumSzbx=vg9KwBHsFJ_Pv8cHGX
zcW>`3PitVi)EjDwTadb8s+a8jyO$n{j;hVosyj$)$Q>dIFCxf0RU~COc56HY`5YdJ
zMLdW88RWd$+tI|!&SHtFBn0;N+oS02{!T`|<V@h5pN(c^+=Z}NV`Cw$`tyR=*z)=d
z4)GS#Teps)q5|+p)zO~xBy!fewMTubdF%)gV3tqyY4y*JU1b=!Xy*&V!dQ{rjch7v
z>N5Q{CXMmJf6nVpe>xj%MQR_2;b882;U9u)?0)yAy}|R&&&t}{{S4B=_Ew32w6s~E
z=(`iD>F?bGOrT3GoZ->V8vPa9q^<fdBesyer3QqRi%SKFydycm(gQ4;;m;`0goufW
zLApeFk;}NT5oav4X>6>lAV86mkwHhY82pakOQfRsL`H(@p|{L(904oLrNul*qr-l3
zVUhRw^Iu@TC%<_Uyi<Yi-g&ye&I9^d;8in0UEK-(ZPnR@>lOCPOc-wx!@|rFs{0m4
zpC4%ey$0$^LEBeo$nD229D;(DM|R+&mr!WCXDsC`n!em`0#ZkZxUWwo@@$=_R~D{=
zH!D7-;)Ryh%HmI6Vc|9~nLs&N;j$h4<%_uY#o3Ra%npAho@h;;FZW;p%d@n2V|dW>
zOWy7SGFfTqz4nNrT#d>2u3|7^{EWubpQlE)RtLvnCqTZazXlj&ZCEGa^h`_XrTg-7
zbVcRH*55c#ZX2_(48F|1o%EQ=TrnJgpn~O`Z$sn?2MzUmH?{l@52#U%9R<vr`un+f
zc$DF(gk)n#O=iGODJZakPH%B>5w=`LxzD{rLsq70;dJ0)ABu{FYjFg<Hq_?OHQi%k
zl8xo07lb|Ra2p)K11gX%hb~;>bv6e7Eep$41PW_n5|VEj89!pl<(+7GIV;;g%sJ#a
zU11tupcY|%H?8hyypeJ-gria7*$8(+M#i%>CQH>+-2stu5rq(KE28ELLG1*J_!gBn
zrXq*tc<R$93*Obj3!f36f`48NK?<Zs-8l~#;h`Gi+=2Q%^Bt^FFNlSOg=Onfj07Rd
zlh<BU<lRF3uXhh=eaf2Av8n6mPc8q6#~+XY4n)+<>|TD5&!IGbmO-4S>Q=2hp~6##
z9%X#&QnUb!=>{{SK*FBc(yP=1qhq6GPYUGZJ+##=2z?aN=a!eWu(#v)c^|DScUkch
zs7(1i)xyc=_&VAB>_2h=P}9xN>$l2-{r$G;-}!v(rIJ+C(o)l|dn(p!MoT+cR5ZM^
zgdyOqot$x(l&DZ$N2eO<HhD^nM~`j|(R^mgh;Yc}rw@MZf3u9`$+M5xqYdI97w{{^
zs9E0Jl$XVp%BPyV-IGM6szLsOc0s#33S9no?mZXt$3%!3$qbC2HaCB*s<Kj1_^4IZ
z8Ny{aQ9)F5-!uCATS073(j1m283H3u<$o7lSAHegE`7*1Awk34q-VOKw#xkcIT1g9
zkp1#$OS2dV4SC{0Z@|(xhU#B8%yQV{w~#-H?`4fU=y`w8FDEI9(*5Ag!0$Kt+Aa5(
z52R!|5rlzjbj+=5p<MzDdJd2cxD_01V>Xjw_|vGZ`KyGOW=QBXCUSAQ<FYvg<f)>3
z&q`ZpzBNzU$;?jqN5VN^r>L4k;l93dRR9cr=`tKmuY<;}Qc_aw)>aUb_y;6v)OlD(
z02Dv~(z<dsQQv}_k5v=6CEO!IEz?uEHn-;$SI=`MV++V8uAy@n1hyuNW=n)pjQyD)
zG$V1Rbuxpzy(E?V^H?byTy-&7*tPX^pj_Z)VF?y!85|s&^i*GC0=WS$t3L*u%G-P;
zxCm5p@W3&%+Yo`%liB&Pv7oS}l4Sc&7L61Vma*;MzkZ3nRh}i+2_$elYY=Bv3D}tO
ztjqgT6!Ah=q7`II{RvfkUICly)Uyq53Uo&bP#~ZfL3qpWKz;%VOA(4sdxT0_`f{C@
zr?8BS!=cUaRPADTxCnNW$cq=^Dk}5Gd!0-#f>TnwB0m!D{KW+m3WG2qKK{J(=01c9
znmDn<#$sq|Q^T4oc?}XA39rp@JFR2;7WDT1PR-4ATJHYtgABu}07M>(YQaX+8~&vw
zx4pfjc!R&NVssA@`L}!#UL|G-_Bg9rny5s~<QO6#n|X(b)(b&~B*el0ef<-vPr5OL
z6r63W-ybUyr>D;!7>xXyM$ccDO*F^r;FefdSN8Sm!-PcZSDgOCEk~iOURWq6EKiz}
zi>JgO=3YtTWOgWbJv=;`fa0;eUD4ORp!fGa1Un=oFoGJ3_wHS{lYOC{glfm7;OXu8
zHTlFEqU#Qy<2K-W`WAdS&-i5cbN_4lG6n|A`}gY3o7#=<Z=7WA_Vo?-r^koWK@jm(
zr2folZhbUfPA=-(H@CF3{J2k9X@fUNqDV>VVmMoFBDlCxycU7I0}h%sE~F<#@DmUy
zaObh=9pvT}2ERs=c@l96?LXtgL*Ho+H|r^9BjlPdOiH%1vdY53qOB(?o)VH!P&7iT
zb?sUdY!w-|=H~ufxy7j?v!3p{<IBl~7yQ8y%5rIGom;n7z@D`G@=k&)4GnPsz7{0C
z%b!JgdN>h~mr*@B5|l5$LcMF5aD${X&XARv`3|}JNk^mu4i1OLxUEvv`}a*tT|3U}
zTj)Mtzn(BLjc!g2YG~xga_B?#l|C?V+l)t6HnOJX?rNx%q#S;&4fXGh@q@Mydenw$
z=RKvWC}kZ=%5g~U7#Q+GeEj_#E;SZ&%jHkhDpevBOH26Z>5u&Vr@0>-$Hci^9Hx##
z|Jl^!VLf^5cO1o+zqe@(8)}t%xqQUq`bu$)@+z&m8ZAvt&|zNX<LibV!NyjIw%IXV
z&Jwb$r^?x)<a*G+-zq8^4ei1DI4K^|-hKd}AQdCy&ajRKg%E3Q{)K_XV}H3GECf=}
z{n4w6cdYU8iRBU}KE`V-tW}40&@rt{HNOKW)X%lr6g$~^HHVi7ZZEjoUg^IG3StIY
zyMICQ@gPl{1Z2_EV-hHbez=;_rzTGb6}*GPaWUK6EYa;-uA|e_hLcs5DtTXv`!cmP
zO-k}*b26)KmCtXdnRz+d*>OG~V-XZ&VNACf=OJKZly*I$$Vq#^{W4GUC_#eu_+XQk
ziD_zmzpP070a@38Lrhp$_gBf(D7I<vh0(L+t4&Y&VQ>HVGr5eS+ZmG#_x=0#BC0X@
zf!Mjm@}~E?@v$FDq!KN6V`OCRb+<EtYKxa=2pmYbA0$q;+W-^J&UDSlAtS#9zgbbC
zYG;=b9_~SEjjh~GJ%FDuk`PwBv+(zC*5P4Er9F!pM9f*EqK4#Z-oiv87(Nsg-a6Yg
zJp%3sdc-SNCqpUg#}ut%V?$A%XlQ(J`%s-WU7eOjjpS%nPETK`8ZO2&OqbPF`5@7~
z3J^9Fp`>I4x!Z!Qf6Omzm4Z1<KDrfiH1d{%^226(PRsM;+`8rcSzg`{DVx>VQl4nw
zTTJ|QtjhzZ^zU?a?uv<-EH1u;x76A77OereC%|J<p}Ii&`s{98cLPbuuN7A}H#F!0
z`ulg_RDRD|<@Xl!k?Y}Qzd5i6xvm+We1+4f_VxmB`;LtfK>lZr82quMWCE)BuFs}`
zU2DRCkD8iS&IbvQCN(P(56hNDhvj$7WqN6m#{$l-u3gZD-e(38wByxf3uwVScYh!K
zO2q+e!t>;wvXWA<H|XC>BL|^VD7H!NYI?&1xDF+M6d{qV>#;+>wbc@Q;=8{e`ZWdz
zomfI8Jh|0kOK0=1I+W8!x1N+OD?{0TWu+3)waUXnYTbWELh<W$3N$}`H0zmw;d>&<
z@LRV+@7!)h17Ji%T-?!VzaOliQ&o}T>6AY@+^P)PgY%|w*LQ9v@6Q^kZcRJqw}WsC
zIw6_32T~#;!I2>IcUtV&T$kRM+UQ?+?HPetn-f}W>}~l4W~R7D<g037gF5AbJAZfF
zPJA{R0y;|;4U)25%ZO%ctFZcdJY#(9?Od=jg0mS4M>L;8jvFKkC_b^HHpt<8Xqt4C
zzl$4YPmG>K*Vdt}sn#TxzP=U`7_13ls{QRuKYl#p<*+q&bexQ4yQ;(h2?@PwfR+h*
zghv#w{1WXLCr?VHrF%w39+82gd|2&S-L}6$F;J3_@FpPvgIm@y_lMvzSmjhzUBU%;
z6Kl%aBC=3Dj0tewcAMMX-9EH+sP{Uo6BNnFcJ!2KsFN6q$-u@*={B=_mii0YYU^vn
z9~We)*Vt7L%bq<cbx4JFa3HG1(vtToz;E#wprvW_M`Nbd+uGLO*(~_{&^DJP=weR=
zH^3R28vUU!%{3}INh2eY0_S(%rNYAF#KL)TnqK{kdZVXDYGK*-XKG`9W`+P^U<m3-
zz>DE!`+c;7D=uCMklp~5Ho6|fdd;OiB@Vdq3mpN&5wOST=wjRt9`u<sv(<NM*G+(L
zD9d%ni}~)|$mmTXqQbEs&&qSw9V2pJ13B4!uDcoQ$A#fYpIGl#0QOf_ZQ35*TR0K>
zZ!t#dFdbt-v3+{9{K50&mBfd><R;Ya>m3=-`Jh38jicK6<g;Kc6x|CYB?Ylu!`9<V
zK-0!YynvL6&0Du-2Rg4_4esppo11$zU?Ft=yUZ|X?einzpB>ufre`%Cl?l-*8PKDC
zAg`XA@Ao<~?3wo7JlMy#41Wn&lUgy4x;h!F)^R<hmjVXT{mJ?oX_BgnbL{F(QI%m3
zHww5pl-%LR#bR9z$cRB`(VAH{2=J-~E2t8%QnQDk<950@$Af4)F5@_znu=2B*SoLp
zAGL)J!w?8_3xfj2f7O}8-I*Cy98A*D=kl7T7t@JdKd|fF4`!1^ql=0Xfp9`?C^f$j
z69*B~&`_(9kz1D$w{42BlarW?3;<M47#O35Ki40=0IufOv5{ixRg@=|8*fif!B>;L
zzrmV!MU$?#&A_>uuc)ltGYn-g0@s{Lx$T}uxUUN;B@I=b)3Jk{>c|`YwjtTX$M5;f
zZN3%g*LN1P$95hci!m|bgwu_l)O`v&l8+dHGkma?{=l<prTHD^$w3<`;@9}~S6u)R
zJw4mrZb@91l#)_&cQ*)0r++dJeAhSj@_Jw_wH7Z~yGwAfzhr9gRYO~QalV+JX+_&|
z19G?C0BS}?c8{3xxT;!STIQ>YQqA_?xJvVAQb@3$RIA>fiC{Dg2_c4BKvOF><8_dS
zhXo21-?5p3!fpiPBA^+e6k6lO>A@l0HEGfp(VrZwdlGd3%4}DQ$$NLm&vf`(S>+Rh
z?Gt_)KL##))}P-${UMp%Ca|yzJRIvwy8sLG@=8C9(nx$u(B^%57|WHmcRNOAX{3<0
z={p-Lc%xTS#QD|Zc8>RCyuC@8ndg0dIf1k6YZAHWO_sha$)^V$`H=_lgP^F;F3=qh
zzO|MvcPAl&c+^5_ZU4`Q<W{^hfR_<=o*_r4bKoBNAA4ZnYx>6xuD^_Uf5k<Sg6=^<
z8M0jswc$fM154Or&QA0#EruBA-`IRBDaom;+XrBIZoa%LwwV6mVM&&mwKBou&;Pli
zC*zpI(wX+e!q2g>!=0$y`Q$6o^Wz6MLP%0pBdLr<pdB14uTeK)1x?Gqtyr$bcmU0^
zGe(G!rJm`yh!+nnMtq>&W}xfs@3YIqt0cUl>0gl%$-h!Id~0Uop&3a4#xr)%8Ka|D
z6!DVj$|tYZs+CUXyn~kE1+l5Ao-F67waz3j3J5d)hen`OQW<u@KY#kw<&PKuMnay1
zFTh2`#PoZmZ`~7H3_XI|SP2JEG}Rz^fYJaqr9uKtv8&2cQLlrp5!Vly?XEKkm=8%%
zQ&eQcYc6M~7VibVz;=4`C0fU3RurA?nV7hEU2I=Vh3eOolnyW$K(%N!?NwA52Hr~G
z%;I_QHA`&uo71Gd$#1PFppjlylj9BIYr~X0Ts!BxE7HnCFO>N)>ApO}XQ8JVz`tyn
z*#1nqqav-XRd^(-?LVG@W!B}q=I?x451^HnhBJ^GZXh7wmn4wwvxLd2sG{Ozhntn-
z;fF?=%)svOq^rpbk8qB(tV~}mlt)!R7z2~%PUnjmOx9ISmjq%4k*(WePxR_B9tZro
zF~{p7Lo<+|7a{83>y7PDkCCyl<#d}HZyb_~(J6!p4?$~c=j<H)&x;Y;H%_(MDHps8
z0H~|&fYy6_WTb@uZ^OqoDsUT7(_PuR*B1$DY?rMWVFV~U!1R-^0h@Uafr(WW6)-}g
z0;UD@Bnm(x&&@oX+t9mW<2(+=8GF6Pf0;51p7+zmXq{)_n&3UkdYO%R<z~a=%P*`z
z0Ag=b2%0P#quSPwhln^y++UoZw}(LnfL?-J95~}FS~b0XENzgfQBTbuxeMHkE(uw_
z5cU;OQrZQg0o+a?1bOwUD_A4oka8bJX<f5$(HIp>D47Pt8Z<KCxT#F!S|!`Kf;U3I
z0D*_BH!!K2-IJ4-!8O^nrugL#zNmn9Bg0$l<ckWAM;l%7eA>||xdmAW^`9n?A7<Jw
zTiqh73JQ|{6kQ%G<ZUk7<<4sK=l4x2R>5t6&<37rX)Py<l9sS#M>0eDno-Zx*W}rT
zQkuUZA3n50$y38BuAwK>Yo$5rm{U$%9~+2{K^k`(1a6h{u~f~hbPGB8n{_zEUK3S=
z8-Evp!EOe!=KR#2xcqN=|IY4SDR|CMzLf2YdU*j<{SvDf%DhY>e2j$3BO7==;YqGx
z#a<mMpa{IYR@(`036k>FZx|UGdTfk!-(bGYsx<~_R(D99Ns+0V%+z14Y+A=yh=IWZ
zv40EDW|s?JR!H|_qA(oMx2zze_CBrnM0MZepC;&ue9s%I`yCzHXg+>^7d|K<(2XSu
z<?DW6`y6|86A2D>`1v#2!jgAyl{->`JU`2f{Fduc>j!sqz1dl!oXiy}YP}U`8`SAo
z|8#$(-f3y}isNOw%T)|iNO?+1RmtuR?$5T&ZzSdFdi?GjCzO;978T>UYT^15TF>CU
z58Q+<<-0CBua(2MUnZAQj^vCHK-%yT#TS$Su9{_GAs~cCM*yn%SF-{Gn<zQOzW?HA
z7<NvoKDlIjt9WfwlEcF%0<IE4uvBiQD-37q;xaz9vr9y2n5yM)KWHsbHnYfCTR+v1
zlhboK#6@guwx-M3oc7mkVOcRS`Q2A(k9M#TG+FwS`O(pNXDm5%kQc}1KciTlLwg?l
z;cf5AkrG2LX=|^IO>umu%H|$aZeYjWsk(0I%lqlhYj*-}yzi*Z&VBtmNJE1zA>who
zyEs{WJU15&^d(wDu7(=IZq%uO9G+}y8ZK&|oiO*rlcFOiC~X-n<o~4$0ip5=xWE?U
zp*Dg7e|#)tvgQaInW(E(d0xnfbSBkvL!SWP#asMbnP*?p(-!+yTnE&D?>>fov4CBN
zh)BIBv9F_}Hsi)Gljcf$6f?702qNX;{0q59p|>j`^2zJe_G9GWsxoeWAH&XRsmp%F
z!p69BM+XbZjpV%7)OeTXnM3>!5=cW3>EOM4xU>@Y*N5dLA?2w5+Yw^3rtFj?SPQVj
ztt&=mW+7o=_`-xME3N?kNy<zJvrHAI@8+nHU%i6)JbLyu+6f9!F0tNck>O!Pa)js!
ziNodjDVZzmupRzwkKjb}6D}+)U+x^8TQw5^kvpuzla)I*eP1E!w7T;@H9JsIqWr%%
zI~r`kPkwZ<q$CDV`Bza}X!sm<4`k{ix<ffvp;v~&<m*>=6qGz#iBkjt@Z)4_w!bCF
zxwb|`rzRsMPa8fcFmI!y^27N;7Dh{FEB(<qIq5my&_Iw5Iy(3L)5W=0+;$6)cDu6c
zp={{&{Q2T|`6fIf<<>%@BR>jC9(Wx6?W(jdhm8d~wu3qG8-wrJfgVOWyY`ST&eoNH
zy0nGrj8|~XL2wCxF3-X{f4EFUHDUV$zTo6U0xL=U%vHmuGgG2nmrGNEj&}l>TmY?6
zF(0N-QvSnj)L9VETVFO{@0_%MWdFS{tvZv7%#l7MSQA*I^@Zz7YDWzJyQ64r)zQHv
zym8|e`<MJrpTu-$Xb_j<l2f?WIR#)YWkhr>a;kM-M+OIfjUNwL?qLRO{ITwnY3Tcq
zFMpF0&0}J(V)+Q2tBz$y=K$(dY<y$jN+@OY&?P>8mP;x@HBpxU(S(h#$g+x@22CrX
zzq*T?>@O=vNNSU|aZQ-8OYl{GULJ@y*M5m+d5%U!)p0)9Rjup;Uqc&yWav0{Q&Ue*
zXdDbO@{JZhvepa!kOolWY6th<Bk69IJFyv#r~5jcDzf*Fve;#HEm7v2-@g|azeBt}
zVw>gdeWLdr^Ym{Ji?cL+a}^cC?}s(<Vi^&-5u$XR5V&~?K?0eXd#%!eTeIWwEdJ<Z
zP>{qt&%chF^6_JFs>BKm+KE;3K_i8MrB`51>vqEGYE`q?@!v%!q`*-6Q}GTRa1UB#
zPIapqne?hJeH0k~*`xXg92As31qG_+=I38UKuB3w#*<u^0-JOP5w2<%3>cgw48RBs
z#cuXAGroI|FX4Z;6$l}zv+;oy<tp>-3V=2vVJe!(SB+ZCRtmJ|{WLT>(^opWSqFxc
zQ@`2H(8!&h+L4O*;)8e1C6vxO{F1v1I6efj?b9c8?#Vqg((UieOSug(NV43UGblYs
z|HV1+h5G`OVY%UMMux>|hN_S1&v#=8zU{uc>XemL3lX$WJRflOwRf@baP_18^F~VH
zjRYP@N%s_amlPLQcnL({;-Q;dO4|q<-eO~K-@$r|lbQMG3T8y3?p%ZTdO^9AKOgz!
zDZ7J%QwYew%5Kf>?nET>9mraD(W2SCpb+%1GAvb>FnaIrpO%^FZ1>mm&yqYL2_N5%
z`tgVpd{MQoF5!r9%Fp)uNmJ)bKtxEnQg%jSb1iWDeN{3nn@da5Lf%$e`-#BJS9)Jy
zNdLUi-kuE1u&dSs{|Yo%Y@b$HLe=xZ<(#Z3<W9Po8N?Bs@mWvNAq8bT9GrhAYL1>M
zDq<rblbC5-g-I-MP(Z-w+v6ejYyba1Z>g|@g#88>Wp298Jb_t)oomCSKybY!aNd~I
z2<dqH!pP`#w8}H6_`?0+uJiYI0V>;<3eww-!NmhB7CTjgBiz)-$MQh;Rol#lR90$x
zo-H%PmT1R-E?d=J5i31)-ajU008W$j#E%;9i}w6_KFhHONyp%s{;%+I^yaTeC*<3R
zpx6`a<TB9oq9C20O(i^Ub4xvaS$Z&8O`s9y{XgNfQV=M|cHaZMMmql;=dJVnXWP#Z
zx@S0ABmnERuy9aH$`FJG7rbimx>sAWySKaYjZP91LmaKax;_E2LBB;rz{S%xUCG|O
z*ZGO5b)73HuvbQQ4|qRc-xTOqSU`GcIW9R=E-oGkz)yE~1W2-^bIEY7LVXx`P_Xo*
zK!Jr4{9~q<e&|4$;XxxS+3t0aH#O#Vb&rFa`)!<pVz~UX!!xL}?%lfx`cRvj&ih0}
zq;tsW_8yGD>xg8of6-r6)s1}oeB15Fjw~V3d%jfwaXI*7PN1T$?&;}aaq#DZ>))?e
z5Xcunp?c`@4ldqnG~0abT1$65lLv9}<M>0JP<`+1Czcxb=wM)^0a*3neU-X`LdUVP
zxVYZV(h)cJCN0feM0mwS73wzhEl{$C$nDB{^i?LmYySwl0BlhSpYIRn2^@lx2}q-y
z4m9LT#}8fh%+S8RYkpYSZLOHkDb*5GI@;U8j}DX9fV_d&&$+n{)BaX~kQAn+o&~P_
z-Zj?AfBV$NV8PJaJKAw=NxL$<TPmHe^V=`%{n8iD@tDKX_L?5V#&*QI?f6Nga-ZNn
zlV%n{y$TJtzk)`t<_aiVH)e@yjAUK(Y3IjEy^)5twy5K>rv#a>w?L)y*jrmTZDb_a
z3)cDbGsenF@qmCou;*BYC;w+eQ$x+#Xh|RG9a5H->GbhtyZC&c<tmEqV#nF}d7G-I
zX|YE!yQK>3B~&vb9g%tnyJ=sB)3V>8!ihPa{|v?}uZkn6|33o20XoP~h?066kVuPN
zP{`rBo#M7OL=4VXbRYP9$0wBha34YQx%#Uveth7+A&T(^CRTarnVE_jCygB)6|s9~
z=Km+c*fk~c@e)b~`d!HFK_h@b);cZk-<$1Q*Q>>p^$#dPgh8$C{8VSG5nNeIXTd;%
z(t7O>D(u%*ymEvjH%V;pRPMQ8oCO{O=+x-u)NA0760$BYm}x=EkV_d0n7;S%uDE2T
zz`Qby!i4qpUHdir9SGNE9@A;gYjK;Mi!Uy9@ZUk#IeTz;xebk@(sg1trEDZiJo_;U
zWHapIo%dDCES!v^@Nfv!)J)aXR`yv=X1_B&dK6C~@U^Da*tT2=yObO_L~P_sRTV2o
zn3d5tV=KYazl$Zj)~haBDf=_a8idV~>gsdb^S`6n^mlhlT(n61>sE*KUSHI^Xb}!P
z_AS817leFR#s4lfo7r8V)6z1&dKHT$H;I;(4eiOxm$|jIAet^d*^9Td-UMZpv>~VK
z->e|gO;j)`fRPY<lXIO{k&xS!keVnWJ3bO~TOh8%@2Ug~p>LE-7sS5%VP?YEnZH$3
z({Jgly>@U=uW3&5-G6eLpZq#3*0pz>-(j35G$p0~X-H18cCL2C)<H$Z^!p%rumL0r
zC7~j4Ea-1p@9}AAdPrz#xwePr*S3s~YXBpP`UKWd0Q^M*Ozf5}1H+s_HX#h@7zCj~
z)!+Sc#k(5s5&BnMgY)HKxzcw5U6Iy5)avlsgFQZodT*a=ss1K+2V~N{($Qt84Nx*0
z8ZJZGh3I|{a3v$dA2@}w+j`<Alw}X?8DJzBCt?Ff8Xbk?1+#&YvNCliC%s`yIuY#c
ztCvRdh_J9rO}Ls)(p`Fb;c&V=p8Z%ZFIX$UFgH<m*3*+zuUS=++kQruEp!X20@|ne
zGO}IoKGY_J7gdi=ATyKIZpxdiFm&3{aZjuCohEIL^WbU0^O39ctAc#I_cQV@N}M(t
zU!;cv^oEJAG+s66Idp$#-;f)gj^JRJl9^tqAwoy^FZqb=XwfJKM<x+b^!$AJ)mxkw
ztsk@ixcv6*JFu}xLr2G5py_}%L9nj`mlbm8u~=DK7n;6U0P=7^!{BoziqF3)0C=My
zhuh#cT->j*4)A|j?&cV!ad<B(B`zJ?{CB5T!g!f(dw8#a`?;ON=K`zA2}b!2EzPo0
z{_IEg3=|J%ezp`*qg*2?I~~X*hw5Rx{NkvMQu-gj=4q(*WfAXroKHlQjRI2q8$C%X
zCMF~1CL_^Nb+~vZ7paD=SGf2DlH7d3(2M9Ae2s|Lkda+pA^{l1X@!KwpV0gF#F#J8
zAuz(|3eGkOQ8E+r&w9@jd?Y0`A9f)jSH-;4{)^wgN+CT7hGbQGJgWV+bk^|Ntg%s>
zfk8CxD@^+uA3p(sZ*xb-A+V_+id<MCfv$0VbSEe>67boB;Ed|&|Ih+3$n82hCq>0P
z%g=C`U*xtQX3dwIWF6pEEjNK903x-n!=lP=*yzi&&ID{j0zYZ51wK&2g5GtlQVa03
ztgqjP1gi&7HeK?8P_Ivnpbk8DaevDvqB^a&qLiSau{9s+2av|eK{<%}X(jDIo$`OO
zY(3xgm$&DKMMP>~1HN(N<?+#-S()Viotsyd0HXfC$qNx5y7u1QG-ySjn{ir|piW+x
zVW);Yv{9GyX6Jah{rUzAtR$O$(enNyMCih2cU66a#xl3+yK`Bd$>B>%RV5`Rx*yp=
zMg?!a*2!D5_8WvY!EwojVZ!3}AdG4IKyG`uWd`b@?(TYSNgV8l3^XF-j}*r{%szlJ
z1OyZC$igXB6!7X_afNP4Pp=MSTZsZ`k&*6>m+yxT^haiqv<Zn%!xuUtLjXOmVI@Ls
z*m-y?m$QoU*lsMB_`9#=xLh4T+{@i9FTUMm(XnD=G=A~&rTfKsKM<vK3|^jUHOBHQ
zf}YpI!~cL^c5`(w7+{M#LSEd0UhWZ}0x$zW(pFMp;O3TBRaI2u5gHeF0HB48Ecma0
z^)~v(NF&0`mJg`fce3K!$(x+O6M?>j(2O7$vm%3-l7^0c5)bDQzxVkNv;jaDAwF;L
zER~e5!(}TjPRi5q9_j2HpT3AmnJWnn_K=qT{su1>g^GhCRZ=RHLJ<^MO2h>K<4H?t
zL%7JoQdw$YSfSTh4X}m4Sjor)AWz)fSdp0cHODClaOccX%2JSQRXuF_LTrw=zp3+Q
zmdFDD3ZaV{4i}pXG%OENmZD#MijMyuVkI4~*jl45l>O_Bj6ZjlUqIK1P|>_9jaK<R
zQTe*6>Z~V;02<J*d<9%Q-<o_MBkWw{Q?BH12q~|11YmfSKKIzmyMvlT@mprnP1mrF
zZ1=?%TXS8*yz3G^Ht@Bs%GVC>!s64Hq&1f`uI|D+?=TOS15pK;Wr#<9QqPgD3thWi
zk4xR`>xia>104yWP!k^F>y3u`_-55LsFxr@22Yt_>$2~m#8EaUn40R{+7XrVufvl-
zJ4N6Z`1~DTwvNfMHmRmpHzpBW{8mu)VcVc;_H9Hd*Olq@)ZIfUR~1yLdf7H~W&HR;
zc2ENvQOxjs3rtRqxabzv;ko#SYr3z&Q_b~rP@J7?#yEi=qV*?nxAR%oY-I0R=e)5F
z;!F7-cUSyIIh-R14Z|)aKB2!Q?=*=ktcs46G}Ld;#Ow~~Tb#18SZHVmQ0O5L2@sx_
zR}B1j)KCxT4N$&hWerVDfl7Jw?6|9}`~XZyX`Hc-T?YX>K!HaRrl2h?k=VlS^6ysg
zo27+J2!-rSBc`+J@YBwWN$9RJ&PL>&YFP1BVcPm7u{1T640`43HxdNx3_d`Gim3ko
z*gpyHVY$2GWo_=m`-Ei)h_lN@3B(UD9>zD0hnJFq)cGxz#<<>14m?5+VwB|l84CeG
zD_XJcFy1|Z(I5YLBP|KUzKZ1J%95~6aXYSp6(c~qs^kU&Dswhwe#U$EP!V#T&i-DT
zFH1?>KRxDKf3!-p#&WeoiI3vL#f$v-ccWVR51?0VMf<$mUk^oOqmdw*Rk+d@m;Tl*
zNko@3c5m+;gs9U=Dl6B)?-`#0bqD#Y6`m(a04`TLm}*2^&|vyW%HF-Z3zj)uGc!4h
z^^H%TCcEH#LS+U+K2EC@GpnkO^TxymWC6DKuL#IupK)YDk7>Z*({BsGCaA|oV6zM&
z*+6`#MVEedNL5#;T28Klo*E5NR)%>yzy4`lF)<~e$|)d$g?Xfe$*z~m5!4q(_Gk!v
z85=to*aa--Q{-Z`6Y=wMKj^3Z58vpvpkI<99^Ic=8XMDLkxF`4h=M5RpM&|2{xUC|
zf~b%Txs)od+{#JTBS1iQiHEmi$Rem85L@lO1tM~dj;og-D(D1&xJRgX%K<nnH|HgC
z<R5{7R}=m$SE|s4GUfjzd^*d<!25PzmHmxC8h}NYnT%b++I4N9j#hnlxvM86v;dT*
zq<Tpob$9!cYxpPxZBe6&ph_P45_p{V-TzmgKEM_DAG-k!-9kY-wTNcG4a~qG5NIgp
z+JW#LQ2NTg=bD<q!}KB|mjDCdoH;DUj&iN@aW%$2M;UFgUZ{#Dm$6Y^&RB%bgLiN}
zkOG*$msT~tmUw*rgY9?n@q7=Zjq5Y-elnJs9jEa}CmJF_bTt_L6|(*JTIjE|5Hfn<
z;DK~XPA)(o4b<RLbdr!~54aTx;S6Aq$P?`;Nc*po#J_XPy=1cfYA~aMbiwSb^X#%`
zi#9vJ_!Lq8)i8<PMazF^Yh#;g_i&Ng_w#2MWcK)kk{K|U^V#pTrlz6$8$p()w%Q*A
zr0!I>9MTLBo!%y<8kn?Ux$m-_vYMXcF*vxfyQ>NK=)JI)JFSAkSD%d;R5=1b>a@B4
zF3?0>w1MWfekcufza-0*Et>ZgsG&3i_wxkAw*KOlmhsft>Z^EojIq_PADwKTv2;oP
z^XmZCN2EK;Rw=*~rn~pDESP#KD)@m_R_F(W!qfBM=y<H$UYbxuOWG$-K8N?u;d=#%
z_ac?gQD2+uHU1}BR!Jy<B^i^>l2cZI&BXIY?rrLa`*(qNAF$PQ4{U(;a^DA0Q2ZNy
zmJO7_h>#*$xSd=%D_g#*XsW#Q^xQ~lpwMj0`#|g2uy=7Sr3DTDg<m`wo-i!|$H>A$
z4!+U(vEzr(9xD}<wJ4*8!l%!9sXe%}U2Lz3f%OWa?%;(ktUwG-+tQ*Ub;t=Yr+`ZU
zZa62(JQ1hQc!Y359@^->iFh&7osfS0x|@VVUh=ic$#k-t6>RDTJ6$d2=0ZPyUKp3f
z#kt%IqZ1bMU-~0>S-f-e+ruRb5qN({QkNO%-vbl+0DQ$p;E3P_QJULX?(sg|ehQja
z_zvXy!lVjDT3WR4g0K6}i*E=Mo^ln~DJjhX_UPq>hcxtTLPkqmM1<iQ%mc$%E1e8^
zK-<J6I3sr$wK*x2+sS57t^R}Ot%^$p`RI34WaNJk&2N2G>YB^;`vA&*^!i<mUST-r
zbH*c0U+6vDjSQY{)$ZRY;@Xc44V8cSaxjkD99(4!Yir|SIeeM^zvB<nqQB!e!5MUZ
zvbB9Dz-B%v?ztc=m~Mw#dT3~VpFUmZ;CM`cM@Nl=_l3BPLOc+!;0?+gZ-T=Un5zTv
zWiar-PQZA8+kXL`+-EboEF5MSt-UogkAW$3ympzWmH1NH-l;Y1dQUwzH3@Vl$2@;m
zn6ycgiwVa<YSh@2Z)}mNGztG>?-ldC<l_BZeCQ-|(w^itG=!<ZZUftKuL^jAlmB#2
zPbbCA^vt3>XKYl_S17*Z`UVCIyl#3D2i&g#OEBDP&}6O_G{EG8I4W#BS6A{Oc)Iq|
z#;9S}-54iOd|@vl+EdC;3_fE{7ygjA!9l&ocf`XPI4}hZuJsUQB+P6d9Ev{H9vpOh
z_s)TfO8~m(XtwlP*B8Te9)!oNEVX;fC9kYCNXqxdxVO>`HCc$f8}Y7P%-p7VEw8vG
zNt}QAu<ozFdHuQ?dYt@viWIA3&{}}3O6Em>V?%=g^BNQK@Zlkv&%5@yC{B=?I4u0Q
z;qESkJd^&(&7(ar@<UhW{mX;~L899p>cD8(J0dpl6Xxc`W@D|b3%`G%TUoM+<Q^X0
zts31WCbcRz+^)a2a-`yHTPlWaTZLg0L}#t&J@AzE8{(66`J&90Wj<n4#!;7S90^mY
zARz%y70~oj&ws6Woqfu<ZoS!SIsW+ldpXKSMXg<ySO~~TZh`))2>~7tO;}aI+so^z
z+7YbfX)tm9Xom?ld}x%w<v9{<rYwp^%e6zbyoyi(YX+Ku3{yB`&;?hN)?$az9rgGb
zcYS+yH319pFVml?s~>2+zmM|}7r__wMtt6F1Qd1f&M#w{gzWId6tXhs2dYQ)I$a5=
z_-b7HKCWxPtG}?`>WqCVy}mMf>EY%_+Gv!Smh5t&uJIJBGO-@F8v-Xxh>g+9t(ug5
zEdlq;hc8_4Hc^S@j5XbbIUYS)8_4WJ*a1cbV--^2#In=$CO=w_DD2xd)*j(&E=pf2
zd<xCX{QBPEVJ{$|EY<cv4*`SA&7B<oOLsl%Y<*MYwxFlg;m%xwXIp*<*|}eGqH;0Q
zr{~|jZDK8xA33f3k;RkSJYVcwtncr}>fW8GwA{NrPc-)Eh#qhF&X2&O4{?<MHn{3#
zSH#@q9uMswwo?1UZd_%mwn)wrl=f3Ar<Uibx<+sfQ7wny(K(w&$eE{AP`QplM2?iU
zQkVK|3)64q1FjteXD0|^j4Og&>Tj-x0>)nk)pArYg478<my!ZIR7VG|WlvVwel3Ux
zzb+U`b9o%~HJm?}kSIzUtaVpmqo?2Aw1CFm!=c9?{a5yC)fr=6tM<<r(?_dwjf0+%
zi;rH6EK^!@Drw4;gf;5Q*ElUVzFE6a=wBz=={tJS+;V=w7)!J>KIx9}R&M%72aA=7
z0n$)9{^&V>G>n>mQx`isV^kbxk`;ZYUSP>AU@Z;}_pd-yrK;_>U@o%0Tm0!PTUxIE
zhqs3*XrR=a8!1G;v=4Sj;ru_fk8W2xE>#?uuq#Y{h5U>zH#QWgb>+%#SA0O0o07u!
z=uwb;qmfGbS31Cj6XRfTM8aQh`B7}o{Qhm{?{b=xWoF$=X=O_24Y5rjXPiAvV11^P
z2$PrRNIF%Et4fMw-Lb}&j;(ZAZVz%k&b*uF5HFR+9wS4xv1VPiApTNX?cMvp5w+OQ
zFa=RYsagN~tkDaX%Zy}r(@nmfCsE>JnnS%dx|5l2->?WduEJQ0$^8xQ^X)dpd(U-r
zK+}nlyHE^OA#9((i+%sDa$oJ*r6_toZQ`Fj2Ew>}E<b_sf58##4E3Lvm%=3;OkI<2
zo8~^AKK^bTF6edK6x-*9FT?Q2>66uA(l83ul38nt&UXzE<RoC7*N>=u=x1}$Mu9P>
z>Ng1<IjmwLbZ2Kj95+x96P|2uipLrSd=>$1-I>H*o$oGcN3Z)6nkk<!?_&E>wa4d#
zLbVBnCrm_xSji7%`x9ehMq^hUYJt}`?zwk*N&;)h^m9u~Zcw$ZGW!;6?d+s}<L_H$
zR(|hWu!-(V_3)`ej)zw9Mf2eJ#bY_Xx-hOcy-svVi7Dq8$WZeSQ*$BDqifzS8=noU
zf9ljd-$=E26<uByfP3;dXJwk8b>oAalH%`2hU<Zc@ds`3SG39+#!OqLmecaDFSv_Y
z?K~LhcT+yj0tJu!WT1Rq`NW{n=P=eiu~4o>A&vBnACZ*4gywd6qL$6M_V>&G?U+J`
z%OoD;1acjViQl)cU-vxOhpbh?Ki3QNVdO?ZnYR7jsvHvY*cCE2$ARU^$Y;MlLo+*t
z(-na6Ndi+;N$l(1C)WL1@zsukCr?6&ui%YgefL$~0u%Dgm?%1+-Q>KSh6W66Et7hK
zvpb*t{YSE1hB&xsgO?Yef}9wHI&Y?C;x7+_Ng48(?V89lADazXbnenA?~B@t@g2uX
zP~N*}q5Bg$srY=<ZFn6?B%<}&I$MTFWZec`9HOeRJqMG=e4{WQi@}!mk;=?lwLzQy
z2N@0;wg1Cy`|7pLy{*}um)T8<igqCTh5il=jWmQ(C_Ly0WD@^kh`PKi_(3WT45#9z
z!hd3?F5M~_x$lE?;^NuPPAeP7-J^no7tYT}@3W}TF}{t9Cs=m;ML35Klry1-WvPB!
zCSVePAA4O)+Jn6$n$^;fJtm%)GP#Z(8xIbEd`aaBb!$C_`&(srqo_z(z+Jt%a^p*t
zB|UZ!4A5lJt_h;Lzp!Wt0jMat;6uP6jw&yi>g+@%j%W!Fj{@C0xQs!Mt|SOzMo_^?
zNy?5D&R<6chP{i*4<bH-R`XYR-MM{)j5=E<Nb!Mv(jN!K3BXp1Ad^Ua$`<yi1cHKE
zkDVHjr{-(ib92P$@)xDwmITV3*ygY%GFfKc=G`L{@sKu2q*4&b@A<#8PdYGGxJSr(
zrT-~4yUpeNz$kN*-NJ(2dRH!p!dMsfI~H)+x=-_pyL4c_ElpP4ibbQ0Q9!^N0HCvD
zrbm33IjV(1w6wPoDQTUP<FV<wGb%tgfl8b9;<w#jmxYQIwp<XQ9caBNET@Es9$a%H
zBBD4TrZguezkK-(T0kf$VS@d_H`$#`Yp^pwu3Spi7(We-ApB2lAuV^tas!iQpm!uZ
z7F42y47v}ObQEoK964bSINr_x^Do^aTh%u+!{<)^N|*F;>m*%XM@i|Nl-ylI-Wrtq
zF}WKLS2aK)&8$-Qzgqk9Xe$4=-Hk+M2?-fXWFAB2U1Xj@X_HyT%$c^CO(bL{V<ht|
zGL#Bsp2sL;p6B`8zQ1$U`+L{>p7pM?*4clwWIucF$FrZ${kiY!zV7QHL1pAG5dpP6
z1CpGcg@gWYrxSI>0iUg&?d)unPSlC~1zH0_K|uk}cWUYeFx~M;zMhX!t^{TDSlZd0
zN##uVVtK<{>dMHLu8hn=t&3AuW)Vzwlr?~VGw7_MRXUC^n0<g4SB68*1-H-dDl=n#
z*4s<ZY?f^S0IIYmm3*;YP_QhNzllJ+w<5ndy>zGa-#by$pFnKl|Gg7+zwf_xq80;S
zj!$Te=HWk`sB?aqSUm5JeGOPH7Zg;4$gd{}{f>wTw;nphLNGAsFOEUWLs8LSb%J*5
z*c~_4*hJuPp>OkOFAcC+;8{WUwemqQ;0Qo00`~0R&Pp3IFk1hIJI}?(hjUtg>{M0(
zo>*Yqc67vGLTvtXv*Swz3K)*Qz9ul#gVh9VzXt1(S9GLboH;kR&Z%fF%tjtU<OuY>
z3@DOH=@bkzT=RIv*aW%Xx0j2B`fBQHw~F*dh9=L30sMqQ9x!Tb82rg|cmKA!Dh`Gt
zKu^!t5fyIh9)F^yr3Fb_Ky0kT?WKv5&(OFaQ|p4cYXR_BfUFc0o0~;J+S!Rg!UMf+
z=^qsZW7%QA99f=3L(>epS<!KEp3~p!69qa33zLsfKVd$vbYkfqO8Pyz^e&UBMg1=M
zYHE|Hzp<?1?qG?YN2k`c2w{izl6rK}qBrH(TPBI41)H_k@eeCqM&$n<u6DGtbArn7
za*Eo^+jyrH;X9@ADav1Ux*l<jr*!O+JiCz}=e&y_Ci~o`Lel>aOrE4kdTVG#+sk*d
zK4|dNwKp#NI_~x2#eUc>b*Xh_J$0ZtDc9m_Mtq=ZbAewosQZA%*4w-8ptZ9HvKk7}
zbb^-ML4?#WHy+RV$Z>BKg}4f>7Jz3#u||dKXr?U&^wH(z<@4XaZ%-Ck1C<+?Hv#=`
z5Jv%bgx#&J{NiG;LK!JB3dqm5j@fbaajPISq|CYGh4Jm)8=;7OI$K-0>s_A~nHn;!
z79YL#vEb5C5uHEFpGHAJbHhWF>=T<#!9E;)s!BmNi8?X_<U$NYj$1C3?)pbe&nFGJ
zx{mu_1n#=UW)rTje2mmLHG4NkO@U|vX57q-4FnQ*&#pgqc^AIC*T@3ha6P@N2#~4*
z>2-v(j!xXCPsd;r4(cHw7i0iKx1fImx<RIGm#y+Zc^Q<}@87=<k=Mi1(|)X~@csLF
zkX$)8&n*Gp_?ns;IA&&M2Flj0=Svr;gK<%X?<`FIC6RPoqzv4F8XeAl;e#NaIJ|o_
zM16|l)HUBt4vTg=e^Tk~EwbYvsEf`7#?33|r$k37&>tOd6C&)!y%j9QJ#6k|i+1YE
z4z-EgB0$(s*-ANq63oL&&n$``h7F~Am%NXcaS>1IQw59{tsGK6-bTNS>vJ19Zh3@I
z=z@V|$*tTP(c>#6<JS>yC_NkU+|_9Jw=~aKz~o&E-u`WUw9dwdoQlj*%RpfSvL$Cx
zd6SZ6d#juMwtyo+zV)vT{Zh4_=TWWcX)ZSpzO$LsIiQ)ixL}N6`)53#hsR^UFG<50
zqzqJ43QJ4L5n$;F-gDi<!!JPC<=iy6#&Pxsu*spw$vZj?47^~KM<Za)dzA<W2L~#N
zl_XH}lp$leA70~gCW+9~*9We^9YMiu5b*}VqCXSgFYyu)?te1`s#sdu8R{j>8)U{1
z1Uz<J?{~Qv@X_pJeRkm0*vrRDpUOSs4dE(SJFH8q#F{knuygp-KcB!tq|e>O1qZfn
z;w?CbUHV1>gkJ**qQtRB`^?OBds+5kfT-0z>GpE2Fk!WlA|`EeE%{IlJ#iHIH&_fI
z-NpTejQVJQLCL_#9jY$VY}R9RsnQ8s8tVhCfX|?`4GH5_;-Q>Dv%9k5OgF~dXC?8H
zd)VZ>9Mj?sPN`N(f3I&4<}od$X1TtgjIG}t^RD{oN-a!gO&@WeR!{-;_;K_Q?tvt$
zd(7=rI#BT}&!PM`*`cNRd3?GZWf1a7y7PRh2}8~zD<=mNiKc@?Louvvru@*1#hQXK
zVHoy_kBJ#;@IHdIDrV4Xhu`e4s{21FU_tqO2jQESw*Zz}=>5jsRdMbxfis+aH>#+d
zlH8{<gSbdC|H~IHWs)fyXAE<bi{oit;ncX4d7tH~dN*Sgg@#NQ6=;i=eiOJA#&(t2
zGSi>=A#0o-@6|wHG7yb0$WxHJTEur9ePbvW=(@Yr&O2MDmbfxh4E$_}3SgvQLlW(2
zJ(0{=7gktk>*e(c^l#K}fhrdG?8a>VVh^X1Y#MGU35a-Be_(W`yqx{@B}&}$aR0Zr
zr?r&l1|GSY>D*55Z~5ZgBwk01Idvu0iF4@u#u`tkWkvlxH}p_A?cSR=FXGG(KPN}_
zW2|4<pagd*^4qxOV&A-|iaVLqerVYEQ2iihF@Vo7F@gkt63uB9bR<u8pSsVUJZj>p
z3G?CF&iM5Sp`%4twXWKhX}*9C;z1<a<(@?@`CPA$p_mW(_m*D;*(!ZXaPS;@JlVe%
zFgBlnRdGW^q}smW;5&Fj%gcvgVEuz^5t2Ddft7%m*u}xYC}w1I6e5b<a7jjX_Ses!
znQq<;#(*|6Sk8xnaZ>?cZs)G<Lq$Mjwl#O^z7mML0=Ny#a;$=S6nM__@bIu@2Co=_
zSuoOhXK_F!S=jq%1voeNKrf7hfWYdeejA6Sk~M`5!~5!scs`$sSTn<hDvM)J=1v*5
zgAXR#ZmV=Pu+2}T7Uyjo&oX=?O+%aZq+$5W)`+Y5H8lT7?62&VwRD|*K-9=12XTl;
z7W}?@4-9B?n~zfgHgrN&Jkd&f>?cF*GC=DV#xbcK#Qm1D!EL^Jn;u!gw8~13YOk5l
z(pT!Pt5eW+S{S9LC1eRU;<p>8wd~cEQ@J6rWMGI|8M6>6@sY3QlB`(x$*}7s;n4p&
z&F*gp(f%B=v2|BG+{NLe7UlD9K$F0}X_)E)^Js&&CmP+Le(MTB5R@D?)EDC3zBQ1R
zZpys(GBYa+bQ@X8@Iic8*me|&REp!I5p#YI1|2mH)5azyX60;-Bsf>bP@rGp;J~Mk
zs<ImR0I6q+xZ5hI(JX7;xbdzwv=~(f^Ix%`uLg8#P`jyQ^{L|O0A_DzCyDK|wE*v6
z=#FZ2m6KO797pTlHR^Ori#)g`a`w9@kikN=grQq)&;IeXd+*dpZy1Vt+^m1hdN}Iy
zCtwoI<GtNJSSCgO&SHXv`G_e8`R1*6*H?Am)oW<6G`LQm_LsUMvx`PQ?*HyvQ_G&6
zkqVbOnEY1$WcUqIu)j9}<KaA%-FQELvYlOXp}^};OPU(0#^7*%Bt?eB+Uo0&-HeKB
zDNCk-*l|eYTeC@a<vTl*FBht%7)&U9HXD_^S|aF#6}t634W6gKV%e37Lxv5EkV!F5
z1`kunIeIAE-1kD8&7PgT3aF~u1!0(LsCW$c%8rDBz{sEqm<_|DXE$h7fsCr6uGUa`
z<XM#jK<_G?RNyKypmG=dKfq@L{Pw(eM=ZvwZ1d~p!E7bsZ`$kEufgRcE{=+v9CX-2
zTc;!*_y^oiv$Dp?)oI8R^EzCN#^BulV({CqkIG$)LSuP!#3^7phv%2^XmMAM5BGIZ
zucv=VhcFoWYfX|<A^ORfZ-2s<J+p%K$uv~a&kh)hM^ycLCOx`PluJiDop~l9<WVQD
zM?G+_N7C@WM_UL^vZt-yaYmzCSNTY&kftU*JZz2Iv-v{|-nQ}#KmHFFz!Hgc`0eD?
z_>0eELx=Vy+G3BBVtep(rR`;jZD{eCSJv3HJ-Samn9J_Oa)%^85i6|w%2!QCf=aKo
zr9z>1pzzn*(=$@zz!KR)h>s6R`xc}cu=c6ApX{&soQVqy??Rds?FE{71Yi}jJrAYK
z2q<R4|9OeBva_|J3<YDu^WS(|@)5CI4h1J^ki(vYRBU|wiM90-tZl_-T}$e%i^dNs
zWt#V>DhdbmU&Tp!RE^uq>JnErt)H;*JZbbqn@~S<k+WXgqq^n$cTyjr@@%mlx9m&a
z*p*xYEz(2y`fSIlV&me@J#Byzgze{xxmFeOATTfxwqX57k3g^Gv7R2M!KVa_m$x^F
zE%o;HF3ukR4q-sAf5wBbqN_Qt#4|r}vVV{kNU}vlHz##^V)o<IKAVc7f*~BHMYP6=
z^=5G610?e_!UNRZcvyG%G~aW*E_D6Cr5>*3A2jMe_*>i7k5zTH^;z32;e|?E1d_N&
zv(umyfmk6xkz}w~-5F0eqHCIc{`Tnky!7Ah=m9Z&Lg@{m0x7R0IYK@x-xRA4^$2Pg
zLMF}^B3z=S&o|q2Zu|QNi}p8WTs2ZR3<)lE9dD`pg|kU$^tmp|S<adR%NU#8^Ncb5
z#+ACCMzj{g%SY)mS8D01{I3}2)plGUaQ)Fn_Ql_AP}$TsL7HGu!e#W>cRFqV^f@8}
zm0_HYV&b%f5)tRF>ga=Jhk%t@(PIj%noB*t&WxOv?>wTgjQw}Jqc^adg!UO^Xk`Wb
zw&4X5!u*V1FW4f*>MtOCkJR}X<?soA{nYnll+_};fRL8JT&$7q{DN)Q@YY}J-Jj)I
z?KS^78`0n1jEcc-LFU*+QROARyqfPHrCdWz{F1wveQAx$^3vA}TrIq>xEf>c-J`$G
zZ|bYZ+1cKXs#$-z%Nf6&ZtPn=!^4T_)SQw`cwsN2bgS1VMf|O#xBITm_sn}SnE5gL
zz1q6S#X%LV!5}LMB+ht9nxcP|U)nYQR{=(JEG*M_B-@<q?stv9%6gx)L7Vo`qdm+m
z$y0ePEw_y4Wf{NwYihKR+cRy1BGpeN>Up-e8=gB6qBm!7liTKd{Mb~VFfo_vjW?cc
z>sJ$8`+FZ*=a%N`T4k1tdSU|xJ1hb8X!~}<uRc*Oq3I9s39qQM8jjjiMBo0js{90$
z*R&so@(Z}NCs*^`^>USwIbNNRk(68tZT)FIu`z8;Ksc?XDSTZbNfC)g(_Zkuj*Ghy
z6m$t&hScZmmN1@(2&D8%$TzVrkzH%X<~ftRBFtjwyB(iD`=?e_GdLf=NFv(Zt!KLS
zn#B_7TmAarH5RUQq`Ef!%A}yr>7=-uj-(s+)^O?QTt)QdNK8tq?a8rlO)Y42dcRKj
z6o*kwQ{`b7?ahn1OkSwRr*$i(Jtyr>4|?`T&7zfttZZ1_ktMTL0xh|j#T*UIj!|wz
z_@SxA+yi^I3^`dn#F^Y*8EH8n4#e4FA+GgytKZ0k-cMLqIS8H@m(~<4yD=*&;CFU#
zsVW`aVE%IiFmzkn?;UQ&sQ1CC^MfjVy=7<bltiMVxpQ;u>;y%aIRKK^(mJrtvf?q+
zQLv`Y2#{rwmDep6O}AY-d@JE8Z1&>{Jv}`%p`hud`0JE)M36l8&71J6e6ogylRtjI
zkdRW@Eq?xU<y2&LPR<~&%70G8tYdnyKi$T|dzp|xfqawjqHWAmf;=(tB+FXYMNKWY
z(%M^7%bqMMCI+m9B%|KnXZ>)Acw+94@$E+w9UU9V_J6`7aK*%q?>n(D)6<{6q%Ix?
zozWkj+fzzz)EUiD(<Qz}bR$wX-l>I0SS(Na6y?1!Fj#sME9K&XI#f+0y~-Pd`BXnt
ztVcfPMf3d?>N{GHH-Y(4RQcjXtmx~~D;0%MX>J`H17tHkK7KBzn`92oz_3$+1}4PK
z-HnZ?c91su(cW&u5fL9hv@zX6NJyxqsR{l(qpGtZaWU?N(aK199x><nPtv^XaM4wg
z|5Efs-_Qyn*%=y2yK6VTIXrv=S>f#|jXssj=vKMqe4876g}z>|><~2R1^8D>xbP$3
zE*BQYv76v9&9$H40M={l;&s^;7K;u)qGpAQNBrR?U2lB|iFeRDi#vZi<OvCWa2x(I
zwy^j${P<OE?PxrYJs<D<#2;eOqy+rc@e#H}OAZ?Ho%xOGvN9hj@53_r$V+g8ByO)n
z7|{g;1dJ?z<E4<^s6pe4G3~mtoE&p-0o_}j2%U$JJ~}$;GD+B`3KDMG+WmtsK^5qs
zu5S5DumgRUk?~m-{F{c9rvLukJz8t5gAX4W0YYImYVy{%yrGAcA?BSl>1XvT3X{L;
zE!HM|uF@^bAU}Wh3=cm9-BnGUAa}No$yeEtS`&tM9wvCq)Y)UDO@1323&LC^T|L`q
zF}yF&P+qYt<+l1A+zxq(1l%_<9m&*sk3A?fo-I(Qb*;Cy0+Hdqnb`!z%eL`xMh>f@
zfPkQx&r(mD+EY^g)DE2iDvJT-gW&;}g(M-#tvUP7)*3FVmt0&&#rh&GztCjlmx3ge
zl+vguC2E~=TZi>{*m4sv`~pt26R*{W`&!?tJs#!B*X<%8O6lcItgH;JJ4ylrEODbR
z>+S6+pFU}p?tfVtirsNlR8a{sqKk;YP4hB7*x%S<k=GHqd*{jg4RsWXi~VBcp43Av
z`(K}o*sNfIa&W*-{ngk3gxOfJXek6^Z-T;-h=>Rm7Z)>gCb-Lh<=Dw?=Bk7B5Yu%8
zvC7-y&~hiTF_zz(v$Q|s)#6=3r9Zbhu*jn1f{7S20VI(}dil(>ehUnoIyq_t@Xkwb
z_*5&G8KYp>2r@H2skz6a-=f7i+dbEQnMs|c(2|uD9@vo5>9rNn($^1n@o)$Uc}_MI
zQ(X3kuj!7p&V}Ur4=cAq7{Hll{B$8#Jo>OcM_BvG@r&^qBjeILoHmA8ZC{#6A$BgV
zO8)3BaWgPruhVHxHJ+QBl>p5vdV#-L_X)d#$YnrX_i?H5w`39f5Bd2wNVTs=?!nk4
z^s#rr#zGEkp2=_Aya`~4NRnE!Aczk`%De-F3h)-TviczCdNHZ{c?CxW6D8$rQxiK4
zO?6+Nz4y+*o6gi&GZeG>^G%d~x4M;;tGjy;T%n_l-gmSa83st0xgD>z?|SnlB3BjF
z(OTnldfbK7HaLxwtd})Xb4B^3%QvEHb&HNKU%9fikQ<Pd`S%sQHQNJo6O*JUhojYr
z=q}0fU)5`P%vM%%!NK*^ocmr&gJ0|1l&-13Xu24=_g-ov=+D?J=e0zpiPUN>2fiXX
zYfp69X$W%q@rqs?k{$3u%F4|Av#`+Cc`klfRu+v!fB{lpj>^mMaA0;wJfD)zIuKMY
zH*Jf~kPEpS1v+pxHZiGE(qeb?=|5ck9$p&dLY|JJ@w#Mcv{D>tYG=29?EWz{6sSSr
zsXR2p%}EmC{M@VB3YfVvv%V2L-k0^c4=$1jS#`aA2U47nWLaBunJ<qg-nCS3TwWf{
z?U83lTpe}c=UMx_IV+GfNhVH}*kY2TsDt8)W_?ZcL`PTmnR70vJl4=rkZAxT9%3OY
z1DL>u-V!^1Bw=)l4OEaI-vVZ&h1JH*)Her}rvH`A8_e1zIVUN69ACvpgsC(%`_FY5
zu8g{rW&Y_>Nq)soG`%JzDK2h*daN>3JPAm&tD9lD&B!(wnVmUcB_@g@O-=jfmPf3&
zbp^ZMy?m_EW3OL*^Y5I<uZO3zKf{jpl&Cp}pJ;E-*R35F6oluhp6q@OXo<ccESv*T
z9@F~e%lkxPp?=<x_1`$<WvjTj-<+3n*lB8(|L|8NrefnZf4|^(g{D<WG{Y})$wkg?
zm}x;`PT|Y^;4DrVQ`~JNE0y8XGuFB$Ugfh>kE1;wE-J(KAH<|!AFp%P=<Dy-E1BB*
z@x#eRk%Gcc&+GU4Z!&s%^ia{FQoO2`t}etx@9kUcob7c^7G`*OgnsEEtUhfV0v4|{
zHUD^Td}{$drqlkq--i#W?stDR`2|~a6~(hsgraA*>h$!J75)m=GCg>E^Cq^d9C6G<
zL;YT#8lKx?_RO-)ZFaRS@rQen82>ZooinB68%wS8KH@>GC9I50vErpft%o%Y_mbmZ
zYt^;qed%WrnN-j#qi1Ku{rwvcHU{$!N65|kzI;&vI5nNIVK)D#74kKmcjatZa0oeG
zob{Dww+N^&5({T_sG(I+Dk&Vw5-E0xtG>a+0*$UKuTm$TI609LzC>?qd@kcAS9p+B
zeW_HheM9w>j_0}{&Y8I78?QYs^}D;f0gz|4)?Q(>?eKCTbE-+hvLL)jfXIz2VB|!+
zF7=S2?9sk9e&eHWGUZyKxCATlD})OZJi~Y3{p+WFo8S6cz|C}fEW})T4>dy9ub|b?
z7VBsUi9jH_|3U_;zKj*Nc8QNdfw)$@Rs0w)L&Fk@n4%jm@SBE(cHkwM)@5-uI90FK
zIWH!rulJqOjc2m5vfy*@*qeWv<2B_$J{JPP-Gr)R0rA2XSe_V6*BpGgDXEFT6nwG%
zR836{EX+VgA8L4rJ;bOBGbC1o2!vRsFzGT85fR8Y9>4&4*tb8RyxY_y4Ovjt#03T5
zkRtBjMKq)^Q%}0-Yqaj(X`$lOdkz9xa2P<1F5ri<7DHKt{YXX+fmqAI`BmK0_c2J!
zWwF9~2o$06`}?(F#{3aA-ea5yd<24CLwvyBYyWo$L_vBGJNGmt(PZ?g#Jw7TM^K#Q
zO^s)X|IfwI^Bw(U&S;L!-gI(J+Ao6~z)2RXm~~Ztv5i6j83VZHQ*<Ba4@tU<o>R6G
ze8EP%z^i$Lb4xf7JbN|ipIc^P%LU>^Ko;2~`eGY<3a-#U&(vt)+`4-}n~vdo0cT4p
zb6rre^NWA&oP&Y_hDZs!8{Hj9s>!lo#3(v@hd+d@rWHds=}kr@Xg~1bq2?IXbrai{
z$t^L-@1n7Tjn=6ub)H^rnVNd)`Z%dNE9d#*g}>THi!zhg@TI=LVG)7v;=pul>L9v`
z<Noz?-z7FtX*|DCI8*Vj7ZCIp;GE&Gpb~_y)B2$(;-3>-r^44lh>^glA`t3?;N&ou
z?!$oi*WX7N$c~`L`?pthe<MYh;=)0Km#_$=<pW9(h$;HxO{IpIzRScBd>kAsA;ih?
z(T?@DTNYPauyD+UcS>h35+$%7&>T{k_b%Gj&($`uJ02%PI13X;9oJ}GeszoUxZ@WZ
zZDuy`$(=$-P`lbzT-ec6TJgty&m);K?rYLx(vXZxD-|00fEtZ1A0HNs3_Ys+!6NEj
zsGwbLHDKqOH$z)KlY9s%L%I1q=at3myoKfI^3$CqMd8HIHf5<sVxsBRxjOBK4=H-m
zWy&QFOf|H|z!<Qya!2bSeO@L%%wCHK2_<*P8~SWoq;ctJ(N>~Qn3zAj-|y?-(z|Ci
z1HUYK|Gpsp!B)`0pO^Nm>@?q_jObt+Ec_tm_$_QWL+<3^L-`_u6P`9roB;ODPMK73
zA7MyMAz)Vy{Kn;$hFi5;^Vu_zP|GiYzn5E><Sx!HS{Z)aRMJ{tVQ!FeoH3S_T|YfB
zWVri6lG8>?T#9E+#=syiYdVC-;Mifq*cE~|$m^%^nXuLgLOSKmtMnL)>c6HS5vhj%
zmQgT}7d~>DTK`Q5*5`D>HcuTkvfMZzO=K8QDaif`Li6d-(V9>h=niG1im?ZUFudX9
zx^=6(l+VSD!TZlwO4q)0-fj%s(R2rtCa<mp1Ps4T0EXS&>ya%cZ(@@_ML}j8AFq2y
z9Iupt2UYu7b$))mE9KGNT$;Vd&Y`Df@2npVv9|Ubsk37f*SrRFabNCGX<tsxD)LQq
z*+zd}J`IgqXWCgJ=Eu+5!|(o6PJo$jPjqGu3*R0Bo4kgT{Ve&e#|BrgN6t-`8$=H`
zrSHM*Qf+hKW@onn8};7m36n^*URi~1v0c8-$u!(4rKM~>$E6XTy1q6L6~UoEU%$Md
z!1KX_c(9`S2)<d6;>EwY8>fApjGR_J6e+YU@8Uv9K_R25dG$yGGSAfR-rlK=7mJG@
zVs47wynzBoDq8VDRVAeW)Q8N>^Qr6FvDAOh7Sz&I<J)yL|B#bMw)9Vk(N-#$D+(GW
zc!Z9mj6~hKd%d`aiCx7Of9BdXazsr~{lE`bQ^scAt4YJ}iyM-9EAtPRN1|k8_yz{R
z+#SuFiAyMH5%0Q?39i;-gN3072c#pS+}v_&6Q0jc4kw^?FDUfhTRY1z2wq*yg8RmC
zb7lZ~`oiTC?d^2T{QQefyURj{OB<8jtx<!>?E&2}S=rNvI=i0r@9ephf5yh1z*I+L
z!y!i!=6=Mr-bF9p0CjytlS?#PMYf_Lfm6E1$>D;*ry6#~r(@qE<gW%ld13=ueG$s@
z=~sLu=Eqew9ty3EU=;}lH66k$NBcFu8c_2~NA!^`TbquTh*C6p<UEi34iD=MKJ7QR
zEo9xV+KZ>WJ$`bM^|yV5*KPHJi_1WCG)T5f*(ZQ6<U-?VQlmu|4J~coulhPEul<VE
z-fF6x+3g)qRK3U2@j)8Q`Zhp*qcev?7g*IS?0Zv>&QG|1U1NgpXA?b9Gv*t0(&NVl
z1{-kuIXmwcwmt&vGhTOi^l)s9G%WOzr8oJzmqv6d$`{;LKfTLkYQA$353js0U#HM&
z&$ymA*G}tvuYS*kn1Y4HS)+c@y{9tY0}_%#{k=%3)Baw^h2DF%zdnW9>T~$&$ib3k
zgdr;qQPHFAZRh@hhh``$-^ci{!<h!OOw-U3nxeu0t%@PIg$O_2b$uUi>gqRjyzNcl
zpu83g+lveA!i?HRLQ0!e+6c?rH3jL@uYW>Jl}=iJm`zEh)W*IITP(cpJ(s#P6f?^g
zs12APhC80)asNA9BM|+t<-ntIMw0XCRry`D2MZJ?(=^b$x8`^kKO|;0tA;|wH)#FE
zx!BIiY`?a1Tjy&-CDC%)$B!+=jZ_uJw~2)sQSd2M@9<G1Aeo?V`F;-|Wf6PH#np!I
z-6hqjsqW3D4i34_E|sw0$|#dD5faagnemBttQv@*aJjwotIGC)jLcX}OtXH%L1(HT
zh-np$aU&G4zK_bZWZ)b9|EWN8W$}m-5@WQUxFu}<PbH}O1pg;@tx8*cO^u!`u$Ekk
zmEokSt1A|D_|r&nlc=k`z3u01vub_|)$Gs*hOp@CQ{uVCm`3az9q%;XxkgJUdGOWo
zXm=X^l1K&yEuB^9uXEbk7BcvRN1qzu&EHx7<*zfP&H1eX6ZccfqMbgBj7k9%EqyT{
zBEvwwaT3Ks4TT>}o<LSzWzl7qt9oyHNkrver6U-4sHiobOt_&vJjAqe3P|vWT~{6}
z3yfU9Q=)0;QwD)@ejbLc3K|?|L3vhA%x!gMdTXNK5xLvib;iseKR$r}9%eo_%@Jey
z2YD21HnowEC9hRqkE*DwynI=c_24B^h&igYi|2zu=h;Em#WvTGH}3AFfnVOfdc|N+
z^V(&@xT>`DS4Z-miAj9LBoi*em*gHOu7&pZFK=!VSj;i*P6LoN?C}C>MCj?{WZT?z
zS+u(UJ#}l&=Vs>SX4qdR3IflvC4vhQhdX`saGL4q32IXGbd*AF%X;F%Dl#&Od3oaE
zwsv+?3k!nQI>>r{ZSCU+$Vu-x5GuM(>$$iwJ?B#0%WJVKKR&Wj_6!!RMQ6d$R+mV<
z$B6{{!e*1-MGlT1X+Eb8v~>Ik#J4YbX&<6k2q>u_mkhzQcMzvZ@rdw|v)%|Q-5TiE
zUc8z7Ut+PvQXDcf$y~V9q6_q5*iP4*E6XheTvwH^3%)mWb>$>4B_=a2-QQjLLMpkw
zzWF$}s7SMzh~lP~3i9rCIi#ZEj<~0AtP}Ksuid>4%gCjdwIw@SDJaOyq-9iSfCtua
zRvs-udOa*<G%Gf_gwLtfP*Du<#&)*DpI-ew>GSF3&u-7X>rWcddxM48*4C3JM?UY9
zB?SaRFaX%3NO(q^hFz?6*0{}aXbZLQ@o`9m9q{$eYqORJ{Z+_fvLcn^dD1fS@;0VE
zPuD)X8q6oq#|F++X~LY%P?v?mV5vF4n`LE_OS6;Ooy)FEH(cEqPNqJ`#IO~srb(8$
z;1MIF`FLG0ORrr%&creY;x?Y_wzpWEd<oKrPV3PwS9Q6--iE`@UfR^sQEIM5V0^sN
z)2TPL3%Ui*hkAa4a+eJ2<-Gj-xHll>xPJh<Ewr;jNDaFO2JC7=69weK;|F|i|Bl($
zLz(+M^2}p-cvjY^D*#Vd_;EG>sKI9VB)iAkeV@hMZbCmpx0jo-$FeheWl+h+UP|4t
zks1Ih*d7KM?jR5cf$Hfet%lXg!A3I`y3b$ifA;q;dsLoM>(W<IvJM>_j$0V}dy)XQ
zefsoeaB%V$T3uOLy8a!}^i?{#c2%Vn@K0%^zLIeK%gHpqW9?p8zjV{AXO8R+*Hn#B
zb2}+RLy5JnW3H-V03NOUy$)-XB#biT#>FYcb6aiwRk0bnjP2{p8*cJb4kjp@0SY2}
z`7JT=BOx`q=k4qt<_CgJBXjTlW%L*&{#BoS@{#=aEnreg1Tj?xRJ6Ae$)%P(tjveI
zWA(5-!|A_q$rw##en`|xe{WvDyJ!8yT@w>%c_1DcU2SP?-S@+hP*S`ed9_p>0stt5
z>I_OShee+C^!KA~rPx^B5#nCGLN4LH`2{jkwKYP(^~cBk)9$)|Hs|+no(iSV#VBx6
zfmG(nV4;8TM{;n5%S}zS9eGAgJtpDV+4?l(9rgt79c)P6o5b@!TsAXbO%Sm+d9lCj
z@4r7$7vSYJND&o3R6E@=bcO1BF06MC!C1`ku`vDx2?ByYgoG4;<)5BbuCcl}IVmfD
zLL#B-uz$>LZhlDY#F9DP(nm+fIs6QA_Lj)pwx{-E#Ijf<vMku}X~|M&YpLS5)5PQ5
zm-SYhlDug`%gYPXCNJvhii_8gM#l_Y?pf$txN$>X%tezqlk&DXK~M~k{@F&0pU~){
zxD*u>9NZXGkmsMXynL4>OLDm)N+S(^Tv#zZlE%SmX*1Jn%G0&Qk;co;$WTPWkP0QG
z1;m7}#(YQo(E#9$kN>HtFl1(KC@%1dNue`X`^@HU^tjqCDK72=^46#~&Z0uV>HA2o
z0hrfJkj=Gg0N6Lo78Z;Ls!P9WHPiF`EZZU7et}VlgoKKZkBy4^n3-=w6OgJHw&srZ
zQ-{;zivYL74OUoaLGdrRy<vTQ1bO9JZP&MNI%T!V$<rc}Um+=gICqXl1L#i8V^BIl
zlqPX|ttWsd8Rad7k2`~ZNQFRDXgY6a%7t_iUWkEHo~(E#NzV0%-(_Ci2l_qJ-?=P&
zzS|t_`a-af%}7?C*LiZRu=&#hDTqD>$#8KSLRt7jq9QtcAw?WnfPZXkl;72cbZ@kp
zK_%r&^nimCXb!~&5k+;a%_iX?EeW+wuy25Az=S1<7djpwndrpxi~S&m?rbYfd3Rtz
z>hy&-#J;Lw9Bz*^k>lqFE7Fd5=Sj%8kozWEJof}ys1-z7FeRw@DEgxoxiY)6G*rfo
zO?IAnPx1e^Kx5`^W=_t1BvEr<aPYY+`e%P!q#!tyQLw41uZ+<jPJ;7#TMQe}xWJAJ
z9`J+O+q+RS&w<^hrPY^)KFkAsyRVpY4jWh)fB_cr3Il^ZAi-CF#z73?;ieTYH?iP`
zN90D(m<Tw}<GH&21qZ~|TFzcx)7IDF;o<Z1mduV$PD;wkteIfSESY9+ZvJ;}j*Sc-
zeA=K3jEn8p*eF$}V`TI@@Dc^k$O;Mz=Kw9ge%(M_y~GoQffyK=VJu1vef$D=d5VfZ
zda~rrYTU*{8sOqIF#&Z7hJBq}T!hF~fE)$91t2Pb`zK6rA)ODm7XS-XO%)^W38TCn
zD9cng2uzB5%u%til;pr~_=oi11%wi2M^{&%=)v27+lvy2bhn|~2tN`L@?IoGNNc#P
zjz8j`DAX4LUwDXOa6I&fH3LdtF-Kuihhg)ECIfK1fENh%)>;}G88E{~^%BOKFt`3Q
zKz=z&Mqq}Yv&oY%$uHqjddKgwXu!|^D^uo6b8{&0fcn7^PsQBYnwEy<nXN4dfeGT_
zg(M^-01ffx&70r9e+PbIZ+rVPnB)Oj26WrYtE%E=PoKYi0-nU67Pq(b>>miEmoI`r
z>etZF-qh!S<(8GP>aIkA5L@w*@^X_p#**#rZES38Dz3*@h@FYwArM%%A0TD4>FMF~
zDqt`Zg_;1*Ff!-|DFu_zD<Z*yp|rHLY?$<;A0*NU(@5e*R+$7-|E@V*9UaB!XV%sX
zqK?@;E}^%0d0(g2c<fkBT)6(v!`9I9USJg9MF4}G-`QN1Rs$T5sIk($Gr)-tfv`Hi
zl_3{*9Kk>^fFD<6PQPFiQ9(X#$p*;T`E%#FKO&t<Ywe^LQP{+LCklah9QJchxgQoa
zLYnJ8K$d^Y+SlrFn^cIJTWjH?*BffaXfDIC*+l2a)xQ9l|2UTH|Nb`r-BX8BV^P*@
U4kCNw@K%Ti_f(NZvQPd07dSga4gdfE

diff --git a/doc/devel/uml/fig131717.png b/doc/devel/uml/fig131717.png
index b45afa0c17916fb91c682ff320f5371bf3f028ff..bac0eab914496ac8dab085fcaa43e0be2748d7ed 100644
GIT binary patch
literal 13151
zcmeHubySpnyY7gfBcKe@p_G7wAfq5DAVaqd3ewWjE!`=Nlr%_7NjFGJNl14$11R0+
zhwuA+>)YSiYwxqx*?*mNo<Am@dE!^kecjh}-Sgq4tk`XAa%>0$a$7=N7zKe~yn#Tj
zeT8CxJtwC@#}EiLL_%2bm3;zw%Ef|kMeF-71NubRyq?8)HG$vgDAx6~2x0GO5pp%k
zlznOH0=A(rc_YTR+MgQB9wzaShGn+0yHl7@e&c}N{Rk%;(eV;#reV7wX%uAf!hh6?
zb`u`fm=q%P(uZD_hwpshR{X-jmW|zb&BWBoDOsqP-DX!wFJDcAQ<4j}kR%)e>3c0(
zjst<b;K28WK=S_wUzYT0Adri8M34zdqe6P**kcSecWTT8ADs&IBSjC)C+ygeK5{|m
z|J_Smqj^1~r;+vMwQ_N$@gqLuH{~NU?4Xy$nh(jyu^{h)sWJcKOHc<yyX*aK%MLQN
zZ@kPnOD=iq@U*L|OD>ToYBmUm<Z)g>LA~>FvA^Y*Po&kxaDHoRD?L5EYr|#LO47nz
zMx})>{r1l%D{p)88lc2r)lJJk;%A(;>(~r>2nh*oY;2qtC}vjI*E>7NE+#H7&QFC>
z!{Uky3wwDQhx1i6ozP`E-$PustdnaT_t(Af_#b-PpZ)r7I)ka}FN`}~KxuBSUY${R
zaHM8pGoo&HelpU)p_#;M_m~tniO2R!ZEbCJb@k`ZpX=(>&m&;kLtkEl_DRJ&e$7h4
z{KjJKC;k3mmG#P(FJFv|jg|7=r1GaYZB=EJl(0E>*v+_9RAui7OuJp4kChmV3=a<v
z4JC40x1D9RwTaTS{95>)5y@JAq^+Q!5cf!kwPQ<c)AotOY1kq<Uy9SSj|jJ!l$6xp
zeqj5sqO42;e%<4Rgv19&1!zCm1_tQNLaxUS;LzyzBsd)HXu<VVRpU>xK!e{R-pLZ+
z-mtc^>RxNU%+AeK2p^l8QrFNhyHKEpaak?;cTUB{#f9>pv@Zvbs1~2%FX%jRaN6mc
zP>nHL%jM%Ip>X*XsQKJ#vAynaI#+}Ld~YC-gf;28gO#Rca_<Vx4KJOxATm-?7?RZY
z2|Igw&xItsSpcgU@%#60{?kpiXI<IyY3Y$}zewCHXTN!T{!B~L^6lHVn^ev_6>g^$
z;LW4*_?9I6HT#KkePg3wS@z_l+J1!=Y3fUHsJx<Lxj}D|+u3(F=iMKiY#MwT(VMO<
ztxqAfYyDzW>Sabl2FWfA-u8!6c5WvF$*yxanx8mK$H8d&z`lpvi|2Q#=C(}Otslsg
z;eEgP2{zyIfnYt6=#gUHo1*!{hReFh;`;gv-kIZ`xM#-QYlWH((_>>f7fI}fC?%zs
z$lsk&kHC3|td2ihtbp4^Mg4xhx!dW)dozxY-&>zHv*D(dmJT{Q9BeA@%D|UEb2!{C
z&VIymhLS()JbCtj5IbMFWI5I#$<WkPy+mKe)zuY2I$3GCpww_OG$@I*yC&YJAjh}A
zHy{@i9ZgI~7<8Y{ai-pdKe;d?LvO5Dk3X4}5WB3j^g(gLRE-_0dUa_^N=k9@Q&v_v
zXsRr+>v5N+;#7UjR`teYm9^1)Yaq$U;9z$wn^@gsiGiGukXP>t1u5y923MDsj~g2s
zcAKNW_6yyn%1uQjxxTjPX37p8J(-~dM-=OJtO#5l-=^SrljXdTUtu;``2=)j!o1;p
zu_NMe(z+KcTq^rnkC}^u3OHd-LqkJK3iZ(K01el4_f+}(JoTD#u=J;E9RyCtdXpTM
zV>Qp$mGB9~;cmO}GoN(6-XbR_cU;Se=}F?Fm{#y+`8XYl;-^@1m>-UqF1mOvc|7Mw
zC7ZzYWIZxhsZfz|=<=-h(s`oXbfiF?f}9+sl%~we2)?R1I5?=Qs~Z}wfeAeKk1;y_
zptc)5I81}}XT9D$X=Qb_+^#z$_kCi!KA0vJI$kykrsZHa`SJ`bySF14T9WStv<m~_
z&!PF6_nIE@km4>cElEhB@$TH=-yc+1-?m=q;X4@BQOJ@#?^LS)J*;Zp@h&EUh?qD@
zz)eGPY+|BDtJ(Ko?~F+^s|z04pyrmy*}iPpd>VM5x*E>9KyVO|HVg^Grg8lpk?ah{
zfe=|*R^|deoXuRGYi=y*dc1hMJzdAg$9H^ueEaroEG(?Kt8ns`RMgCD>+47@eZ8Uh
zZJ{*x2>Kc-%c5@a+qk&woSeB~ffkGH;kFyYISpWZcrE8!!0fnzN42}Rmjo#t$DUJG
z2D+a^<#uLiY@7?5|K@R>*KUjX;lrbyX1u__Kq}Xxxt*AiLQN86w(<0GcWlJbGjn{d
zL5vq%o(LK?{cgmiqEhe|&WuQKOfsjrhPAbIOXPO_X#uQhWj7~A;Nn+k46A0r-FM*r
zwBt*<3YpS5d3lrquFh_5mzgs0o{evhq{<Qq3mkC7urXd>-U)o-z{*xzAu`s~_i$Es
z@@42MR};pISD2~9;(`$WR+$wjUBS({_9SW)3^H#a15*iIrko)VWV!ajc?;T<EoSYo
zAv8ZwI=#p8obBq2UMxXUM)c1_pL8h1K52k8nv7%R6|sKaa|k5VQZN+e{{6xJQj`Z-
zI)xyVx-PGXaj8H2hb()OEG7-))F(>`Rb-%-cs}ey5I_p|gt;fak_<+i&Eseu{TRac
z6HgrQvKZY!R>|G5z$l4{9)^~pa&c67#jZd2u_pL%UY`aI<?_%XCF^N`E{}6FP-Dq9
zxFA0`hGMeZZ?BFQxaq<^fpvTx9{Pn=uZG%!fMgF!WK8_g^Tm5^CJdS7w{Sn`gZ6uT
zND;{#mGa}8?k1M{*m18$5EB{hyp?e1H7@UFg_krq;nbe67glQFp4iI%!Z2^h^Ma}>
z?g<h1w5nxoGKlQ#=dBdlCHdx0EZ%P_%o6uCt1@pidGH~1xNgZ_hs@=jBT=w`1xN4Z
za;fph?%@mK7!lwbB#c2nD~wQ>3-nq;Tu_)AdhLOrWKIE}B~J6Fslh?QgO7y553YW!
zOuvIqX;*{`@vAxZLWq^9hs}xD+$0*J3ySlxA>LoCm-h?`HbHoMzWF)Ap*FalknA%|
z_^RS=TaNC}eu|G%p{w{9;y%r%KJurY%>ny0S+`_w#n3{prMI71vWvB*R!4u2^IVS5
zn?D=2dzGHH0x}>JV}^;D8As6AosOnA_Zt0Ia_QrJ6w}jUDw(0LCv5v22*2%`CE3U4
zYv|MC|0rYp=qbq)@*q7;stOMMp(sU+5pp+)ohjlev0u>*q>Q}6%Z~0R-ZnP;BP}1E
z9fQT9%c4E^rT<O0!6zTa2y`l`tC*V+{;G6(nmTCiWYI|L_?OcA&n8{PktZ;3%QtR|
zG~<cRVg#Bg`+^)F)b6ZT69$3gF79&ifJ28D?}pZy%zT)4ciIp=ZBOqUgRPDbiol8C
zaz0R8thbb`2Ifts!fGR$E2Y-vdQT$)iYpe1ATGqxqMeAy)bTsKBk>hS@DurjkbLt_
z;4Jz^#8Wvet$B)w!ARO7)|aJ-79?z(KIh$ogFG8!#I4`5Fort%4(a6fFbo#lBAEBV
zPwQM$!6A{QaD(8?oizqq>r`$suT4k_H{%Vh&KXNoWq*<|CgcbAFFyxUH^^I0Hl{Wi
zc+53-!%=nke3vn*Mq}^;fm%~Ei|SoX{Mz7OOP}sG<lU&Aqtu%BouV~{G1wN*@K~Cg
zZ;uw~h-n~{cG?t2ACDPXYKQi5uTo?9YCS(*i~t$h%=wm`4-7<Q0K}T=>Qi~jC09{?
zKk?w;fQ(K5m7*g5?{+$Tsfl_QClQfW@UwpRry|RRHh-cVfoNuBl(Moi3ibP7!rV`;
zZ+cooUS1v~LdwbxCwpse2tp}1dsNaxLPFNp*Fm!4u)C~Y=V&|E<b(9@iea5lSG8dL
zKuXKxNA3l8`SH!;w)EdwQCg>>lG4c77(8QhYwIy9Yv@VH%(l6yX%y=Ib9;n#AT|z8
zZ?XVu#wHp)^;OFYcS6_F8nWD%Dun7hKRqNNBJ%0oI6R#gA5V|;c#)Ex{$RKT2{jJy
z?CcDo<fhG-taCbS^tzcrm&=1SJ&HX+ugYSRs}r#6uCRaebrws$ujuV&QUF{Fv?$5s
zUQRBq><c(2r=5jG--)b-hQ^=#sm5|aR8Uaxh!_jQ16=N4Z*OsBg_E6~`OViCEQ*q`
z5fOA5?6`EKxL+JVKEsPZyzMc5%t4A90!H=iTk7=|U#-QZrB)`?(R=RvFAB54`Ck*o
zd_|l6XcIY@kH53x2gM=r=7ODnrb~d?L3KV-D%cz?qFd(`5fSmjqasGu?hmWt2l80V
ze(Oo(#iQi<3MNG)kT{3)uUyDbHf<SXvyb5LTgi6grH0=_sYsBNyzfoG#8@(v6B~kk
zjB-hYNRyfRb4G#V4}AL=g%<N@0y8bwg_KaJ%jQ@~R%&YF$}YgIJk19FbzXo%YPI&3
zV1D)V^jbFm9X1BzpFMkKz1;mI%VB>=NvTld9=6YW^f(c}xs+5_v0j%mzve?iBSXUv
zY(-__HSf_X_0A5it`|qY77o!9S&~-2=39BUYX=UPJU6&XRqss~y>>I7sjmac)L^!J
zU0q!uG0VyLNIih}P%JOOW`u_QoDUexY&Zo4#m$>HlbyD>ow~w~nAh<PhM6`$5B0rM
z8LO`Y7#EMw^5nP8R`rqy6T4ref4k|4PFn(?1=-oFC;J<!6=tTUrc*^aelyz*7IR1!
z7Z)d|nz*MhXm=v-$idTeMBzzu>`)*+EflSNdLSFmftJ!d`Pp!J+AvWm%{Y+X_@JFv
zFuSKWKC6$er$}J0PY9o}c}Okw<wM5rNd(E|rHH%z5m02!YI$9G8b;dh_7YJ>nK&B&
z@qln#o)lijJ$ERsbO@<SNttcN6JUP)_$rGvHr^P_Q4qK|S{NQyv=*&F^*zR4!8a_1
z%(CCP-E@^uDi;ew!((C&7pN}Zyy+<dNvLQ7t{oSVhYjr7H^WuM?~%h#Zr<%5A|)>i
zG@CHyWkN88;s!h3uh4+F3&FgVMQM?$d-}65%v6QZkN%X(5Nc)2)P+7VOm}HoXyPLu
z;a74m=((;@TVkf-T<zVXflfULpV(a^#CU;%B9%H9(Z>?!J%rbAzu7{OB!SO#c|OXf
zK08Q%&Qm=0K~%W05-Y)rdJn^xmVw^6AYGePMS|9#!FG=F2*Pzoa1}oH;Zr;3R{RQi
zXl9AHn;Mtg{hPBdFjKQ0*bgI2iqqB}qqxd=3S6*eA7ZA8J(wPQic8mgOwy>vYw!WW
zbxm;9Q9>l8-JTV32Oj$L4L0=#6geV=5GkI<59*|3rpLLa8(8And(Uvbn~*(LUFe->
zA-@HoXWuDh5`bhVwJH=DYAu4zq)X$TM-820{_*1n;M$Nni=v>Is%+kDafd;KJ`N3F
zpE2lSNFNp-k_-PF2_X}LVL(bnVNI#4gpNdqvfm7$NQnC|6v-Na`eH0M*@V#NeD+MQ
zh7huc{Od@^gg_o2o152ku>@CL3fhsz*jA5d+`FlvWwSfX>8w!dK>OmL$LW!>r+i2n
z?*Id1?4S4cn6?t#uj6}@hod++IVsvq{B*VQLa5<TYOs*%vV)%ZNtAr_Umlkbgvh>t
z88JRLe8r&0d`IWDcO1yCV!zwFNGA!zYVkKSKaVxRYuyR7c~0Q5W=xS}Zksgo4L6NH
zO|o1iyXBM3JFVdr2bB`0oOh)f@p0`-DO-|)g0K+x6;4ERc5gNmIq`0&Y5w^fPYwme
z$GB13V*^^K!t(L$Zp1nplV=|XdHL6%^I0z^x|cLig#~ne7xowStNn2mhzX&7^c+bD
zwRCVr#p6fWKd&y<*F^h(D3~skk8wl*peJDMiZ3(d@x9Aaee|Y&h|O_rDNz6OI$v~i
zeNLfsYG2^I9CxnSUl)XC(cQV0PSn6Z_ilZa>M{{GkNwxa8DLtYb||`xSG~7;B@-b#
zh_)CVtESnSGF-BUuLoc69UOr0%i-fNAV2Frt>xzCCMf7pmrGg>NuZOC_Tyv;%pS`A
zm{08Jt$c8{+k1L`F+Q%+Ff%hc`q2BGxq0#v9Z@~KCA!e(pEHZ<33?DgjLFW$>FJ9#
zGv@`c&$+o9^`~38xw-MrjE6xU?*n`N`t?=jZf6IWFbS(ht^F_U*RP|voxlbnw~UMo
zxZ2u4)=<1uG&9J$nc;AUQ*^};??PK}$>XZDv^1bpWM=9EG6o{3dZk4wZ2tFB*K*Sj
zyUzt8WB-Q2q8lo-45MJ@A7+&}#!JcPXfwDZHi!!mX2ciLXUZxn`n9(<fa;VJIDeJj
z4>XAKa!EMe{pX|`iT+maZEW`T_Oji+fNpGVMxx%^*~P@fNWtUd;}5r{PJef?D!qP<
zp02CO$XL?6SkmksJ9l*h0!1VUj**d(*;w~^Y{Vt2+%7MGI$+H*Odk^!b&uOhShC9L
zaLel^Ugx_geKTZ>inNc9&q{A{3<@L_W}{yltE2sI(Q16rr?frBf2NbRS9Tk3`{VuT
zQs&Q!R}1qhbj3dL8_{$-k5ba8LYGfC^Ur`xCp{8$6NG2}<n6X#3c$DIXFfb!>FWzy
zzb^rI;h&kEO*zS$oSbZIY}CB?9iv)qLI!y2(VU;#UK*7I{I!6DjLzfd|A63ch@iKK
zY(>uZo1-2c*UF-S=HgEuzuT6>z8_-CvW)p}^bU`2?_~=Z?S~H^Lfxv~Hew91zS6s+
z=_>qV^eE>EdmILyxeBp-t~|Xu%X|8-hq{?oAW0E8UL=6)fwiEb14N(o%k#4pfzW-~
zL8~tU401`6Lqqf#wN^`=U91hv8I<JYOphML14XQ_uMfxo#zscIzP{aKfdK*2&Q}V>
zT(ciwe?wLn9`2F9gE^-kK6=DPVy12-FW>)1gaQnEqQ<T;Xo{}1ptaOw3<xCr@FgD{
z63~!*;}4&x=QC79<mJPSdgr=Av&kqj3Qg_pWA=73_3+EcUl$KGp$U`^S_tF->>Y;i
zZhZn0%*?ji!I**F)?}6auldZ(%+5~9XTkf4TnC$D1ATq7yT><f+!!v@Wc5bi>Hs3j
z&CTtrC7sOg(&T+>E=IY$w3J!3ynAKW2bl^KlKth}!uo2U-@SZTYCKZFB{f}UJObAC
z?(Qx~P8!T-_-R@q;R=tzGqaLt7iXOVR(xv$P)w}Oj((k=pT~2UGO@4(zmaOeY<!D2
z(`!)#E#-^~z2@EqR!qw$uQi}d5-><x$eX60W(xU=Ml21XJ9(Hmn39;UpMvLdXk^5o
zhEO7G(hHAT%Q@cvL!ruaSO{0T*eB*fGo@kqBKdwgOf#*6JKP%IhP3$v;p?ZR2k9{H
zKF`RH;iyXgXVZV6&G7gMzIPuM<DEH+xwWWQo65>ps8)KZ3Xa6Fgx;(kqYlk9Cz`{_
zIv1mcrqazLBDe%80>`AJj4@SmhJ5nX59R!*z3csjbi@BaLyt3&Fr-}z%~R&<*Hb0J
ze`hbFlc_PiXCLF}N)GdS%Ex+TIF`G)hQf~MY-6wl975TzSZ8-Zsu>hHOT2El*Fs~m
zvP1Z4uN&zJ^Y`TPt^>?7z*kuuhVca7k1h*s$XH=)X4dl_|EXV~p1YQXGF-G>WJ*w^
zGtKvjDzwOKs@f!mo&b=(Td8)?+lD_`A3!}GWOH@DheJj`P-CJ5M__S%sS54fNNS=4
zF3jg%_i4g-WGQL!QIfXk52~bXn_zjE#L!xUOVEjIBZvWjJ?f*w+!Wk~SypB%WUJb}
zgn7Hy`3tqo2QZgrrrfExd)M3jyc^s?FpT?y^QomhvC$~WD=sl;dSI+i0^@+7XI4P7
zN^8F~k*PgXQa(Ie=;{(LR4nfWo83Kb$%q7y?fYbcMwv91E?WW{+Y{CfnSaUI>^je+
z)2;P0@4@G)_dgV_PH9^u_M7C@(%>Ls#3723APa1Mb3K(IAN3NN>LeBHHAPw!RBPH2
zAjDe6!)hvp-Hl`5n~%9mra#xA>-5l9GkxJ0DqW5?oI))OICF|pzAw9NOzD_2<Y1_J
zmn7WnmZImrL(*`bBolf5NG5|7cQz*q+?C^}HK!=;rYXgo)GjJ__h<Qors%?FmPr<g
zgTc2YWHw{Z*Z}bLn{tZIo0wB9KN*zD?~$6gn~c6bMRwYFb6X?@P)O0_Dbfx}g^8U}
zTlS<GulZ!GQsZ4yJdr|QO)dblNi)IW#d~GJErnk#`0=&{KRD}2%q%k!1@p8d5edGd
zz}s#kO)b5V%DGj%v$z#;G!hwPTCWn$XzcXhV?Jz)4l|*h!g7_Y!xa`QEjU+I(iJNP
z!{`yA)KAoTBtU!I-V{DN!U)M)s9=8DTPg9no~3KDSTB&J3;&7lMfc4yX0^(%)zv59
z8KyPi;%sbXILeF)R*i9R_5#nAl0W_R6{ya6u7&P)OJ`k;+zHcI+X@1ALL8a;QdTwu
z_W6$v`SyX-78-pIh_z6uD6I}+-}^MP<Y(*VCl7vNZLY3n7Zeoa<iv8CPY>lP4XFVZ
zlmI@v98M`IDRCMP=am@rV$&qKT{tw%XsW6L(g(<Z4-6O*gh;h|=c?S?N7~v02k41M
zOicPe;+_G?JD7r#+_y-(H2|<dKpztLT~wg`Lqi$-j&vMl*+6G}xepZ!y>H4={_|h>
zY)&+*HxODS0P~TM=m64c{xlh<SwdMieiwU1PkAq0^8@V^E11;Dxahpp`=g7E#bOch
zT86Iw$T){;0UZTBDk)Kr{7cP$oMB>O^4#U5H1hX=oWL`Zf{U-RCQQuC&)qI+Ba164
z?3#UVBmIT^?nuB7w`T-E`?GhWqoQ(JeM#WX*50sT?MJQ+4f**pl4MX!NlD4UmSu8)
z7~S;3>V;)YcMErIq{<O@*1LIv(;QDMB28`wizaGtnSUK*Ih8Fg186@oGP1IJ+!O=D
z_7M#xe+IbjbjOb$_b4fy&-X_(9hRad%xZqD?3#`hi}>={4X*5pNSi!nfk8K?YAUj_
z7zG3xQd6}6qi=lMx3W7`X{iHP>h<f_haGl*{{|C%#2{=EsYO~<RfXRgGMexf!3FdK
zfVa&E+TrZzu$UNwt9B;rrZTFNo<1El&ZcbnSYIAK{*hoNhHc=>z54BR=RGiaJg#Sz
zkyZfWKxPreSz+^gvEv`Kxc2OK7pk+VsY#CiSomsKS<KM*DvTT~s^xiwg>sS(pmj}6
zNE%^kSQx6jy!_<+B72vZi0EnzB__w|N{J^X6F6s_6(oTJGdDl4?NH+ND8qRnm=mm!
ztAR8h{9@s+i?fjOnKw9%Ux_PVz_TyGZglJ!UK76Sser@pMF7`72y}igM<;Pv0-NbG
zxXb6y^E-3Rs7|nK0W-VU*SxgV(Mg-xo~d;xiL~mBgkSCoT<Ro_?s-w2rBqf{78IBP
z1Qj@&!}Ec;T^_n=0wqOF?W~7)TUfonBZAQfhA$ETMH&}H*-bkbfJ29dhKPuW&}g*L
zycm^BX>IM<6)k0TJC?G(B|kz@Bwc0;AIY!#cpiCgFxHk_Y=3X=VGkL(jMl9KV*d4?
z3FX_BdyTfY6m?XLPyYr^rMg=HD&NUY*DfH~ZnDOHbD31`7BNT?lIi>OM5kCCQy!ow
zP(RS9^u&_-O74Jx`k^N7gh@JF&B(9&6&~}2kDO!YSWC*Ns(3IWn!-B+?$bbMv;~q_
z!ui#(H>}!8bEL!s!_|T4u2(dVaOvLZvcO&+!16{zk>5_A!u;?Pn}RZ^)n5cr3PM+D
zpWhk4f3<AO6DuKD?GEHN=r@ivu4{%Om`xhs3NCYaYvuF;^8)+4^P1>7)Bb5J3{Psz
z=iLRn2E(HfrynaTm^(LfqWz%4JOFtNf*)|0tqC&_ILQZS#ZDdEXF}Y?q;Xe0(>k)$
zog>jaY9d1m4+9y~8%iZ6V{nDkmL!<P{?wS%xXtYr7b1v}p6ktF4wy74Ww^NB3?f^(
z244xuL}3^wosMD%ChM<}%)<JMy1>0HZjOb&ds^fBq8i`ZJ>(DH^ap(J8oH7ei>Mez
z_5y}sQN6spY(jEPqpkI+yN24}y;qC%j%oE0e<Ly0v@lS?dHYy}<A8Mh$6r?SlBN0S
z0s80vh{dA?T=-^=W<V&pA4)RKRdYEo@+o)&%1pV`HP(eM^55bIcRTFO7!k~l-tI9V
z_uWR!%T(B4uic@&el^y4bQ%AkqE{C!h4G_|>K7IPAN3EKqXg44EZFZK^RJZjswM6>
zV~<IaoQodQngXGBJ)ZKTPZ5u2I`vOK&@Ni-(Seh~qJn#`$<mTm;KhTy>^BW11a<EV
zLMv4Vdy;MAj_h7~GX_hx1hs1AdAuZm``b|HANGxX{eI`&BNtP;M*8pDXBp+vt<Jv6
z_D{#|2h5SI!93_%!aJG9cv5fZe0HFTHo=15FjIm+2*|H$0kmin8+2m~^<0v&p5=ZF
z5Zx%t0Ya}NHiJK1)D`^2k!W{Vz%rxVEQvp*aLHB5uDAK7Gca6!Yz0e`y7cxBoFZLn
zXaxD0bS_}ALbUkp1PggwDCH|c3T_5~6DU8Xy$3I)^Do6HeHX;_L}25-%RX-as{h({
zu&Ye}+&`@)H~(_(pTC$GQWR}DWDU{#aHaovL$As>DF)RIvF<r@5N(0KHX?#kLp@3t
z5Q%2`tv>~Yv5)p|QL_XgerKAHtmFN6-un6C&wSMiViJ;=$jGDfi<Km&$IYsy7Z=)t
z^VhCY*UiO%o|*r`SU3Lle{QUMA2ofKN<0(%2LB7!geSgQ`gKa@)@&5ixSnrl#<TV&
z@{-`*00jWAfg}oIF`yyS(`L~I|E;+$>DtS8X!HKPFYEDE&34Er`~LUS?FIp-gU#{r
zaln271NwA1c*VcDu7dvWRuWAUBO~&;Hph!MD|0eZ%Eh+G+ik+TNap!rS6{T0EN3$U
z@DSSRz0-4`<e@rWP`^Z>w4<{Cna;}kKDoH_xhH{p_fIq~FXz~o11u7tRRRNW4;L3d
z4ftKkD=B5smekbL)YeX(Wxb#V1|5D>4Nx<wT=v4%RnbFSdyAsMus<v6v!pQ|9b3K`
zFr=?6@MEj}^&xPWyqQ@+=T{0&Ga%~5E&<;8QEQA!;}zQhFk`h2pg^rIWPslAN=!^V
zoOUul$^?dCY`EdDE;x-_<{=@r4>BVo!=NW2mdzjpJ+W2CwKuvvN;}3gr%m?O9$%>*
z8k6kcxYsYHl&`WsW{`Y~<|+qDzSzqGfr|uqcJI%QENNPbbiQZGC7a1ou6&6w9LNM&
zl{6F>jJNiC0{&R%zfNZ^H6)caH7^sloee-fw7dsA!tKq?S8j5^c+Aa}l5|+=i~{F<
z8d&_Zbtem4s?MAYS2UcP@^Y#|8;98aeF1~`q-MD!g`MQMo|BdAT3uQSyzRGptNo`3
z=-p#y78aJSXcq7x^<{QO27UO_=5(FY+RqF?*`uPOzW8PR?S9jJwwtmY0hJenEub{v
zD$fJGcdP=11HQgDfbfn$e04oP@uvql3h*%&HZ(7*O(&cmbxip|o9S+8&pX_9lw3?Y
z%)7jwD)e8Q*pr~vM1tl0yLYP@F&aEh2PXD%Px94VTykp0rS*4o$*75J?w}CBG#9(?
zAS^N!$Xfp{5eNjj3NN8WdR@_=Du9a5anP5RfuYt*{CZzle7&UZ(O8Rf@9)}3Dtpn;
zzGk(<D1Q!}rLp^|w#`RJ;p8Lt*1{z8b5p#s@$4|Q2D=qvT>GWNp-Jz9b)RT_!6U)c
zN+_kn!KX?T2!dH=U(dQZ_mx|WI8zl>p~^kym9l$tBEzBv>pMM(r6Y{C`EL(2DOKlM
zqCh%D7G7NdwXiVB`l>jwULxPrIoof%*qC;ExYz5)NSG0NImwybB^Rn$sXmiNcIHiB
zani>IMc(t-{~V%kRcB-iKb%`VYxI~;;7?arC6>i&(o(&PW>)sq(&f6O{bVe+SdzAT
zQ)zZDHJ6(YDl*CZ04w67heuz!xC48Syw`Q?$%optk+P|eDyg9&LCon6^z<9|8ne3_
ze`e!Jw<A3uyuv{-O>>j@-t+pzqO}qEO_d>R3VrF-zRoE-q-=N4M$<(fpRJ#6zWiV<
z0}J@7*m^U8&@U?mN!+9(>S`L}WWH{Dj}waqH5)+qsvT+HEG}zabCRiXNDHm|CUx9D
zIa&LMuwsa}w$t_5a_&1`7hJ_EDv-98w|fc5vsO1TGR(&!jnJw!1N<m`RjTFmhLypp
z>@U<6=iPt(`aC8I<CF2>&we_rkPUo>-wwFE!AUb_-OPj5yVpo8M`Y@fRx0nOQp$P`
ztaj9Ta86(qT}wpTM~&eF#%h*oJ<?|>=pVi-O^h+Uu)}ufsGqvvD;iF2Jn=fFm&>^@
z@GWUcd|X_yIySYsT9JT}JspAID#izA!G&XM_vR{)2}~7-rS>zk-9>D2_jAD?X1wBj
zz(qAB_)UI~TTU(%5sX^x7%TqiuUD<@J{adYDG6n@yx=Dl%#C+k!_RzpkB?hblE^mp
z&Nj(U5==@dKUW&Qria~0Y6*`MuZ#6Agsyc7OzYXRTkDaBT#3r-JM@I^LaWnsK?4y4
zmgaA|-#60HTj{GxjtvejCKRNuLqB@DH#^iTWIKiSd4xyDVR8!V1;zR(uic9?4&|Yg
z#Kvex#9(QS)>+=a^|c#Ej{KiQ8U@o>3NRjSGPGTumJxinOr^|)WHOJ7kAE$MN5x#`
zB6eGo3m^K;LydrOcu~rZcs;CaIMvNqk^VSsw8T$6C29kOa4{9~Q_NxmDaw>9uR`%@
zIPXFA8`Y@cG+#x(bS}o`2=e<9M%s30l{qLfz57^s^?;Bt3AgDezJ;bkl&prM+xGM|
zrpi6hrVeG&{lS!t_isEALL2+ffeLMVilQv#34(F%XGV>9BEr!U14Uj!C~pAX!Mt+w
zP-IX-waO15BW#e%$85DHVK=pKGTigSyCdQ6L+#Dd{ip(qbAOy^?7Y3ILheBs{p8DQ
z-)t*$MrbI>@8@L1)hUY?(*pVUYmCD*&GXpG98NtAQu2EpMc>*M#1#Q=%d;6({wy0d
z8&GaC_8aeV2XDCxh;pu=e(mxX)#VcqpVP4o3-hwD1fdg_3WdS7Fz-8aXlmeXf;ena
zjKhgbM~J<&sC%r81}Yecp~}n<LI1tE%;|7CsA)t#^>a`z0{k^lw*@i?AOd!FbtSu9
z9LH!l8Up1E6sUlznDeWeEg-+rOGN{p5;&yju@c7G1VA6~ODKGcfV>A>+KY<|5>4l#
z%uLbz)$_v{x6PvOo{cG5q^z|&O+jRAJUl$nkJXJx+y1ib4%_KMH)k3ye`ZMOU-lw`
zuyBaMaX18wvh28NKzBx0%-km>g=!|oZT|XBC1ABE4uBWv?*;}2fJIA51*)_IVy>#9
z0(j@p#6-=z{?COjXk+|V|4(m0oz)y`vh(kb?6UOX8l#~vfB_E;4{renG@pt<(7$vZ
z^q%@p?*Zxy95v!?HC$da`{5O;lzmA{(*Ym`?7}#1>*a0N!y19(2!U`ENSrP=8ZI`j
z<2~O=zC2C_Z!he*fuu^O&xyML%;VkVAH2X$J*+>h+g<6+B?1f!JzCVfeW(d!`1<<#
zx;huYyMPRNlG|{S%ja}3>3WKG+vRlALF31<-fo6sVgP+2=uP5D77!q=egvX^jm2D3
z^7&YDFqOb`f@SxoCt0$IOiWDG0N8-H1U9+={3ne9fDQUJoMpM4WL@=mqQBn~81jCF
zk7cfU8wBQB7bK+}iZBqs4)*tto$LR>q&@y~ncOH2<RYN7(mQ70jM4giGXhLxoc&+i
z+(-mWgqN3>QNbUvT+n*@O%x2@8yJ=X0s`8$a}mmyFeK)Gw6&jK*_vQxKnWZ5*^(y~
z&gbEeDqTQ(KTi9&b`l0f>QZp-x5eza>K?Z$p9v~5i9zLGz1mxjHwShD6~CIA8gm9S
zGxOPEgj{;$)YR0MSD^SHKR+MU35vT`@Rv$^9(#lFLv?aa+o$E_b*uG*(zTlE>hwsZ
z0yT%@rI?{wAQH!*%zy*{s;+*bZq2a{%?uCu$myR8Nml)v+6@{?J+GIi5>QrcBR=zc
zjNT($>b*ecxQjQqB~XnzdVBG1c!3c*TUTlzcRM-iojUk=xEdWD4Zt1@?#qYiJ-K|p
zS_r_CQ@0Sp3z8~O?+QxM#u7nMsYY#OPEHQcrANnnV1@N3>+3_gLaBWP>NVZ)!+%%C
zNB=2u4{;;^Rp4gO7}t`CeVXy_`u0Q7zxD0T4J`NU;%KUh8P`)F0BnOwTA+6E?|i%7
zaE>-#kfYi_3KDs&RR;A*&5_UjMd5eWhxH(T*PQ90d5#hi5?)aE4Gbu#sGI;P0ZIe%
zYmju;gEvsgk;vzyD5Fo>28tztXZ5Q;O-$hOY!~QB<>kZMhnyT7zO1GosYCjM{QUCb
zbh|J&m*SbxtFsKf_p0}@fO`!bhKUSFX=YMQ{)M^Aj1f>;z(WIy%Vdp?f&KEKq(E4a
zZ&NKmC0uok2NCc6znAApz&F;{d3bp<t`^18(vs0r%iXhR*yn%sttK5g+MUU;eJ-}P
zFSdXq^r4|tShvV()&e-1r93W#L`1QdcqF;Ep)^2nn(x9B;Am4(qRqXyvglisR$v{(
z48|feHFn#;Sn2C~New$15I9$W>uF3=$-My&)J3W@r+^bpi*aFHIS4{aT`{=^iJu7C
zzy7$G2Em}2>cV0)gT6^V`4J@m1o-@$^ev-&pe(YmoL_)SMldkFNqjXx^C>9U0!q*v
z8&H9o&MtElvLvOXfOd7?^+>CXaw7=o4??6`waprsNwE7%P7a)j$#MPz<7eXL1P!Pq
z$dGqzV`cv%qbkr>1~nJJI<&O>b)^f%cNGyYgW8NMKVxX<DzZ;)yBZX<U!2H%F!tO5
zldE{I5paxcVBv(JR0{7$R=8#l2Qn_@3m&CWoxekmm#v>4Nl9V)JpeUIO@x-r|E4y|
z`(@^xxi(baIh$?tGU6U4`$5!7Mp1HspCxj9egOy+T#p*|5Du3op!(bWb1gZ2=>3&A
zGcRwmJ)92J35pY_K$*@(z*E+-CS7#**#`o~Xi#uCTn|cAj(1ls=SdpuLASeeZw}d}
z&vAav*Ql#5D|@Z}{7QiHqjI$e;d@Rg7?jFnR#&S8zvJZO{I0A*TWNBw$f5{WdYvu;
z1(=&S+^<fCV;z}icjMH#-k<D8xmI1#s0wcQH==#Rx)rXP%FsTJS9i1}G$&Gqs({{H
zQK7^)A<keCZ}MuG*DIeb&XjI=^o{)!T@1da(rN1i^$y~;ss=GAq^APlA*fdZ@R1$U
zJk3B6wcqo0!?d1ZBe?Y{!awwd_vC*gt6v%Ip!}z{h8v6|cwDzK`s@%N141bq;S_Rw
zLPjw210M&J*LMJ01QLen34^3O`~NThZ;e4&tqIAuejpOQ$4|MZaxYBFH}dI(9{9hC
pG3kH$Uy6VGYsLTUSM=qz_y^|drF}1Kz#nHI5+bs~1<1Fa{|m80czFN-

literal 14266
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

diff --git a/doc/devel/uml/fig131845.png b/doc/devel/uml/fig131845.png
index da87ab8cb6cc144b1855411468a26b56054b8e55..cfe59fedd68985119ece7e40aa552dffeafb19e0 100644
GIT binary patch
literal 15777
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
Is{7%;0mG2kPyhe`

literal 18298
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
QvK8p*6M6Amxc-~}4=4CJsQ>@~

diff --git a/doc/devel/uml/fig131973.png b/doc/devel/uml/fig131973.png
index d16d88131e90ff3c19b82c42067cdb5ef8e708d7..e13300f66fef398cd3d6e1743c24ee7838b78427 100644
GIT binary patch
literal 20316
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
TI_w3Wn#bVj>gTe~DWM4fH6O!r

literal 24292
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

diff --git a/doc/devel/uml/fig132229.png b/doc/devel/uml/fig132229.png
index 4cc4b71d5be185ffa2382bc0367a47569fc6e473..99844d873cdac8d4221f117a9b4a2b532990419a 100644
GIT binary patch
literal 31158
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

literal 36167
zcmbrm1z41Qw>~<8;vfxDBH)11455h95`vV1G((GsNS8D!AZ^ehp@^g)-JQ}RAzjiX
z-Eh|UetYlt``-OO*Z*8+E-%I5nJ0d+*1higUK4OnS(fPBg>wi5g6NK%v?>CD%Ys1Q
z2qAIc9lh(Vd<euP#2x8dYER!Ujksy4^&X4=F1ST@(QxLqYHjc(Lzg-_<S)vqZ8mC|
zbH0+9N$f^COe!<n6B!Il(}||z)2Y!PJ_gWJB=gIln0uIYXjMjw&Bbq_Ic#GqJiV4W
zj+NVF(DnmYH#|i}MTZLdGAkagHY{~!7MNN3smjAGAS9x=2uH9#Abz}jO@Mu4melSP
z{5yA15{-R3POA9~{F7*pEW!TQffz*%|9E$xeqkS>>!uF|`?k=3d>BI_C5V0B$JdBP
zO0b64VSn8G&yigW$u53Y&nx+YtCSa;>X{JUCA>o)2oNX<xQrp1E!n>mL3oBD2!VL$
z6IANpT6fNSO<qy)*Y&<Ey^O6Ez7{x2pSSOfAu0BL+K4}*5l3~{(|FHaC9fr9_7=n5
z7%6E*gM@z(Vw3RCna-|Jc^_ln=jHJ)O3b5aG+@GylzYCsgmaeoz5V*H9eOXL9p`q-
zrJ<eP#9Q_alZIxq+TXq%2#>yWtf)3`GBPGZR0m%geU2s#l5upr=|d`SeyfH=MTO34
ztfSiuH<bRs>Br|xlcwXf%^$go{TY&y8pIdbJSKbt_Mb@Y7=;rcsxk0!tGBHK`}?x|
z+G7=N_9G+A2RkIrjv;bNqKe40^z?ZCE6Oaf%kww0Q|HVYG>`Tz8pdmQ49a&EWEv{I
zg_-E-F_)Kr3<~m^vZHPEI@<T>=*Sy&-;k1&Q&N(8`t*5{Nvh&?x88IwTT`*!@#;|e
zwY%cn%s$0s!pSK-N#PFVM7Fk!!Z&>@)*7iK{adcj;h#ZN)G=N{AZbxP-6F?TPH*b^
z4N`(H2=HFD7f5!Qo_^`Jy>!c5|Iys8QY@9qJLkjQ15Zz>UFy-&2!RLwi+dZ4_umQH
z&lK0zI>>KiVFsp`j|dG|1f5M}8q7ppwN&3xGl<<}Vfj?Dw-_0D-@1Gar=Q%-?G46L
zC+AN1jAJ<w>s`-#>W=l@-I98AyKnJNl7o^0twj)c-dElrB*xD(a|c|Gj@1fp9iSJk
zY;JBA^*Wx~nDydfXXiv8b8|1-%Wpif#9bNwR+zV_#BTZM(fJ@5A5y<HM!wpLw6y7k
z-VqHAQJIh4jg2f>$_ffWg@r#bF*7sSUou_!gT<3wm{cTO_E2Zfy8Ri#1Tj?j%)rpu
z-d_5mue<h-mC<IgvAV8XxeJDLgT2|qc*J$Ptd}p_43%nmFznc!q9L!`KzJk44s;%w
zoAY^jb}jUlNlIznN%oMEY!uyjuc<RQ>qA=dep>2dZtj?<=t%Lh<<O|Sl4!ZhhS_TQ
z26=04NQlAU&&`kFqZMum*?lePDYaPv>)WqUXkXv{#!&jkqmAlk*4xVmEiLJ?XNMBC
zs!FfVom!d3=@MM=yx_UXfT;F=V3t59HoV-ErVtRYfrIOzpumYlg{yj<yb*S0VD)(~
z=HYUD_@J^pVeEByc>l>>rxYdS4vX@|9FGHPpVvvU8`NAsQ*)22CB}L)oD1^v3k$wc
zQ0&+RzzudkKSSrWKTn1F)fkfg=~G*YeTq{#QJ_#a9(@fPHVQmaH8_!D!e{aM%C$T;
z#>dHtVx1MXUhUuCjyQdKH<)IEfqG}H(9&8)=F3?AeBz52M=K+(lm_UCZI8t-{-&*k
zpHp~(f-zBV-%kJPVZCZ!(BhGt%&l8&la#lSIa=|h#H|F0;wk6NsXSJZYi@DdS*SPu
z{`N{|XUqmhUEQ&1sCrS3&fzr7#T=z4KOUmCi8pv%Z-a#d-iaoz*F_jQ_~eDBhR$&p
zOE;fMWQB-OO%pR=6BRnX?Sc(Y*x;5(LNf`G0UO^Oh}WoS3d)>UJKhN>a745`$kjCP
zD9FiC;S=QIdNN-9jKhG2k}^3<ITMfYAreLHZG{@eF%fiL8O||jij0UDDRpdZZ(pw1
z8NJ`u-qC?(XII&)ZEI7kxJFui<Ig3#ek~2;HHFeoQEi2WgwS7m)b&{@wm8$@A1T>f
zY&#`(u#{I~KRXI5B!D&kXMsh3^Bd+8E^+ayrKKhKMPy{8{N=ZLWlnp$yEfS&K|#V#
ze;aCP{gh?&c#!Cf_b&R7gmQ~ytm>2lQVL^;<L=>+q7=KmJ!D-}SZMY0D@s5h!c<!<
zYVp^H4<9%+GJkJvRk&^~WMo&mPSl<eTilyXU=;T})U~dN2n);eJlbEaJP2(Sa#{c7
zPsaR!Ut3o<wq}&hLBiPh<A+#7M5$I3K|d}+?^gMl&l5B4v3z`dW}Wc`1qC6mUfoqx
zJe+zZzKh992$E(xX5dj!P(TMx=035sTpcbkF*B3J?pM;F28@QieO^Qa<*}j<2`Z{^
zTpx{ytM)yu=qJte?b|o=$B)yqvbJ}27_U8gZATkvN=HY>p3K!685PC(@Y}SVFDp^h
z+PsE_hLGiT@2>H5L?Q*Ur20Wy%+;peUPqV@5(bf{$9uDIUlotOGr^-T{P?UyKu8!I
z5&|<cT4156tV|qrC93tsix)6fRCII)?Sf<F2P<WP_MxY}*bSAt`cLJPXp-?>ab6wu
zn2yj43<`4FS*fs@sHNo8U_-A}Z*9{FT1nr&jlGMTH%%Wtbbb1iRPuJnh2EZ?@Yq;7
zN=nC#8KtvlUyhVHySceh_+Shpu_q;rB1ItX`MH%K^6}TG5QtQt|4G1)i2RBn7t=$|
z9DMc^^71vvkBMhs0V5=?{!hwHEaR<*?EK32H9?{-sr4y@gzTkXICDa<^buXR{wHHg
zP#gIZ5C)kJ7}fc$op5n+ZEkLc%O^9-hL*eU<<9imk=#*pS2H$~k&!V^bzkiJvb^2P
zPFN>*-XSLdf%C!wPeSw3C{A4qydVs>w@>e*l6&gvreKDNk;ofQe~<eS(RuDpoF(F!
z6|!+I&GGB!C!Cs@(SWsCWNpxXrT2~8Wk*LxJqsFdLr8~-KS-^g)sz$$bLp2ypUfu7
zz8W4G!NtKrqTrRBob28Q5piT><X~rYbz$M%yLW?G@e2zJzkl1Lsc}Te*VWZ!z$-od
zvtkTW*f$YT(V)OUwLVfZvRlZtjg5@d)MycxTsR^sO4HVs&tN&%v{fSulUB?;{Z?OJ
zpPEPivX5dkuhB%Uug~k?V8ZqnX6)?j@$vB-V`O!_urX}x>;eM<Vy>EnhJ{f$yZ023
zRwLLD4&=u+5|_fuK4Q=YImQi{+IhR-DoM9t##QB8TU#MnrtL~fHpBaqlao5Sx<iA5
z@WaE-c=`($O3i<;$j`4$H60xuUhC(zpJ}VDm6V^4;M6RysMyQw>+2(9zI~pO(wwct
zxFIlvPVjiGiE(9R<;7W&&*8^Mt6pP8){IAsJ24Ow)_Ym5ToDiy%&@q7>((t((<?<P
z`ud|uvLue&r+Ja?+Gpo3652kq$zKeiMq{*c9|V+@9TZv)EiEsXNS9zdj}Q0WzI_XK
zmY;tuOGG?}jXZ#ZgQNH$`LTtC9tNWoSz$jL8W%^Ood4m&EiNjH)LWOy1+HJW6VA=g
ze_~-VmDdq3TIRmDzA@XWtD}?7<+3tdLL#<nxVJuiu)WO5!Lh&I%F`4==X`wVA}cE!
zK@mh)C*r<)?=pFs1xafzVI7-Qss+mXmZ33OA_c4iL;4#whA<Veg4Ux|UgC__WRj9n
zQah_-JQ4C!Q&SNJy;<U|({?2oE2Fj9<PVvdiuOcYt=F$#SC!X}<mTbgY<qXjyxaQ}
z?)J(^M%J&qPBFLXmWcB5a(oIF#rHSX#%o@X2h@N6u2ScAK0x}yVBJ_s_S3pbKPsHL
z*wLn5L@?#CzQm(lv4NjI*&^g&)kL&v>FS;wAFPIV4-aD`k*&FEM#g-wYsADVzkCTv
z&>}=40dpmX#|t?I#s=Kie1SnH2sv_S?n1PN8Clj**Vh*_tVXOPa42-VzxiWeU=PA$
zg2#4DSlEwr^^9VN9IecW_Qy|UTj)4;2n<P!eGm@kCDEi8D(~tS+uR!Ipa1piL5$*c
z*UdRtA)z#UOxLeRa`<3&Rz?U22<)A(uXs^6Cr8JvFS<pIuNYS$Kg`d&KooZr2)=mJ
zt}F3Yf40HS)>edkvY41y)$zVXnTCpd*xR?oUg=yh@$u*g7`!8|lhqS4$@Ptm5{GtF
zl%Mmb@(*@Z2)t+7<le+J;Y<Mc&jQ+bD)J|uC_y}7z{N%?2gd)Y4HEJHL@G|G8d80+
zkt+WTB*w>oB301eN(st8k!lbdsYJ1-OLT<O9phk6H;02gU06fz(pRIpU9T*?vdF#c
z=;-Ls{yN@ZD%}R&VCiR67I>t&41QJs^bP$96z@Q=y?wj!uJ}=X$}nWhU*Ez`ojQg0
zgc2pqMb+QiOIt{U*ng>l_7;Z>O))h&nfr9jxFH;tSZQ%_Dpwn?qP%=yN(uzL2KcC+
zo?b<HIRy4SoR)bA?vBpRt7BDF85tIjA9J8Cb8=ez9<M>8(N<Pg01h<vI2?EJ*fd+G
zv$S$*zkOq8VR;C%tgNg&th@O12;nDt%3Jl2+dEBlX{e*4!_(7K)OGXs_I9P~*5fkc
zJ9qB1x3^z4>wxw2DO|tAu3=~>wo_f1QQ)!K!-p)%`LJ*yTZOB>kyF#rk!P=PT-3OC
zk2G0L&$1l$exZf8T>-}GKlc3=E|Q|M50~^g3eBtMKK3~rt&{)g`$riVABV?}7bfan
z@)%TRYAwMJOc06xZ07&~6PA{i7^~IMilOAzY3zQE3J*U|O`VdQtb&cPFb3it`<sAm
zLTRu18PP-(+__9X9UxPAs-@Sigsaug`NJArxM~FU>gcNo|Dx*fw53rcC8h1{ZEkMv
zmWC%!o~(>jS(}(hu~)e5SXFr*6=N(c7M<p=K5Tm}pA5171s;)|z5SHFzK+iRa?u!r
zxMz7u$=>eT6o<uqYCBtj)Xd0E%c2jto(QAb3XI_jgo~JBmyOSPdG_k+l&H(X!UqFp
z3F_KUChG%+imX|EE{eK3)I2|Pq5E!}P(*Yz4GoPJj3V+wI591MeMg5CKr5Jm*^am$
z_hRu{dLOe5`|h72JVQ;#YXSHFi`{8GPS_b6UIhe1H`=bkbTjZ8dfVmvGsWAKzz(yH
zI<7g(_++HCz<R6_R^ZK>H^W%(GVmEoOG@IP>IVm10fXe3b!uqG&ZwZLAK$-!zc<7#
zEt63q+NR=Eo*y>jZ{kt}8CGJmxA!Py@2h`y(I!5MI-2><Mlt)JJRVI?XbXp7YuSzG
z*v&?W1Ba1e4>M%@+hGKM4m$;h<$3=(i~vRLaKXffu=j~n0w=F2S1U2y_23h;hYvq1
zvV?tm0D0D0Q&mcHxX5}e@z#ra;~W@ZJG<OcYZm&|wgvgyGBS>b(|-VgO+NzXW%hBG
zIbq$scV=@MG^hO5n#QQ-<o@i)+g4WSv8Ia`FQPHU66{-BTVK-BRJewFdLCF>e!+Z$
zrPP<HZNK|_A|=6de}8KcmH?m)w+UbBa0PyP238Ht+!q2i4QgUL7pi~$shf9;|DXgd
zzJ`vDtU~Mya%G{O5glD@W@cv1i?d~LKuO8+Xhp2T$@mKrr=_1zgx{r*1Vr)U#}D@8
z|J=_8chuE;!`bgY;E#a-prS$+)%?nwo!E-K|Nn#^P@g`3W)Tq?h7`gQ_C=>azE1Zc
z4XlxdA3yG!643f-=NS8jh22+FY<qvx{{8#+#ZyV;vIr@tksL1EE)hZ|VG=C@rDS1k
z{7AVAC7Fl||D{WbdVFu>93W>t!#z7%>2a{tZ_xSe8_LJOVRCR#hajlReTM<ovb($c
zg9i^}WPG6%RZt+%lzIf!_}bK%>*5!<($-?X*UpG@Akn>H8iB{*Ef?65{}*KM3*`mC
zPj1~pUc!w&U2Bic@3P^l4G62{!2*1Id<+rn2wPiQ2vi)4JZx+<u;5|(Z{2zp6x0f7
z6_8BCPHJA>soyln5<qTtj-++F_EF~~n+FRlhz6;6l>$*wfV5!6Cp*A$U&bNuGXm7(
zadLb#|0CrUy|7bTG#^IM#M;_GQ?uzM#;yc5d5LDW{%mIg4*)MT8jABNTy_|b*$#SP
zVPSc5DXAA)Tr7_zVaBgV2;7sGVNx+MVJ;F@P-umBAT;XhuZ)jNAk)&)u$L$eknuBO
z5OW78^UJQJWnVjTdga3}LA4c?v$LlXrFe6Y2*Yy_-vMIc;Nq$)C(sKyuyJ!MaZ$0d
zvUW!Ey->Kw|3J>j2xTx+{S3EL{KOrG`S|D{S=HR#z1*0{uH-#Q2Y}!6dBwIY@ue4#
zsJ{acR<F1>?n_Gh5L%^<ILvNF>>&Tzjfyo_J4Ni*CL2C}WLg=`bn+vlH8wK?m{b1g
z(<l4c4qI%M-SPYkf#?1_t7J2vJ^*Gj9dT|8J!$pz_0`qY-QB8^Nb$g#)zvEdS!Ky)
zcvu*;&MP`vTEkEeLY)(MpsI=6noGf|JY4A^jQTbAJ&Ayd>ypoDJiILZic$d6U%qhj
z@#QeDs_7kZu&<I;-*crY1%@y23?nQA1)d6N<iu*I=4OZRstA;yKBN$#p~AEc;3@wt
z>EYoaC)W(YyWV*1?G=TYwwU|s>eI{1BM>OOy}bdm);BcR7NuGb6>@WMJcinen3(tw
z{V^#C66&BYe?UM$%O5~8*YyF`|C={&V7?(!#>B+<yw1<h_a&ef5*7wna}XjpI@c_$
zu3c4HJ3l|aybVKG97P~Rv;)fxFbD#{z(R%PC9wn~QctbN&xyUEp-Smpz8Xi|R?q#;
zyRq9&=H?|W#upxs1Gy+o&h_T>(9l^T`u&}&W@w9y0r+ensok?K(}$iT=;;P(3eBuw
z4jyrgw#$Q=Hd~&`-71bC^VDaoR6z?1cGy3Q_F{*>+oPks9{<;eZxyMjtKW?wXANuL
z-h8jAws|$GnfJJbj-6dQK7QkT5hurrQvAimg$onYlzNy$Is?1EvvktZOsM)!YciBH
z6aGxg;j!CtstN;P9ptC-Z5=s9MWn%#)lrP|PV@0m9dLcB_enVW678JJ3$MFK)g|@y
zU2mY$(CmNtl2tA_?^Cz-!~}kC@0Q#4dqR@Cmwe7s>2GZ5_4KiLO-Fn>I=D+FsTCRV
z?V+ZI#^U4+T!eQHFdZWRf@TsgjjgZOtyY~3b|*8MvkeS#R5_TxoZNnUC3ei~q(HYQ
zcY8^@(q`gz<uBM5fq{j|DJQX{ZzBpKNmaF?m66{%Px6kv4oxPa`S{4lAn7u4avq2Z
zx#Af-X^muF>}%)Y6jr<U)p2iqIZz;VSkL2#*>BB^#)~s!Hj;bjT|7g|&sv$FWA?C{
zz#=*xY@=e@*0%cZpB(Ra12rle`d&Bp!A6$e>gJpgEjd4$HRUy_s+!v5!hU$3JtH@R
zJ_5l@%d!<D6KVRAgz*>(P;$wY(TcJM-`+w&<!AI+Id1>EEaTS7NZE@mhr?4@^qC>L
zpS96Z;;={<J$H=^4HNBhzJC3hp_zTWznFd4XkwwPq(p!9Az|`ncd|lGPR`)t-zMzG
z#^3v{k9Wj95iT1I@AmV%ouegv?B1oMUl#I`#9oHUqQUYFTVhU5Kt@w{_s1{G*P@1o
z4+|pH?@r5~FDNY3D^+_JrTPAiEkFNy$<C;oFDFY>-fZWIma3`-=1>=yLG0kfNt0tV
zqmnl9PM&=DVkrTvDR}@l>QmwNvmga&sX7>3FUFhey~V}91uXPgd_<mh?Y3RDZ*3v|
zqLq{6b;3IKbm~ll>+c{L1Y$h8gAFEI!^VcU=rbeg0n}sw+qgM7%N!RYV`GQhRx8X>
z{Q?>$OaHw5{QQ88XsWMI<%*1p(^FObSo}d-NvS=`!1Jc(;Vx88?{C;nLIl*Ya&Bs#
z&a8djQ^olZ=s}L-u%M#zMcR>;PY&O9i$sdv*Y}L>EXZ9*b4j^smi4w(Tf7RjT1lsU
z@2dd&{7K&+K9OF5*9m)CzO}o%beU$_P@Fu5VCc-K-Ax5#TDBKZr!`gDFv!fZuJ6T9
zre+hUeSDRAFx&`4H1`ku5)1}YJlklGEjfX|f#L@;z|WsQGc&mwY7Z&qdqp4U-_+Y1
z*wWV4hEmxH(ip%=D!iV<X4evozJUQx*f;;~7wk+-Oi0vJW5|@Cnnr_QENL!4?8L-N
zXwe%tZZI=T>B{EbKRl9M8FqP3YPY{Ry|)ooB27RLB<%dS<GspS519-FYv|9)BLd0h
z?@4<ER8M;Dy*1UAY$g#O9zWLBJs4*^+09Q*jxZgVYN~RZp`|rg`a2;jcVL<=Tq>+@
znAqt@bnweg18vryJw|<Tsef>=(6FYFg7q!X`mL=88$^CS!9!ms?z5(dDJw^-pGF`A
zQq3pE-n@F%`A)#%!i5WuA3ui5y|_fO;r~x15m*TYVS`ip&^=Ac{wMPDKKK-9gUYsK
zgHi|c?oW4gM1tRuNwT$19hW(BS{y#TYc?wuA8$pCelkmLVl278<@P+*c}n%XL9Mkx
zRpnT}^H;UO{wA~E*;Nk<Tc-tYhi=kbO9g)2ILCj?+%Pe_qC$=-Cyv)>_m%j=-wkiW
z48p!$lzrvtI^B{=#yo6dVz#Eu;oQ`pw#!(x=(clAPj&tKK*_5-`-FkKql}DKUvzgK
zV=y<8U82y-G$KEJ>8@v_?go?QIxebCyOJL(Seu;%rRm$Jm1(APMMfj#E>~GtW`Jh}
zthlze1}VtvaP6fr-%7wH2P1zcui~GAhf};vOhn`mmN<YiMq#I=Xg(7fKNam*X{NM{
z3}&C^>2&}ufW6#Lj&|IIdo5EfX!@T>`fG7zWoG6V6kPGScI_HK&z`=%g~Q$BojIc|
z7a6YB?L}(X;Mtx>@%I#)DnJ{nzB*vW1*9#YHNbPElII8rhLpJ8o`}7PcWW*W2_Z_}
zgjnUCW#{_nQK}jT5k9`lO37?@cQ+FCl9--@oBIgp+pw^(*x1-tjN(~Y*F%$&rw{iw
z06w*+Kn6{<s47h_en=q+M5m#NNgeC;Yu6n1Y0Pn}2v6U*>1#{pFMI0}Tog+M0VS1k
zH$l{Gn~*_d7iiAI$snFTl$&nhlbpgr&nH(d(jTSz*Lkp?;dNo5v*Xszt^aQtRjb6#
z)WIRY#duh1#>B+r6@zH0MSs@&_ZJ=KQ<URMJq`+!lBOVj+`$%G^g^4l)|D{;b%50d
zhD)HQv9+TE5ZaBs4XYGkxOw&d<0g$>fD!xqu4m7lm6U@5At}j(`jy(wrShM7v%hjp
zb@TH2k2+6+uRG`>j!BXopvY$QI<%FLs0P??;JG&q1YKWmFF?*9QgTYl0w6aX7yD>G
zSq{GnB+Ruy;PS@}%?<&$ErH@6iqG4j7x#wkJJSy03|(FK;T)#?+IDv9k=(l1KG}C>
z?X0g0Ij>yYS=x6Vb(w{-5(rC}j)4M;sM5iO#l<V+0n$u4MMY!4QuKY%#YcVr{vFuF
zG0%f9rP~=6G@VUNvw(<)x1mf2*k1bdQ=;2UJ3(efD-h(88*|^8ot<~Qy%Caf@G>`_
zhZ`7!u&j@z;CmNAG@z(`6{vPyqC^Mn+z?0!C<zF4APQ~m>?S>Vde@*%?dVyV=4VWB
zU;hSJu~^raoSa-lMC9YgkDGZG!>zry05SP^n-275Xr4fBlYPZt`Q%A{ZZ4D0H9^6l
zfdTf>p=w@5RaI4ps!yNp22yf@LXfRru@4de@J`QK<8InNEZh8^B-_-~BnynTni`Z=
z5cPi!4(eCByMO`$6Xtoe)eprXaCGW@jjPU3L<}e3k0C&$Z~|K3%$YN|c!V}iPG~kZ
z8(UjiUPB2Bi;R~2Q$F~psGP@ER>bGdVXuco0az5aojkpBC;coEsw5OO%`m{hNG|Qk
zm6b}%p+Yf_eV`3rA0$3{{5ZF$$eP-2{zO(L@Gt5mm#dXGc+#)b;KC_n*f(XacjYjS
z6|h%;!Ui1U0kC~^l6&sLOcmh>DKGO`;)`0vHdv7YctvY#YjMMBZ<x4^`HxV<JKNh^
zXzH)Y%7m*%ngWr#hne2&>gqZ=*ilIC-raqg)%HQ^CG5z0W0;EdVA`wKdOnl)Bc>nU
zT#me|*3W^M=$?9h-jIoK#4IFWy%ZBzf+rGSxPF0-4(bO-M}dUghwbmGPL5Wg@cHs(
zIYLw4ya;n~3<cW;sBL+6QM+GAEqTW;|K$ZJn!FU1@!rbP^5|f->b|_ay*)nE8^jDE
z#p&sRs{5@xRX+y?(lVfW;S`Lv20lpbh}@53@hmBeB9|nqjRBhSKoKOGiFYQ7YRX(3
zp4v?YOpp2-f~cE<X_KP6dwTK#EdeQ^Dxabl1JrmV4BcAEAwQ|0)v$kXFqG8}c6Kdo
zZJWP;kK1J%RE?sKUXY0WEOoRPtMq^p%FfP?<!-!)aXr$Cf8_5J2b5u1zzu!={5f5>
z_MYhxq820#1}S?j@7EbG7~FU?%WldZ8sQ+KX~OiP2ucH9A#9fWUpY0=;u<0lEO<$n
z-(JD{{A0eoIR#~jg)4>#LPYgx!|>MX@YPU$H9Epk!lR_{3o<>vr+5(v3d7U=boPlS
z)vcT8AwA;wV5SAtrp*p!gm)VMWKhWbcd2pHT3nrxfcL>d3zJ62WC)37#R+*6c?UAb
zm~Rqtf^{rE{7cWrd~-RA;H4^#YW+Q^ccGv_q6DAh(L9dVFQpk9_DV8B?^6gGutL00
zp(S_pO7$CSG%d&*<j#L2Z-Xm_@UB7q>K4=^6f=@g2nwDy3m*Akg=otk6F_(y!Eas?
z>-P#dCO1W>I=7+zbr0gCcJrio`N2`zGI}Cy;y8#oVo5aj;<~zg-5CZ=u@}6ZsS0Fx
z)xe`RXJ)hM_?+T?@k8b5gBg`5q1_9h>S)tUFHn7vl_`FUPt;hdR!g)CGN$kAj2{lR
z&uY9QU!xYf2{&FL5cJPpXHevqsj)QT1^dr)ho>_apJD_>$=$hMknqvGzbD>D-r-(T
zWEG;i%_v-f(I$tFHu}L5Kiracj8t>76ipZZ9skl&5;&QmAE})=BNKPn%T$FjUIZRu
z27!ul8n-Adxz&@*OoPBh+=n~R<xMp0Aa$HSMFnq!!R3GaE+G+-*4y{llSS}8hCO}`
zS0|DDBl<=4Av1yow5@mJ_7{b4RHAB(V5YJ1-#MDD=N+}{o3+nihDlj`FkZE@{0<cT
zmb}APu3_*0bnUPdn()yxC!@D2&AcZ_1m1&C6m{kNb7j;5|G8+d(+JV4Nv{duI)eVC
z!Nf3*68(xIziI_FdCyDhH4@+&A`%Hc)7lwH5cnWeqRgvd_!22UQ`k);k)B4XL<Q8q
ztvSSee~F>#!g(guW15b=NStvvidt;2y4di8n!PtXO;=mAB=$DeY9-Sio`DfcR7^x^
zmXWX%i=_i^_4Yd<cD>!eAu4&gD~ChzBDM8>f$$a#6fdVFNeM!c<Rkj(r}c+ou)3lt
zCp=fC-kpv!cA#&ZyFjSd=W8GGo1l8rFr1*8m$%Q9xb#p#9cCq(0dzk+I8}byA?-bC
z!(+1QYd{zBUY6El2^KFIBzg-oWB3UucN!Whc>$MF-7A#vxVKLO9Y108LG6CBNMPCz
zK8{Rpl1mSOEA+t$3ud`fXWlzcLpj5E$_EdQ^S-peZ&ph179RT2Y3wm)RHEkRYi|lP
zBWPUdy_JDbB)urD_gOZmP7MZ|R~35<QiVD-iC?Z;UK0lIuVdJx^?qv!Ei=FqccJ07
zYkgA*PUFDcjDSx_qKnk=8Dav@-5U*}<|PNMcm^NrlBI`WQH?ZoaplEMWETSN=X>>K
zW*TZ3B{s?CGlq)rxi_^48U)A%%r8<26cJX{XRl&EwR>p+=l=6OSzb_o5y7y;c<;a|
zD1ctA)<P}dguOh)%X<a;D;oF}Bixk<+(&gWj0*2vSXRNX1rbRveN}7PVBUhUas<V*
zJGT*VMp9k^tdl9<FX6#y(bl%M@Nd8yJ^^NHIk&d97LWL1>bkm$ipm0qnhOJvy9DRX
zftmuaXE?6!9c8+=is78ovzz2A&c^NrFO_e-oS3*bm+<069V9xo<jTrQpqT@;3F`n)
zYU}85RLR%HsCJ~Mr2()}1|}8t0EnQoBn%EVHeI8_yu$EIM|Et}-f1;jQO5%V1HC|n
z_Vo=84sv{!m6j%zYz(2(R8iq`S%09Zsma5WJvnJC*4o*bou2-<C7hi<rtQa%ywp^G
zFG~#OJt$Fh*5x%v_MP#fpe77E+1S|JzU`+!8uRU=7X;X@vm9!YR&+>GAw}UEm-ZbF
zcWqZFwm>Xd&Ml_E!jiw~my~$`1_Uh!>(wV`XPeC8KzvP4Z|UxSs}RF$R6E@oRkExQ
zg;siZ?M}aS%M;pGb@Jd)8`ev_H*w;g6DJWiNn3;H0a%7D8OY!=n~CSfRL)e=e<;5w
zV{`L?zP?7Yfx*Gi68ol(j!@OXuC7Z|K_!_pGY>gAIgc*~HcYm($XlKN^5H{GLql?5
zp~l$i4=z|>T~rgEOjD0fVXs0?9OMa9%XI+(GD%k;oCXKeqZ{IIfJO%Ld+6uSd-B+_
zAlpE^A#-8j@f$g5_9IYW!8R9A8!!d-4=$iVOWbOKUW|x{z@Yn2gaz!8Rf)njJk;Lo
zNyXU;Jn=3wF+tQkRFssWN1H!52ta$Z1wj;RvU!Ep`s#hxOuKJv%nP&!pVv@xbS8)!
zjG*_omvs#cIxYMA`h<jp9&ZpyG##40oy#U1xyFkF{)*~)6|TG4ZvRcy4OF-lwcr3l
z_ID}`GYP^YR15F^xD5(GY6e8@$iwQhySs}ibFw_#UGsSjU>#f|bK@QotoOJOcyX79
z@0?Zimq<yh6QLr0qjK;o?5@>t@tfDLC6IUI<bMDD-Sst-nubav5fR~YKo;DJ>u^p;
zQFfe-HhX4fCNVKFyK+B}l;3hNAE-wyZEf08l`a(QtWX<qFI!7*SnKnbF0xHU#Kv;M
zTrpn9JAIm_^kx?&vZ^h{M%>-j=+7ZHE^;DJ)rUzXHOm`_hc72j{Y2n+)BSEIf-Pw8
zlS&}*===!-AL8L#2y4;o(t3#Jy#uFsxd=ZidNW$VhHj(&2s<~?3Zcjs*Dd04{mwW|
z<5-u{y;Bf8wCg0(5REc*hs;Q<m(jj|McWf$$hBLgU9W!|djPG<PDz{iRbmxtM6_Rh
zy|k4HU|By)d=mKGfC{xHL=Hq3{h$568Cd0#K>&`!E>rAPv9?3R5m0J|p~c1Wbzk(r
zwTQ?Ek;OY^(mF;nDkzlzA%RstqXpoeXZ&<oHd7L;T-;=LRvA|&$YSC=lyf9(*Q~=>
zxFh7vM7Mf2etfRb)6r2z1_TZ!W=Rrh`@9AlAx)zf&}bJf{2+U`V|*Tay0WI*ddPBw
zV(0qwP$W7|UBhXv`HkcE@3H6e^xgSvp`ZqGFCs$rVaLUt$)FPj<hQm%9X<66xy8e_
zQ-1U}eiOCkj+lR)sh~LnVfmr-#yaUjF7NOeL+S06c1Pz|OJm~0y#h=ETfA7&10^C-
z^PNwPCAQ*mZ&k5zhGx}8s_QCfv&995?G;NU<Quu?C7EMh+4KS}FN|owVArot5D<VL
z;4gRCXLpZVHS2w6dTOzti(O`hg-?{G13WQCJ-oZE?f#uR->Ik+!9&SGmxN(O`4}Dc
zXAVp+iCFCZ-n(+e^xaM^@9|%(>ZZL<86kL1NuMY1y%YTd=jXDxbwe|C1*<Zb?%k@<
zuo7AY0x{ufZRN+w-yw8o8AKla3f$WxnjaY&9Jtvw=4CG5vgq^r@bFb}=Kn%m-qz^T
zkp%9))Nb0n?;k8^R(cS%m-&+?7X+<-Zgk#lZWBq)<!f;Sl88)G?P6%KyVZR6t81&i
zq}_iJsadZq1@WB+q`1Bzu~CQe9SJjWF22-P)1}=eo!054y$$im@Ni1%lgP;JoBxXg
z(cLK0G%vR!Q?D!~fAfCBppNbkT92c>m9wMy1}*L0Fcge1G~qMsn##zDT<JgF#+B*F
zNGeOq6ns=pj;`D0*Wr9~70=_|n5&v26|qM}Rqc=Zqrv*fvH0ZC4I{JuvaFR4;IET?
zWhb!YYjnsc)<zkSxwm~a*b5Y#BJTISvsjny$ypOUi5et(d`(xE`oT`ZTls^=CRrQy
zK(B&BCx=azNK<YuuG(6b(PEWkt-7|Dj9+$roz~4|tGB7nKT(oz>A83FmFYlZBM*DK
z$-q_clH#K*E!T0+R^GYu&6wsSfMP83i^uC&-A}_bM2_T=TwF8_vDM)_wJO0yr(q)@
z4$m~a)tiyun<Q$S`#YBg=Em;-G%Ge_VM;uge!56D=a|e^l*gld4u97Xp)(4%Ys8P&
z%)t`bn%nfsYp3lhKRV7-d%9&WGk`+&$=LB3tX^_>hTuB6WaZwBI1D2<cM4m3(lzU~
z$=RLNliMYH3k$<}vzL<{4z_t3U+wgKrDlE(qV3=mx&romu!`}d2pAs0m)jXv#&7K7
zh8b=$H*ZZ(PmhZ;D=Cw0c@T=p$<H^1g1q$``_j?QRp(WGWn>KR1Q8mlDRpX|<L)Bs
zIf}bJOQRl4SM7;V4}QtL`XF_Zg}Ip!5ns79USs_rci`K%vxQGwUXZTOrx-NU`)n@l
z&Hi|A;AYvFV=~6VTGf}u$FX?X=kRdDk~QTki2kmNeOg3rd`z_!S8<&~urYq_xnEKs
zu9dva^$_|x-os_>&(F&2GlY4l$15<RSO+*M+DbxUx<N~d3PE$PiJF?S7+p^GtSJt{
zodg9yOcK`b^+=JWxy0ws8FzJy74bln@osv$<e^twK!C_^-JImc4vdhbeUC5QLI^du
zLN)<XA{_i@iqAoW^?nFvN=*9t05CQwwYS&=I56i<ubc~^TR7#@_`oyuQ7r^GiIfSm
zU=~Emw{W)j76{3>g{QAogT33~Ok~Pg#N2rZT3s@L?EjqpZn2l+t~54}kX?FzzNR+q
z*@_g;0#~rzDeo*m>PEE@<kgqpq~62;^blb_)fEKT|8<}i$cZuRp!&n@&EY~Q4|`T!
zVFACIBW=yC^CPl|+Qrt`gM&`#49j?&AbVd1>IbXb*^F0%yr0fRMMZVpW?Z5nq)A>$
ziJOhBxwCVu+$GNr4aH3zT-BS@E+!ll?r%dwWnL%83=9l_)&jLJWWD<rR(#guu6;)T
z4`2Tq=Ic}R&*9;6uoMDiLz}MdLz<(70SKq5+27Um6$ETBGDI}w=H)5K%byp#mXVgW
zhqYJ%A81tTgH`^jybMYR;X!zHktK>P>wvh>dO8{!PQRMp%*{P&;3Cp&Z)<A{UH!-$
zr9S?bpkAyuDZE;qXIO(XT}xO8dgN1ASKxaT<3$E~dwW}3Gm49&c@p1O!g>YT3TV=@
z(o!hw$t81hbMZ(RmVkwxnJENUM?|*j<*3%h#YIzoS`}n=NyvYhS$Byd)YsZse1M5%
zWn=SKAR#91Xl}meqDAURd(N*|g0t&QY3R9#*F!8?V;(yrfRX^ouCK2@;HOQ15mQF4
zZEb<QYiDQ28F(b{(7<C+=5cUxp3Hh3%W_13g<%N@l39H@q;}yGZ6Nr7JE~27GF)ui
z8p%Dp4P?)KRn^S{s$TLZFIArW#4<29?PtDnWeh{W2NulUeggzl&=lB{HM1~l+uJkt
z5kF)@E=0t{++l|+ufmNdt6e6Kh>TQ~w;m~_JbzxAU0pNwV|LZCPEOpy^&a&Gfml@`
zquSG1_f_P1^h&{p_KBE*s*B{Jeb+gMPiTsjXLWa$b6FGI0l>_4p&F#yHI?MeL0ksg
zFIzIq;LgUzRGxCYh_<@Ask!;LWQT>^^t;cOdEM*aK`SaM78e#$)BDIJfjX6AUmhtF
zWF%aB8Atl@{b*mG6No&(QI~^`h4BSGC!XI_9^5`VV_u!PnWcmE#(YKJ`})A<Gcz?M
zB}{6UhGnqj(<&;CKq@I-2I4h9y1RxM*VQ|TNatB-4}C2?Lw%QNR1Q~cL_~qp@*t?s
zVsC`wnck%4<h)UUIQGZ>_kXnTdI<qT26jZ}9cR$*gMt)*(v2TWY^g;3B(4+W5)>5V
z<-NzZIGf<baP85(GGnmt0UKA8lk)*<fG;wr^2B5n6gZY`(q4Tim)!mO_3K+N@W3fx
z%fs^*4Gs%_ba>buN)fCT>1}DLkX03!sembkItqiUqoV^<YJ+-%V8GD5e%|A+x>{QK
zg@y1ox#WN0_SNy4Q+jnD@V-dME)Wm5nyP|StsPnL^(&HqpbQ|A-Kl?gj0u9o52OI#
zCRmx8CTlGLZ3{O(Tqt+>@uNpw>uygku3W!lQclZu>5}(JmK3nx>uZr811MOn#wz1T
z?KbCB8p<lefBd%}skxyqyc;Fu2OM5|tRVOw=0VB7@OaA9%#4Il>^-Tmk&!Lb2;dM)
zwKy@!SO8m-hlgm9p04iV+}!R@6UiKr3jJ|@{7Xn72AM@6RFTqGV4Fi3M1e?j-{lq5
zt)B{=?MZ`T^gesCZ0N;_m92@~Uv@4M5{M{As3)E5Lj&nTLqlQ6hPOf4k9S>Q*Q;We
z!CXCmGKN<0R=civ^Ud87&!f`p>})lTt+lm1@TOon(SLdpouGIGUmUzTMK%Zp^D?up
z=V)<J1uZWv`4Q9agF34!Z(?i=MxUaG?H8uQIxJH&0=)>Z)lX;VY$1G_j-0%^J?Zq|
z^Ev|T5>%=^T6mFds%JCbovf+vG7WJDW)~tL*07P#K;QXKAJ+ey)jB!tiexhowvjvr
zVxEUjC7Z!B0UICdr(K*KVHdoe6P8#<GYtFF4#YtppVN|Zl9JC~zI^GoB^y3LxPT<)
zdPK0VDu}=Hd!pyueL<cKz0c@URa(zyw}4SUd*+PCR<EYdYx5tU<8Ih~9Ld}?nYg@w
z6Pk`@>+riuSa(EN!VKiR*wN<w>A_O_P}TeQfr14yoWr~-c;liLzZ24@9r(DNwsrDN
zJBaE<KkBDdJEow&jRaF%NrDteIj2vbcKCqzUiM2JsyB_N>Tn$@aC!r3o#}ZjD_&T*
zqJs;PAowysAW}fa2stjm`lP>ju~Z}C;hfya%c0p1_OL0oKt!UZr1StS3nVdD|DtBE
z)!_vl^xS<=Q@}9``q$5_2Hn#H$&cyKVM5?s&;LtJVP|=))fcU+^|Q0{ZVnBqzOnIk
z$?tsgAC<e41d_;P2ap8%v-IwlT(mtKb!p|&;d_}Pho=czJIE4CLoJR2JfUFrnt>jw
zi+AGWL5NXMu!xdlD9W@gGgfQYX*${OuYxEo%YM}9bzGO6nt4yx;>tSel$fETY_Wm&
z?`gswzAVR*L<<|qGLoiyDNx^ntpu%K{?khNwNW$}00O0%h!!t#P)$K5S{cdu4V?W;
zB09*cg|OaOSyKc@pGukfju>#hq3fH}l~Er_c~<#}@(<uaP^x*Z;3AvAlg6U-?$bI0
z7y9*N->qMoBpRB*NtmBCHAX$DDtmi-30}uHi`wE_&XtvDFdesS;zM_dw}c8;_#jbn
z_`={DX4%ho6S6*dm-fC;KQ31>oq*aIB>&a<l!TR`qU=(BJ+0?jZ;V+d4hWAHxg+Kj
z2APJZ{Ot)B42{1JkN<KyMf^@#MII~aU^OjkuLIpOuH$A4t+Q(oDXofrwu8$nf&fgd
zqI<u>fUF=PAh@sjfvR8LeMv{8OQ}{g^hQ%6Fj!Z8Hip=5U}mI(EUp+I(d*R#ZlXCA
z*uacX3-I>`h!TZ$QI~`4Eh18GvBmaM!#_V?x%fLLlf}KWNtlNOW+luv;cZGgQI}X2
z%7{wCsDKw{(~6|O{v>+lykoKT$p|fO7cXf$_;Il=Qt%+-o+TD>S^v}mG0O;kRvUhr
z+0)bW{Q2|4!^2RXVZw*RCVGgL(yG&ZliWw7E8nkWT#W<z1h|XX*w!l3>GMRT;!{}@
z1>^yrva&)+CD{Q>`3DAK#l)5ifCjj@x%Y_L-Ih9}ICxu3XKb<rs%xGBYnaSPGfjS)
znmP(Z4GZOorIE7!k&y~OT3K0HU<q5c0~a?KSd&$uU4V#$BpcpNPk+a68mP#!vAM~`
z!J(>+dqQ|F;%?aZx9N3AgfWV@&)@DTCd%@&ooZa8<H%5Tul99fR6X_Z3_O9W_fv&~
z(&EPzEBGarLLUz!Bkn_c$KPN=iZS2+mG3`sW$pZ5+PhyGR(n734q6fUBxyRvTSsg%
zW78Nh5iLQTx_Es~S%-C)rjKxHF;v9l7CI_H+^Z5G8bC6)LTZ(0E%32ZQc{u!_>ihX
zT9}-y&0PZ9DtN%zl8K0jjB~W4h&U2hYVLBi{9VNk?99AZ@?qr;^&u|0bmR3oMJ}AP
ztQGVZN#}6dI2MRls6rI~ZhN!KvU6vNYUSoS7HKs#HGO9>9?x=%-Bh~}$U42Ozf@?i
zgJnT6@R-Ty3HPcuh>w4aB}qeE(uzOMwt41*mMBlYi!2FlOS_*!PC<c-iwjLa0jj~2
zG&IFVb$IA*ohnZc8=J3HRVN*B!uTlArsLs3{Vr%ls_#5Kr|;yn{d=Mg9|dR|TC4!N
z1(!OB6{cH>eZukHn6(iFz)LDN(y8b4=Jn8L<`!%1n^$h$)Mg0_0ihi_0GMwF`-g-~
z2a!pFz)np?H3Q?bv?Ky;8qi9jTVxdiXaZpQj~^Sgz61-8X>Qv60`F^<LDkCQB4>m=
zNQj_xYF1*0lZy(}Qz8(xn;5-5g*VpMZ!Y#*x4#pRZm+;Bq)(1DZ_fYN02lo-pfEol
zABS0qG=<X}Ml<x)ZDV2%v|`FzcZ!)`()3=l9C4951C>)mTM0?@hTBVYUFOGlXfGv{
z(uIK=SFw*Xsy{<s&4%0|p=4xY$!;Y{t7fBqWauYaLpa9&=!}@cmSV9il^K0cP1ET|
z4>jUyGDo={kv)X2FX(hNeB9>bN0t~%YCR9#1PI<+56K-TaPakB#G7E-Wvj12&^m{Z
z#MWtweF+v5(T{q3pPlPMZ?frOyL?$Xe3H;W%0Dv2dWowyWAuA`Ggux`yM{A>(16G@
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

diff --git a/doc/devel/uml/fig132357.png b/doc/devel/uml/fig132357.png
index 8f89db240858111252a9d5f3d9d92550d208a503..3d4abea3f19a33f7c885c03a8e232c625ab0fa6d 100644
GIT binary patch
literal 21611
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
Ph$1Y^Y)$Dnx5z&La^f?d

literal 25627
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
O2o(hl`65}fp#K1FaZ-{1

diff --git a/doc/devel/uml/fig132741.png b/doc/devel/uml/fig132741.png
index da739593c1a3633935d064e6d1e1ab7ffa366e4d..f8d66640c985c539044c6091df5cc6b07f22c2c0 100644
GIT binary patch
literal 22552
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

literal 25229
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

diff --git a/doc/devel/uml/fig132869.png b/doc/devel/uml/fig132869.png
index 5935bc63c86672bee9da2ce067594897ddd97f40..577464de423eb1e490910c9cd0e8378e9e600f80 100644
GIT binary patch
literal 11353
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
P!w_i+1@Qvdd(Zy?-=h9}

literal 13284
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


From 8e46819c090ff286acb8e9a0ff53a3d1019de4a8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 19:45:47 +0200
Subject: [PATCH 091/368] UML: export actual Version as HTML report

---
 doc/devel/uml/class128005.html   |   7 +-
 doc/devel/uml/class128133.html   |   3 +-
 doc/devel/uml/class128138.html   |   2 +-
 doc/devel/uml/class128181.html   |   8 +-
 doc/devel/uml/class128225.html   |   2 +-
 doc/devel/uml/class128261.html   |   7 +-
 doc/devel/uml/class128266.html   |   2 +-
 doc/devel/uml/class128309.html   |   5 +-
 doc/devel/uml/class128389.html   |   3 +-
 doc/devel/uml/class128394.html   |   2 +-
 doc/devel/uml/class128437.html   |   6 +-
 doc/devel/uml/class128517.html   |   5 +-
 doc/devel/uml/class128645.html   |  13 +-
 doc/devel/uml/class128821.html   |   2 +-
 doc/devel/uml/class128901.html   |   2 +-
 doc/devel/uml/class128906.html   |   1 +
 doc/devel/uml/class128949.html   |   3 +-
 doc/devel/uml/class129029.html   |   2 +-
 doc/devel/uml/class129333.html   |   6 +-
 doc/devel/uml/class129413.html   |   4 +-
 doc/devel/uml/class129541.html   |   6 +-
 doc/devel/uml/class129797.html   |   3 +-
 doc/devel/uml/class129925.html   |   2 +-
 doc/devel/uml/class130309.html   |   3 +-
 doc/devel/uml/class130437.html   |   4 +-
 doc/devel/uml/class130565.html   |   5 +-
 doc/devel/uml/class130821.html   |   4 +-
 doc/devel/uml/class130949.html   |   2 +-
 doc/devel/uml/class131077.html   |   2 +-
 doc/devel/uml/class131333.html   |   7 +-
 doc/devel/uml/class131461.html   |  15 +--
 doc/devel/uml/class131589.html   |   2 +-
 doc/devel/uml/class131717.html   |  16 ++-
 doc/devel/uml/class132229.html   |   2 +-
 doc/devel/uml/class132485.html   |   2 +-
 doc/devel/uml/class132741.html   |   6 +-
 doc/devel/uml/class133253.html   |   5 +-
 doc/devel/uml/class133765.html   |   2 +-
 doc/devel/uml/class133893.html   |   3 +-
 doc/devel/uml/class134021.html   |   3 +-
 doc/devel/uml/class134149.html   |   7 +-
 doc/devel/uml/class134277.html   |   7 +-
 doc/devel/uml/class134405.html   |   4 +-
 doc/devel/uml/class134533.html   |   2 +-
 doc/devel/uml/class134661.html   |   5 +-
 doc/devel/uml/class134789.html   |   2 +-
 doc/devel/uml/class134917.html   |   2 +-
 doc/devel/uml/class135173.html   |   7 +-
 doc/devel/uml/class135301.html   |   2 +-
 doc/devel/uml/class135429.html   |   9 +-
 doc/devel/uml/class135557.html   |   5 +-
 doc/devel/uml/class136325.html   |   3 +-
 doc/devel/uml/class136453.html   |  29 ++---
 doc/devel/uml/class136581.html   |  13 +-
 doc/devel/uml/class136709.html   |   8 +-
 doc/devel/uml/class136837.html   |   4 +-
 doc/devel/uml/class136965.html   |   4 +-
 doc/devel/uml/class137093.html   |   4 +-
 doc/devel/uml/class137221.html   |   2 +-
 doc/devel/uml/class137349.html   |   4 +-
 doc/devel/uml/class137477.html   |   4 +-
 doc/devel/uml/class137605.html   |   2 +-
 doc/devel/uml/class137733.html   |   2 +-
 doc/devel/uml/class137861.html   |   2 +-
 doc/devel/uml/class137989.html   |   2 +-
 doc/devel/uml/class138117.html   |   2 +-
 doc/devel/uml/class138245.html   |   2 +-
 doc/devel/uml/class138373.html   |   2 +-
 doc/devel/uml/class138501.html   |   5 +-
 doc/devel/uml/class138629.html   |   2 +-
 doc/devel/uml/class138757.html   |   5 +-
 doc/devel/uml/class138885.html   |   2 +-
 doc/devel/uml/class139013.html   |   4 +-
 doc/devel/uml/class139141.html   |   5 +-
 doc/devel/uml/class139397.html   |   2 +-
 doc/devel/uml/class139525.html   |   3 +-
 doc/devel/uml/class139653.html   |  10 +-
 doc/devel/uml/class139781.html   |   8 +-
 doc/devel/uml/class139909.html   |   6 +-
 doc/devel/uml/class140421.html   |   2 +-
 doc/devel/uml/class140549.html   |   5 +-
 doc/devel/uml/class140677.html   |   1 +
 doc/devel/uml/class140805.html   |   1 +
 doc/devel/uml/class141701.html   |   3 +-
 doc/devel/uml/class141829.html   |   3 +-
 doc/devel/uml/class142469.html   |   3 +-
 doc/devel/uml/class143365.html   |   3 +-
 doc/devel/uml/class144005.html   |   3 +-
 doc/devel/uml/class145285.html   |   3 +-
 doc/devel/uml/class145541.html   |   8 +-
 doc/devel/uml/class145669.html   |   4 +-
 doc/devel/uml/class145925.html   |   3 +-
 doc/devel/uml/class146053.html   |   3 +-
 doc/devel/uml/class146309.html   |   5 +-
 doc/devel/uml/class146565.html   |   1 +
 doc/devel/uml/class146693.html   |   5 +-
 doc/devel/uml/class146821.html   |   5 +-
 doc/devel/uml/class147077.html   |   5 +-
 doc/devel/uml/class147333.html   |  24 ++++
 doc/devel/uml/classdiagrams.html |   3 +-
 doc/devel/uml/classes.html       |   3 +-
 doc/devel/uml/classes_list.html  |   3 +-
 doc/devel/uml/fig128181.png      | Bin 39718 -> 35072 bytes
 doc/devel/uml/fig129541.png      | Bin 12086 -> 11432 bytes
 doc/devel/uml/fig129797.png      | Bin 18260 -> 16746 bytes
 doc/devel/uml/fig130181.png      | Bin 10701 -> 9234 bytes
 doc/devel/uml/fig130693.png      | Bin 12650 -> 11090 bytes
 doc/devel/uml/fig130821.png      | Bin 14498 -> 13295 bytes
 doc/devel/uml/fig130949.png      | Bin 7478 -> 6705 bytes
 doc/devel/uml/fig131589.png      | Bin 12406 -> 10449 bytes
 doc/devel/uml/fig132485.png      | Bin 6985 -> 6196 bytes
 doc/devel/uml/fig132868.png      | Bin 0 -> 30757 bytes
 doc/devel/uml/index.html         | 208 ++++++++++++++++++++++++-------
 doc/devel/uml/index_60.html      |   2 +-
 doc/devel/uml/index_65.html      |   2 +-
 doc/devel/uml/index_66.html      |   3 +-
 doc/devel/uml/index_67.html      |  38 +++---
 doc/devel/uml/index_69.html      |   3 +-
 doc/devel/uml/index_70.html      |   2 +-
 doc/devel/uml/index_71.html      |   1 +
 doc/devel/uml/index_73.html      |   2 +-
 doc/devel/uml/index_77.html      |   2 +-
 doc/devel/uml/index_79.html      |   3 +-
 doc/devel/uml/index_80.html      |   4 +-
 doc/devel/uml/index_82.html      |   4 +-
 doc/devel/uml/index_83.html      |   3 +-
 doc/devel/uml/index_84.html      |   5 +-
 doc/devel/uml/index_86.html      |  24 ++--
 doc/devel/uml/style.css          |   2 +-
 129 files changed, 495 insertions(+), 284 deletions(-)
 create mode 100644 doc/devel/uml/class147333.html
 create mode 100644 doc/devel/uml/fig132868.png

diff --git a/doc/devel/uml/class128005.html b/doc/devel/uml/class128005.html
index d033a8de1..646e844c8 100644
--- a/doc/devel/uml/class128005.html
+++ b/doc/devel/uml/class128005.html
@@ -16,11 +16,12 @@
 <!-- ============================================================= -->
 
 <a name="refclass128005"></a>
-<p>Declaration :</p><ul><li>C++ : class SessionImpl : public <a href="class139653.html#refclass139653"><b>Session</b></a> </li></ul><p>Implementation class for the Session interface<br /></p><p>Artifact : <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><div class="sub">
+<p>Implementation class for the Session interface<br /></p><p>Declaration :</p><ul><li>C++ : class SessionImpl : public <a href="class139653.html#refclass139653"><b>Session</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><div class="sub">
 <a name="refrelation128005"></a>
-<table><tr><td><div class="element">Relation <b>edls (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # edls : <a href="class128133.html#refclass128133"><b>Seq</b></a>, multiplicity : 1..*</li><li>C++ : protected: &lt;<a href="class128133.html#refclass128133"><b>Seq</b></a>&gt; edls</li></ul><a name="refrelation128261"></a>
+<table><tr><td><div class="element">Relation <b>edls (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # edls : <a href="class128133.html#refclass128133"><b>Seq</b></a>, multiplicity : 1..*</li><li>C++ : protected: &lt;<a href="class128133.html#refclass128133"><b>Seq</b></a>&gt; edls</li></ul><a name="refrelation128261"></a>
 <table><tr><td><div class="element">Relation <b>theFixture (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # theFixture : <a href="class128261.html#refclass128261"><b>Fixture</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class128261.html#refclass128261"><b>Fixture</b></a> * theFixture</li></ul><a name="refrelation147717"></a>
-<table><tr><td><div class="element">Relation <b>pipes (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # pipes : <a href="class138117.html#refclass138117"><b>Pipe</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class138117.html#refclass138117"><b>Pipe</b></a>* pipes</li></ul><p>the global ports (busses) of the session<br /></p></div>
+<table><tr><td><div class="element">Relation <b>pipes (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>the global ports (busses) of the session<br /></p><p>Declaration :</p><ul><li>Uml : # pipes : <a href="class138117.html#refclass138117"><b>Pipe</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class138117.html#refclass138117"><b>Pipe</b></a>* pipes</li></ul><p>Stereotype: vector</p>
+</div>
 <p>All public operations : <a href="class139653.html#refoperation133509"><b>currEDL</b></a> , <a href="class139653.html#refoperation133637"><b>getFixture</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128133.html b/doc/devel/uml/class128133.html
index 175eb30d6..118140660 100644
--- a/doc/devel/uml/class128133.html
+++ b/doc/devel/uml/class128133.html
@@ -19,7 +19,8 @@
 <p>Declaration :</p><ul><li>C++ : class Seq </li></ul><p>Directly inherited by : <a href="class128261.html#refclass128261"><b>Fixture</b></a> </p>
 <p>Artifact : <a href="index.html#refartifact128645"><b>edl</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><div class="sub">
 <a name="refrelation128901"></a>
-<table><tr><td><div class="element">Relation <b>clips (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # clips : <a href="class128517.html#refclass128517"><b>MObject</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class128517.html#refclass128517"><b>MObject</b></a> *&gt; clips</li></ul><a name="refrelation147333"></a>
+<table><tr><td><div class="element">Relation <b>clips (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # clips : <a href="class128517.html#refclass128517"><b>MObject</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class128517.html#refclass128517"><b>MObject</b></a> *&gt; clips</li></ul><p>Stereotype: list</p>
+<a name="refrelation147333"></a>
 <table><tr><td><div class="element">Relation <b>track (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # track : <a href="class128389.html#refclass128389"><b>Track</b></a></li><li>C++ : protected: <a href="class128389.html#refclass128389"><b>Track</b></a>* track</li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class128138.html b/doc/devel/uml/class128138.html
index 6cbff1e37..6f3344e8e 100644
--- a/doc/devel/uml/class128138.html
+++ b/doc/devel/uml/class128138.html
@@ -16,5 +16,5 @@
 <!-- ============================================================= -->
 
 <a name="refclass128138"></a>
-<p>Declaration :</p><ul><li>C++ : class Thread </li></ul><p>We can basically reuse the Thread class design from Cinelerra2, Thread becomes a baseclass for all Threads <br /></p></body>
+<p>We can basically reuse the Thread class design from Cinelerra2, Thread becomes a baseclass for all Threads <br /></p><p>Declaration :</p><ul><li>C++ : class Thread </li></ul></body>
 </html>
diff --git a/doc/devel/uml/class128181.html b/doc/devel/uml/class128181.html
index 0a87b01fd..7743c8f03 100644
--- a/doc/devel/uml/class128181.html
+++ b/doc/devel/uml/class128181.html
@@ -18,10 +18,10 @@
 <a name="refclass128181"></a>
 <p>Declaration :</p><ul><li>C++ : class File </li></ul><div class="sub">
 <a name="refrelation128437"></a>
-<table><tr><td><div class="element">Relation <b>descriptor (descriptor)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # descriptor : <a href="class128693.html#refclass128693"><b>FileHandle</b></a></li><li>C++ : protected: <a href="class128693.html#refclass128693"><b>FileHandle</b></a> * descriptor</li></ul><p>type of this frame<br /></p><a name="refoperation128181"></a>
-<table><tr><td><div class="element">Operation <b>getFrame</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getFrame(in  : <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a>, in frame_address : , in mode : ) : <a href="class128821.html#refclass128821"><b>Frame</b></a></li><li>C++ : public: <a href="class128821.html#refclass128821"><b>Frame</b></a> getFrame()</li></ul><p>mode = READ, WRITE, ...<br /></p><a name="refrelation128225"></a>
-<table><tr><td><div class="element">Relation <b>handle (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # handle : <a href="class128693.html#refclass128693"><b>FileHandle</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class128693.html#refclass128693"><b>FileHandle</b></a> * handle</li></ul><p>weak pointer<br /></p><a name="refrelation128609"></a>
-<table><tr><td><div class="element">Relation <b>mappings (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # mappings : <a href="class128565.html#refclass128565"><b>FileMap</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class128565.html#refclass128565"><b>FileMap</b></a> * mappings</li></ul><p>weak pointers<br /></p><a name="refrelation129162"></a>
+<table><tr><td><div class="element">Relation <b>descriptor (descriptor)</b></div></td></tr></table><p>type of this frame<br /></p><p>Declaration :</p><ul><li>Uml : # descriptor : <a href="class128693.html#refclass128693"><b>FileHandle</b></a></li><li>C++ : protected: <a href="class128693.html#refclass128693"><b>FileHandle</b></a> * descriptor</li></ul><a name="refoperation128181"></a>
+<table><tr><td><div class="element">Operation <b>getFrame</b></div></td></tr></table><p>mode = READ, WRITE, ...<br /></p><p>Declaration :</p><ul><li>Uml : + getFrame(in  : <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a>, in frame_address : , in mode : ) : <a href="class128821.html#refclass128821"><b>Frame</b></a></li><li>C++ : public: <a href="class128821.html#refclass128821"><b>Frame</b></a> getFrame()</li></ul><a name="refrelation128225"></a>
+<table><tr><td><div class="element">Relation <b>handle (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>weak pointer<br /></p><p>Declaration :</p><ul><li>Uml : # handle : <a href="class128693.html#refclass128693"><b>FileHandle</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class128693.html#refclass128693"><b>FileHandle</b></a> * handle</li></ul><a name="refrelation128609"></a>
+<table><tr><td><div class="element">Relation <b>mappings (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>weak pointers<br /></p><p>Declaration :</p><ul><li>Uml : # mappings : <a href="class128565.html#refclass128565"><b>FileMap</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class128565.html#refclass128565"><b>FileMap</b></a> * mappings</li></ul><a name="refrelation129162"></a>
 <table><tr><td><div class="element">Relation <b>&lt;aggregation&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class129333.html#refclass129333"><b>FileProvider</b></a></li><li>C++ : protected: <a href="class129333.html#refclass129333"><b>FileProvider</b></a> * </li></ul></div>
 <p>All public operations : <a href="class128181.html#refoperation128181"><b>getFrame</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class128225.html b/doc/devel/uml/class128225.html
index 0b6e60921..0d48fbf93 100644
--- a/doc/devel/uml/class128225.html
+++ b/doc/devel/uml/class128225.html
@@ -18,6 +18,6 @@
 <a name="refclass128225"></a>
 <p>Declaration :</p><ul><li>C++ : class FrameReference : public <a href="class128906.html#refclass128906"><b>SmartPointer</b></a> </li></ul><div class="sub">
 <a name="refrelation129761"></a>
-<table><tr><td><div class="element">Relation <b>frame (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # frame : <a href="class128821.html#refclass128821"><b>Frame</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class128821.html#refclass128821"><b>Frame</b></a> * frame</li></ul><p>maybe weak reference<br /></p></div>
+<table><tr><td><div class="element">Relation <b>frame (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>maybe weak reference<br /></p><p>Declaration :</p><ul><li>Uml : # frame : <a href="class128821.html#refclass128821"><b>Frame</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class128821.html#refclass128821"><b>Frame</b></a> * frame</li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class128261.html b/doc/devel/uml/class128261.html
index f02717863..e506f8250 100644
--- a/doc/devel/uml/class128261.html
+++ b/doc/devel/uml/class128261.html
@@ -18,10 +18,13 @@
 <a name="refclass128261"></a>
 <p>Declaration :</p><ul><li>C++ : class Fixture : public <a href="class128133.html#refclass128133"><b>Seq</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact128773"><b>fixture</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><div class="sub">
 <a name="refrelation131717"></a>
-<table><tr><td><div class="element">Relation <b>effectiveTimeline (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # effectiveTimeline : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a> effectiveTimeline</li></ul><a name="refoperation128645"></a>
+<table><tr><td><div class="element">Relation <b>effectiveTimeline (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # effectiveTimeline : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a> effectiveTimeline</li></ul><p>Stereotype: list</p>
+<a name="refoperation128645"></a>
 <table><tr><td><div class="element">Operation <b>getPlaylistForRender</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getPlaylistForRender() : list&lt;ExplicitPlacement   [ProcessingLayer::MObject]&gt;</li><li>C++ : public: list&lt;ExplicitPlacement   [ProcessingLayer::MObject]&gt; getPlaylistForRender () </li></ul><a name="refoperation129157"></a>
 <table><tr><td><div class="element">Operation <b>getAutomation</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getAutomation() : Auto   [ProcessingLayer::MObject]*</li><li>C++ : public: Auto   [ProcessingLayer::MObject]* getAutomation () </li></ul><a name="refrelation147589"></a>
-<table><tr><td><div class="element">Relation <b>track (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # track : <a href="class128389.html#refclass128389"><b>Track</b></a></li><li>C++ : protected: <a href="class128389.html#refclass128389"><b>Track</b></a>* track</li></ul></div>
+<table><tr><td><div class="element">Relation <b>track (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # track : <a href="class128389.html#refclass128389"><b>Track</b></a></li><li>C++ : protected: <a href="class128389.html#refclass128389"><b>Track</b></a>* track</li></ul><a name="refrelation163333"></a>
+<table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class147333.html#refclass147333"><b>Segmentation</b></a></li><li>C++ : protected: <a href="class147333.html#refclass147333"><b>Segmentation</b></a>* </li></ul><p>Stereotype: partitioning</p>
+</div>
 <p>All public operations : <a href="class128261.html#refoperation129157"><b>getAutomation</b></a> , <a href="class128261.html#refoperation128645"><b>getPlaylistForRender</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128266.html b/doc/devel/uml/class128266.html
index be0f14da2..5aa7dc687 100644
--- a/doc/devel/uml/class128266.html
+++ b/doc/devel/uml/class128266.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass128266"></a>
-<p>Declaration :</p><ul><li>C++ : class Condition </li></ul><p>I provided a reworked Condition class in my Cinelerra2 repository<br /></p><div class="sub">
+<p>I provided a reworked Condition class in my Cinelerra2 repository<br /></p><p>Declaration :</p><ul><li>C++ : class Condition </li></ul><div class="sub">
 <table><tr><td><div class="element">Class <b><a href="class128522.html#refclass128522"><b>Lock</b></a></b></div></td></tr></table>
 </div>
 </body>
diff --git a/doc/devel/uml/class128309.html b/doc/devel/uml/class128309.html
index 52ecd0c18..be692dbcb 100644
--- a/doc/devel/uml/class128309.html
+++ b/doc/devel/uml/class128309.html
@@ -18,8 +18,9 @@
 <a name="refclass128309"></a>
 <p>Declaration :</p><ul><li>C++ : class FileHandleCache </li></ul><div class="sub">
 <a name="refrelation128737"></a>
-<table><tr><td><div class="element">Relation <b>handles (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # handles : <a href="class128693.html#refclass128693"><b>FileHandle</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class128693.html#refclass128693"><b>FileHandle</b></a>&gt; handles</li></ul><a name="refattribute128225"></a>
+<table><tr><td><div class="element">Relation <b>handles (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # handles : <a href="class128693.html#refclass128693"><b>FileHandle</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class128693.html#refclass128693"><b>FileHandle</b></a>&gt; handles</li></ul><p>Stereotype: list</p>
+<a name="refattribute128225"></a>
 <table><tr><td><div class="element">Attribut <b>handles_available</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : - handles_available : int</li><li>C++ : private: int handles_available</li></ul><p>initialized to the maximum number of filehandles the backend may use for mapped files. When no handles are available, the handle which is last in the handles list is closed and (re-)used.<br />Else this number is decremented for each new filehandle used and incremented for any one explicitly freed.<br /></p></div>
+<p>initialized to the maximum number of filehandles the backend may use for mapped files. When no handles are available, the handle which is last in the handles list is closed and (re-)used.<br />Else this number is decremented for each new filehandle used and incremented for any one explicitly freed.<br /></p><p>Declaration :</p><ul><li>Uml : - handles_available : int</li><li>C++ : private: int handles_available</li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class128389.html b/doc/devel/uml/class128389.html
index 1adc7425d..16c19b700 100644
--- a/doc/devel/uml/class128389.html
+++ b/doc/devel/uml/class128389.html
@@ -18,7 +18,8 @@
 <a name="refclass128389"></a>
 <p>Declaration :</p><ul><li>C++ : class Track : public <a href="class129157.html#refclass129157"><b>Meta</b></a>, public <a href="class128517.html#refclass128517"><b>MObject</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact128901"><b>track</b></a>, Diagram : <a href="index.html#refclass diagram128133"><b>Session structure</b></a></p><div class="sub">
 <a name="refrelation147205"></a>
-<table><tr><td><div class="element">Relation <b>subTracks (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + subTracks : <a href="class128389.html#refclass128389"><b>Track</b></a>, multiplicity : *</li><li>C++ : public: <a href="class128389.html#refclass128389"><b>Track</b></a> subTracks</li></ul><p>Child tracks in a tree structure<br /></p></div>
+<table><tr><td><div class="element">Relation <b>subTracks (&lt;directional composition&gt;)</b></div></td></tr></table><p>Child tracks in a tree structure<br /></p><p>Declaration :</p><ul><li>Uml : + subTracks : <a href="class128389.html#refclass128389"><b>Track</b></a>, multiplicity : *</li><li>C++ : public: <a href="class128389.html#refclass128389"><b>Track</b></a> subTracks</li></ul><p>Stereotype: vector</p>
+</div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128394.html b/doc/devel/uml/class128394.html
index 7b7e1a826..ecd1cc4ae 100644
--- a/doc/devel/uml/class128394.html
+++ b/doc/devel/uml/class128394.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass128394"></a>
-<p>Declaration :</p><ul><li>C++ : class Mutex </li></ul><p>I provided a reworked Mutex class in my Cinelerra2 repository<br /></p><div class="sub">
+<p>I provided a reworked Mutex class in my Cinelerra2 repository<br /></p><p>Declaration :</p><ul><li>C++ : class Mutex </li></ul><div class="sub">
 <table><tr><td><div class="element">Class <b><a href="class128650.html#refclass128650"><b>Lock</b></a></b></div></td></tr></table>
 </div>
 </body>
diff --git a/doc/devel/uml/class128437.html b/doc/devel/uml/class128437.html
index 4e790db31..5c53683d2 100644
--- a/doc/devel/uml/class128437.html
+++ b/doc/devel/uml/class128437.html
@@ -19,7 +19,9 @@
 <p>Declaration :</p><ul><li>C++ : class FileMapCache </li></ul><div class="sub">
 <a name="refrelation129505"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class128821.html#refclass128821"><b>Frame</b></a></li><li>C++ : protected: <a href="class128821.html#refclass128821"><b>Frame</b></a> * </li></ul><a name="refrelation129633"></a>
-<table><tr><td><div class="element">Relation <b>checked_in (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # checked_in : <a href="class128565.html#refclass128565"><b>FileMap</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class128565.html#refclass128565"><b>FileMap</b></a> checked_in</li></ul><p>checked_in objects are subject of cache aging and must be not in use<br /></p><a name="refrelation129290"></a>
-<table><tr><td><div class="element">Relation <b>checked_out (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # checked_out : <a href="class128565.html#refclass128565"><b>FileMap</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class128565.html#refclass128565"><b>FileMap</b></a>&gt; checked_out</li></ul><p>this list keeps all mappings which are in use, and thus prevents them from Cache aging<br /></p></div>
+<table><tr><td><div class="element">Relation <b>checked_in (&lt;directional composition&gt;)</b></div></td></tr></table><p>checked_in objects are subject of cache aging and must be not in use<br /></p><p>Declaration :</p><ul><li>Uml : # checked_in : <a href="class128565.html#refclass128565"><b>FileMap</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class128565.html#refclass128565"><b>FileMap</b></a> checked_in</li></ul><p>Stereotype: list</p>
+<a name="refrelation129290"></a>
+<table><tr><td><div class="element">Relation <b>checked_out (&lt;directional composition&gt;)</b></div></td></tr></table><p>this list keeps all mappings which are in use, and thus prevents them from Cache aging<br /></p><p>Declaration :</p><ul><li>Uml : # checked_out : <a href="class128565.html#refclass128565"><b>FileMap</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class128565.html#refclass128565"><b>FileMap</b></a>&gt; checked_out</li></ul><p>Stereotype: list</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class128517.html b/doc/devel/uml/class128517.html
index 892d720be..ea076d171 100644
--- a/doc/devel/uml/class128517.html
+++ b/doc/devel/uml/class128517.html
@@ -17,10 +17,11 @@
 
 <a name="refclass128517"></a>
 <p>Declaration :</p><ul><li>C++ : class MObject : public <a href="class134021.html#refclass134021"><b>Buildable</b></a> </li><li>Java : public interface MObject </li></ul><p>Directly inherited by : <a href="class128773.html#refclass128773"><b>AbstractMO</b></a> <a href="class128901.html#refclass128901"><b>Clip</b></a> <a href="class129029.html#refclass129029"><b>Effect</b></a> <a href="class129669.html#refclass129669"><b>Label</b></a> <a href="class128389.html#refclass128389"><b>Track</b></a> </p>
-<p>Artifact : <a href="index.html#refartifact128261"><b>mobject</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><div class="sub">
+<p>Artifact : <a href="index.html#refartifact128261"><b>mobject</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refattribute128517"></a>
 <table><tr><td><div class="element">Attribut <b>length</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # length : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> length</li></ul><p>TODO: how to represent time intervals?<br /></p></div>
+<p>TODO: how to represent time intervals?<br /></p><p>Declaration :</p><ul><li>Uml : # length : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> length</li></ul></div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128645.html b/doc/devel/uml/class128645.html
index 7b271a2ee..27413648f 100644
--- a/doc/devel/uml/class128645.html
+++ b/doc/devel/uml/class128645.html
@@ -16,13 +16,14 @@
 <!-- ============================================================= -->
 
 <a name="refclass128645"></a>
-<p>Declaration :</p><ul><li>C++ : class Placement </li><li>Java : public interface Placement </li></ul><p>Directly inherited by : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a> </p>
-<p>used to specify the position of a MObject in the EDL. This can be done in various ways (absolute, relative). <br />Placement at the same time acts as (refcounting) smart pointer for accessing the MObject.<br /></p><p>Artifact : <a href="index.html#refartifact129029"><b>placement</b></a></p><div class="sub">
+<p>used to specify the position of a MObject in the EDL. This can be done in various ways (absolute, relative). <br />Placement at the same time acts as (refcounting) smart pointer for accessing the MObject.<br /></p><p>Declaration :</p><ul><li>C++ : class Placement </li><li>Java : public interface Placement </li></ul><p>Directly inherited by : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact129029"><b>placement</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refoperation128005"></a>
-<table><tr><td><div class="element">Operation <b>resolve</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + resolve() : ExplicitPlacement   [ProcessingLayer::MObject]&amp;</li><li>C++ : public: ExplicitPlacement   [ProcessingLayer::MObject]&amp; resolve () </li></ul><p>create an actual (explicit) placement while trying to satisfy the network of adjacent objects and placements.<br /></p><a name="refrelation144901"></a>
-<table><tr><td><div class="element">Relation <b>subject (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # subject : <a href="class128517.html#refclass128517"><b>MObject</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class128517.html#refclass128517"><b>MObject</b></a>* subject</li></ul><p>Placement acts as smart pointer<br /></p><a name="refoperation134277"></a>
-<table><tr><td><div class="element">Operation <b>chain</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + chain(in style : ) : </li><li>C++ : public:  chain (const &amp; style) </li></ul><p>create and add another Placement for this media object, thus increasingly constraining the (possible) position of this object.<br /></p><a name="refrelation145413"></a>
-<table><tr><td><div class="element">Relation <b>chain (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # chain : <a href="class139909.html#refclass139909"><b>LocatingPin</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class139909.html#refclass139909"><b>LocatingPin</b></a>* chain</li></ul><p>Chain of additional Placements further constraining the position of this MObject<br /></p></div>
+<table><tr><td><div class="element">Operation <b>resolve</b></div></td></tr></table><p>create an actual (explicit) placement while trying to satisfy the network of adjacent objects and placements.<br /></p><p>Declaration :</p><ul><li>Uml : + resolve() : ExplicitPlacement   [ProcessingLayer::MObject]&amp;</li><li>C++ : public: ExplicitPlacement   [ProcessingLayer::MObject]&amp; resolve () </li></ul><a name="refrelation144901"></a>
+<table><tr><td><div class="element">Relation <b>subject (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Placement acts as smart pointer<br /></p><p>Declaration :</p><ul><li>Uml : # subject : <a href="class128517.html#refclass128517"><b>MObject</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class128517.html#refclass128517"><b>MObject</b></a>* subject</li></ul><a name="refoperation134277"></a>
+<table><tr><td><div class="element">Operation <b>chain</b></div></td></tr></table><p>create and add another Placement for this media object, thus increasingly constraining the (possible) position of this object.<br /></p><p>Declaration :</p><ul><li>Uml : + chain(in style : ) : </li><li>C++ : public:  chain (const &amp; style) </li></ul><a name="refrelation145413"></a>
+<table><tr><td><div class="element">Relation <b>chain (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Chain of additional Placements further constraining the position of this MObject<br /></p><p>Declaration :</p><ul><li>Uml : # chain : <a href="class139909.html#refclass139909"><b>LocatingPin</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class139909.html#refclass139909"><b>LocatingPin</b></a>* chain</li></ul></div>
 <p>All public operations : <a href="class128645.html#refoperation134277"><b>chain</b></a> , <a href="class128645.html#refoperation128005"><b>resolve</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128821.html b/doc/devel/uml/class128821.html
index 26d9d7275..d6bdeb84a 100644
--- a/doc/devel/uml/class128821.html
+++ b/doc/devel/uml/class128821.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass128821"></a>
-<p>Declaration :</p><ul><li>C++ : class Frame </li></ul><p>Frames are just a low level lump of continous memory, most parts are opaque. Frames are memory sensitive, they will be small constant sized structures which can be efficently managed in a pool.<br /></p><div class="sub">
+<p>Frames are just a low level lump of continous memory, most parts are opaque. Frames are memory sensitive, they will be small constant sized structures which can be efficently managed in a pool.<br /></p><p>Declaration :</p><ul><li>C++ : class Frame </li></ul><div class="sub">
 <a name="refrelation128181"></a>
 <table><tr><td><div class="element">Relation <b>&lt;directional aggregation&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a>, multiplicity : *</li><li>C++ : protected: &lt;<a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a> *&gt; </li></ul><a name="refrelation128309"></a>
 <table><tr><td><div class="element">Relation <b>&lt;directional aggregation&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a></li><li>C++ : protected: <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a> * </li></ul><a name="refrelation128693"></a>
diff --git a/doc/devel/uml/class128901.html b/doc/devel/uml/class128901.html
index 9cc9def6f..3b1c46b47 100644
--- a/doc/devel/uml/class128901.html
+++ b/doc/devel/uml/class128901.html
@@ -19,7 +19,7 @@
 <p>Declaration :</p><ul><li>C++ : class Clip : public <a href="class128773.html#refclass128773"><b>AbstractMO</b></a>, public <a href="class128517.html#refclass128517"><b>MObject</b></a> </li></ul><p>Directly inherited by : <a href="class138629.html#refclass138629"><b>CompoundClip</b></a> <a href="class138885.html#refclass138885"><b>SimpleClip</b></a> </p>
 <p>Artifact : <a href="index.html#refartifact129413"><b>clip</b></a></p><div class="sub">
 <a name="refrelation142469"></a>
-<table><tr><td><div class="element">Relation <b>source (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # source : <a href="class136709.html#refclass136709"><b>Media</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class136709.html#refclass136709"><b>Media</b></a>* source</li></ul><p>the media source this clip referes to<br /></p></div>
+<table><tr><td><div class="element">Relation <b>source (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>the media source this clip referes to<br /></p><p>Declaration :</p><ul><li>Uml : # source : <a href="class136709.html#refclass136709"><b>Media</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class136709.html#refclass136709"><b>Media</b></a>* source</li></ul></div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128906.html b/doc/devel/uml/class128906.html
index 2877c4770..81b5fdc34 100644
--- a/doc/devel/uml/class128906.html
+++ b/doc/devel/uml/class128906.html
@@ -17,5 +17,6 @@
 
 <a name="refclass128906"></a>
 <p>Declaration :</p><ul><li>C++ : class SmartPointer </li><li>Java : package abstract class SmartPointer </li></ul><p>Directly inherited by : <a href="class128778.html#refclass128778"><b>FileReference</b></a> <a href="class128225.html#refclass128225"><b>FrameReference</b></a> </p>
+<p>Stereotype: auxiliary</p>
 </body>
 </html>
diff --git a/doc/devel/uml/class128949.html b/doc/devel/uml/class128949.html
index 29a9702fc..eb6b0e313 100644
--- a/doc/devel/uml/class128949.html
+++ b/doc/devel/uml/class128949.html
@@ -16,7 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass128949"></a>
-<p>Declaration :</p><ul><li>C++ : class FrameDescriptor </li><li>Java : package interface FrameDescriptor </li></ul><p>A FrameDescriptor implements the higher level interfaces for frames. Further refinements are made by subclassing and policy classes<br /></p><div class="sub">
+<p>A FrameDescriptor implements the higher level interfaces for frames. Further refinements are made by subclassing and policy classes<br /></p><p>Declaration :</p><ul><li>C++ : class FrameDescriptor </li><li>Java : package interface FrameDescriptor </li></ul><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refrelation128821"></a>
 <table><tr><td><div class="element">Relation <b>&lt;aggregation&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class128821.html#refclass128821"><b>Frame</b></a></li><li>C++ : protected: <a href="class128821.html#refclass128821"><b>Frame</b></a> * </li></ul></div>
 </body>
diff --git a/doc/devel/uml/class129029.html b/doc/devel/uml/class129029.html
index b04d54df7..2c20d1a0f 100644
--- a/doc/devel/uml/class129029.html
+++ b/doc/devel/uml/class129029.html
@@ -19,7 +19,7 @@
 <p>Declaration :</p><ul><li>C++ : class Effect : public <a href="class128773.html#refclass128773"><b>AbstractMO</b></a>, public <a href="class128517.html#refclass128517"><b>MObject</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact129541"><b>effect</b></a></p><div class="sub">
 <a name="refattribute128901"></a>
 <table><tr><td><div class="element">Attribut <b>plugin</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # plugin : string</li><li>C++ : protected: string plugin</li></ul><p>Identifier of the Plugin to be used<br /></p></div>
+<p>Identifier of the Plugin to be used<br /></p><p>Declaration :</p><ul><li>Uml : # plugin : string</li><li>C++ : protected: string plugin</li></ul></div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class129333.html b/doc/devel/uml/class129333.html
index 1425f3c9b..3eac15183 100644
--- a/doc/devel/uml/class129333.html
+++ b/doc/devel/uml/class129333.html
@@ -16,11 +16,11 @@
 <!-- ============================================================= -->
 
 <a name="refclass129333"></a>
-<p>Declaration :</p><ul><li>C++ : class FileProvider </li></ul><p>This is the Factory for Files, whenever something wants to use some file (or temporary storage), This Factory will hand out some smart/shared pointer to a File object which will be used to retrieve Frames.<br /></p><div class="sub">
+<p>This is the Factory for Files, whenever something wants to use some file (or temporary storage), This Factory will hand out some smart/shared pointer to a File object which will be used to retrieve Frames.<br /></p><p>Declaration :</p><ul><li>C++ : class FileProvider </li></ul><div class="sub">
 <a name="refrelation129034"></a>
 <table><tr><td><div class="element">Relation <b>files (&lt;aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # files : <a href="class128181.html#refclass128181"><b>File</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class128181.html#refclass128181"><b>File</b></a> * files</li></ul><a name="refoperation128010"></a>
-<table><tr><td><div class="element">Operation <b>useFile</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + useFile(in name : string, in mode : ) : <a href="class128778.html#refclass128778"><b>FileReference</b></a></li><li>C++ : public: <a href="class128778.html#refclass128778"><b>FileReference</b></a> useFile()</li></ul><p>Announces that the application intends to use this file with mode (READ|WRITE|READWRITE)<br /></p><a name="refoperation128138"></a>
-<table><tr><td><div class="element">Operation <b>useTemporaryStorage</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + useTemporaryStorage(in type : <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a>) : <a href="class128778.html#refclass128778"><b>FileReference</b></a></li><li>C++ : public: <a href="class128778.html#refclass128778"><b>FileReference</b></a> useTemporaryStorage()</li></ul><p>Provides a pool for interminate frames<br /></p></div>
+<table><tr><td><div class="element">Operation <b>useFile</b></div></td></tr></table><p>Announces that the application intends to use this file with mode (READ|WRITE|READWRITE)<br /></p><p>Declaration :</p><ul><li>Uml : + useFile(in name : string, in mode : ) : <a href="class128778.html#refclass128778"><b>FileReference</b></a></li><li>C++ : public: <a href="class128778.html#refclass128778"><b>FileReference</b></a> useFile()</li></ul><a name="refoperation128138"></a>
+<table><tr><td><div class="element">Operation <b>useTemporaryStorage</b></div></td></tr></table><p>Provides a pool for interminate frames<br /></p><p>Declaration :</p><ul><li>Uml : + useTemporaryStorage(in type : <a href="class128949.html#refclass128949"><b>FrameDescriptor</b></a>) : <a href="class128778.html#refclass128778"><b>FileReference</b></a></li><li>C++ : public: <a href="class128778.html#refclass128778"><b>FileReference</b></a> useTemporaryStorage()</li></ul></div>
 <p>All public operations : <a href="class129333.html#refoperation128010"><b>useFile</b></a> , <a href="class129333.html#refoperation128138"><b>useTemporaryStorage</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class129413.html b/doc/devel/uml/class129413.html
index b8fa2c81b..5c0d8e925 100644
--- a/doc/devel/uml/class129413.html
+++ b/doc/devel/uml/class129413.html
@@ -20,9 +20,9 @@
 <a name="refrelation130565"></a>
 <table><tr><td><div class="element">Relation <b>anchor (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # anchor : <a href="class128517.html#refclass128517"><b>MObject</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class128517.html#refclass128517"><b>MObject</b></a>* anchor</li></ul><a name="refattribute128133"></a>
 <table><tr><td><div class="element">Attribut <b>relType</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # relType : <a href="class133893.html#refclass133893"><b>RelType</b></a></li><li>C++ : protected: <a href="class133893.html#refclass133893"><b>RelType</b></a> relType</li></ul><p>the kind of relation denoted by this Placement<br /></p><a name="refattribute129029"></a>
+<p>the kind of relation denoted by this Placement<br /></p><p>Declaration :</p><ul><li>Uml : # relType : <a href="class133893.html#refclass133893"><b>RelType</b></a></li><li>C++ : protected: <a href="class133893.html#refclass133893"><b>RelType</b></a> relType</li></ul><a name="refattribute129029"></a>
 <table><tr><td><div class="element">Attribut <b>offset</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # offset : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> offset</li></ul><p>Offset the actual position by this (time) value relative to the anchor point. TODO: Representation?<br /></p><table><tr><td><div class="element">Class <b><a href="class133893.html#refclass133893"><b>RelType</b></a></b></div></td></tr></table>
+<p>Offset the actual position by this (time) value relative to the anchor point. TODO: Representation?<br /></p><p>Declaration :</p><ul><li>Uml : # offset : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> offset</li></ul><table><tr><td><div class="element">Class <b><a href="class133893.html#refclass133893"><b>RelType</b></a></b></div></td></tr></table>
 </div>
 </body>
 </html>
diff --git a/doc/devel/uml/class129541.html b/doc/devel/uml/class129541.html
index 40d20683a..8e7441336 100644
--- a/doc/devel/uml/class129541.html
+++ b/doc/devel/uml/class129541.html
@@ -16,11 +16,11 @@
 <!-- ============================================================= -->
 
 <a name="refclass129541"></a>
-<p>Declaration :</p><ul><li>C++ : class Allocation : public <a href="class139909.html#refclass139909"><b>LocatingPin</b></a> </li></ul><p>Directly inherited by : <a href="class130181.html#refclass130181"><b>Constraint</b></a> <a href="class130053.html#refclass130053"><b>Wish</b></a> </p>
-<p>a directive to place a MObject in a specific way<br /></p><p>Artifact : <a href="index.html#refartifact130053"><b>allocation</b></a></p><div class="sub">
+<p>a directive to place a MObject in a specific way<br /></p><p>Declaration :</p><ul><li>C++ : class Allocation : public <a href="class139909.html#refclass139909"><b>LocatingPin</b></a> </li></ul><p>Directly inherited by : <a href="class130181.html#refclass130181"><b>Constraint</b></a> <a href="class130053.html#refclass130053"><b>Wish</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact130053"><b>allocation</b></a></p><div class="sub">
 <a name="refattribute128773"></a>
 <table><tr><td><div class="element">Attribut <b>repr</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # repr : string</li><li>C++ : protected: string repr</li></ul><p>human readable representation of the condition characterizing this allocaton, e.g. "t &gt;= 10"<br /></p><a name="refoperation131205"></a>
+<p>human readable representation of the condition characterizing this allocaton, e.g. "t &gt;= 10"<br /></p><p>Declaration :</p><ul><li>Uml : # repr : string</li><li>C++ : protected: string repr</li></ul><a name="refoperation131205"></a>
 <table><tr><td><div class="element">Operation <b>get_repr</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + get_repr() : string</li><li>C++ : public: inline const string getRepr () const </li></ul></div>
 <p>All public operations : <a href="class129541.html#refoperation131205"><b>get_repr</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class129797.html b/doc/devel/uml/class129797.html
index 934410392..b651b6ffa 100644
--- a/doc/devel/uml/class129797.html
+++ b/doc/devel/uml/class129797.html
@@ -16,7 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass129797"></a>
-<p>Declaration :</p><ul><li>C++ : class ExplicitPlacement : public <a href="class128645.html#refclass128645"><b>Placement</b></a> </li><li>Java : public interface ExplicitPlacement </li></ul><p>Artifact : <a href="index.html#refartifact129157"><b>explicitplacement</b></a></p><div class="sub">
+<p>Declaration :</p><ul><li>C++ : class ExplicitPlacement : public <a href="class128645.html#refclass128645"><b>Placement</b></a> </li><li>Java : public interface ExplicitPlacement </li></ul><p>Artifact : <a href="index.html#refartifact129157"><b>explicitplacement</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refattribute128261"></a>
 <table><tr><td><div class="element">Attribut <b>time</b></div></td></tr></table>
 <p>Declaration :</p><ul><li>Uml : # time : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> time</li></ul><a name="refattribute128389"></a>
diff --git a/doc/devel/uml/class129925.html b/doc/devel/uml/class129925.html
index 3052beb5b..91945b847 100644
--- a/doc/devel/uml/class129925.html
+++ b/doc/devel/uml/class129925.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass129925"></a>
-<p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class Auto : public <a href="class129157.html#refclass129157"><b>Meta</b></a>, public <a href="class134661.html#refclass134661"><b>ParamProvider</b></a>&lt;VAL&gt; </li></ul><p>Automation data for some parameter (i.e. a time varying function)<br /></p><p>Artifact : <a href="index.html#refartifact130309"><b>auto</b></a></p><div class="sub">
+<p>Automation data for some parameter (i.e. a time varying function)<br /></p><p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class Auto : public <a href="class129157.html#refclass129157"><b>Meta</b></a>, public <a href="class134661.html#refclass134661"><b>ParamProvider</b></a>&lt;VAL&gt; </li></ul><p>Artifact : <a href="index.html#refartifact130309"><b>auto</b></a></p><div class="sub">
 <a name="refoperation131077"></a>
 <table><tr><td><div class="element">Operation <b>getValue</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getValue() : VAL</li><li>C++ : public: VAL getValue () const </li></ul></div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> , <a href="class129925.html#refoperation131077"><b>getValue</b></a> , <a href="class134661.html#refoperation130949"><b>getValue</b></a> </p>
diff --git a/doc/devel/uml/class130309.html b/doc/devel/uml/class130309.html
index 5c515d659..bd7b1b3d1 100644
--- a/doc/devel/uml/class130309.html
+++ b/doc/devel/uml/class130309.html
@@ -16,5 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass130309"></a>
-<p>Declaration :</p><ul><li>C++ : class ControllerFacade </li></ul><p>Provides unified access to the Proc-Subsystem Controller. Especially, this Facade class provides the functions to get a render engine to carry out actual renderings.<br /></p><p>Artifact : <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, Component(s) : <a href="index.html#refcomponent129541"><b>ControllerFacade</b></a></p></body>
+<p>Provides unified access to the Proc-Subsystem Controller. Especially, this Facade class provides the functions to get a render engine to carry out actual renderings.<br /></p><p>Declaration :</p><ul><li>C++ : class ControllerFacade </li></ul><p>Artifact : <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, Component(s) : <a href="index.html#refcomponent129541"><b>ControllerFacade</b></a></p><p>Stereotype: boundary</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class130437.html b/doc/devel/uml/class130437.html
index f70da5140..9e90254ce 100644
--- a/doc/devel/uml/class130437.html
+++ b/doc/devel/uml/class130437.html
@@ -16,9 +16,9 @@
 <!-- ============================================================= -->
 
 <a name="refclass130437"></a>
-<p>Declaration :</p><ul><li>C++ : class PathManager </li></ul><p>While building a render engine, this Strategy class decides on the actual render strategy in accordance to the current controller settings (system state)<br /></p><p>Artifact : <a href="index.html#refartifact131717"><b>pathmanager</b></a>, Component(s) : <a href="index.html#refcomponent129285"><b>RenderPathManager</b></a></p><div class="sub">
+<p>While building a render engine, this Strategy class decides on the actual render strategy in accordance to the current controller settings (system state)<br /></p><p>Declaration :</p><ul><li>C++ : class PathManager </li></ul><p>Artifact : <a href="index.html#refartifact131717"><b>pathmanager</b></a>, Component(s) : <a href="index.html#refcomponent129285"><b>RenderPathManager</b></a></p><div class="sub">
 <a name="refoperation128261"></a>
-<table><tr><td><div class="element">Operation <b>buildProcessor</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + buildProcessor() : <a href="class131461.html#refclass131461"><b>Processor</b></a></li><li>C++ : public: <a href="class131461.html#refclass131461"><b>Processor</b></a> buildProcessor () </li></ul></div>
+<table><tr><td><div class="element">Operation <b>buildProcessor</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + buildProcessor() : <a href="class131461.html#refclass131461"><b>RenderGraph</b></a></li><li>C++ : public: <a href="class131461.html#refclass131461"><b>RenderGraph</b></a> buildProcessor () </li></ul></div>
 <p>All public operations : <a href="class130437.html#refoperation128261"><b>buildProcessor</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class130565.html b/doc/devel/uml/class130565.html
index 9e783f8e1..be15e2b15 100644
--- a/doc/devel/uml/class130565.html
+++ b/doc/devel/uml/class130565.html
@@ -16,9 +16,10 @@
 <!-- ============================================================= -->
 
 <a name="refclass130565"></a>
-<p>Declaration :</p><ul><li>C++ : class BuilderFacade </li></ul><p>Provides unified access to the builder functionality. While individual components of the builder subsystem may be called if necessary or suitable, it is usually better to do all extern invocations via the high level methods of this Facade<br /></p><p>Artifact : <a href="index.html#refartifact130437"><b>builderfacade</b></a>, Component(s) : <a href="index.html#refcomponent128261"><b>Controller</b></a></p><div class="sub">
+<p>Provides unified access to the builder functionality. While individual components of the builder subsystem may be called if necessary or suitable, it is usually better to do all extern invocations via the high level methods of this Facade<br /></p><p>Declaration :</p><ul><li>C++ : class BuilderFacade </li></ul><p>Artifact : <a href="index.html#refartifact130437"><b>builderfacade</b></a>, Component(s) : <a href="index.html#refcomponent128261"><b>Controller</b></a></p><p>Stereotype: boundary</p>
+<div class="sub">
 <a name="refoperation128517"></a>
-<table><tr><td><div class="element">Operation <b>buildEngine</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + buildEngine() : <a href="class131333.html#refclass131333"><b>RenderEngine</b></a></li><li>C++ : public: <a href="class131333.html#refclass131333"><b>RenderEngine</b></a> buildEngine () </li></ul><p>Main Operation of the Builder: create a render engine for a given part of the timeline<br /></p></div>
+<table><tr><td><div class="element">Operation <b>buildEngine</b></div></td></tr></table><p>Main Operation of the Builder: create a render engine for a given part of the timeline<br /></p><p>Declaration :</p><ul><li>Uml : + buildEngine() : <a href="class131333.html#refclass131333"><b>RenderEngine</b></a></li><li>C++ : public: <a href="class131333.html#refclass131333"><b>RenderEngine</b></a> buildEngine () </li></ul></div>
 <p>All public operations : <a href="class130565.html#refoperation128517"><b>buildEngine</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class130821.html b/doc/devel/uml/class130821.html
index f5856aaab..d56ad24bb 100644
--- a/doc/devel/uml/class130821.html
+++ b/doc/devel/uml/class130821.html
@@ -16,9 +16,9 @@
 <!-- ============================================================= -->
 
 <a name="refclass130821"></a>
-<p>Declaration :</p><ul><li>C++ : class ConManager </li></ul><p>Connection Manager, used to build the connections between render engine nodes, if these nodes need to cooperate besides the normal "data pull" operation. Esp., the Connection Manager knows how to wire up the effect's parameters with the corresponding ParamProviders (autmation) in the Session<br /></p><p>Artifact : <a href="index.html#refartifact130693"><b>conmanager</b></a></p><div class="sub">
+<p>Connection Manager, used to build the connections between render engine nodes, if these nodes need to cooperate besides the normal "data pull" operation. Esp., the Connection Manager knows how to wire up the effect's parameters with the corresponding ParamProviders (autmation) in the Session<br /></p><p>Declaration :</p><ul><li>C++ : class ConManager </li></ul><p>Artifact : <a href="index.html#refartifact130693"><b>conmanager</b></a></p><div class="sub">
 <a name="refoperation129029"></a>
-<table><tr><td><div class="element">Operation <b>getConnection</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getConnection() : int</li><li>C++ : public: int getConnection () </li></ul><p>TODO<br /></p></div>
+<table><tr><td><div class="element">Operation <b>getConnection</b></div></td></tr></table><p>TODO<br /></p><p>Declaration :</p><ul><li>Uml : + getConnection() : int</li><li>C++ : public: int getConnection () </li></ul></div>
 <p>All public operations : <a href="class130821.html#refoperation129029"><b>getConnection</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class130949.html b/doc/devel/uml/class130949.html
index 05f451c34..05255113d 100644
--- a/doc/devel/uml/class130949.html
+++ b/doc/devel/uml/class130949.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass130949"></a>
-<p>Declaration :</p><ul><li>C++ : class RenderState </li></ul><p>Encapsulates the logic used to get a "current render process" in accordance to the currentyl applicable controller settings. The provided StateProxy serves to hold any mutalbe state used in the render process, so the rest of the render engine can be stateless.<br /></p><p>Artifact : <a href="index.html#refartifact131845"><b>renderstate</b></a></p><div class="sub">
+<p>Encapsulates the logic used to get a "current render process" in accordance to the currentyl applicable controller settings. The provided StateProxy serves to hold any mutalbe state used in the render process, so the rest of the render engine can be stateless.<br /></p><p>Declaration :</p><ul><li>C++ : class RenderState </li></ul><p>Artifact : <a href="index.html#refartifact131845"><b>renderstate</b></a></p><div class="sub">
 <a name="refoperation128389"></a>
 <table><tr><td><div class="element">Operation <b>getStateProxy</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getStateProxy() : <a href="class132741.html#refclass132741"><b>State</b></a></li><li>C++ : public: <a href="class132741.html#refclass132741"><b>State</b></a> getStateProxy () </li></ul></div>
 <p>All public operations : <a href="class130949.html#refoperation128389"><b>getStateProxy</b></a> </p>
diff --git a/doc/devel/uml/class131077.html b/doc/devel/uml/class131077.html
index a5d40eab9..7dd483052 100644
--- a/doc/devel/uml/class131077.html
+++ b/doc/devel/uml/class131077.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass131077"></a>
-<p>Declaration :</p><ul><li>C++ : class Assembler </li></ul><p>This is the actual building facility: provided the correct tools and associations, it serves to build and connect the individual ProcNode objects<br /></p><p>Artifact : <a href="index.html#refartifact130821"><b>assembler</b></a></p><div class="sub">
+<p>This is the actual building facility: provided the correct tools and associations, it serves to build and connect the individual ProcNode objects<br /></p><p>Declaration :</p><ul><li>C++ : class Assembler </li></ul><p>Artifact : <a href="index.html#refartifact130821"><b>assembler</b></a></p><div class="sub">
 <a name="refoperation128901"></a>
 <table><tr><td><div class="element">Operation <b>build</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + build() : <a href="class131333.html#refclass131333"><b>RenderEngine</b></a></li><li>C++ : public: <a href="class131333.html#refclass131333"><b>RenderEngine</b></a> build () </li></ul></div>
 <p>All public operations : <a href="class131077.html#refoperation128901"><b>build</b></a> </p>
diff --git a/doc/devel/uml/class131333.html b/doc/devel/uml/class131333.html
index 70d8c0609..936641c7e 100644
--- a/doc/devel/uml/class131333.html
+++ b/doc/devel/uml/class131333.html
@@ -16,10 +16,11 @@
 <!-- ============================================================= -->
 
 <a name="refclass131333"></a>
-<p>Declaration :</p><ul><li>C++ : class RenderEngine : public <a href="class131461.html#refclass131461"><b>Processor</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact131973"><b>renderengine</b></a></p><div class="sub">
+<p>Declaration :</p><ul><li>C++ : class RenderEngine : public <a href="class131461.html#refclass131461"><b>RenderGraph</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact131973"><b>renderengine</b></a></p><div class="sub">
 <a name="refoperation129413"></a>
-<table><tr><td><div class="element">Operation <b>play</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + play() : void</li><li>C++ : public: void play () </li></ul><p>TODO: will probably be handled differently (see Cehteh)<br /></p><a name="refrelation132485"></a>
-<table><tr><td><div class="element">Relation <b>renderSegments (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : - renderSegments : <a href="class131461.html#refclass131461"><b>Processor</b></a>, multiplicity : 0..*</li><li>C++ : private: list&lt;<a href="class131461.html#refclass131461"><b>Processor</b></a>&gt; renderSegments</li></ul></div>
+<table><tr><td><div class="element">Operation <b>play</b></div></td></tr></table><p>TODO: will probably be handled differently (see Cehteh)<br /></p><p>Declaration :</p><ul><li>Uml : + play() : void</li><li>C++ : public: void play () </li></ul><a name="refrelation132485"></a>
+<table><tr><td><div class="element">Relation <b>renderSegments (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : - renderSegments : <a href="class131461.html#refclass131461"><b>RenderGraph</b></a>, multiplicity : 0..*</li><li>C++ : private: list&lt;<a href="class131461.html#refclass131461"><b>RenderGraph</b></a>&gt; renderSegments</li></ul><p>Stereotype: list</p>
+</div>
 <p>All public operations : <a href="class131333.html#refoperation129413"><b>play</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class131461.html b/doc/devel/uml/class131461.html
index da8373b8e..0463e56d1 100644
--- a/doc/devel/uml/class131461.html
+++ b/doc/devel/uml/class131461.html
@@ -4,25 +4,26 @@
 <html xmlns="http://www.w3.org/1999/xhtml">
 
 <head>
-<title>Class Processor</title>
+<title>Class RenderGraph</title>
 <link rel="stylesheet" href="style.css" type="text/css" />
 </head>
 
 <body bgcolor="#ffffff">
 
-<div class = "title">Class Processor</div>
+<div class = "title">Class RenderGraph</div>
 <p></p>
 
 <!-- ============================================================= -->
 
 <a name="refclass131461"></a>
-<p>Declaration :</p><ul><li>C++ : class Processor </li></ul><p>Directly inherited by : <a href="class131333.html#refclass131333"><b>RenderEngine</b></a> </p>
-<p>Artifact : <a href="index.html#refartifact132101"><b>processor</b></a></p><div class="sub">
+<p>Declaration :</p><ul><li>C++ : class RenderGraph </li></ul><p>Directly inherited by : <a href="class131333.html#refclass131333"><b>RenderEngine</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact132101"><b>rendergraph</b></a></p><div class="sub">
 <a name="refrelation132613"></a>
-<table><tr><td><div class="element">Relation <b>output (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # output : <a href="class131589.html#refclass131589"><b>ExitNode</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class131589.html#refclass131589"><b>ExitNode</b></a> * output</li></ul><a name="refattribute129413"></a>
+<table><tr><td><div class="element">Relation <b>pipes (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # pipes : <a href="class131589.html#refclass131589"><b>ExitNode</b></a>, multiplicity : 1..*</li><li>C++ : protected: <a href="class131589.html#refclass131589"><b>ExitNode</b></a> * pipes</li></ul><p>Stereotype: list</p>
+<a name="refattribute129413"></a>
 <table><tr><td><div class="element">Attribut <b>start</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # start : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> start</li></ul><p>begin of the timerange covered by this processor<br /></p><a name="refattribute129541"></a>
+<p>begin of the timerange covered by this processor<br /></p><p>Declaration :</p><ul><li>Uml : # start : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> start</li></ul><a name="refattribute129541"></a>
 <table><tr><td><div class="element">Attribut <b>end</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # end : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> end</li></ul><p>end of the timerange (excl)<br /></p></div>
+<p>end of the timerange (excl)<br /></p><p>Declaration :</p><ul><li>Uml : # end : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> end</li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class131589.html b/doc/devel/uml/class131589.html
index 86ae3636b..b459ef44a 100644
--- a/doc/devel/uml/class131589.html
+++ b/doc/devel/uml/class131589.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass131589"></a>
-<p>Declaration :</p><ul><li>C++ : class ExitNode : public <a href="class131717.html#refclass131717"><b>ProcNode</b></a> </li></ul><p>The output of the render pipeline. Pulling from such exit nodes actually ivokes the render process<br /></p><p>Artifact : <a href="index.html#refartifact132229"><b>exitnode</b></a></p><div class="sub">
+<p>The output of the render pipeline. Pulling from such exit nodes actually ivokes the render process<br /></p><p>Declaration :</p><ul><li>C++ : class ExitNode : public <a href="class131717.html#refclass131717"><b>ProcNode</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact132229"><b>exitnode</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class131717.html#refoperation136069"><b>process</b></a> , <a href="class131717.html#refoperation135685"><b>pull</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class131717.html b/doc/devel/uml/class131717.html
index 2a2783381..faf08fb65 100644
--- a/doc/devel/uml/class131717.html
+++ b/doc/devel/uml/class131717.html
@@ -16,14 +16,18 @@
 <!-- ============================================================= -->
 
 <a name="refclass131717"></a>
-<p>Declaration :</p><ul><li>C++ : class ProcNode </li><li>Java : public interface ProcNode </li></ul><p>Directly inherited by : <a href="class131589.html#refclass131589"><b>ExitNode</b></a> <a href="class131973.html#refclass131973"><b>Link</b></a> <a href="class133765.html#refclass133765"><b>Source</b></a> <a href="class131845.html#refclass131845"><b>Trafo</b></a> </p>
-<p>Key abstraction of the Render Engine: A Data processing Node<br /></p><p>Artifact : <a href="index.html#refartifact132357"><b>procnode</b></a></p><div class="sub">
+<p>Key abstraction of the Render Engine: A Data processing Node<br /></p><p>Declaration :</p><ul><li>C++ : class ProcNode </li><li>Java : public interface ProcNode </li></ul><p>Directly inherited by : <a href="class131589.html#refclass131589"><b>ExitNode</b></a> <a href="class131973.html#refclass131973"><b>Link</b></a> <a href="class133765.html#refclass133765"><b>Source</b></a> <a href="class131845.html#refclass131845"><b>Trafo</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact132357"><b>procnode</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refrelation136965"></a>
-<table><tr><td><div class="element">Relation <b>datasrc (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # datasrc : <a href="class131717.html#refclass131717"><b>ProcNode</b></a></li><li>C++ : protected: <a href="class131717.html#refclass131717"><b>ProcNode</b></a> * datasrc</li></ul><p>The predecessor in a processing pipeline, i.e. a source to get data to be processed<br /></p><a name="refrelation137861"></a>
-<table><tr><td><div class="element">Relation <b>params (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # params : <a href="class134533.html#refclass134533"><b>Parameter</b></a>, multiplicity : 1..*</li><li>C++ : protected: vector&lt;<a href="class134533.html#refclass134533"><b>Parameter</b></a>&gt; params</li></ul><a name="refrelation152581"></a>
-<table><tr><td><div class="element">Relation <b>predecessors (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # predecessors : <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a> predecessors</li></ul><a name="refoperation135685"></a>
+<table><tr><td><div class="element">Relation <b>datasrc (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>The predecessor in a processing pipeline, i.e. a source to get data to be processed<br /></p><p>Declaration :</p><ul><li>Uml : # datasrc : <a href="class131717.html#refclass131717"><b>ProcNode</b></a></li><li>C++ : protected: <a href="class131717.html#refclass131717"><b>ProcNode</b></a> * datasrc</li></ul><a name="refrelation137861"></a>
+<table><tr><td><div class="element">Relation <b>params (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # params : <a href="class134533.html#refclass134533"><b>Parameter</b></a>, multiplicity : 1..*</li><li>C++ : protected: vector&lt;<a href="class134533.html#refclass134533"><b>Parameter</b></a>&gt; params</li></ul><p>Stereotype: vector</p>
+<a name="refrelation152581"></a>
+<table><tr><td><div class="element">Relation <b>predecessors (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # predecessors : <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a> predecessors</li></ul><p>Stereotype: array</p>
+<a name="refoperation135685"></a>
 <table><tr><td><div class="element">Operation <b>pull</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + pull() : </li><li>C++ : public:  pull () </li></ul><a name="refoperation136069"></a>
-<table><tr><td><div class="element">Operation <b>process</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + process() : </li><li>C++ : public:  process () </li></ul></div>
+<table><tr><td><div class="element">Operation <b>process</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + process() : </li><li>C++ : public:  process () </li></ul><a name="refrelation166789"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a></li><li>C++ : protected: <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a>* </li></ul></div>
 <p>All public operations : <a href="class131717.html#refoperation136069"><b>process</b></a> , <a href="class131717.html#refoperation135685"><b>pull</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class132229.html b/doc/devel/uml/class132229.html
index 8fc999275..cf51e3c81 100644
--- a/doc/devel/uml/class132229.html
+++ b/doc/devel/uml/class132229.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass132229"></a>
-<p>Declaration :</p><ul><li>C++ : class Projector : public <a href="class131845.html#refclass131845"><b>Trafo</b></a> </li></ul><p>Special video processing node used to scale and translate image data.<br /></p><p>Artifact : <a href="index.html#refartifact132869"><b>projector</b></a></p><div class="sub">
+<p>Special video processing node used to scale and translate image data.<br /></p><p>Declaration :</p><ul><li>C++ : class Projector : public <a href="class131845.html#refclass131845"><b>Trafo</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact132869"><b>projector</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class131717.html#refoperation136069"><b>process</b></a> , <a href="class131717.html#refoperation135685"><b>pull</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class132485.html b/doc/devel/uml/class132485.html
index 54bafe5c9..ff9264b69 100644
--- a/doc/devel/uml/class132485.html
+++ b/doc/devel/uml/class132485.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass132485"></a>
-<p>Declaration :</p><ul><li>C++ : class PluginAdapter : public <a href="class131845.html#refclass131845"><b>Trafo</b></a> </li></ul><p>Adapter used to integrage an effects processor in the render pipeline<br /></p><p>Artifact : <a href="index.html#refartifact133125"><b>pluginadapter</b></a></p><div class="sub">
+<p>Adapter used to integrage an effects processor in the render pipeline<br /></p><p>Declaration :</p><ul><li>C++ : class PluginAdapter : public <a href="class131845.html#refclass131845"><b>Trafo</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact133125"><b>pluginadapter</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class131717.html#refoperation136069"><b>process</b></a> , <a href="class131717.html#refoperation135685"><b>pull</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class132741.html b/doc/devel/uml/class132741.html
index 89bb5e220..dcae6fe88 100644
--- a/doc/devel/uml/class132741.html
+++ b/doc/devel/uml/class132741.html
@@ -17,9 +17,11 @@
 
 <a name="refclass132741"></a>
 <p>Declaration :</p><ul><li>C++ : class State </li><li>Java : public interface State </li></ul><p>Directly inherited by : <a href="class142597.html#refclass142597"><b>StateAdapter</b></a> <a href="class142469.html#refclass142469"><b>StateProxy</b></a> </p>
-<p>Artifact : <a href="index.html#refartifact130949"><b>stateproxy</b></a>, Component(s) : <a href="index.html#refcomponent128005"><b>Builder</b></a></p><div class="sub">
+<p>Artifact : <a href="index.html#refartifact130949"><b>stateproxy</b></a>, Component(s) : <a href="index.html#refcomponent128005"><b>Builder</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refrelation135941"></a>
-<table><tr><td><div class="element">Relation <b>currFrame (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # currFrame : <a href="class133253.html#refclass133253"><b>Frame</b></a></li><li>C++ : protected: <a href="class133253.html#refclass133253"><b>Frame</b></a> * currFrame</li></ul><a name="refoperation135813"></a>
+<table><tr><td><div class="element">Relation <b>currFrame (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # currFrame : <a href="class133253.html#refclass133253"><b>Frame</b></a></li><li>C++ : protected: <a href="class133253.html#refclass133253"><b>Frame</b></a> * currFrame</li></ul><p>Stereotype: vector</p>
+<a name="refoperation135813"></a>
 <table><tr><td><div class="element">Operation <b>fetch</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + fetch() : </li><li>C++ : public:  fetch () </li></ul><a name="refoperation135941"></a>
 <table><tr><td><div class="element">Operation <b>allocateBuffer</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + allocateBuffer() : </li><li>C++ : public:  allocateBuffer () </li></ul><a name="refoperation136197"></a>
 <table><tr><td><div class="element">Operation <b>releaseBuffer</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + releaseBuffer() : </li><li>C++ : public:  releaseBuffer () </li></ul><a name="refoperation136325"></a>
diff --git a/doc/devel/uml/class133253.html b/doc/devel/uml/class133253.html
index d34dc0fb5..7675db614 100644
--- a/doc/devel/uml/class133253.html
+++ b/doc/devel/uml/class133253.html
@@ -16,6 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass133253"></a>
-<p>Declaration :</p><ul><li>C++ : class Frame </li><li>Java : public interface Frame </li></ul><p>Directly inherited by : <a href="class133381.html#refclass133381"><b>AFrame</b></a> <a href="class133637.html#refclass133637"><b>GLBuf</b></a> <a href="class133509.html#refclass133509"><b>VFrame</b></a> </p>
-<p>TODO: how to relate to Cehteh's Frame entity in the Backend?<br />The latter is the fundamental Frame entity, wheras this Object rather represents a buffer set containing frame date<br /></p><p>Artifact : <a href="index.html#refartifact133765"><b>frame</b></a></p></body>
+<p>TODO: how to relate to Cehteh's Frame entity in the Backend?<br />The latter is the fundamental Frame entity, wheras this Object rather represents a buffer set containing frame date<br /></p><p>Declaration :</p><ul><li>C++ : class Frame </li><li>Java : public interface Frame </li></ul><p>Directly inherited by : <a href="class133381.html#refclass133381"><b>AFrame</b></a> <a href="class133637.html#refclass133637"><b>GLBuf</b></a> <a href="class133509.html#refclass133509"><b>VFrame</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact133765"><b>frame</b></a></p><p>Stereotype: interface</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class133765.html b/doc/devel/uml/class133765.html
index b6f9bde2d..d4b581b4c 100644
--- a/doc/devel/uml/class133765.html
+++ b/doc/devel/uml/class133765.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass133765"></a>
-<p>Declaration :</p><ul><li>C++ : class Source : public <a href="class131717.html#refclass131717"><b>ProcNode</b></a> </li></ul><p>Source Node: represents a media source to pull data from.<br /></p><p>Artifact : <a href="index.html#refartifact134277"><b>source</b></a></p><div class="sub">
+<p>Source Node: represents a media source to pull data from.<br /></p><p>Declaration :</p><ul><li>C++ : class Source : public <a href="class131717.html#refclass131717"><b>ProcNode</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact134277"><b>source</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class131717.html#refoperation136069"><b>process</b></a> , <a href="class131717.html#refoperation135685"><b>pull</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class133893.html b/doc/devel/uml/class133893.html
index ba0cbda57..8db886c76 100644
--- a/doc/devel/uml/class133893.html
+++ b/doc/devel/uml/class133893.html
@@ -16,7 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass133893"></a>
-<p>Declaration :</p><ul><li>C++ : enum RelType </li><li>Java : public enum RelType </li></ul><p>the possible kinds of RelativePlacements<br /></p><p>nested in <a href="class129413.html#refclass129413"><b>RelativeLocation</b></a></p>
+<p>the possible kinds of RelativePlacements<br /></p><p>Declaration :</p><ul><li>C++ : enum RelType </li><li>Java : public enum RelType </li></ul><p>nested in <a href="class129413.html#refclass129413"><b>RelativeLocation</b></a></p>
+<p>Stereotype: enum</p>
 <div class="sub">
 <p>Items :</p><ul>
 <li>SAMETIME</li>
diff --git a/doc/devel/uml/class134021.html b/doc/devel/uml/class134021.html
index 01a81da6f..f9732546a 100644
--- a/doc/devel/uml/class134021.html
+++ b/doc/devel/uml/class134021.html
@@ -17,7 +17,8 @@
 
 <a name="refclass134021"></a>
 <p>Declaration :</p><ul><li>C++ : class Buildable : public <a href="class140165.html#refclass140165"><b>Visitable</b></a> </li><li>Java : public interface Buildable </li></ul><p>Directly inherited by : <a href="class128517.html#refclass128517"><b>MObject</b></a> </p>
-<p>Artifact : <a href="index.html#refartifact131077"><b>buildable</b></a></p><div class="sub">
+<p>Artifact : <a href="index.html#refartifact131077"><b>buildable</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refoperation129669"></a>
 <table><tr><td><div class="element">Operation <b>apply</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : abstract, + apply(inout providedTool : <a href="class134149.html#refclass134149"><b>BuilderTool</b></a>) : void</li><li>C++ : public: virtual void apply (<a href="class134149.html#refclass134149"><b>BuilderTool</b></a>&amp; providedTool) = 0 </li></ul></div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
diff --git a/doc/devel/uml/class134149.html b/doc/devel/uml/class134149.html
index ec9c026f4..dc49f9771 100644
--- a/doc/devel/uml/class134149.html
+++ b/doc/devel/uml/class134149.html
@@ -16,10 +16,11 @@
 <!-- ============================================================= -->
 
 <a name="refclass134149"></a>
-<p>Declaration :</p><ul><li>C++ : class BuilderTool : public <a href="class140037.html#refclass140037"><b>Tool</b></a>, public <a href="class140293.html#refclass140293"><b>Applicable</b></a>&lt;&gt; </li><li>Java : public interface BuilderTool </li></ul><p>Directly inherited by : <a href="class134405.html#refclass134405"><b>NodeCreatorTool</b></a> <a href="class134277.html#refclass134277"><b>SegmentationTool</b></a> </p>
-<p>Used according to the visitor pattern: each Tool contains the concrete implementation for one task to be done to the various MObject classes<br /></p><p>Artifact : <a href="index.html#refartifact131205"><b>buildertool</b></a></p><div class="sub">
+<p>Used according to the visitor pattern: each Tool contains the concrete implementation for one task to be done to the various MObject classes<br /></p><p>Declaration :</p><ul><li>C++ : class BuilderTool : public <a href="class140037.html#refclass140037"><b>Tool</b></a>, public <a href="class140293.html#refclass140293"><b>Applicable</b></a>&lt;&gt; </li><li>Java : public interface BuilderTool </li></ul><p>Directly inherited by : <a href="class134405.html#refclass134405"><b>NodeCreatorTool</b></a> <a href="class134277.html#refclass134277"><b>SegmentationTool</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact131205"><b>buildertool</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refoperation129797"></a>
-<table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : abstract, + treat(in mElement : <a href="class134021.html#refclass134021"><b>Buildable</b></a>) : void</li><li>C++ : public: virtual void treat (const <a href="class134021.html#refclass134021"><b>Buildable</b></a>&amp; mElement) = 0 </li></ul><p>This operation is to be overloaded for the specific MObject subclasses to be treated.<br /></p></div>
+<table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>This operation is to be overloaded for the specific MObject subclasses to be treated.<br /></p><p>Declaration :</p><ul><li>Uml : abstract, + treat(in mElement : <a href="class134021.html#refclass134021"><b>Buildable</b></a>) : void</li><li>C++ : public: virtual void treat (const <a href="class134021.html#refclass134021"><b>Buildable</b></a>&amp; mElement) = 0 </li></ul></div>
 <p>All public operations : <a href="class140293.html#refoperation134405"><b>treat</b></a> , <a href="class134149.html#refoperation129797"><b>treat</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class134277.html b/doc/devel/uml/class134277.html
index 6c87e8635..4b7d1cd77 100644
--- a/doc/devel/uml/class134277.html
+++ b/doc/devel/uml/class134277.html
@@ -16,12 +16,15 @@
 <!-- ============================================================= -->
 
 <a name="refclass134277"></a>
-<p>Declaration :</p><ul><li>C++ : class SegmentationTool : public <a href="class134149.html#refclass134149"><b>BuilderTool</b></a>, public <a href="class140293.html#refclass140293"><b>Applicable</b></a>&lt;&gt; </li></ul><p>Tool implementation for deriving a partitioning of the current timeline such, that each segement has a constant configuration. "Constant" means here, that any remaining changes over time can be represented by automation solely, without the need to change the node connections.<br /></p><p>Artifact : <a href="index.html#refartifact131333"><b>segmentationtool</b></a></p><div class="sub">
+<p>Tool implementation for deriving a partitioning of the current timeline such, that each segement has a constant configuration. "Constant" means here, that any remaining changes over time can be represented by automation solely, without the need to change the node connections.<br /></p><p>Declaration :</p><ul><li>C++ : class SegmentationTool : public <a href="class134149.html#refclass134149"><b>BuilderTool</b></a>, public <a href="class140293.html#refclass140293"><b>Applicable</b></a>&lt;&gt; </li></ul><p>Artifact : <a href="index.html#refartifact131333"><b>segmentationtool</b></a></p><div class="sub">
 <a name="refoperation129925"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(in something : <a href="class134021.html#refclass134021"><b>Buildable</b></a>) : void</li><li>C++ : public: void treat (const <a href="class134021.html#refclass134021"><b>Buildable</b></a>&amp; something) </li></ul><a name="refoperation130181"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(in clip : <a href="class128901.html#refclass128901"><b>Clip</b></a>) : void</li><li>C++ : public: void treat (const <a href="class128901.html#refclass128901"><b>Clip</b></a>&amp; clip) </li></ul><a name="refoperation130053"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(in effect : <a href="class129029.html#refclass129029"><b>Effect</b></a>) : void</li><li>C++ : public: void treat (const <a href="class129029.html#refclass129029"><b>Effect</b></a>&amp; effect) </li></ul><a name="refrelation139013"></a>
-<table><tr><td><div class="element">Relation <b>segments (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # segments : <a href="class135173.html#refclass135173"><b>Segment</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class135173.html#refclass135173"><b>Segment</b></a>&gt; segments</li></ul><p>the partitioning of the Timeline to be created by this tool.<br /></p></div>
+<table><tr><td><div class="element">Relation <b>segments (&lt;directional composition&gt;)</b></div></td></tr></table><p>the partitioning of the Timeline to be created by this tool.<br /></p><p>Declaration :</p><ul><li>Uml : # segments : <a href="class135173.html#refclass135173"><b>Segment</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class135173.html#refclass135173"><b>Segment</b></a>&gt; segments</li></ul><p>Stereotype: list</p>
+<a name="refrelation163461"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class147333.html#refclass147333"><b>Segmentation</b></a></li><li>C++ : protected: <a href="class147333.html#refclass147333"><b>Segmentation</b></a>* </li></ul><p>Stereotype: create</p>
+</div>
 <p>All public operations : <a href="class140293.html#refoperation134405"><b>treat</b></a> , <a href="class134149.html#refoperation129797"><b>treat</b></a> , <a href="class134277.html#refoperation130181"><b>treat</b></a> , <a href="class134277.html#refoperation130053"><b>treat</b></a> , <a href="class134277.html#refoperation129925"><b>treat</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class134405.html b/doc/devel/uml/class134405.html
index 8030835d6..427a1e23a 100644
--- a/doc/devel/uml/class134405.html
+++ b/doc/devel/uml/class134405.html
@@ -16,14 +16,14 @@
 <!-- ============================================================= -->
 
 <a name="refclass134405"></a>
-<p>Declaration :</p><ul><li>C++ : class NodeCreatorTool : public <a href="class134149.html#refclass134149"><b>BuilderTool</b></a>, public <a href="class140293.html#refclass140293"><b>Applicable</b></a>&lt;&gt; </li></ul><p>This Tool implementation plays the central role in the buld process: given a MObject from Session, it is able to attach ProcNodes to the render engine under construction such as to reflect the properties of the MObject in the actual render.<br /></p><p>Artifact : <a href="index.html#refartifact131461"><b>nodecreatertool</b></a></p><div class="sub">
+<p>This Tool implementation plays the central role in the buld process: given a MObject from Session, it is able to attach ProcNodes to the render engine under construction such as to reflect the properties of the MObject in the actual render.<br /></p><p>Declaration :</p><ul><li>C++ : class NodeCreatorTool : public <a href="class134149.html#refclass134149"><b>BuilderTool</b></a>, public <a href="class140293.html#refclass140293"><b>Applicable</b></a>&lt;&gt; </li></ul><p>Artifact : <a href="index.html#refartifact131461"><b>nodecreatertool</b></a></p><div class="sub">
 <a name="refoperation130309"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(inout something : <a href="class134021.html#refclass134021"><b>Buildable</b></a>) : void</li><li>C++ : public: void treat (<a href="class134021.html#refclass134021"><b>Buildable</b></a>&amp; something) </li></ul><a name="refoperation130437"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(inout clip : <a href="class128901.html#refclass128901"><b>Clip</b></a>) : void</li><li>C++ : public: void treat (<a href="class128901.html#refclass128901"><b>Clip</b></a>&amp; clip) </li></ul><a name="refoperation130565"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(inout effect : <a href="class129029.html#refclass129029"><b>Effect</b></a>) : void</li><li>C++ : public: void treat (<a href="class129029.html#refclass129029"><b>Effect</b></a>&amp; effect) </li></ul><a name="refoperation130693"></a>
 <table><tr><td><div class="element">Operation <b>treat</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + treat(inout auto : <a href="class129925.html#refclass129925"><b>Auto</b></a>) : void</li><li>C++ : public: void treat (<a href="class129925.html#refclass129925"><b>Auto</b></a>&amp; auto) </li></ul><a name="refattribute129797"></a>
 <table><tr><td><div class="element">Attribut <b>proc</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # proc : <a href="class131461.html#refclass131461"><b>Processor</b></a></li><li>C++ : protected: <a href="class131461.html#refclass131461"><b>Processor</b></a> proc</li></ul><p>holds the Processor (Render Engine Element) to be built by the current build step<br /></p></div>
+<p>holds the Processor (Render Engine Element) to be built by the current build step<br /></p><p>Declaration :</p><ul><li>Uml : # proc : <a href="class131461.html#refclass131461"><b>RenderGraph</b></a></li><li>C++ : protected: <a href="class131461.html#refclass131461"><b>RenderGraph</b></a> proc</li></ul></div>
 <p>All public operations : <a href="class140293.html#refoperation134405"><b>treat</b></a> , <a href="class134149.html#refoperation129797"><b>treat</b></a> , <a href="class134405.html#refoperation130437"><b>treat</b></a> , <a href="class134405.html#refoperation130565"><b>treat</b></a> , <a href="class134405.html#refoperation130693"><b>treat</b></a> , <a href="class134405.html#refoperation130309"><b>treat</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class134533.html b/doc/devel/uml/class134533.html
index cc2ba0f55..41bf3599e 100644
--- a/doc/devel/uml/class134533.html
+++ b/doc/devel/uml/class134533.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass134533"></a>
-<p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class Parameter </li></ul><p>Descriptor and access object for a plugin parameter. Parameters may be provided with values from the session, and this values may be automated.<br /></p><p>Artifact : <a href="index.html#refartifact134405"><b>parameter</b></a>, Component(s) : <a href="index.html#refcomponent130053"><b>ProcNode</b></a></p><div class="sub">
+<p>Descriptor and access object for a plugin parameter. Parameters may be provided with values from the session, and this values may be automated.<br /></p><p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class Parameter </li></ul><p>Artifact : <a href="index.html#refartifact134405"><b>parameter</b></a>, Component(s) : <a href="index.html#refcomponent130053"><b>ProcNode</b></a></p><div class="sub">
 <a name="refoperation130821"></a>
 <table><tr><td><div class="element">Operation <b>getValue</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getValue() : VAL</li><li>C++ : public: VAL getValue () const </li></ul><a name="refrelation138629"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # provider : <a href="class134661.html#refclass134661"><b>ParamProvider</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class134661.html#refclass134661"><b>ParamProvider</b></a>* provider</li></ul></div>
diff --git a/doc/devel/uml/class134661.html b/doc/devel/uml/class134661.html
index 1933e5d2e..42afe7bb0 100644
--- a/doc/devel/uml/class134661.html
+++ b/doc/devel/uml/class134661.html
@@ -16,8 +16,9 @@
 <!-- ============================================================= -->
 
 <a name="refclass134661"></a>
-<p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class ParamProvider </li><li>Java : public interface ParamProvider&lt;VAL&gt; </li></ul><p>Directly inherited by : <a href="class129925.html#refclass129925"><b>Auto</b></a> </p>
-<p>A facility to get the actual value of a plugin/effect parameter<br /></p><p>Artifact : <a href="index.html#refartifact134533"><b>paramprovider</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><div class="sub">
+<p>A facility to get the actual value of a plugin/effect parameter<br /></p><p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class ParamProvider </li><li>Java : public interface ParamProvider&lt;VAL&gt; </li></ul><p>Directly inherited by : <a href="class129925.html#refclass129925"><b>Auto</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact134533"><b>paramprovider</b></a>, Component(s) : <a href="index.html#refcomponent128133"><b>Session</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refrelation137989"></a>
 <table><tr><td><div class="element">Relation <b>param (&lt;association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # param : <a href="class134533.html#refclass134533"><b>Parameter</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class134533.html#refclass134533"><b>Parameter</b></a>* param</li></ul><a name="refrelation138373"></a>
 <table><tr><td><div class="element">Relation <b>ipo (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # ipo : <a href="class134789.html#refclass134789"><b>Interpolator</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class134789.html#refclass134789"><b>Interpolator</b></a>* ipo</li></ul><a name="refoperation130949"></a>
diff --git a/doc/devel/uml/class134789.html b/doc/devel/uml/class134789.html
index 5da6a8542..c3f469971 100644
--- a/doc/devel/uml/class134789.html
+++ b/doc/devel/uml/class134789.html
@@ -16,5 +16,5 @@
 <!-- ============================================================= -->
 
 <a name="refclass134789"></a>
-<p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class Interpolator </li></ul><p>Provides the implementation for getting the acutal value of a time varying or automated effect/plugin parameter<br /></p><p>Artifact : <a href="index.html#refartifact134661"><b>interpolator</b></a></p></body>
+<p>Provides the implementation for getting the acutal value of a time varying or automated effect/plugin parameter<br /></p><p>Declaration :</p><ul><li>C++ : template&lt;class VAL&gt; class Interpolator </li></ul><p>Artifact : <a href="index.html#refartifact134661"><b>interpolator</b></a></p></body>
 </html>
diff --git a/doc/devel/uml/class134917.html b/doc/devel/uml/class134917.html
index c2d5f5781..cfbb6bb3e 100644
--- a/doc/devel/uml/class134917.html
+++ b/doc/devel/uml/class134917.html
@@ -16,5 +16,5 @@
 <!-- ============================================================= -->
 
 <a name="refclass134917"></a>
-<p>Declaration :</p><ul><li>C++ : class Time </li></ul><p>denotes a temporal position (time point), based on timeline start.<br /><br />investigate posix.4 realtime timers, wrap these here<br /></p><p>Artifact : <a href="index.html#refartifact134789"><b>time</b></a>, Component(s) : <a href="index.html#refcomponent129925"><b>CommonLib</b></a></p></body>
+<p>denotes a temporal position (time point), based on timeline start.<br /><br />investigate posix.4 realtime timers, wrap these here<br /></p><p>Declaration :</p><ul><li>C++ : class Time </li></ul><p>Artifact : <a href="index.html#refartifact134789"><b>time</b></a>, Component(s) : <a href="index.html#refcomponent129925"><b>CommonLib</b></a></p></body>
 </html>
diff --git a/doc/devel/uml/class135173.html b/doc/devel/uml/class135173.html
index d4c848734..9f75dca8e 100644
--- a/doc/devel/uml/class135173.html
+++ b/doc/devel/uml/class135173.html
@@ -21,7 +21,10 @@
 <table><tr><td><div class="element">Attribut <b>start</b></div></td></tr></table>
 <p>Declaration :</p><ul><li>Uml : # start : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> start</li></ul><a name="refattribute130053"></a>
 <table><tr><td><div class="element">Attribut <b>length</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # length : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> length</li></ul><p>duration (span) of this timeline segment.<br /></p><a name="refrelation138885"></a>
-<table><tr><td><div class="element">Relation <b>elements (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # elements : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a> *&gt; elements</li></ul><p>relevant MObjects comprising this segment. TODO: actually necessary??<br /></p></div>
+<p>duration (span) of this timeline segment.<br /></p><p>Declaration :</p><ul><li>Uml : # length : <a href="class134917.html#refclass134917"><b>Time</b></a></li><li>C++ : protected: <a href="class134917.html#refclass134917"><b>Time</b></a> length</li></ul><a name="refrelation138885"></a>
+<table><tr><td><div class="element">Relation <b>elements (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>relevant MObjects comprising this segment. TODO: actually necessary??<br /></p><p>Declaration :</p><ul><li>Uml : # elements : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a>, multiplicity : *</li><li>C++ : protected: list&lt;<a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a> *&gt; elements</li></ul><p>Stereotype: list</p>
+<a name="refrelation163589"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class131461.html#refclass131461"><b>RenderGraph</b></a></li><li>C++ : protected: <a href="class131461.html#refclass131461"><b>RenderGraph</b></a>* </li></ul><p>Stereotype: correspondance</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class135301.html b/doc/devel/uml/class135301.html
index 178a99fd4..286141bf3 100644
--- a/doc/devel/uml/class135301.html
+++ b/doc/devel/uml/class135301.html
@@ -16,5 +16,5 @@
 <!-- ============================================================= -->
 
 <a name="refclass135301"></a>
-<p>Declaration :</p><ul><li>C++ : template&lt;class T&gt; class Factory </li></ul><p>a template for generating functor-like Factory objects, used to encapsulate object creation and providing access via smart-pointers only.<br /></p></body>
+<p>a template for generating functor-like Factory objects, used to encapsulate object creation and providing access via smart-pointers only.<br /></p><p>Declaration :</p><ul><li>C++ : template&lt;class T&gt; class Factory </li></ul></body>
 </html>
diff --git a/doc/devel/uml/class135429.html b/doc/devel/uml/class135429.html
index 538ad35b0..f78af5ebf 100644
--- a/doc/devel/uml/class135429.html
+++ b/doc/devel/uml/class135429.html
@@ -16,13 +16,14 @@
 <!-- ============================================================= -->
 
 <a name="refclass135429"></a>
-<p>Declaration :</p><ul><li>C++ : class Appconfig </li></ul><p>Singleton to hold inevitable global flags and constants and for performing erarly (static) global initialization tasks.<br /></p><p>Artifact : <a href="index.html#refartifact135173"><b>appconfig</b></a></p><div class="sub">
+<p>Singleton to hold inevitable global flags and constants and for performing erarly (static) global initialization tasks.<br /></p><p>Declaration :</p><ul><li>C++ : class Appconfig </li></ul><p>Artifact : <a href="index.html#refartifact135173"><b>appconfig</b></a></p><p>Stereotype: singleton</p>
+<div class="sub">
 <a name="refattribute130181"></a>
 <table><tr><td><div class="element">Attribut <b>theApp_</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : static, - theApp_ : <a href="class135429.html#refclass135429"><b>Appconfig</b></a></li><li>C++ : private: static <a href="class135429.html#refclass135429"><b>Appconfig</b></a> theApp_</li></ul><p>holds the single instance and triggers initialization<br /></p><a name="refoperation131333"></a>
-<table><tr><td><div class="element">Operation <b>Appconfig</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : - Appconfig() : </li><li>C++ : private: Appconfig () </li></ul><p>perform initialization on first access. <br />A call is placed in static initialization code<br />included in lumiera.h<br /></p><a name="refoperation131461"></a>
+<p>holds the single instance and triggers initialization<br /></p><p>Declaration :</p><ul><li>Uml : static, - theApp_ : <a href="class135429.html#refclass135429"><b>Appconfig</b></a></li><li>C++ : private: static <a href="class135429.html#refclass135429"><b>Appconfig</b></a> theApp_</li></ul><a name="refoperation131333"></a>
+<table><tr><td><div class="element">Operation <b>Appconfig</b></div></td></tr></table><p>perform initialization on first access. <br />A call is placed in static initialization code<br />included in lumiera.h<br /></p><p>Declaration :</p><ul><li>Uml : - Appconfig() : </li><li>C++ : private: Appconfig () </li></ul><a name="refoperation131461"></a>
 <table><tr><td><div class="element">Operation <b>instance</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : static, - instance() : Appconfig*</li><li>C++ : private: static Appconfig* instance () </li></ul><a name="refoperation131589"></a>
-<table><tr><td><div class="element">Operation <b>get</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : static, + get(inout key : string) : string</li><li>C++ : public: static string get (string &amp; key) </li></ul><p>access the configuation value for a given key.<br />@return empty string for unknown keys, else the corresponding configuration value<br /></p></div>
+<table><tr><td><div class="element">Operation <b>get</b></div></td></tr></table><p>access the configuation value for a given key.<br />@return empty string for unknown keys, else the corresponding configuration value<br /></p><p>Declaration :</p><ul><li>Uml : static, + get(inout key : string) : string</li><li>C++ : public: static string get (string &amp; key) </li></ul></div>
 <p>All public operations : <a href="class135429.html#refoperation131589"><b>get</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class135557.html b/doc/devel/uml/class135557.html
index cb97dca6f..596d71978 100644
--- a/doc/devel/uml/class135557.html
+++ b/doc/devel/uml/class135557.html
@@ -20,9 +20,10 @@
 <p>Artifact : <a href="index.html#refartifact135813"><b>error</b></a>, Component(s) : <a href="index.html#refcomponent129925"><b>CommonLib</b></a></p><div class="sub">
 <a name="refoperation131845"></a>
 <table><tr><td><div class="element">Operation <b>what</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + what() : const char*</li><li>C++ : public: virtual const char* what () const </li></ul><a name="refoperation131973"></a>
-<table><tr><td><div class="element">Operation <b>rootCause</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + rootCause() : std::exception</li><li>C++ : public: std::exception rootCause () </li></ul><p>If this exception was caused by a chain of further exceptions,<br />return the first one registered in this throw sequence.<br />This works only, if every exceptions thrown as a consequence<br />of another exception is propperly constructed by passing<br />the original exception to the constructor<br /></p><a name="refattribute130309"></a>
+<table><tr><td><div class="element">Operation <b>rootCause</b></div></td></tr></table><p>If this exception was caused by a chain of further exceptions,<br />return the first one registered in this throw sequence.<br />This works only, if every exceptions thrown as a consequence<br />of another exception is propperly constructed by passing<br />the original exception to the constructor<br /></p><p>Declaration :</p><ul><li>Uml : + rootCause() : std::exception</li><li>C++ : public: std::exception rootCause () </li></ul><a name="refattribute130309"></a>
 <table><tr><td><div class="element">Attribut <b>cause</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : - cause : <a href="class136325.html#refclass136325"><b>std::exception</b></a></li><li>C++ : private: <a href="class136325.html#refclass136325"><b>std::exception</b></a> cause</li></ul><p>a copy of the first exception encountered in this exception chain<br /></p></div>
+<p>a copy of the first exception encountered in this exception chain<br /></p><p>Declaration :</p><ul><li>Uml : - cause : <a href="class136325.html#refclass136325"><b>std::exception</b></a></li><li>C++ : private: <a href="class136325.html#refclass136325"><b>std::exception</b></a> cause</li></ul><p>Stereotype: auto_ptr</p>
+</div>
 <p>All public operations : <a href="class135557.html#refoperation131973"><b>rootCause</b></a> , <a href="class135557.html#refoperation131845"><b>what</b></a> , <a href="class136325.html#refoperation131717"><b>what</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class136325.html b/doc/devel/uml/class136325.html
index 002984e29..0fa282d7b 100644
--- a/doc/devel/uml/class136325.html
+++ b/doc/devel/uml/class136325.html
@@ -17,9 +17,10 @@
 
 <a name="refclass136325"></a>
 <p>Declaration :</p><ul><li>C++ : class std::exception </li></ul><p>Directly inherited by : <a href="class135557.html#refclass135557"><b>Error</b></a> </p>
+<p>Stereotype: auxiliary</p>
 <div class="sub">
 <a name="refoperation131717"></a>
-<table><tr><td><div class="element">Operation <b>what</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + what() : const char*</li><li>C++ : public: virtual const char* what () const </li></ul><p>the base class of all exceptions thrown by the standard library<br /></p></div>
+<table><tr><td><div class="element">Operation <b>what</b></div></td></tr></table><p>the base class of all exceptions thrown by the standard library<br /></p><p>Declaration :</p><ul><li>Uml : + what() : const char*</li><li>C++ : public: virtual const char* what () const </li></ul></div>
 <p>All public operations : <a href="class136325.html#refoperation131717"><b>what</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class136453.html b/doc/devel/uml/class136453.html
index 610053bbe..37d311511 100644
--- a/doc/devel/uml/class136453.html
+++ b/doc/devel/uml/class136453.html
@@ -16,28 +16,29 @@
 <!-- ============================================================= -->
 
 <a name="refclass136453"></a>
-<p>Declaration :</p><ul><li>C++ : class Asset </li><li>Java : public interface Asset </li></ul><p>Directly inherited by : <a href="class136709.html#refclass136709"><b>Media</b></a> <a href="class137093.html#refclass137093"><b>Meta</b></a> <a href="class136837.html#refclass136837"><b>Proc</b></a> <a href="class136965.html#refclass136965"><b>Struct</b></a> </p>
-<p>Superinterface describing especially the bookeeping properties of Assets<br /></p><p>Artifact : <a href="index.html#refartifact136069"><b>asset</b></a></p><div class="sub">
+<p>Superinterface describing especially the bookeeping properties of Assets<br /></p><p>Declaration :</p><ul><li>C++ : class Asset </li><li>Java : public interface Asset </li></ul><p>Directly inherited by : <a href="class136709.html#refclass136709"><b>Media</b></a> <a href="class137093.html#refclass137093"><b>Meta</b></a> <a href="class136837.html#refclass136837"><b>Proc</b></a> <a href="class136965.html#refclass136965"><b>Struct</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact136069"><b>asset</b></a></p><p>Stereotype: interface</p>
+<div class="sub">
 <a name="refattribute130437"></a>
 <table><tr><td><div class="element">Attribut <b>id</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : + id : long</li><li>C++ : public: const long id</li></ul><p>Asset primary key.<br /></p><a name="refattribute130565"></a>
+<p>Asset primary key.<br /></p><p>Declaration :</p><ul><li>Uml : + id : long</li><li>C++ : public: const long id</li></ul><a name="refattribute130565"></a>
 <table><tr><td><div class="element">Attribut <b>name</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : + name : string</li><li>C++ : public: const string name</li></ul><p>element ID, comprehensible but sanitized. The tuple (category, name, org) is unique.<br /></p><a name="refrelation140421"></a>
-<table><tr><td><div class="element">Relation <b>category (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + category : <a href="class137221.html#refclass137221"><b>Category</b></a>, multiplicity : 1</li><li>C++ : public: const <a href="class137221.html#refclass137221"><b>Category</b></a>* category</li></ul><p>primary tree like classification of the asset<br /></p><a name="refattribute130821"></a>
+<p>element ID, comprehensible but sanitized. The tuple (category, name, org) is unique.<br /></p><p>Declaration :</p><ul><li>Uml : + name : string</li><li>C++ : public: const string name</li></ul><a name="refrelation140421"></a>
+<table><tr><td><div class="element">Relation <b>category (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>primary tree like classification of the asset<br /></p><p>Declaration :</p><ul><li>Uml : + category : <a href="class137221.html#refclass137221"><b>Category</b></a>, multiplicity : 1</li><li>C++ : public: const <a href="class137221.html#refclass137221"><b>Category</b></a>* category</li></ul><a name="refattribute130821"></a>
 <table><tr><td><div class="element">Attribut <b>org</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : + org : string</li><li>C++ : public: const string org</li></ul><p>origin or authorship id. Can be a project abbreviation, a package id or just the authors nickname or UID. This allows for the compnent name to be more generic (e.g. "blur"). Default for all assets provided by the core Lumiera codebase is "lumi".<br /></p><a name="refattribute130949"></a>
+<p>origin or authorship id. Can be a project abbreviation, a package id or just the authors nickname or UID. This allows for the compnent name to be more generic (e.g. "blur"). Default for all assets provided by the core Lumiera codebase is "lumi".<br /></p><p>Declaration :</p><ul><li>Uml : + org : string</li><li>C++ : public: const string org</li></ul><a name="refattribute130949"></a>
 <table><tr><td><div class="element">Attribut <b>version</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : + version : uint</li><li>C++ : public: const unsigned int version</li></ul><p>version number of the thing or concept represented by this asset. Of each unique tuple (name, category, org) there will be only one version in the whole system. Version 0 is reserved for internal purposes. Versions are considered to be ordered, and any higher version is supposed to be fully backwards compatible to all previous versions.<br /></p><a name="refattribute131077"></a>
+<p>version number of the thing or concept represented by this asset. Of each unique tuple (name, category, org) there will be only one version in the whole system. Version 0 is reserved for internal purposes. Versions are considered to be ordered, and any higher version is supposed to be fully backwards compatible to all previous versions.<br /></p><p>Declaration :</p><ul><li>Uml : + version : uint</li><li>C++ : public: const unsigned int version</li></ul><a name="refattribute131077"></a>
 <table><tr><td><div class="element">Attribut <b>groups</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # groups : set&lt;string&gt;</li><li>C++ : protected: set&lt;string&gt; groups</li></ul><p>additional classification, selections or departments this asset belongs to. Groups are optional, non-exclusive and may be overlapping.<br /></p><a name="refattribute131205"></a>
+<p>additional classification, selections or departments this asset belongs to. Groups are optional, non-exclusive and may be overlapping.<br /></p><p>Declaration :</p><ul><li>Uml : # groups : set&lt;string&gt;</li><li>C++ : protected: set&lt;string&gt; groups</li></ul><a name="refattribute131205"></a>
 <table><tr><td><div class="element">Attribut <b>shortDesc</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # shortDesc : string</li><li>C++ : protected: const string shortDesc</li></ul><p>user visible Name-ID. To be localized.<br /></p><a name="refattribute131333"></a>
+<p>user visible Name-ID. To be localized.<br /></p><p>Declaration :</p><ul><li>Uml : # shortDesc : string</li><li>C++ : protected: const string shortDesc</li></ul><a name="refattribute131333"></a>
 <table><tr><td><div class="element">Attribut <b>longDesc</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : # longDesc : string</li><li>C++ : protected: const string longDesc</li></ul><p>user visible qualification of the thing, unit or concept represented by this asset. perferably "in one line". To be localized.<br /></p><a name="refoperation132101"></a>
-<table><tr><td><div class="element">Operation <b>getParents</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getParents() : vector&lt;PAsset&gt;</li><li>C++ : public: vector&lt;PAsset&gt; getParents () </li></ul><p>List of entities this asset depends on or requires to be functional. May be empty. The head of this list can be considered the primary prerequisite<br /></p><a name="refoperation132229"></a>
-<table><tr><td><div class="element">Operation <b>getDependant</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getDependant() : vector&lt;PAsset&gt;</li><li>C++ : public: vector&lt;PAsset&gt; getDependant () </li></ul><p>All the other assets requiring this asset to be functional. For example, all the clips depending on a given media file. May be empty. The dependency relation is transitive.<br /></p><a name="refoperation132869"></a>
-<table><tr><td><div class="element">Operation <b>isActive</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + isActive() : bool</li><li>C++ : public: bool isActive () </li></ul><p>weather this asset is swithced on and consequently included in the fixture and participates in rendering<br /></p><a name="refoperation132997"></a>
-<table><tr><td><div class="element">Operation <b>enable</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + enable(in bool : ) : void,  exceptions : <a href="class135941.html#refclass135941"><b>State</b></a></li><li>C++ : public: void enable ()  throw (<a href="class135941.html#refclass135941"><b>State</b></a>)</li></ul><p>change the enabled status of this asset. Note the corresponding #isActive predicate may depend on the enablement status of parent assets as well<br /></p></div>
+<p>user visible qualification of the thing, unit or concept represented by this asset. perferably "in one line". To be localized.<br /></p><p>Declaration :</p><ul><li>Uml : # longDesc : string</li><li>C++ : protected: const string longDesc</li></ul><a name="refoperation132101"></a>
+<table><tr><td><div class="element">Operation <b>getParents</b></div></td></tr></table><p>List of entities this asset depends on or requires to be functional. May be empty. The head of this list can be considered the primary prerequisite<br /></p><p>Declaration :</p><ul><li>Uml : + getParents() : vector&lt;PAsset&gt;</li><li>C++ : public: vector&lt;PAsset&gt; getParents () </li></ul><a name="refoperation132229"></a>
+<table><tr><td><div class="element">Operation <b>getDependant</b></div></td></tr></table><p>All the other assets requiring this asset to be functional. For example, all the clips depending on a given media file. May be empty. The dependency relation is transitive.<br /></p><p>Declaration :</p><ul><li>Uml : + getDependant() : vector&lt;PAsset&gt;</li><li>C++ : public: vector&lt;PAsset&gt; getDependant () </li></ul><a name="refoperation132869"></a>
+<table><tr><td><div class="element">Operation <b>isActive</b></div></td></tr></table><p>weather this asset is swithced on and consequently included in the fixture and participates in rendering<br /></p><p>Declaration :</p><ul><li>Uml : + isActive() : bool</li><li>C++ : public: bool isActive () </li></ul><a name="refoperation132997"></a>
+<table><tr><td><div class="element">Operation <b>enable</b></div></td></tr></table><p>change the enabled status of this asset. Note the corresponding #isActive predicate may depend on the enablement status of parent assets as well<br /></p><p>Declaration :</p><ul><li>Uml : + enable(in bool : ) : void,  exceptions : <a href="class135941.html#refclass135941"><b>State</b></a></li><li>C++ : public: void enable ()  throw (<a href="class135941.html#refclass135941"><b>State</b></a>)</li></ul></div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class136581.html b/doc/devel/uml/class136581.html
index f9cfcc755..27db85e0f 100644
--- a/doc/devel/uml/class136581.html
+++ b/doc/devel/uml/class136581.html
@@ -16,14 +16,15 @@
 <!-- ============================================================= -->
 
 <a name="refclass136581"></a>
-<p>Declaration :</p><ul><li>C++ : class AssetManager </li></ul><p>Facade for the Asset subsystem<br /></p><p>Artifact : <a href="index.html#refartifact136197"><b>assetmanager</b></a></p><div class="sub">
+<p>Facade for the Asset subsystem<br /></p><p>Declaration :</p><ul><li>C++ : class AssetManager </li></ul><p>Artifact : <a href="index.html#refartifact136197"><b>assetmanager</b></a></p><p>Stereotype: boundary</p>
+<div class="sub">
 <a name="refoperation133125"></a>
 <table><tr><td><div class="element">Operation <b>getID</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : static, + getID(in idi : <a href="class136453.html#refclass136453"><b>Asset</b></a>) : </li><li>C++ : public: static  getID () </li></ul><a name="refoperation132485"></a>
-<table><tr><td><div class="element">Operation <b>getAsset</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getAsset(in id : long) : KIND,  exceptions : <a href="class136069.html#refclass136069"><b>Invalid</b></a></li><li>C++ : public: template&lt;class KIND&gt; KIND getAsset (long &amp; id)  throw (<a href="class136069.html#refclass136069"><b>Invalid</b></a>)</li></ul><p>find and return corresponging object<br /></p><a name="refoperation132613"></a>
-<table><tr><td><div class="element">Operation <b>known</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + known(in id : long) : bool</li><li>C++ : public: bool known (long id) </li></ul><p>@return true if the given id is registered in the internal asset DB<br /></p><a name="refoperation132741"></a>
-<table><tr><td><div class="element">Operation <b>remove</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + remove(in id : long) : void,  exceptions : <a href="class136069.html#refclass136069"><b>Invalid</b></a>, <a href="class135941.html#refclass135941"><b>State</b></a></li><li>C++ : public: void remove (long id)  throw (<a href="class136069.html#refclass136069"><b>Invalid</b></a>, <a href="class135941.html#refclass135941"><b>State</b></a>)</li></ul><p>remove the given asset &lt;i&gt;together with all its dependants&lt;/i&gt; from the internal DB<br /></p><a name="refoperation132357"></a>
-<table><tr><td><div class="element">Operation <b>reg</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : static, # reg(inout name : string, inout category : string, inout org : string, inout uint : version) : long,  exceptions : Invalid</li><li>C++ : protected: static long reg (string &amp; name, string &amp; category, string &amp; org, version&amp; uint)  throw (Invalid)</li></ul><p>registers an asset object in the internal DB, providing its unique key<br /></p><a name="refrelation142085"></a>
-<table><tr><td><div class="element">Relation <b>registry (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # registry : <a href="class138373.html#refclass138373"><b>DB</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class138373.html#refclass138373"><b>DB</b></a>* registry</li></ul><p>@internal Table or DB holding all registered asset instances.<br /></p></div>
+<table><tr><td><div class="element">Operation <b>getAsset</b></div></td></tr></table><p>find and return corresponging object<br /></p><p>Declaration :</p><ul><li>Uml : + getAsset(in id : long) : KIND,  exceptions : <a href="class136069.html#refclass136069"><b>Invalid</b></a></li><li>C++ : public: template&lt;class KIND&gt; KIND getAsset (long &amp; id)  throw (<a href="class136069.html#refclass136069"><b>Invalid</b></a>)</li></ul><a name="refoperation132613"></a>
+<table><tr><td><div class="element">Operation <b>known</b></div></td></tr></table><p>@return true if the given id is registered in the internal asset DB<br /></p><p>Declaration :</p><ul><li>Uml : + known(in id : long) : bool</li><li>C++ : public: bool known (long id) </li></ul><a name="refoperation132741"></a>
+<table><tr><td><div class="element">Operation <b>remove</b></div></td></tr></table><p>remove the given asset &lt;i&gt;together with all its dependants&lt;/i&gt; from the internal DB<br /></p><p>Declaration :</p><ul><li>Uml : + remove(in id : long) : void,  exceptions : <a href="class136069.html#refclass136069"><b>Invalid</b></a>, <a href="class135941.html#refclass135941"><b>State</b></a></li><li>C++ : public: void remove (long id)  throw (<a href="class136069.html#refclass136069"><b>Invalid</b></a>, <a href="class135941.html#refclass135941"><b>State</b></a>)</li></ul><a name="refoperation132357"></a>
+<table><tr><td><div class="element">Operation <b>reg</b></div></td></tr></table><p>registers an asset object in the internal DB, providing its unique key<br /></p><p>Declaration :</p><ul><li>Uml : static, # reg(inout name : string, inout category : string, inout org : string, inout uint : version) : long,  exceptions : Invalid</li><li>C++ : protected: static long reg (string &amp; name, string &amp; category, string &amp; org, version&amp; uint)  throw (Invalid)</li></ul><a name="refrelation142085"></a>
+<table><tr><td><div class="element">Relation <b>registry (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>@internal Table or DB holding all registered asset instances.<br /></p><p>Declaration :</p><ul><li>Uml : # registry : <a href="class138373.html#refclass138373"><b>DB</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class138373.html#refclass138373"><b>DB</b></a>* registry</li></ul></div>
 <p>All public operations : <a href="class136581.html#refoperation132485"><b>getAsset</b></a> , <a href="class136581.html#refoperation133125"><b>getID</b></a> , <a href="class136581.html#refoperation132613"><b>known</b></a> , <a href="class136581.html#refoperation132741"><b>remove</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class136709.html b/doc/devel/uml/class136709.html
index b07b2cdc6..07f4ded09 100644
--- a/doc/devel/uml/class136709.html
+++ b/doc/devel/uml/class136709.html
@@ -16,11 +16,11 @@
 <!-- ============================================================= -->
 
 <a name="refclass136709"></a>
-<p>Declaration :</p><ul><li>C++ : class Media : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class137349.html#refclass137349"><b>Clip</b></a> <a href="class138501.html#refclass138501"><b>CompoundMedia</b></a> <a href="class137477.html#refclass137477"><b>Unknown</b></a> </p>
-<p>key abstraction: media-like assets<br /></p><p>Artifact : <a href="index.html#refartifact136453"><b>media</b></a></p><div class="sub">
+<p>key abstraction: media-like assets<br /></p><p>Declaration :</p><ul><li>C++ : class Media : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class137349.html#refclass137349"><b>Clip</b></a> <a href="class138501.html#refclass138501"><b>CompoundMedia</b></a> <a href="class137477.html#refclass137477"><b>Unknown</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact136453"><b>media</b></a></p><div class="sub">
 <a name="refoperation133253"></a>
-<table><tr><td><div class="element">Operation <b>createClip</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + createClip() : <a href="class128901.html#refclass128901"><b>Clip</b></a></li><li>C++ : public: <a href="class128901.html#refclass128901"><b>Clip</b></a> createClip () </li></ul><p>create a (possibly compound) Clip refering to this media, ready to be added to the EDL.<br /></p><a name="refoperation133381"></a>
-<table><tr><td><div class="element">Operation <b>howtoProc</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + howtoProc() : <a href="class138757.html#refclass138757"><b>ProcPatt</b></a></li><li>C++ : public: <a href="class138757.html#refclass138757"><b>ProcPatt</b></a> howtoProc () </li></ul><p>@return descriptor how to build a render pipeline corresponding to this media<br /></p></div>
+<table><tr><td><div class="element">Operation <b>createClip</b></div></td></tr></table><p>create a (possibly compound) Clip refering to this media, ready to be added to the EDL.<br /></p><p>Declaration :</p><ul><li>Uml : + createClip() : <a href="class128901.html#refclass128901"><b>Clip</b></a></li><li>C++ : public: <a href="class128901.html#refclass128901"><b>Clip</b></a> createClip () </li></ul><a name="refoperation133381"></a>
+<table><tr><td><div class="element">Operation <b>howtoProc</b></div></td></tr></table><p>@return descriptor how to build a render pipeline corresponding to this media<br /></p><p>Declaration :</p><ul><li>Uml : + howtoProc() : <a href="class138757.html#refclass138757"><b>ProcPatt</b></a></li><li>C++ : public: <a href="class138757.html#refclass138757"><b>ProcPatt</b></a> howtoProc () </li></ul></div>
 <p>All public operations : <a href="class136709.html#refoperation133253"><b>createClip</b></a> , <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136709.html#refoperation133381"><b>howtoProc</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class136837.html b/doc/devel/uml/class136837.html
index 32eeedace..ee7c013c5 100644
--- a/doc/devel/uml/class136837.html
+++ b/doc/devel/uml/class136837.html
@@ -16,8 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass136837"></a>
-<p>Declaration :</p><ul><li>C++ : class Proc : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class137861.html#refclass137861"><b>Codec</b></a> <a href="class137733.html#refclass137733"><b>Effect</b></a> </p>
-<p>key abstraction: data processing asset<br /></p><p>Artifact : <a href="index.html#refartifact136581"><b>proc</b></a></p><div class="sub">
+<p>key abstraction: data processing asset<br /></p><p>Declaration :</p><ul><li>C++ : class Proc : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class137861.html#refclass137861"><b>Codec</b></a> <a href="class137733.html#refclass137733"><b>Effect</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact136581"><b>proc</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class136965.html b/doc/devel/uml/class136965.html
index b705413c0..6d8310a27 100644
--- a/doc/devel/uml/class136965.html
+++ b/doc/devel/uml/class136965.html
@@ -16,8 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass136965"></a>
-<p>Declaration :</p><ul><li>C++ : class Struct : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class138117.html#refclass138117"><b>Pipe</b></a> <a href="class138757.html#refclass138757"><b>ProcPatt</b></a> <a href="class137989.html#refclass137989"><b>Track</b></a> </p>
-<p>key abstraction: structural asset<br /></p><p>Artifact : <a href="index.html#refartifact136709"><b>struct</b></a></p><div class="sub">
+<p>key abstraction: structural asset<br /></p><p>Declaration :</p><ul><li>C++ : class Struct : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class138117.html#refclass138117"><b>Pipe</b></a> <a href="class138757.html#refclass138757"><b>ProcPatt</b></a> <a href="class137989.html#refclass137989"><b>Track</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact136709"><b>struct</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class137093.html b/doc/devel/uml/class137093.html
index 6fc18f4e0..c57edd68a 100644
--- a/doc/devel/uml/class137093.html
+++ b/doc/devel/uml/class137093.html
@@ -16,8 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass137093"></a>
-<p>Declaration :</p><ul><li>C++ : class Meta : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class138245.html#refclass138245"><b>Dataset</b></a> </p>
-<p>key abstraction: metadata and organisational asset<br /></p><p>Artifact : <a href="index.html#refartifact136837"><b>meta</b></a></p><div class="sub">
+<p>key abstraction: metadata and organisational asset<br /></p><p>Declaration :</p><ul><li>C++ : class Meta : public <a href="class136453.html#refclass136453"><b>Asset</b></a> </li></ul><p>Directly inherited by : <a href="class138245.html#refclass138245"><b>Dataset</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact136837"><b>meta</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class137221.html b/doc/devel/uml/class137221.html
index 6bac4b8ca..273e26211 100644
--- a/doc/devel/uml/class137221.html
+++ b/doc/devel/uml/class137221.html
@@ -16,5 +16,5 @@
 <!-- ============================================================= -->
 
 <a name="refclass137221"></a>
-<p>Declaration :</p><ul><li>C++ : class Category </li></ul><p>tree like classification of Assets<br /></p><p>Artifact : <a href="index.html#refartifact135941"><b>category</b></a></p></body>
+<p>tree like classification of Assets<br /></p><p>Declaration :</p><ul><li>C++ : class Category </li></ul><p>Artifact : <a href="index.html#refartifact135941"><b>category</b></a></p></body>
 </html>
diff --git a/doc/devel/uml/class137349.html b/doc/devel/uml/class137349.html
index 7d1b67bef..5239eaf48 100644
--- a/doc/devel/uml/class137349.html
+++ b/doc/devel/uml/class137349.html
@@ -16,9 +16,9 @@
 <!-- ============================================================= -->
 
 <a name="refclass137349"></a>
-<p>Declaration :</p><ul><li>C++ : class Clip : public <a href="class136709.html#refclass136709"><b>Media</b></a> </li></ul><p>bookkeeping (asset) view of a media clip.<br /></p><p>Artifact : <a href="index.html#refartifact136325"><b>clip</b></a></p><div class="sub">
+<p>bookkeeping (asset) view of a media clip.<br /></p><p>Declaration :</p><ul><li>C++ : class Clip : public <a href="class136709.html#refclass136709"><b>Media</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact136325"><b>clip</b></a></p><div class="sub">
 <a name="refrelation141957"></a>
-<table><tr><td><div class="element">Relation <b>source (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # source : <a href="class136709.html#refclass136709"><b>Media</b></a>, multiplicity : 1</li><li>C++ : protected: const <a href="class136709.html#refclass136709"><b>Media</b></a>* source</li></ul><p>media source of this clip<br /></p></div>
+<table><tr><td><div class="element">Relation <b>source (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>media source of this clip<br /></p><p>Declaration :</p><ul><li>Uml : # source : <a href="class136709.html#refclass136709"><b>Media</b></a>, multiplicity : 1</li><li>C++ : protected: const <a href="class136709.html#refclass136709"><b>Media</b></a>* source</li></ul></div>
 <p>All public operations : <a href="class136709.html#refoperation133253"><b>createClip</b></a> , <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136709.html#refoperation133381"><b>howtoProc</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class137477.html b/doc/devel/uml/class137477.html
index 8f5631895..b1b8d8b30 100644
--- a/doc/devel/uml/class137477.html
+++ b/doc/devel/uml/class137477.html
@@ -16,8 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass137477"></a>
-<p>Declaration :</p><ul><li>C++ : class Unknown : public <a href="class136709.html#refclass136709"><b>Media</b></a> </li></ul><p>Directly inherited by : <a href="class137605.html#refclass137605"><b>Preview</b></a> </p>
-<p>placeholder for unknown or unavailable media source<br /></p><p>Artifact : <a href="index.html#refartifact137093"><b>unknown</b></a></p><div class="sub">
+<p>placeholder for unknown or unavailable media source<br /></p><p>Declaration :</p><ul><li>C++ : class Unknown : public <a href="class136709.html#refclass136709"><b>Media</b></a> </li></ul><p>Directly inherited by : <a href="class137605.html#refclass137605"><b>Preview</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact137093"><b>unknown</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136709.html#refoperation133253"><b>createClip</b></a> , <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136709.html#refoperation133381"><b>howtoProc</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class137605.html b/doc/devel/uml/class137605.html
index f8942d22a..9d793649b 100644
--- a/doc/devel/uml/class137605.html
+++ b/doc/devel/uml/class137605.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass137605"></a>
-<p>Declaration :</p><ul><li>C++ : class Preview : public <a href="class137477.html#refclass137477"><b>Unknown</b></a> </li></ul><p>alternative version of the media data, probably with lower resolution<br /></p><p>Artifact : <a href="index.html#refartifact136965"><b>preview</b></a></p><div class="sub">
+<p>alternative version of the media data, probably with lower resolution<br /></p><p>Declaration :</p><ul><li>C++ : class Preview : public <a href="class137477.html#refclass137477"><b>Unknown</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact136965"><b>preview</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136709.html#refoperation133253"><b>createClip</b></a> , <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136709.html#refoperation133381"><b>howtoProc</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class137733.html b/doc/devel/uml/class137733.html
index 9e9122764..e1c77a7e1 100644
--- a/doc/devel/uml/class137733.html
+++ b/doc/devel/uml/class137733.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass137733"></a>
-<p>Declaration :</p><ul><li>C++ : class Effect : public <a href="class136837.html#refclass136837"><b>Proc</b></a> </li></ul><p>Effect or media processing component<br /></p><p>Artifact : <a href="index.html#refartifact137221"><b>effect</b></a></p><div class="sub">
+<p>Effect or media processing component<br /></p><p>Declaration :</p><ul><li>C++ : class Effect : public <a href="class136837.html#refclass136837"><b>Proc</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact137221"><b>effect</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class137861.html b/doc/devel/uml/class137861.html
index e492ab185..3daa3239c 100644
--- a/doc/devel/uml/class137861.html
+++ b/doc/devel/uml/class137861.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass137861"></a>
-<p>Declaration :</p><ul><li>C++ : class Codec : public <a href="class136837.html#refclass136837"><b>Proc</b></a> </li></ul><p>description of some media data decoder or encoder facility<br /></p><p>Artifact : <a href="index.html#refartifact137349"><b>codec</b></a></p><div class="sub">
+<p>description of some media data decoder or encoder facility<br /></p><p>Declaration :</p><ul><li>C++ : class Codec : public <a href="class136837.html#refclass136837"><b>Proc</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact137349"><b>codec</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class137989.html b/doc/devel/uml/class137989.html
index 5ee601cc6..95d34e58f 100644
--- a/doc/devel/uml/class137989.html
+++ b/doc/devel/uml/class137989.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass137989"></a>
-<p>Declaration :</p><ul><li>C++ : class Track : public <a href="class136965.html#refclass136965"><b>Struct</b></a> </li></ul><p>structural asset holding the configuration of a track in the EDL<br /></p><p>Artifact : <a href="index.html#refartifact137477"><b>track</b></a></p><div class="sub">
+<p>structural asset holding the configuration of a track in the EDL<br /></p><p>Declaration :</p><ul><li>C++ : class Track : public <a href="class136965.html#refclass136965"><b>Struct</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact137477"><b>track</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class138117.html b/doc/devel/uml/class138117.html
index a0c0efcf7..6303d6c05 100644
--- a/doc/devel/uml/class138117.html
+++ b/doc/devel/uml/class138117.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass138117"></a>
-<p>Declaration :</p><ul><li>C++ : class Pipe : public <a href="class136965.html#refclass136965"><b>Struct</b></a> </li></ul><p>structural asset representing a basic building block within the high level model: a port for building a processing chain and generating media output<br /></p><p>Artifact : <a href="index.html#refartifact137605"><b>pipe</b></a></p><div class="sub">
+<p>structural asset representing a basic building block within the high level model: a port for building a processing chain and generating media output<br /></p><p>Declaration :</p><ul><li>C++ : class Pipe : public <a href="class136965.html#refclass136965"><b>Struct</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact137605"><b>pipe</b></a></p><div class="sub">
 <a name="refrelation148229"></a>
 <table><tr><td><div class="element">Relation <b>wiringTemplate (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # wiringTemplate : <a href="class138757.html#refclass138757"><b>ProcPatt</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class138757.html#refclass138757"><b>ProcPatt</b></a>* wiringTemplate</li></ul></div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
diff --git a/doc/devel/uml/class138245.html b/doc/devel/uml/class138245.html
index cc00110c8..42565060f 100644
--- a/doc/devel/uml/class138245.html
+++ b/doc/devel/uml/class138245.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass138245"></a>
-<p>Declaration :</p><ul><li>C++ : class Dataset : public <a href="class137093.html#refclass137093"><b>Meta</b></a> </li></ul><p>meta asset describing a collection of control data<br /></p><p>Artifact : <a href="index.html#refartifact137733"><b>dataset</b></a></p><div class="sub">
+<p>meta asset describing a collection of control data<br /></p><p>Declaration :</p><ul><li>C++ : class Dataset : public <a href="class137093.html#refclass137093"><b>Meta</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact137733"><b>dataset</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class138373.html b/doc/devel/uml/class138373.html
index 59b8657a5..9e4e8f0ea 100644
--- a/doc/devel/uml/class138373.html
+++ b/doc/devel/uml/class138373.html
@@ -16,5 +16,5 @@
 <!-- ============================================================= -->
 
 <a name="refclass138373"></a>
-<p>Declaration :</p><ul><li>C++ : class DB </li></ul><p>Implementation of the registry holding all Asset instances known to the Asset Manager subsystem. As of 8/2007 implemented by a hashtable.<br /></p><p>Artifact : <a href="index.html#refartifact137861"><b>db</b></a></p></body>
+<p>Implementation of the registry holding all Asset instances known to the Asset Manager subsystem. As of 8/2007 implemented by a hashtable.<br /></p><p>Declaration :</p><ul><li>C++ : class DB </li></ul><p>Artifact : <a href="index.html#refartifact137861"><b>db</b></a></p></body>
 </html>
diff --git a/doc/devel/uml/class138501.html b/doc/devel/uml/class138501.html
index fd0b56e89..420f671ef 100644
--- a/doc/devel/uml/class138501.html
+++ b/doc/devel/uml/class138501.html
@@ -16,9 +16,10 @@
 <!-- ============================================================= -->
 
 <a name="refclass138501"></a>
-<p>Declaration :</p><ul><li>C++ : class CompoundMedia : public <a href="class136709.html#refclass136709"><b>Media</b></a> </li></ul><p>compound of several elementary media tracks,<br />e.g. the individual media streams found in one media file<br /></p><p>Artifact : <a href="index.html#refartifact138245"><b>compoundmedia</b></a></p><div class="sub">
+<p>compound of several elementary media tracks,<br />e.g. the individual media streams found in one media file<br /></p><p>Declaration :</p><ul><li>C++ : class CompoundMedia : public <a href="class136709.html#refclass136709"><b>Media</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact138245"><b>compoundmedia</b></a></p><div class="sub">
 <a name="refrelation142341"></a>
-<table><tr><td><div class="element">Relation <b>tracks (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # tracks : <a href="class136709.html#refclass136709"><b>Media</b></a>, multiplicity : 1..*</li><li>C++ : protected: vector&lt;<a href="class136709.html#refclass136709"><b>Media</b></a> *&gt; tracks</li></ul><p>elementary media assets comprising this compound<br /></p></div>
+<table><tr><td><div class="element">Relation <b>tracks (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>elementary media assets comprising this compound<br /></p><p>Declaration :</p><ul><li>Uml : # tracks : <a href="class136709.html#refclass136709"><b>Media</b></a>, multiplicity : 1..*</li><li>C++ : protected: vector&lt;<a href="class136709.html#refclass136709"><b>Media</b></a> *&gt; tracks</li></ul><p>Stereotype: vector</p>
+</div>
 <p>All public operations : <a href="class136709.html#refoperation133253"><b>createClip</b></a> , <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136709.html#refoperation133381"><b>howtoProc</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class138629.html b/doc/devel/uml/class138629.html
index 83cab8165..07422105d 100644
--- a/doc/devel/uml/class138629.html
+++ b/doc/devel/uml/class138629.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass138629"></a>
-<p>Declaration :</p><ul><li>C++ : class CompoundClip : public <a href="class128901.html#refclass128901"><b>Clip</b></a> </li></ul><p>Clip MObject which is actually a compound of several elementary clips,<br />e.g. the several streams found within multichannels media.<br /></p><p>Artifact : <a href="index.html#refartifact138501"><b>compoundclip</b></a>, Diagram : <a href="index.html#refclass diagram128133"><b>Session structure</b></a></p><div class="sub">
+<p>Clip MObject which is actually a compound of several elementary clips,<br />e.g. the several streams found within multichannels media.<br /></p><p>Declaration :</p><ul><li>C++ : class CompoundClip : public <a href="class128901.html#refclass128901"><b>Clip</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact138501"><b>compoundclip</b></a>, Diagram : <a href="index.html#refclass diagram128133"><b>Session structure</b></a></p><div class="sub">
 <a name="refrelation143493"></a>
 <table><tr><td><div class="element">Relation <b>components (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # components : <a href="class128901.html#refclass128901"><b>Clip</b></a>, multiplicity : 1..*</li><li>C++ : protected: <a href="class128901.html#refclass128901"><b>Clip</b></a>* components</li></ul></div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
diff --git a/doc/devel/uml/class138757.html b/doc/devel/uml/class138757.html
index d4594382d..786f86aa2 100644
--- a/doc/devel/uml/class138757.html
+++ b/doc/devel/uml/class138757.html
@@ -16,9 +16,10 @@
 <!-- ============================================================= -->
 
 <a name="refclass138757"></a>
-<p>Declaration :</p><ul><li>C++ : class ProcPatt : public <a href="class136965.html#refclass136965"><b>Struct</b></a> </li></ul><p>special type of structural Asset representing information how to build some part of the render engine's processing nodes network.<br /></p><p>Artifact : <a href="index.html#refartifact137989"><b>procpatt</b></a></p><div class="sub">
+<p>special type of structural Asset representing information how to build some part of the render engine's processing nodes network.<br /></p><p>Declaration :</p><ul><li>C++ : class ProcPatt : public <a href="class136965.html#refclass136965"><b>Struct</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact137989"><b>procpatt</b></a></p><div class="sub">
 <a name="refrelation143621"></a>
-<table><tr><td><div class="element">Relation <b>instructions (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # instructions : <a href="class139013.html#refclass139013"><b>BuildInstruct</b></a>, multiplicity : 1..*</li><li>C++ : protected: const vector&lt;<a href="class139013.html#refclass139013"><b>BuildInstruct</b></a>&gt; instructions</li></ul></div>
+<table><tr><td><div class="element">Relation <b>instructions (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # instructions : <a href="class139013.html#refclass139013"><b>BuildInstruct</b></a>, multiplicity : 1..*</li><li>C++ : protected: const vector&lt;<a href="class139013.html#refclass139013"><b>BuildInstruct</b></a>&gt; instructions</li></ul><p>Stereotype: vector</p>
+</div>
 <p>All public operations : <a href="class136453.html#refoperation132997"><b>enable</b></a> , <a href="class136453.html#refoperation132229"><b>getDependant</b></a> , <a href="class136453.html#refoperation132101"><b>getParents</b></a> , <a href="class136453.html#refoperation132869"><b>isActive</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class138885.html b/doc/devel/uml/class138885.html
index ce532c0e7..efb3765a6 100644
--- a/doc/devel/uml/class138885.html
+++ b/doc/devel/uml/class138885.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass138885"></a>
-<p>Declaration :</p><ul><li>C++ : class SimpleClip : public <a href="class128901.html#refclass128901"><b>Clip</b></a> </li></ul><p>Elementary clip consisting of only one media stream<br /></p><p>Artifact : <a href="index.html#refartifact138373"><b>simpleclip</b></a></p><div class="sub">
+<p>Elementary clip consisting of only one media stream<br /></p><p>Declaration :</p><ul><li>C++ : class SimpleClip : public <a href="class128901.html#refclass128901"><b>Clip</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact138373"><b>simpleclip</b></a></p><div class="sub">
 </div>
 <p>All public operations : <a href="class134021.html#refoperation129669"><b>apply</b></a> , <a href="class140165.html#refoperation134789"><b>apply</b></a> , <a href="class140165.html#refoperation134917"><b>dispatchOp</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class139013.html b/doc/devel/uml/class139013.html
index 9c8b83182..77b78ca2c 100644
--- a/doc/devel/uml/class139013.html
+++ b/doc/devel/uml/class139013.html
@@ -16,6 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass139013"></a>
-<p>Declaration :</p><ul><li>C++ : class BuildInstruct </li></ul><p>Directly inherited by : <a href="class139141.html#refclass139141"><b>DoAttach</b></a> <a href="class139269.html#refclass139269"><b>DoRecurse</b></a> </p>
-<p>(Interface) building instructions to be executed by the Builder on the render node network under construction.<br /></p><p>Artifact : <a href="index.html#refartifact138117"><b>buildinstruct</b></a></p></body>
+<p>(Interface) building instructions to be executed by the Builder on the render node network under construction.<br /></p><p>Declaration :</p><ul><li>C++ : class BuildInstruct </li></ul><p>Directly inherited by : <a href="class139141.html#refclass139141"><b>DoAttach</b></a> <a href="class139269.html#refclass139269"><b>DoRecurse</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact138117"><b>buildinstruct</b></a></p></body>
 </html>
diff --git a/doc/devel/uml/class139141.html b/doc/devel/uml/class139141.html
index e1b79bcb6..167bf32f8 100644
--- a/doc/devel/uml/class139141.html
+++ b/doc/devel/uml/class139141.html
@@ -18,8 +18,9 @@
 <a name="refclass139141"></a>
 <p>Declaration :</p><ul><li>C++ : class DoAttach : public <a href="class139013.html#refclass139013"><b>BuildInstruct</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact138117"><b>buildinstruct</b></a></p><div class="sub">
 <a name="refrelation144133"></a>
-<table><tr><td><div class="element">Relation <b>nodes (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + nodes : <a href="class136837.html#refclass136837"><b>Proc</b></a>, multiplicity : 1..*</li><li>C++ : public: const <a href="class136837.html#refclass136837"><b>Proc</b></a>* nodes</li></ul><a name="refattribute131461"></a>
+<table><tr><td><div class="element">Relation <b>nodes (&lt;directional aggregation&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + nodes : <a href="class136837.html#refclass136837"><b>Proc</b></a>, multiplicity : 1..*</li><li>C++ : public: const <a href="class136837.html#refclass136837"><b>Proc</b></a>* nodes</li></ul><p>Stereotype: vector</p>
+<a name="refattribute131461"></a>
 <table><tr><td><div class="element">Attribut <b>point</b></div></td></tr></table>
-<p>Declaration :</p><ul><li>Uml : + point : string</li><li>C++ : public: const string point</li></ul><p>identifying the point where the nodes should be attached<br /></p></div>
+<p>identifying the point where the nodes should be attached<br /></p><p>Declaration :</p><ul><li>Uml : + point : string</li><li>C++ : public: const string point</li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class139397.html b/doc/devel/uml/class139397.html
index 1bfe82fbf..64f6abd05 100644
--- a/doc/devel/uml/class139397.html
+++ b/doc/devel/uml/class139397.html
@@ -16,7 +16,7 @@
 <!-- ============================================================= -->
 
 <a name="refclass139397"></a>
-<p>Declaration :</p><ul><li>C++ : class MediaFactory </li></ul><p>Depends on <a href="index.html#refpackage129157"><b>BackendLayer</b></a></p><p>Depends on <a href="index.html#refpackage129157"><b>BackendLayer</b></a></p><p>specialized Asset Factory for configuring (new) media asset instances based on existing media files on disk; can create placeholder assets as well<br /></p><p>Artifact : <a href="index.html#refartifact136453"><b>media</b></a></p><div class="sub">
+<p>specialized Asset Factory for configuring (new) media asset instances based on existing media files on disk; can create placeholder assets as well<br /></p><p>Declaration :</p><ul><li>C++ : class MediaFactory </li></ul><p>Depends on <a href="index.html#refpackage129157"><b>BackendLayer</b></a></p><p>Depends on <a href="index.html#refpackage129157"><b>BackendLayer</b></a></p><p>Artifact : <a href="index.html#refartifact136453"><b>media</b></a></p><div class="sub">
 </div>
 </body>
 </html>
diff --git a/doc/devel/uml/class139525.html b/doc/devel/uml/class139525.html
index 603d8d16b..7769856e0 100644
--- a/doc/devel/uml/class139525.html
+++ b/doc/devel/uml/class139525.html
@@ -16,5 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass139525"></a>
-<p>Declaration :</p><ul><li>C++ : class MediaAccessFacade </li></ul><p>provides functions for querying (opening) a media file, detecting the channels or streams found within this file, etc. Delegating to the actual backend functions<br /></p><p>Artifact : <a href="index.html#refartifact138629"><b>mediaaccessfacade</b></a>, Component(s) : <a href="index.html#refcomponent130437"><b>Media Access</b></a></p></body>
+<p>provides functions for querying (opening) a media file, detecting the channels or streams found within this file, etc. Delegating to the actual backend functions<br /></p><p>Declaration :</p><ul><li>C++ : class MediaAccessFacade </li></ul><p>Artifact : <a href="index.html#refartifact138629"><b>mediaaccessfacade</b></a>, Component(s) : <a href="index.html#refcomponent130437"><b>Media Access</b></a></p><p>Stereotype: boundary</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class139653.html b/doc/devel/uml/class139653.html
index 076a6ee5b..c5d179e40 100644
--- a/doc/devel/uml/class139653.html
+++ b/doc/devel/uml/class139653.html
@@ -16,12 +16,12 @@
 <!-- ============================================================= -->
 
 <a name="refclass139653"></a>
-<p>Declaration :</p><ul><li>C++ : class Session </li></ul><p>Directly inherited by : <a href="class128005.html#refclass128005"><b>SessionImpl</b></a> </p>
-<p>Primary Interface for all editing tasks.<br />The session contains defaults, all the assets being edited, and a set of EDL with the individual MObjects to be manipulated and rendered.<br /></p><p>Artifact : <a href="index.html#refartifact138757"><b>session</b></a></p><div class="sub">
+<p>Primary Interface for all editing tasks.<br />The session contains defaults, all the assets being edited, and a set of EDL with the individual MObjects to be manipulated and rendered.<br /></p><p>Declaration :</p><ul><li>C++ : class Session </li></ul><p>Directly inherited by : <a href="class128005.html#refclass128005"><b>SessionImpl</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact138757"><b>session</b></a></p><div class="sub">
 <a name="refoperation133509"></a>
-<table><tr><td><div class="element">Operation <b>currEDL</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + currEDL() : <a href="class128133.html#refclass128133"><b>Seq</b></a></li><li>C++ : public: <a href="class128133.html#refclass128133"><b>Seq</b></a> currEDL () </li></ul><p>The EDL currently in focus. In most cases, Session and EDL are almost the same, just EDL emphasizes the collection aspect. But generally (for larger editing projects) one Session can contain several EDLs, which may even be nested. At any given time, only one of these EDLs has focus and recieves the editing commands.<br /></p><a name="refoperation133637"></a>
-<table><tr><td><div class="element">Operation <b>getFixture</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + getFixture() : Fixture&amp;</li><li>C++ : public: Fixture&amp; getFixture () </li></ul><p>While the session can be comprised of several EDLs, <br />there is only one Fixture, which represents the actual<br />configuration of all Objects to be rendered<br /></p><a name="refrelation144773"></a>
-<table><tr><td><div class="element">Relation <b>current (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : static, + current : <a href="class139781.html#refclass139781"><b>SessManager</b></a>, multiplicity : 1</li><li>C++ : public: static <a href="class139781.html#refclass139781"><b>SessManager</b></a>&amp; current</li></ul><p>Standard access path to get at the current session via the Session Manager, which acts as a "PImpl" smart pointer<br /></p><a name="refrelation150917"></a>
+<table><tr><td><div class="element">Operation <b>currEDL</b></div></td></tr></table><p>The EDL currently in focus. In most cases, Session and EDL are almost the same, just EDL emphasizes the collection aspect. But generally (for larger editing projects) one Session can contain several EDLs, which may even be nested. At any given time, only one of these EDLs has focus and recieves the editing commands.<br /></p><p>Declaration :</p><ul><li>Uml : + currEDL() : <a href="class128133.html#refclass128133"><b>Seq</b></a></li><li>C++ : public: <a href="class128133.html#refclass128133"><b>Seq</b></a> currEDL () </li></ul><a name="refoperation133637"></a>
+<table><tr><td><div class="element">Operation <b>getFixture</b></div></td></tr></table><p>While the session can be comprised of several EDLs, <br />there is only one Fixture, which represents the actual<br />configuration of all Objects to be rendered<br /></p><p>Declaration :</p><ul><li>Uml : + getFixture() : Fixture&amp;</li><li>C++ : public: Fixture&amp; getFixture () </li></ul><a name="refrelation144773"></a>
+<table><tr><td><div class="element">Relation <b>current (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Standard access path to get at the current session via the Session Manager, which acts as a "PImpl" smart pointer<br /></p><p>Declaration :</p><ul><li>Uml : static, + current : <a href="class139781.html#refclass139781"><b>SessManager</b></a>, multiplicity : 1</li><li>C++ : public: static <a href="class139781.html#refclass139781"><b>SessManager</b></a>&amp; current</li></ul><a name="refrelation150917"></a>
 <table><tr><td><div class="element">Relation <b>defaults (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # defaults : <a href="class141445.html#refclass141445"><b>DefaultsManager</b></a></li><li>C++ : protected: <a href="class141445.html#refclass141445"><b>DefaultsManager</b></a>* defaults</li></ul></div>
 <p>All public operations : <a href="class139653.html#refoperation133509"><b>currEDL</b></a> , <a href="class139653.html#refoperation133637"><b>getFixture</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class139781.html b/doc/devel/uml/class139781.html
index 60bd83878..f731b1ac4 100644
--- a/doc/devel/uml/class139781.html
+++ b/doc/devel/uml/class139781.html
@@ -18,10 +18,10 @@
 <a name="refclass139781"></a>
 <p>Declaration :</p><ul><li>C++ : class SessManager </li></ul><p>Artifact : <a href="index.html#refartifact138885"><b>sessmanager</b></a></p><div class="sub">
 <a name="refoperation133765"></a>
-<table><tr><td><div class="element">Operation <b>clear</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + clear() : void</li><li>C++ : public: void clear () </li></ul><p>clear current session contents <br />without resetting overall session config.<br />Afterwards, the session will contain only one <br />empty EDL, while all Assets are retained.<br /><br /></p><a name="refoperation133893"></a>
-<table><tr><td><div class="element">Operation <b>reset</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + reset() : void</li><li>C++ : public: void reset () </li></ul><p>reset all session config and <br />start with a pristine default session.<br /></p><a name="refoperation134021"></a>
-<table><tr><td><div class="element">Operation <b>load</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + load() : void</li><li>C++ : public: void load () </li></ul><p>replace the current session by a new<br />session loaded from serialized state.<br /></p><a name="refoperation134149"></a>
-<table><tr><td><div class="element">Operation <b>save</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + save() : void</li><li>C++ : public: void save () </li></ul><p>create a complete, serialized representation<br />of the current session config and contents.<br />@todo how to serialize, prameters, return value?<br /></p></div>
+<table><tr><td><div class="element">Operation <b>clear</b></div></td></tr></table><p>clear current session contents <br />without resetting overall session config.<br />Afterwards, the session will contain only one <br />empty EDL, while all Assets are retained.<br /><br /></p><p>Declaration :</p><ul><li>Uml : + clear() : void</li><li>C++ : public: void clear () </li></ul><a name="refoperation133893"></a>
+<table><tr><td><div class="element">Operation <b>reset</b></div></td></tr></table><p>reset all session config and <br />start with a pristine default session.<br /></p><p>Declaration :</p><ul><li>Uml : + reset() : void</li><li>C++ : public: void reset () </li></ul><a name="refoperation134021"></a>
+<table><tr><td><div class="element">Operation <b>load</b></div></td></tr></table><p>replace the current session by a new<br />session loaded from serialized state.<br /></p><p>Declaration :</p><ul><li>Uml : + load() : void</li><li>C++ : public: void load () </li></ul><a name="refoperation134149"></a>
+<table><tr><td><div class="element">Operation <b>save</b></div></td></tr></table><p>create a complete, serialized representation<br />of the current session config and contents.<br />@todo how to serialize, prameters, return value?<br /></p><p>Declaration :</p><ul><li>Uml : + save() : void</li><li>C++ : public: void save () </li></ul></div>
 <p>All public operations : <a href="class139781.html#refoperation133765"><b>clear</b></a> , <a href="class139781.html#refoperation134021"><b>load</b></a> , <a href="class139781.html#refoperation133893"><b>reset</b></a> , <a href="class139781.html#refoperation134149"><b>save</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class139909.html b/doc/devel/uml/class139909.html
index 210261f35..0995624c2 100644
--- a/doc/devel/uml/class139909.html
+++ b/doc/devel/uml/class139909.html
@@ -16,9 +16,9 @@
 <!-- ============================================================= -->
 
 <a name="refclass139909"></a>
-<p>Declaration :</p><ul><li>C++ : class LocatingPin </li></ul><p>Directly inherited by : <a href="class129541.html#refclass129541"><b>Allocation</b></a> <a href="class129285.html#refclass129285"><b>FixedLocation</b></a> <a href="class129413.html#refclass129413"><b>RelativeLocation</b></a> </p>
-<p>An element with value semantics, which actually implements the placement of some MObject by positioning it in some way.<br /></p><p>Artifact : <a href="index.html#refartifact139013"><b>locatingpin</b></a></p><div class="sub">
+<p>An element with value semantics, which actually implements the placement of some MObject by positioning it in some way.<br /></p><p>Declaration :</p><ul><li>C++ : class LocatingPin </li></ul><p>Directly inherited by : <a href="class129541.html#refclass129541"><b>Allocation</b></a> <a href="class129285.html#refclass129285"><b>FixedLocation</b></a> <a href="class129413.html#refclass129413"><b>RelativeLocation</b></a> </p>
+<p>Artifact : <a href="index.html#refartifact139013"><b>locatingpin</b></a></p><div class="sub">
 <a name="refrelation146053"></a>
-<table><tr><td><div class="element">Relation <b>next (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # next : <a href="class139909.html#refclass139909"><b>LocatingPin</b></a></li><li>C++ : protected: <a href="class139909.html#refclass139909"><b>LocatingPin</b></a>* next</li></ul><p>next additional LocatingPin, if any<br /></p></div>
+<table><tr><td><div class="element">Relation <b>next (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>next additional LocatingPin, if any<br /></p><p>Declaration :</p><ul><li>Uml : # next : <a href="class139909.html#refclass139909"><b>LocatingPin</b></a></li><li>C++ : protected: <a href="class139909.html#refclass139909"><b>LocatingPin</b></a>* next</li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class140421.html b/doc/devel/uml/class140421.html
index 0d3267c6e..b189140f1 100644
--- a/doc/devel/uml/class140421.html
+++ b/doc/devel/uml/class140421.html
@@ -18,7 +18,7 @@
 <a name="refclass140421"></a>
 <p>Declaration :</p><ul><li>C++ : class Plug : public <a href="class130053.html#refclass130053"><b>Wish</b></a> </li></ul><p>Artifact : <a href="index.html#refartifact139525"><b>plug</b></a></p><div class="sub">
 <a name="refrelation147973"></a>
-<table><tr><td><div class="element">Relation <b>outPort (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # outPort : <a href="class138117.html#refclass138117"><b>Pipe</b></a></li><li>C++ : protected: <a href="class138117.html#refclass138117"><b>Pipe</b></a>* outPort</li></ul><p>the Port this MObject wants to be conected to<br /></p></div>
+<table><tr><td><div class="element">Relation <b>outPort (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>the Port this MObject wants to be conected to<br /></p><p>Declaration :</p><ul><li>Uml : # outPort : <a href="class138117.html#refclass138117"><b>Pipe</b></a></li><li>C++ : protected: <a href="class138117.html#refclass138117"><b>Pipe</b></a>* outPort</li></ul></div>
 <p>All public operations : <a href="class129541.html#refoperation131205"><b>get_repr</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class140549.html b/doc/devel/uml/class140549.html
index 9366aa42a..a57aaab4c 100644
--- a/doc/devel/uml/class140549.html
+++ b/doc/devel/uml/class140549.html
@@ -16,8 +16,9 @@
 <!-- ============================================================= -->
 
 <a name="refclass140549"></a>
-<p>Declaration :</p><ul><li>C++ : class ConfigRules : public <a href="class140677.html#refclass140677"><b>QueryHandler</b></a>&lt;&gt; </li><li>Java : public interface ConfigRules </li></ul><p>Directly inherited by : <a href="class140933.html#refclass140933"><b>ResolverBase</b></a> </p>
-<p>public acces point for running Config Queries<br /></p><div class="sub">
+<p>public acces point for running Config Queries<br /></p><p>Declaration :</p><ul><li>C++ : class ConfigRules : public <a href="class140677.html#refclass140677"><b>QueryHandler</b></a>&lt;&gt; </li><li>Java : public interface ConfigRules </li></ul><p>Directly inherited by : <a href="class140933.html#refclass140933"><b>ResolverBase</b></a> </p>
+<p>Stereotype: interface</p>
+<div class="sub">
 <a name="refrelation148485"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class140677.html#refclass140677"><b>QueryHandler</b></a></li><li>C++ : protected: <a href="class140677.html#refclass140677"><b>QueryHandler</b></a>* </li></ul><a name="refrelation148741"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class140677.html#refclass140677"><b>QueryHandler</b></a></li><li>C++ : protected: <a href="class140677.html#refclass140677"><b>QueryHandler</b></a>* </li></ul></div>
diff --git a/doc/devel/uml/class140677.html b/doc/devel/uml/class140677.html
index 6b32a5b25..99e322277 100644
--- a/doc/devel/uml/class140677.html
+++ b/doc/devel/uml/class140677.html
@@ -17,6 +17,7 @@
 
 <a name="refclass140677"></a>
 <p>Declaration :</p><ul><li>C++ : template&lt;class TY&gt; class QueryHandler </li><li>Java : public interface QueryHandler&lt;TY&gt; </li></ul><p>Directly inherited by : <a href="class140549.html#refclass140549"><b>ConfigRules</b></a> </p>
+<p>Stereotype: interface</p>
 <div class="sub">
 <a name="refrelation148613"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class140549.html#refclass140549"><b>ConfigRules</b></a></li><li>C++ : protected: <a href="class140549.html#refclass140549"><b>ConfigRules</b></a>* </li></ul><a name="refrelation148869"></a>
diff --git a/doc/devel/uml/class140805.html b/doc/devel/uml/class140805.html
index a9f18e933..68f8f3d3e 100644
--- a/doc/devel/uml/class140805.html
+++ b/doc/devel/uml/class140805.html
@@ -17,6 +17,7 @@
 
 <a name="refclass140805"></a>
 <p>Declaration :</p><ul><li>C++ : template&lt;class TY&gt; class TypeHandler </li><li>Java : public interface TypeHandler&lt;TY&gt; </li></ul><p>Directly inherited by : <a href="class141317.html#refclass141317"><b>TypeHandler&lt;Pipe&gt;</b></a> </p>
+<p>Stereotype: interface</p>
 <div class="sub">
 <a name="refoperation135045"></a>
 <table><tr><td><div class="element">Operation <b>find</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : abstract, + find(in capabilities : Pred) : TY</li><li>C++ : public: virtual TY find () = 0 </li></ul><a name="refoperation135173"></a>
diff --git a/doc/devel/uml/class141701.html b/doc/devel/uml/class141701.html
index 232cf2aed..96bd39a8d 100644
--- a/doc/devel/uml/class141701.html
+++ b/doc/devel/uml/class141701.html
@@ -16,5 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass141701"></a>
-<p>Declaration :</p><ul><li>C++ : class User </li></ul></body>
+<p>Declaration :</p><ul><li>C++ : class User </li></ul><p>Stereotype: actor</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class141829.html b/doc/devel/uml/class141829.html
index d6c42943f..9a503a186 100644
--- a/doc/devel/uml/class141829.html
+++ b/doc/devel/uml/class141829.html
@@ -16,5 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass141829"></a>
-<p>Declaration :</p><ul><li>C++ : class Serializer </li></ul></body>
+<p>Declaration :</p><ul><li>C++ : class Serializer </li></ul><p>Stereotype: actor</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class142469.html b/doc/devel/uml/class142469.html
index 58c82f008..d03cae5ca 100644
--- a/doc/devel/uml/class142469.html
+++ b/doc/devel/uml/class142469.html
@@ -16,7 +16,8 @@
 <!-- ============================================================= -->
 
 <a name="refclass142469"></a>
-<p>Declaration :</p><ul><li>C++ : class StateProxy : public <a href="class132741.html#refclass132741"><b>State</b></a> </li></ul><div class="sub">
+<p>Declaration :</p><ul><li>C++ : class StateProxy : public <a href="class132741.html#refclass132741"><b>State</b></a> </li></ul><p>Stereotype: implementation</p>
+<div class="sub">
 </div>
 <p>All public operations : <a href="class132741.html#refoperation135941"><b>allocateBuffer</b></a> , <a href="class132741.html#refoperation135813"><b>fetch</b></a> , <a href="class132741.html#refoperation136325"><b>isCalculated</b></a> , <a href="class132741.html#refoperation136197"><b>releaseBuffer</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class143365.html b/doc/devel/uml/class143365.html
index c4e3718c3..974308cbc 100644
--- a/doc/devel/uml/class143365.html
+++ b/doc/devel/uml/class143365.html
@@ -21,7 +21,8 @@
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144517.html#refclass144517"><b>Strategy</b></a></li><li>C++ : protected: <a href="class144517.html#refclass144517"><b>Strategy</b></a>* </li></ul><a name="refrelation156421"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144517.html#refclass144517"><b>Strategy</b></a></li><li>C++ : protected: <a href="class144517.html#refclass144517"><b>Strategy</b></a>* </li></ul><a name="refrelation156677"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144517.html#refclass144517"><b>Strategy</b></a></li><li>C++ : protected: <a href="class144517.html#refclass144517"><b>Strategy</b></a>* </li></ul><a name="refrelation156933"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144261.html#refclass144261"><b>Invocation</b></a></li><li>C++ : protected: <a href="class144261.html#refclass144261"><b>Invocation</b></a>* </li></ul><a name="refoperation136581"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144261.html#refclass144261"><b>Invocation</b></a></li><li>C++ : protected: <a href="class144261.html#refclass144261"><b>Invocation</b></a>* </li></ul><p>Stereotype: creates</p>
+<a name="refoperation136581"></a>
 <table><tr><td><div class="element">Operation <b>callDown</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + callDown() : </li><li>C++ : public:  callDown () </li></ul></div>
 <p>All public operations : <a href="class143365.html#refoperation136581"><b>callDown</b></a> , <a href="class142725.html#refoperation136453"><b>callDown</b></a> </p>
 </body>
diff --git a/doc/devel/uml/class144005.html b/doc/devel/uml/class144005.html
index bc2bf60f2..e5388ff5e 100644
--- a/doc/devel/uml/class144005.html
+++ b/doc/devel/uml/class144005.html
@@ -18,7 +18,8 @@
 <a name="refclass144005"></a>
 <p>Declaration :</p><ul><li>C++ : template&lt;int SIZ&gt; class BuffTable </li></ul><div class="sub">
 <a name="refrelation153861"></a>
-<table><tr><td><div class="element">Relation <b>&lt;directional aggregation by value&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144133.html#refclass144133"><b>BuffHandle</b></a>, multiplicity : SIZ</li><li>C++ : protected: <a href="class144133.html#refclass144133"><b>BuffHandle</b></a> </li></ul><a name="refrelation153989"></a>
+<table><tr><td><div class="element">Relation <b>&lt;directional composition&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class144133.html#refclass144133"><b>BuffHandle</b></a>, multiplicity : SIZ</li><li>C++ : protected: <a href="class144133.html#refclass144133"><b>BuffHandle</b></a> </li></ul><p>Stereotype: array</p>
+<a name="refrelation153989"></a>
 <table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a></li><li>C++ : protected: <a href="class142725.html#refclass142725"><b>WiringDescriptor</b></a>* </li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class145285.html b/doc/devel/uml/class145285.html
index 914d312aa..196eeda82 100644
--- a/doc/devel/uml/class145285.html
+++ b/doc/devel/uml/class145285.html
@@ -16,5 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass145285"></a>
-<p>Declaration :</p><ul><li>C++ : enum MediaKind </li><li>Java : package enum MediaKind </li></ul></body>
+<p>Declaration :</p><ul><li>C++ : enum MediaKind </li><li>Java : package enum MediaKind </li></ul><p>Stereotype: enum</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class145541.html b/doc/devel/uml/class145541.html
index 06bd62289..842eae98c 100644
--- a/doc/devel/uml/class145541.html
+++ b/doc/devel/uml/class145541.html
@@ -19,9 +19,11 @@
 <p>Declaration :</p><ul><li>C++ : class Timeline </li></ul><p>Directly inherited by : <a href="class145797.html#refclass145797"><b>TimelineView</b></a> </p>
 <div class="sub">
 <a name="refrelation159109"></a>
-<table><tr><td><div class="element">Relation <b>&lt;aggregation by value&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145669.html#refclass145669"><b>Project</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class145669.html#refclass145669"><b>Project</b></a> </li></ul><a name="refrelation159237"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145925.html#refclass145925"><b>PlayControl</b></a></li><li>C++ : protected: <a href="class145925.html#refclass145925"><b>PlayControl</b></a>* </li></ul><a name="refrelation159621"></a>
+<table><tr><td><div class="element">Relation <b>&lt;composition&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145669.html#refclass145669"><b>Project</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class145669.html#refclass145669"><b>Project</b></a> </li></ul><a name="refrelation159237"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145925.html#refclass145925"><b>PlayControl</b></a></li><li>C++ : protected: <a href="class145925.html#refclass145925"><b>PlayControl</b></a>* </li></ul><p>Stereotype: own</p>
+<a name="refrelation159621"></a>
 <table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146309.html#refclass146309"><b>Sequence</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class146309.html#refclass146309"><b>Sequence</b></a>* </li></ul><a name="refrelation160005"></a>
-<table><tr><td><div class="element">Relation <b>globalBusses (&lt;directional aggregation by value&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # globalBusses : <a href="class138117.html#refclass138117"><b>Pipe</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class138117.html#refclass138117"><b>Pipe</b></a> globalBusses</li></ul></div>
+<table><tr><td><div class="element">Relation <b>globalBusses (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # globalBusses : <a href="class138117.html#refclass138117"><b>Pipe</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class138117.html#refclass138117"><b>Pipe</b></a> globalBusses</li></ul><p>Stereotype: list</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class145669.html b/doc/devel/uml/class145669.html
index d2fb577a5..49d3c0315 100644
--- a/doc/devel/uml/class145669.html
+++ b/doc/devel/uml/class145669.html
@@ -18,7 +18,7 @@
 <a name="refclass145669"></a>
 <p>Declaration :</p><ul><li>C++ : class Project </li></ul><div class="sub">
 <a name="refrelation158981"></a>
-<table><tr><td><div class="element">Relation <b>&lt;aggregation by value&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145541.html#refclass145541"><b>Timeline</b></a>, multiplicity : 1..*</li><li>C++ : protected: <a href="class145541.html#refclass145541"><b>Timeline</b></a> </li></ul><a name="refrelation159365"></a>
-<table><tr><td><div class="element">Relation <b>&lt;aggregation by value&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146309.html#refclass146309"><b>Sequence</b></a>, multiplicity : 1..*</li><li>C++ : protected: <a href="class146309.html#refclass146309"><b>Sequence</b></a> </li></ul></div>
+<table><tr><td><div class="element">Relation <b>&lt;composition&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145541.html#refclass145541"><b>Timeline</b></a>, multiplicity : 1..*</li><li>C++ : protected: <a href="class145541.html#refclass145541"><b>Timeline</b></a> </li></ul><a name="refrelation159365"></a>
+<table><tr><td><div class="element">Relation <b>&lt;composition&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146309.html#refclass146309"><b>Sequence</b></a>, multiplicity : 1..*</li><li>C++ : protected: <a href="class146309.html#refclass146309"><b>Sequence</b></a> </li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class145925.html b/doc/devel/uml/class145925.html
index ae3ae19c7..f4d4d79e1 100644
--- a/doc/devel/uml/class145925.html
+++ b/doc/devel/uml/class145925.html
@@ -18,6 +18,7 @@
 <a name="refclass145925"></a>
 <p>Declaration :</p><ul><li>C++ : class PlayControl </li></ul><div class="sub">
 <a name="refrelation160389"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146437.html#refclass146437"><b>PlayheadCursor</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class146437.html#refclass146437"><b>PlayheadCursor</b></a>* </li></ul></div>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146437.html#refclass146437"><b>PlayheadCursor</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class146437.html#refclass146437"><b>PlayheadCursor</b></a>* </li></ul><p>Stereotype: direct</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class146053.html b/doc/devel/uml/class146053.html
index d2e874de1..71cf26b2c 100644
--- a/doc/devel/uml/class146053.html
+++ b/doc/devel/uml/class146053.html
@@ -18,7 +18,8 @@
 <a name="refclass146053"></a>
 <p>Declaration :</p><ul><li>C++ : class Monitor </li></ul><div class="sub">
 <a name="refrelation160133"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145541.html#refclass145541"><b>Timeline</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class145541.html#refclass145541"><b>Timeline</b></a>* </li></ul><a name="refrelation160517"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145541.html#refclass145541"><b>Timeline</b></a>, multiplicity : 0..1</li><li>C++ : protected: <a href="class145541.html#refclass145541"><b>Timeline</b></a>* </li></ul><p>Stereotype: attach</p>
+<a name="refrelation160517"></a>
 <table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146437.html#refclass146437"><b>PlayheadCursor</b></a></li><li>C++ : protected: <a href="class146437.html#refclass146437"><b>PlayheadCursor</b></a>* </li></ul></div>
 </body>
 </html>
diff --git a/doc/devel/uml/class146309.html b/doc/devel/uml/class146309.html
index 485390623..49148d00d 100644
--- a/doc/devel/uml/class146309.html
+++ b/doc/devel/uml/class146309.html
@@ -18,8 +18,9 @@
 <a name="refclass146309"></a>
 <p>Declaration :</p><ul><li>C++ : class Sequence </li></ul><div class="sub">
 <a name="refrelation159493"></a>
-<table><tr><td><div class="element">Relation <b>&lt;aggregation by value&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145669.html#refclass145669"><b>Project</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class145669.html#refclass145669"><b>Project</b></a> </li></ul><a name="refrelation159877"></a>
-<table><tr><td><div class="element">Relation <b>subSequences (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # subSequences : <a href="class146309.html#refclass146309"><b>Sequence</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class146309.html#refclass146309"><b>Sequence</b></a>* subSequences</li></ul><a name="refrelation161541"></a>
+<table><tr><td><div class="element">Relation <b>&lt;composition&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class145669.html#refclass145669"><b>Project</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class145669.html#refclass145669"><b>Project</b></a> </li></ul><a name="refrelation159877"></a>
+<table><tr><td><div class="element">Relation <b>subSequences (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # subSequences : <a href="class146309.html#refclass146309"><b>Sequence</b></a>, multiplicity : *</li><li>C++ : protected: <a href="class146309.html#refclass146309"><b>Sequence</b></a>* subSequences</li></ul><p>Stereotype: contains</p>
+<a name="refrelation161541"></a>
 <table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class128517.html#refclass128517"><b>MObject</b></a></li><li>C++ : protected: <a href="class128517.html#refclass128517"><b>MObject</b></a>* </li></ul><a name="refrelation161669"></a>
 <table><tr><td><div class="element">Relation <b>trackTree (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # trackTree : <a href="class128389.html#refclass128389"><b>Track</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class128389.html#refclass128389"><b>Track</b></a>* trackTree</li></ul></div>
 </body>
diff --git a/doc/devel/uml/class146565.html b/doc/devel/uml/class146565.html
index caadd3954..a4f6d0ccf 100644
--- a/doc/devel/uml/class146565.html
+++ b/doc/devel/uml/class146565.html
@@ -17,5 +17,6 @@
 
 <a name="refclass146565"></a>
 <p>Declaration :</p><ul><li>C++ : class Facade </li><li>Java : package interface Facade </li></ul><p>Directly inherited by : <a href="class146693.html#refclass146693"><b>Proxy</b></a> <a href="class146821.html#refclass146821"><b>ServiceImpl</b></a> </p>
+<p>Stereotype: interface</p>
 </body>
 </html>
diff --git a/doc/devel/uml/class146693.html b/doc/devel/uml/class146693.html
index 1dfd3512e..f36b4439d 100644
--- a/doc/devel/uml/class146693.html
+++ b/doc/devel/uml/class146693.html
@@ -17,7 +17,8 @@
 
 <a name="refclass146693"></a>
 <p>Declaration :</p><ul><li>C++ : class Proxy : public <a href="class146565.html#refclass146565"><b>Facade</b></a> </li></ul><div class="sub">
-<a name="refrelation162181"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146949.html#refclass146949"><b>C_Interface</b></a></li><li>C++ : protected: <a href="class146949.html#refclass146949"><b>C_Interface</b></a>* </li></ul></div>
+<a name="refrelation170117"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146949.html#refclass146949"><b>C_Interface</b></a></li><li>C++ : protected: <a href="class146949.html#refclass146949"><b>C_Interface</b></a>* </li></ul><p>Stereotype: uses</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class146821.html b/doc/devel/uml/class146821.html
index af636ece9..0647b5350 100644
--- a/doc/devel/uml/class146821.html
+++ b/doc/devel/uml/class146821.html
@@ -17,7 +17,8 @@
 
 <a name="refclass146821"></a>
 <p>Declaration :</p><ul><li>C++ : class ServiceImpl : public <a href="class146565.html#refclass146565"><b>Facade</b></a> </li></ul><div class="sub">
-<a name="refrelation162437"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class147205.html#refclass147205"><b>InstanceHandle</b></a></li><li>C++ : protected: <a href="class147205.html#refclass147205"><b>InstanceHandle</b></a>* </li></ul></div>
+<a name="refrelation170501"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class147205.html#refclass147205"><b>InstanceHandle</b></a></li><li>C++ : protected: <a href="class147205.html#refclass147205"><b>InstanceHandle</b></a>* </li></ul><p>Stereotype: has_a</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class147077.html b/doc/devel/uml/class147077.html
index a17c10f3a..e8b9d723b 100644
--- a/doc/devel/uml/class147077.html
+++ b/doc/devel/uml/class147077.html
@@ -17,7 +17,8 @@
 
 <a name="refclass147077"></a>
 <p>Declaration :</p><ul><li>C++ : class C_Instance : public <a href="class146949.html#refclass146949"><b>C_Interface</b></a> </li></ul><div class="sub">
-<a name="refrelation162309"></a>
-<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146821.html#refclass146821"><b>ServiceImpl</b></a></li><li>C++ : protected: <a href="class146821.html#refclass146821"><b>ServiceImpl</b></a>* </li></ul></div>
+<a name="refrelation170373"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class146821.html#refclass146821"><b>ServiceImpl</b></a></li><li>C++ : protected: <a href="class146821.html#refclass146821"><b>ServiceImpl</b></a>* </li></ul><p>Stereotype: calls</p>
+</div>
 </body>
 </html>
diff --git a/doc/devel/uml/class147333.html b/doc/devel/uml/class147333.html
new file mode 100644
index 000000000..daace754a
--- /dev/null
+++ b/doc/devel/uml/class147333.html
@@ -0,0 +1,24 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class Segmentation</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class Segmentation</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass147333"></a>
+<p>Declaration :</p><ul><li>C++ : class Segmentation </li></ul><div class="sub">
+<a name="refrelation163205"></a>
+<table><tr><td><div class="element">Relation <b>&lt;association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class128261.html#refclass128261"><b>Fixture</b></a></li><li>C++ : protected: <a href="class128261.html#refclass128261"><b>Fixture</b></a>* </li></ul><p>Stereotype: partitioning</p>
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/classdiagrams.html b/doc/devel/uml/classdiagrams.html
index 8159cb541..8e9652413 100644
--- a/doc/devel/uml/classdiagrams.html
+++ b/doc/devel/uml/classdiagrams.html
@@ -18,7 +18,8 @@
 <table>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram130309" target = "projectFrame"><b>Asset Kinds</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129669" target = "projectFrame"><b>Automation Entities</b></a></td><td></td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129285" target = "projectFrame"><b>Builder Entities</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132868" target = "projectFrame"><b>Builder Entities</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129285" target = "projectFrame"><b>Builder Tool (Visitor)</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128645" target = "projectFrame"><b>Controller Entities</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128181" target = "projectFrame"><b>File Mapping</b></a></td><td></td><td>Shows whats used to access Frames</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram130181" target = "projectFrame"><b>Hierarchy</b></a></td><td></td><td>Lumiera Exception hierarchy</td></tr>
diff --git a/doc/devel/uml/classes.html b/doc/devel/uml/classes.html
index 637ca483e..b30de8c8b 100644
--- a/doc/devel/uml/classes.html
+++ b/doc/devel/uml/classes.html
@@ -115,7 +115,6 @@
 <tr bgcolor=#f0f0f0><td><a href="class136837.html#refclass136837" target = "projectFrame"><b>Proc</b></a></td><td></td><td>key abstraction: data processing asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141957.html#refclass141957" target = "projectFrame"><b>ProcDispatcher</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class144389.html#refclass144389" target = "projectFrame"><b>ProcessData</b></a></td><td></td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class131461.html#refclass131461" target = "projectFrame"><b>Processor</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131717.html#refclass131717" target = "projectFrame"><b>ProcNode</b></a></td><td>interface</td><td>Key abstraction of the Render Engine: A Data processing Node</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class138757.html#refclass138757" target = "projectFrame"><b>ProcPatt</b></a></td><td></td><td>special type of structural Asset representing information how to build some part of the render engine's processing nodes network.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145669.html#refclass145669" target = "projectFrame"><b>Project</b></a></td><td></td><td></td></tr>
@@ -130,11 +129,13 @@
 <tr bgcolor=#f0f0f0><td><a href="class129413.html#refclass129413" target = "projectFrame"><b>RelativeLocation</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133893.html#refclass133893" target = "projectFrame"><b>RelType</b></a></td><td>enum</td><td>the possible kinds of RelativePlacements</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131333.html#refclass131333" target = "projectFrame"><b>RenderEngine</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class131461.html#refclass131461" target = "projectFrame"><b>RenderGraph</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130949.html#refclass130949" target = "projectFrame"><b>RenderState</b></a></td><td></td><td>Encapsulates the logic used to get a "current render process" in accordance to the currentyl applicable controller settings. The provided StateProxy serves to hold any mutalbe state used in the render process, so the rest of the render engine can be stateless.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class146181.html#refclass146181" target = "projectFrame"><b>RenderTask</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140933.html#refclass140933" target = "projectFrame"><b>ResolverBase</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129205.html#refclass129205" target = "projectFrame"><b>Scheduler</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135173.html#refclass135173" target = "projectFrame"><b>Segment</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class147333.html#refclass147333" target = "projectFrame"><b>Segmentation</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134277.html#refclass134277" target = "projectFrame"><b>SegmentationTool</b></a></td><td></td><td>Tool implementation for deriving a partitioning of the current timeline such, that each segement has a constant configuration. "Constant" means here, that any remaining changes over time can be represented by automation solely, without the need to change the node connections.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128133.html#refclass128133" target = "projectFrame"><b>Seq</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class146309.html#refclass146309" target = "projectFrame"><b>Sequence</b></a></td><td></td><td></td></tr>
diff --git a/doc/devel/uml/classes_list.html b/doc/devel/uml/classes_list.html
index 33f50cb20..94c71e519 100644
--- a/doc/devel/uml/classes_list.html
+++ b/doc/devel/uml/classes_list.html
@@ -116,7 +116,6 @@
 <a href="class136837.html#refclass136837" target = "projectFrame"><b>Proc</b></a><br />
 <a href="class141957.html#refclass141957" target = "projectFrame"><b>ProcDispatcher</b></a><br />
 <a href="class144389.html#refclass144389" target = "projectFrame"><b>ProcessData</b></a><br />
-<a href="class131461.html#refclass131461" target = "projectFrame"><b>Processor</b></a><br />
 <a href="class131717.html#refclass131717" target = "projectFrame"><b>ProcNode</b></a><br />
 <a href="class138757.html#refclass138757" target = "projectFrame"><b>ProcPatt</b></a><br />
 <a href="class145669.html#refclass145669" target = "projectFrame"><b>Project</b></a><br />
@@ -131,11 +130,13 @@
 <a href="class129413.html#refclass129413" target = "projectFrame"><b>RelativeLocation</b></a><br />
 <a href="class133893.html#refclass133893" target = "projectFrame"><b>RelType</b></a><br />
 <a href="class131333.html#refclass131333" target = "projectFrame"><b>RenderEngine</b></a><br />
+<a href="class131461.html#refclass131461" target = "projectFrame"><b>RenderGraph</b></a><br />
 <a href="class130949.html#refclass130949" target = "projectFrame"><b>RenderState</b></a><br />
 <a href="class146181.html#refclass146181" target = "projectFrame"><b>RenderTask</b></a><br />
 <a href="class140933.html#refclass140933" target = "projectFrame"><b>ResolverBase</b></a><br />
 <a href="class129205.html#refclass129205" target = "projectFrame"><b>Scheduler</b></a><br />
 <a href="class135173.html#refclass135173" target = "projectFrame"><b>Segment</b></a><br />
+<a href="class147333.html#refclass147333" target = "projectFrame"><b>Segmentation</b></a><br />
 <a href="class134277.html#refclass134277" target = "projectFrame"><b>SegmentationTool</b></a><br />
 <a href="class128133.html#refclass128133" target = "projectFrame"><b>Seq</b></a><br />
 <a href="class146309.html#refclass146309" target = "projectFrame"><b>Sequence</b></a><br />
diff --git a/doc/devel/uml/fig128181.png b/doc/devel/uml/fig128181.png
index cedf4dae20748670cd76b0eff25ac6cb2d758f14..26c27d1905f356526a641e905724e3428aee0b0c 100644
GIT binary patch
literal 35072
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
MRZ+;6H+lR&0J_8nU;qFB

literal 39718
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
T87;vT6J*aRo=ulFxcmPAMa?}|

diff --git a/doc/devel/uml/fig129541.png b/doc/devel/uml/fig129541.png
index 731ebdf447f60f04ad2e9082581a917f04a98398..38d07738a332191aa021fb026a7f853202a089c4 100644
GIT binary patch
literal 11432
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
Jukzs8e*nWNc`^V1

literal 12086
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

diff --git a/doc/devel/uml/fig129797.png b/doc/devel/uml/fig129797.png
index 229233231f800c5fc87227e88b5d09f278a16d4a..557bef1596f85654719c445c2cd841ec6fbf9ea8 100644
GIT binary patch
literal 16746
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
b;|Oe*6=r9}`rvOU@EGbF@6FXce(`?+=(Fak

literal 18260
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

diff --git a/doc/devel/uml/fig130181.png b/doc/devel/uml/fig130181.png
index fbd802a8954d5e9ef97671ae6f02b2e4a088b67e..387ca9cb801418065bee4b50c2ff0829d6e48c7c 100644
GIT binary patch
literal 9234
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

literal 10701
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
D*S$T#

diff --git a/doc/devel/uml/fig130693.png b/doc/devel/uml/fig130693.png
index 81351d39bcd2df034b8bad94cfcd1270a3a3de69..25b344151de1d96adfb72a14123b0a69bd67110c 100644
GIT binary patch
literal 11090
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
U?m7(a%0iI3hUW{<UVrfa0rP0DasU7T

literal 12650
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

diff --git a/doc/devel/uml/fig130821.png b/doc/devel/uml/fig130821.png
index 0c951bf0659530fa5ca8fc2240c3f94c3a1e2409..b0f53e1ba20869760793ef8cd9baaccb6fa41da8 100644
GIT binary patch
literal 13295
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

literal 14498
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
RU%*J@mYlL|mbBrM{|B5IAMpSH

diff --git a/doc/devel/uml/fig130949.png b/doc/devel/uml/fig130949.png
index c8628370092ad43d4116aa555d4133d16d3201b3..f2d1f2f0897e5f9bb84803a939f079d30fbf3e7e 100644
GIT binary patch
literal 6705
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

literal 7478
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
Ap#T5?

diff --git a/doc/devel/uml/fig131589.png b/doc/devel/uml/fig131589.png
index 14e1606022c8c02471ea2060dcc5d242f1d09322..a6ac2ca9505367cb4f12fb2361ca19aa09cf1fc8 100644
GIT binary patch
literal 10449
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

literal 12406
zcmeI2cT|&K*6(8jEEENmjuE6tmrf`GA_4*;0!l}E2}lh+s33?G>AeU73WgpqR0X7W
z2pxj--XXNWJ^bd*yfbrW?mO>0cdh%!y=!HyWMw^ha-MVc*=K)0`}_WhssiaH+Di}!
zgjDg-gQpP4*+>ZF%m&F>@J)4EnmGh=3!?Zy=9yd4%9y)eA9nI&W9!USgx-_0PKq2e
z<wmRN{m&Ow_%+VRkmkeAuIgXEbM7hC`7^(A)6?(peA?A~ww;}sZjMPbxb%vHO8ZrF
zWqbl(jkMI5)#{ZAVLo~{NhV1TFVQ3?DGPI{&6LjgPOs2(tn~#5<fETIh8PSY<y<o<
z#P{(dI|#&7*6|$V7G(q-1QP#o6as1Tn<j$XXJrwAK<+^?XCNOh{_{&eCn<WUQ~hEg
zq;a_w`kRS0C=th8Co)K}iqItqPgmjB)Mo!B7&PlY;uze#YG&XK5ocAlgRoo0<#1ex
z%jSRRc#ge2E+?FJOK|@-X2Z*1nJMDfu=C?b3KwQ}_9iN3*^S>=Vx_YYbe${iYA@Xe
z^b*z=&zUQL0S8^$5|n=pMoI;pwR#*1D+E(Y*@4-hYFI;(Dt&h?qnZN0ycI#Grrl&{
zF^g7`H1JOQeEK}BbrLH4x4?(2dI=SEX3U23kqKw3+s^BVche0T)Ro@-?6j;EEo9*O
z^S3dniC>T1{C%itzYDL=9G(ewaQ+z_m(5|#Qa0p;UgbP4O%HtK{8JBnMP#<2%B6!6
zo_g@kp}D%=TQ2#XhwwUmpJi8vCJbx1FfOrJ^C38y8ur8IM_>%|J!G4pozNQ7R<*$i
zn&LJuZ)ZkIBPzEnc*)Q09SPJ6b}*~g9N!0zu#oHIhd1c$9lx<NY_;G*IKBEnODAN}
zL@z>IMtwpJebA5jhFc|MNjpwmi_?=KZbR9WWmUp{f!nR$sOt^Qya-(#E59khH%QP#
z;I+rz5)<JnT-2zJtaECDQm?NW40u0iy&Bugd$Ui%SoMvkK3<;k#zp8Qaii^}`A{A*
zYKe+2a=CWN^Afp5(W7BZQsZckST$Jc^q%Qd#6I&}=a{g_#?zN=$8m2B8M!_)9X{MO
zG&n3eoLIfw$Sr7x#n{g=H!Jv2EHw5QTI~hF^>wGjW!}rk24*V6Gz5RxxVWX*_Bg59
z!=rwlWQ<4e;Cp>?;K+?KRH|W(Sz`>`uv(ua+*@n}_Y1l4`PTrCfkrM(><_<7(nc?j
zOvJZW3pi{d)#B8a>z_j(MA<(}_Hel-Kq+D{{5;zr*|NqGty!I))zZ*!-W#nlMvMqc
zrq+G3m9>(<11sgSvWlQcPdoRpCUkXv()VZaq4k*dEaTY}%@^_9HHqFLR*F5JPyyw;
zOXBv2l{&lVU}c{wf=!ftlrmGSIZylSN}Tp1`znQPEvn45!Rl0hui4G&4>Gx>k|R9y
zHGFu*)z`e_&UAw+B;AFG#y1{P``G3>#Q-e)a%;`_BOxcNEcPHfX1rn^MY;-Jc*A0n
z94<yBb-U8KJ%=$;B3L;I=PJAtseMDT^~{z*G~PTfp2Kgxt3vJr54RtM0)k=8%dFT;
zOd0BjZyZk{mB5Z~dJAcmn^?6k3&~#H7q-WuqBY$)(V8;E!9ENOWYkXG*62Ca6q}yX
z_cDsy0Xj}qbLPpdIZvxvO7^T&SCUVoWaVb^0X&By9izO}tjszxIBZGPKH>YbLK-&)
z){z*`lr)Ykw>im+JQh+U`J^s5&g8kKgU;1KS^uPa3%7-D!lfK{n?7eM+GDDOjJy4k
zIK@7Ve;Pnm+iA3#>l_I-YK2-$AGkPg2?`9feY4UoE>bZYYbx$Aqlx;l+@j>TrZ$>d
zB52hxCooK?N<I+j`_AHK@(M(FU)@)_S`i7KZBbi=xV(L)uoJ#jjlw5fT-?FBnmIbn
zh0!L9WnXc&1oPjo{r&Mtv9V=`Kkb%+`gKsd9U(BJOCCEB-Q8Bl7+P`_PL*8hlekBz
zO@7<wr><#8IhgHKU+Q%HF+DT;;`vd0vIsBEwl6)r>sXD=9pk?EP$oYs^yR1N83Hy@
z#wmAG3wiy<s~__N-S`ON$3tE_h7D5zVR*a2iWx)Qgi@Ov)-s>wWI6<hO$xNg;-k&*
z!S{vA)w<Va=*+ZnJp2Oc>QQFBG4hA<#P(Ni$bR2;pyBiJ1>5cyj%)WKe#4_(S;cMx
z=bk|No9-oBgI10f2X0nnL}*2*G8W{5iyv6OYze9|B=MwFi6W<uzE3%v&gh$KZ+GoS
zYqpzuA`MfMut=>DMmTXW(?r*x%pcn)?Yz0RR)pt|y)zy5V)j8pRMMQ)`D(aTxpKPL
zU@HMuYx`&UzpD}ucB{Sp3UEtfV~4|omDG;o&$y91Yz0v;QvrNPc&;qzWTOm8UA8z{
zwl&;^E+s1kFWEq^B@*c7=4KMkah$Pi%sb-n6L)}X!`c;PGD`mz(eOgEjhJsvFT5Lf
zHF;(3@$h5rxf%Lfh#Bcv>8w02tOM6CcxO+YotzA9M6Y3`pn^Zy+7w8_`Pe>X*feIZ
zK9Y<nZG_u*XUdx;wy436mx+T9v?gZA<L>P()=<w{J+TFWa~Vnt6Cr!f@M^9h8KqoG
z^quIz+6Q5F8bSC+LpEvXgZ)c0*}v2@ba!ZaEgmQG=Vj>aRJ2qltr!ecc_c4F6J?*0
zXVaEF&F*63N%?XdXWto$q7M+FyAeY#?76;Nf8jlNP^SFD@9O~t-ut^Cp-HfMiq@=r
zJI)p6dHq#l$M@oM2EMsEF~bKw>L_#cLT=V&sFcob_nX4YM8eeUewM2}UM)QwYGbXL
zCCYYWc0!ANB;(Y2C@plhaB8LVW-&eAV)qRH(A#ragM4ZkFH^Fp*+J+opi_oFq&Mxn
zoR(_V#AV)ix_J*w^yu=KmQPJlj5oK&4o8sB;QrksWrohpXmWx$tvn??{Wm+}3l}60
z`Pw{#uXhU=_8G>x?;FQ{)IRaQzGdvR(e_J)KhZ~(@FF?7FwYYH<etrsZ@WnQHK}Go
z-?+x2L_6DR>R^p|zG?|qVksAl6Xs@8u&UUKFgdE-IM+b_DEP5N^_<%uiy^hMrUBbt
zoB%(aIAQ2(@0}jmsvh+w+7euIt1{6XZ~6ZDBb&^w$-_%#^GUj?8%(^EvxcjYqZ)^*
zSVWHf@Zb%3iDg+n4(mLN<2&)DgOvxJq3*O)VfQ>b^gp|z#?fw@lS3yW6+19gyX1{t
z&)2>6PhWNDKR70|*I>zEX2yBoq2f0Rj8kSW_}J(LIIVg`cRQ`##@e{$8`OEmds2P$
z)hi5{tCb)PA_H|yPoN}~%_>yl0z#Ub$ZUzx8gff$*6P-29W?!?I!J1+!D(tUvM5-a
zi4O(}kAM#<E%!hzz;aqL$OpR9Mlzp%@OMv0|8d>=zg8~!d49P*KQL0mvp*M+0Sg<i
zaLEVB9`0Gf07KfYXxr30x2KiY$XBcaiK&<D+N{|t-NtwAv_xz~BDVbnX)S7!MBA{E
zqEhSb%wN(|#|vG9zh?q2rS;vyT&9|0D&}=Cl&<mNE-!fmizyW|-$H*Fh+)(}cv+>Q
z&yNO)wl|dGjtpr9ZN_YHk2U&cbxnawbH7<{tp5s$fMUSSPJ_`RH|5W2rhNnIS+v}~
zPkpC(p3H{D%Le{D^LD8(cWX5bv0_+^e0B0O1IP4huko|3k~&ppqD2|VNqS;Pv+g~4
ztHz!Zos}i~YAM&_!4~0YQY9T%IL2uC&4J2djnD+jugh;by16VLmuF_!>JpWUNGtQt
z^nchrC{&QU^ju`;)ncHUf}6_DJ$y!EF*urnme{qS^&s01mYdq_&e(oJc&v=|!8n<f
zPx{*%0zSIP+f0$6byn0)j;&fJxrJ7&Q(*2q!_o(}_?v!OmHkITCzdC7vANXrCMv_i
z9F@9J_dA6wwt^Y%m1*DjIC{YYH%Az}SSV+})bkl0*}zR#Hs6yD4)dkiJXpd0{q=?k
zHl#$nq@}A$MM5?{Rh1wtWUBE9vpI8HLE&8(NxpjaJDKM4t))%JEk`G(n!ux%E?tWq
zOwPwma~W`l5iMd=X`Ur&)>&1n;|IsN6A-nOvXqbP-XCquhqW%m`cu%b-SeZ+KSXd>
z9=}^BB?{<j5@X)sG&M6_I8G~D7-yX*_HAB!tO`q*rCZQF#15x=c$ZIS+|imrT?s8@
zl=Gk(=T>5k>>Ntt0zuG+t3k$+mnVt2%^rQ-YQ)p4=_Hg$JDj{dBxf8&@>SuT(H%o_
z77Vno&pwH?B9eJK6(~XmL4O?aej|*Zy?e*qXzL8Lz9hQW))t;n0(TT$SbyD4+?P~p
zZ@MP@6AorryTg#bb?Vm#Ot`zrm)<8Xhv?b-9oq5S^#cpC6n;^^D|ah<)}!|;W^K^J
zV3Tvxm%WnPdlyIGS8!!il#cPSUgLn)gYhH{!)WMDUNfD)aryvLVu=><gEp%@61X84
zx>IdbTFhypErw2)>hiB8q5K1trOu&yjc!U0Gb|UY)YsY(<41SqV%0>D*8SOMIs>M8
zy58;6*%?->2;j0o;VFfYvU3>=T@@cLwHWbGS@gFf)m(b6U6QAt?}|J*1`{J)dN>$*
z9Y$MbTRFLX>21WGz{Y_jXHfb`M{BEwNFUNA$p7}O>n@H@bFl_W6@uS}3P7c+uo7}j
zmIOs13kn6AzOp=1_$v~cX9Y#2Ik=K)irQnLL;tB8S++`;<E@?KTvsx38Y$C;j~NxA
zm!M~*F7t^tSP$gtyOpuW2hZ6CTbKp2?dmCDZU}m^`MC`&je+X<v2=<7+8mo0Ye#mO
zR;%lAC-#H(3hkf^-C%ogC&U2Kte=*9GjH{I;Z#REEcwv2<A{H2wY{QUKLO#mQu6Ak
zb}PG6_l0gdgE*oo7%J_Bmjhb{_XsC4T*>d*wVaeICUDpx2-bPObYuiX-tC79+caYq
zx}(BSzXmyzQU#J;u%UnBXfHwS3~RXkzC6#IY;P4Q;~IA)%q<ZKg^)wn?%NYCo$Sv@
zH*-d!b>NG?pFtl)ma5!SH79{CiuX%aAAYBhwe;WM??>3;YAfWMO(iTSrEVX6rSy!%
z#dBSXtD=;3b_U13(yz6Mnp{u;CTU`L2<2XryNcBs_pmnFsV671y3f~ljGDpz+|-@0
zFt&2AZ2c4!!l7yX%pK8HQGK;qXxUm%se($3wWqeW*5z~Vz_a`|rh7M4o>T3~Ohh)S
z(F)tlgZ)zF>hkuQeyV{+6{ECQ5`C(d+la9)@yONG(DkFH-r%sStl6sRSK|4nw?1}i
z2xkt851Lz;EosjSl!yI<ns(KVB_fy~Dv&_Gaq65VufnaylyRi^Ft50^?K9~UpX+xu
zn=laqP}kaoA)D>6!v3`q9*|)kH#iA56yIy0^qgslrM%EK{#B)Xcg@3jPJN`jbOmQ)
zh<=EDWA1Tx<QZ$J*=I|%4&`<_`+;`n*$dt52@?}WE--fX`5`*T;OMiwM~gKD*L()4
z^)BV93z8<$UZIvY`n~7>`r>PFdyJZ+1$hG8%4}grEq_KJ2C;(EOs;|@IS;apT6C4j
zl#_)mOI(|veNrvE|CKX)m%4`;NFJHg@z>)|^#To!8iT1s=ZJhGPQ|C2R)gEi{Pqg?
zrPL~$kqkIm2g`W8Ti}H2n4~fHxOEfYfwnp$sr&dTKY2=4u7osBB%yu4g!~t63BwHu
z+vn>AZ^XGQH0?%E@N!2`W)peSt}$HuO-c4o0fU|{S(>20^RUb87r^nG8FQSRB`Yi2
zCVK6MUmQ2_p9zF<DgFKUANu*~)~`DLO=3|nN%9#;7NGDTaZJsmVqoUSTpv9Oq)|8v
znf+xe_7~n!Jo8cQ$&-(m00_jqPV8UdApZqq@}FHA>6o?nD8uqG_BsT@9tc26E_Sh0
zPFD7D4;uu+*YF?1e4j4eO$vc1iFSZ`<bMZg{_#IPE^T33e-@M;=Skx0{wmcfj-ol_
zWi((mcnaUitUsnn>AHFAUv3T7#5dcmaKVny`3|g8Ur1WoEsbCjGg?qpso^VQE!T&H
zgUE_!{<b3e?PLexGd<!!%UndT`qG4tLOzDc7RBdw8X2_3`~^G3nU^L-vnZX>dH~tx
zzY}_`)il+~sp?(d9`l8HfxWk2G)M2{nt$4g`OZ-u7=Hl^6J^CB;ybs6EzfV0JfHS>
zO4m5^Jm>94O1W5Y{^u!<uoB%t(_6Riq$IlV<SOml?VZdPLnF!&O9mx|&Oj*22F~)d
zv+>5;n%HEh3%)%^w07);n5#}^8b!YHI9bReRHz;dut5DDcDo^$t8B1&*65rI_E$;^
z(amN1O+(C)F|1WHyZvA<IOa|Jc?1}o?3b%>Ct7Xv((8)l5atIiZd|!4yXU%{j4?L{
zwL>)g?$W~)7oOI%^Y_&!k}9?zb!SNoAZHovU*PwCPwD3(_Di-DL)C<Nz)8H&RZ*Aq
zO-0IBs*uvepF+J_-DMFAAjznkl?mV*>4bEw7LT{yq-s6<!$^N;KCZ~5wUif^H{u_H
zYR}?KEGJ)Ogz=ZAovKECSKAjoJuJ`%ZQrR=`BLlK>KAge6@o*%b}|gv*!drk6avY(
z+&Xm3bNqpgyV`XlL8txuA7i9rw?h=Kv2rVlm+U+l@X?=xr)sxW$2c^5YK|vj%(E!c
z<<`hRu}L9IKL!MSbbHJUmp=sn0-nO_&pd5rdma-U1Ioh>S+vVC#+f}hgL=S;AXGd+
zB0oJ+sad84N|-(^wi<DF(S-sXJLCO<5f6g6IJ~^<y)-2fB>eTOzcp>NcH*Xu^(K!>
zozx}Y-=_h<@E068c?<x9fK+Pt>e@<Qmk>{LYkP6Qo&e0=pnB+wJo82kZn(9zT|>kf
z*UUBF8Xx2z5sTNhCu&Ev=n^#J{uT_BI}*eXxLRLWO9-L_Q2;63_P$NoLm8}`vLVJ{
z_5F}T>7IG(>q%jwBi|;;@WX5P5V*9kyV)kFfN5e&dP;^1Uj|T2ZddpIX0G+8Sn))w
zk*GAawuApyj*IN-Mo(!VN^Ev`P+Ap|cAkLTq-0{YbUQ|-N-smn0Pf+xTl@Wus)0cY
z#qFsF4+jehevqGq?JSfmF6VeDPyb?5VJ{S&i@82`{;AFKsHl<44*(WQd4^~wXep|A
zhtpWVH%a7kURU?!(FxeB`~)7qJ<B15%MCo#gGOn8U>pwRYzY_M*d88?*mvv~4Q7B-
zKyFVN_S)=eE++0&)%$3<WOTSu9(H-Lzc6~Lz`PD9TY5#QN&ca_eYnMrGxBhAh3F0>
z=*`Orm<30WtSVJ;tv%@mmq=(=KG-`yfBsx_?bg@raEQnsWy35scKSzE`leUAKe|d<
z;rDR^ce8~IWGDdvRT#&nT92_b%#JJY+J|W(rR+hu!db>Q^?yuqgzn2E$~1~aL^C8x
zilywEC>zAL=)JxFbrCHa2&D2#M8)?)opX>0v!>+HKSS1k4RoGjs(-*u(M%!f@Bcae
z1l#)YqHuHZr@1&`6CN+5%s`kA!<aSci@7473Vh;mQ;0H1$E-_pe-P0M<Fyzh+-f-Q
zYk5b+ze|7gEfkLs=y(4d|KtjZy1XiP+nqcL-<k?-{Cb*hl&%cdIGpq_E35f<J8GT0
zI2DxuE6JG<Lmz-5@a;9o9pamQ>C+#1F)vVO?(<J=sztGH-Vw<a`U2)35~Z@~-O+AM
zD*i1H0x|pOH8=VOOA9{5ZF7c34Pj|b^{&3YuJA;-aFXP)a*LClcLa~8QG~HmAtxkC
zriTr2m193w=oMZA!k#!?A&YV=0Be<Idix)qOnKbAl6w(xeLj1u0W)V>krD?PW@4>c
z_GOzP+wh6L35-XawBzxrP{jzLN`EkvFC_izz-I#)kuD+8XP~g7PNE(ycv1J}?#-U-
zzLN@$vDdurJhqn3K9<-|ZU#9>lGXj$x2F!RHKoC8;yx=FG}c<nb63?hZ`f+d2*&T4
zPVsUv=qpIbH=knO>4&I0J+wj(U&a{%g}GF;&|2&2SG8ORdBXL`?#I!!n=Dd3dwY?j
zsg+YZp%m%vbF%>R#_Y?PJH^gk{B#i%!S;qV`XDU=oeE0h%gUES(hF^jv<C|97Jv7h
z7Mcl*Gh=<aBo0f%sDj_dmo;wiP*<e+L>@5c!#Wtm@f9mLmxX~lQ>G0-tvj!+=RC`w
z6mQWa*=U@S1{*!WTTFL8*}zj|r=z8*2MODo$1Ct3^K&FVrIKHm9fH@UUj&Nmg`ki6
zaG@Yd>+m2kKP*|g)NCN;*Kyk!v#Y62=VlSdeeTc)*;2`UOt|IU+1e<7?uyc*+nXP-
zGP#EKgo9DI)9Kq{8kR0YILF1Y$Wa`>@(pVZl&T-aZ&;l_MZTbyygp8tSA<tY1mQh+
z0Hn&YSV^`w^P$bn{DrlRFa@NZYK@l|!Lg-*3i@E+SpPE9Zy;xhg_!{4qW>=ZYVDxP
zMsDEY;lorhH&#9<pPR}0PHJAR@*#wsC<%-)`#F30$r6y<z7#KqTdagjg@IfbOLE@(
zF?$Y_?|u}!A<JW|-{CJRXIl0-Wk~`alF5>A+Hh7JxR%cX7JglJPyRqNN6X6MsKe0F
zr<<_&a5m(VsvLG@Afcuoz@S<Mx7mq!0I(mgN$L|emOmAfg)ls=Q3*+895@*3Kkh!}
zS*xh*(|}CGhmZR1i<LT7t`qzzJyo3-2INT`SoR-%R+|RQ<?FE)az)hT{d1@v02fWX
z%R4ht%~-7Z($bgWNdWAg4rdy-ziVd_leV^xqL9^ZHYht=73y+l=}$70u+<pUk6yyA
zuHjDhQl=VRnMMj<Don+MOm)`ROiU54OPq!skt)r1MBO-umsMN^5Om&{d1aK=NV@We
zva#_F(eSJM;_039QX`Y47omcT2^MRm^07An&!GU4UZ>p}VK>U3m&UGCS0h9vJ6i3d
zOQH_sR${EZ9hkm@&H++u*MCti@*d2ekzk6T<EwedO)I|^5_&mM_hxBFQIZ*_3TMru
z8bElevOFYx_C&>`_SZ}603>CWV)(ruK39x@Nx1C+)(O*Ewj3zd2X#wPana?RuPH6$
ze=WFZpREd%cY^D}O>T2@ap@_Pd#LQR96_DB{p0~1ka9ozY+U@VI=q_qX#I@D&4q!v
zcZvm4h_5A5wuF#2x~hlUIa<ZTkLJRK(QwfCX_x#`6u5&i)&W74skPP74rJZ(b4*=P
z(hMC6M}1SWW0d)<(ODLeC)ViYVaNUEnOVjQ5Xz~;|7d((V<~&s{pF;}WWOW8-fIs#
zoPQ}t41jh7YMgYQa$PSuw=5)>`uf!qhu64=n#6ol1e(P#gM9Y|+Ov=+Ni2`-pbr3J
z)6jmrqdO6M$bwky!hFSL&FaGEa*_e{eWI=BX3)IR%#o;ZDL>MOOFtJ2IN;iBW+HFF
zWeCI|g}xb;7Ycx?<U}z9rIlDBxX`^8R;%EL&l%1|pvSLfFf$U4A0dDFJF#`{yKb+j
ze^MY{Vl){J7IRt;?t)eA+AYEhT7G}$newA}LG$8__u11<!N$saNzUD6^-lqYY&FFJ
z9XT$`w1Z<cp3;YoyO_v11MewKbU_+}yYO~WkGE21kYr8Z-ff&UIg`XuJt2~@Us6^=
zjtEAk)o5~*c1-U|xyFwB0x%6niUl3yNknt_s5mG#uge~7ucZbLNOu`JKwY2O4tJNR
zf66fb7Vogyhq=SV%~3h>V#)j~Jew=|X_xq=8O|t#?M$327dPQSxrQg(=>TZH5gF@o
z<1%jrGezn6>`Y=ohH-Jre`}Tc7~&gjO3;eiI3Q-83#K~JcYvBB+rpC-dcrbOhdq@@
zHYSeW)_NA(7-g5DH1buUOYEX(gc2;qb>=9#bZlf*agf=M-BN)lSB6@<6~RF=MVx8(
zEMMRI_$1NZ7&<h<1-Y;Ok?TrNST<-T2-$zmLl&^YLk?2Qi#~OnO}zl3F^1F74uF-D
z-fCYg)%FFi8wH?v#=onI-8Y#{f;u%IXz~xEHHfpfO%?!MNhr0~*$cg*^_DL$X6-4(
z1<5a9yS#@(e3e2a_Bwe_6b<6f`9*X?AQb$kUVx*Sbl$pv0M4Mz*Er&2J(zygtDU2T
zt$1nkP%D^u=dk3#j=*1279^1?G?(KG<I%yyu-bt6ZZZwOc<tA>y#WH!-}F#L$Ksbj
zPw(`MH7r6pIJ<J0Dl`P=qUU>LNv?`W+F`$GmS^6&gnR;lki3XE1QZDb)(tfsTVpGJ
z0pru-&HEvKVQzre@v-UN`YRX0Il_UQG^0+H>&}-#bqogcC-||Y+`%hnex-ZX3X7!*
zMs)X9%#AHqIP^|E>|lH`l;t=<{8|8)YBlh~uK(agxwwmAzV0VS|Avkb)Hl?np>T(}
z2JFEh-kxB$#K7sAB<)?TS|x6cu4STvK;B$eXv_S}ec@*i^Zjn)UsvN|zG;7H4$Zs;
zf$+YY7AB8*1L{I*F{wEs2;}a6xEJbycBC7<NDqNfUFc;gJJxOmYW05=&kHr3?F`@!
z?BXC({CDjS|5#c7yQYf&f7ky%1OLZoAW8rac~WXg6>>_o9GNldUL`sxI~WT~eK7MG
zh&#V7*`Mt|>GNtvXCc1VLIJw@x6DC*^$Z*qt7jnhIkMS<Faf?1s~D|OR?L~Src6r>
zfN!GoXyv!`cH;jA`ayhSH!FL`?h-nm{7>4HmMzQz^n}}sPEU@y5B^m_LymttzV%a7
z*V(wIVf{AZHi1YQfT<r&oGgikvx~(R03Q7n--AFT%F<J=@t!}uW{ZFCqi%*}kdr#i
zDeq!6%5mxfju(|4H4eZVAW9$e`@PLpp;6Aj5_O*hTA~AQcz<Oo!u$Q<J8{w-+X=BR
z-Dv>#=hXBh8!x3=H>w6R7)cuePYp=jv}FnSFn7cJ6CIN9*w{Js&Z&N^Zi5RrO#LXT
z8N8kTUS*b@a@-2B@A4rb2?C~}iEnj-k--$Vm-PDW@jksw7zafw(5Afq_s}RF2qsX*
zQ}W(vSPm20oB1hwP-t&@GK1!=AYZM1H7Yx$1=<Bt5nc~S!hN_1(eLsH`_V#qlu^_y
ze$PEjt^OVkt<+|QDUZJY4q8|T`#ZX>wnMu!BmNXavBd=aqnm0vUMrJA=mapBTF?T0
z;yTt|omj%M(A6)ef9R52=54@zsMBz#X8c&FMWhAXNg&pI%e9U3bJ<@wP^YYvlRNHL
zn&wCf{AQ?O+#w78M=WtU=`yR|{9uKNjAZK3;`Hy&b&I9`Glp#O?Rp6upgGgz9l_~m
z*;}P@6u&2@OXd$6a5}{~jV$C-*XGKSRS47Zq+mhK29E0qipr7ZUQ!ujxRI~#E%mNd
z@{2C%X#q(FR5hct2Yo5?<AI~FMkF=<>vQ%SF*h1ecQsMdgDw0!BYpOzKE>-lYHK|~
zFKC2dR0evCC@oLmE2t6Irg}>n4Lmm?0a?*mn!(7&pj#^I@y6l(#Z-~4aY7UbN%m8-
z1O<l8(QvZ5aHWwo|FO^ZA@fuO@@R!AI!9|!sB&Q5J)@IRB3HPipy0bVVHbZ`Gq469
zSk%`+xsDXUfj?tzBnN<ZAee^52f^zSbQ8tw*VNkT<kRZzIqC|n2mXrN59I^1n}HS(
z=Hgm^`$N@R93@_H7k8~!sXL2mJGB{a<_k73d++}pTSUqSy4WbzAgx>>JT)XuP=hK{
z)V_D)o@45?PE0XZ<+R!K%nW9z0(InL24W>^QG<$55OUpTDcS<V|G|eLB>f^8nO51`
zH*ZqP5vP0`c~2Gg51a#UPLacXjxsjm&dKHv7AH7cC-VC9ZJu}yP!K$!_aI#ZMgU%?
zuynzR;lIlkf3iAq_CY{K`L%zCAN;^K_Guep7<3%|8&1f-B)cdd{Mz`M@t9nOWnNOv
zW`w?ca8TfhsKFSp6^5k8ZyaCQQOF;t6bx#p_=;CvO&^?>zVRLm=E*^(t<wI~29s={
zx8bs9b6&($q=s<zeC%f?<pFCn-fpbIePLGF)u1hy=>rw0G1v*!2KXJ&YCkRuMULQq
zNujhj{k{V#RA0un`)#mT!JpA5`KW_Y+(vH`Py@gxJvCRb6*_By-B-hWkb-%wqR<Cg
z54G;6LeLf!M6O`ioz+R+tJ4^5oSP=M1Y$GEUIE8=-DA68l|QRJPJp<R1PX=?kXY2J
zhKJVjzI^@7eJ#(uiQm940xr5bNpo+|p`hG3YlE*IsfL$k*tQD0BsnP^ieH)@$dC=|
zlqOVuJRtHE@!={0Zi=+1(<h35YXP=>KisISjY$A`fLD_Zw8YJWKReHQp2+@6^>ObG
zAi)iHfcuMn(CZe!mlMN3s+RD1r1~(MF)nC5C#hk4k#o?nJFxgL=!#`AC@V{cul9{A
zat9|<CAtd2pUr=vu`y4Ax!5%;DEDn9eM{=_hJp4p@FIBSqR4fT>#c7k19nU7O_8T*
zEqa5m&+)SIha1Vd&vkTI{aBqBdz*oNJSf=l?-LoU*f0sd0J2Qx=s2mTKLss$`^c*O
zhZEH}n4l|#Y`sd@p<N>a-~>)p6dw<eWNo0?orO<f1dYi$V)9O~90Na8NsP_ln%M>n
z`X``9?+MM!WIEx*nCv$CvHBm+ts-5K)w-v0<{WyoI=pJ+ya>P?HDia|IO{*7j*t{s
zxyQ<)HRqJ^(a?y^E}?NJpI{A#)_<gtvmQX9QVecBKSAPC)=a`>#hl0?kSBh?myv?@
z^rLvoK%9H$uzFDBuJf}W7H0^ALnfTl(cr4dsZt*;+6e09yrOj4sRlljF4QM$IbfpO
zUj@oSW3y#C_h!D2=$0JX^mXT(zqGh1gn~6e4wWVOCCl+eXEjn!{{p&*qP9H3rMhmf
z_|0uUiW@g>Om-TiJ~b>uxI2J8UgnUR1@ctoPcMht^z?sI)D<uvk6V&9RFjU8Dqd>?
zAqpIBQc3&9GuF{gd9&29&W<b2JGEHQ;I=r96U$nm-eK^inEaVfo=0$2DZ8A#s|woP
zb-Y70qT;ZeJ2Y$peiSYYON=;gJ#b?0hqZs#`NK8|l!;cmj>}vF16oI>j=jkVE8@oW
z^fVX+HJozix>9x$`}1)nK6vPuKZU2rGJ}|>DKI(#?bqRj%+fzs@nXq>CKfc!vw=Oe
zi9h^zU7h|P$l{vp_V%i~$f4cnw&)noVzoh;?98Q*WI8}^zTWvK!l}VTAg>=-HkJ^&
zYoMnO#9q1LvR8n5phdp@(euw~UvAQzg#-nrvvUknIfcoRE!Fkonku_(9^_jK<%T#j
zT4{{1@(Xm2zP;=CSGF&-6o7sZrJ&j5#B5uop+d(1KvzX{YWR6Pk}wL-u7Mt$Z$vsE
zgso~kB6xNs@lyr$FZ#XzlI8w$Yxw_Dm$t-vf-QDnby{Bg_Pm`Y@=edgTDy!up-^-B
wi%P_Q)kmcwSb_89N$u%2_-`8UBTvX51>QwIe;N!BJp`gCulgWQ*67Xu02+cnm;e9(

diff --git a/doc/devel/uml/fig132485.png b/doc/devel/uml/fig132485.png
index 54612a806bd5f67b1fe87fb91aaca1951e5a9f58..7037db9ecf86c83b1bcad225e0a56199bb2590fb 100644
GIT binary patch
literal 6196
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
WAVd6UBKU6rgWeyvv`aMaJ^e2av7~GO

literal 6985
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
SuMPZ*45X^0rHH(15%OQBlXrFi

diff --git a/doc/devel/uml/fig132868.png b/doc/devel/uml/fig132868.png
new file mode 100644
index 0000000000000000000000000000000000000000..f82a05a43bac80a5522b77b85563f457eff5bdbb
GIT binary patch
literal 30757
zcmeFZWmr{f+b%rmkdp2Ykdp33LRwOgmhO=5P(o?x?vR%55D=tOI;0zvZoYfEo_9UZ
zdiQ>Re8>K?f9!Rv!@(GH&N1$BkL$kTJkM)<RDLOqj!KLQfk4n@Wh7N05IFEBtT!?&
z*z`E7OhX`)5LwCR>h5X#i$1zTTMtOT_9k}nlqcL`Y-L|Cq&pUnFg%lMob^tvXqKbq
zNN%=M4`+B<{e)TSDwO!e=F<f9%Kp&<H=3sB+RTFsHaYQ!BJH9g^X6M_!wm6iTbn1I
zB0@qUTLRNAK1*Bbg>KVljpdk96I?Lh`aiL`J&?c_GP)QIfgaeRgn^E0_&F>**rdIO
zM+O@{Bor*LalpW)1e>3vG-6=W!7t+vHvUfk?}vXTC$gypP8k<hs!tGp$08-c4LWhf
zh$y3?76NKZR3CEbr9DExp{#do2#8?&_tdJr3AMYsJ{x>)Ve#3U8U~_Fiz`+8@I=0E
zPx5U*K~)!WG_Fovo^o97b~~r}v5U*{eBD7R#@WR9cuvWUzVqqh&8*xZ7>L**eP|AS
zXaVQ9d-jdvNDKi?YB5!XbSryX;nVg9MM2-&UbR9VHQXQV5A6jCL}y=-j0Gk~hEjj{
z-TwAom#H@J^_cm%32f0oVVC-hp`b;gOD0R14VEV8V;@9XdL@>Qn}?@ht*3Qun|^Sx
z#q;(u3K7wBB;&4cEh1CIM{l`JO;KSpF!=DtShA3BizwClaJm<@G|SYegMI^B%nluI
zebR`g-xk^0QTvE#in;l67QHlP)QIOr2A^p^V^J9dBKElE)7_V(>?}JJBoj20XlG_-
z=Eg=^SJ$qj5DyPp>KBA1B`3$nayr`DJrQ2!C!13BcCRkBzb;qPtsigf1x81S%&qR*
z#3vKAdR-J5_+CX|#l)&T!^IezoP3jN(B`eDsCcma;3^}7EaZ0Rr>X-3@n5K=yD_9h
zQdO1l&ujLmzP?z_tVB`v^(`tZBcg(y_3nDd_qLKm>Qja=_xpEdYPj4sNn>C#wniRm
zEGK-CLh=K#TwKVh0u{3*Q<fc^afeg5?+qTti3FVeCpDn+c`)Kj_&p%*aXCy33teFn
zR%agTNai#ifo8eZniO*1a2va44T6*k0gG;RHA&A_i9w6I?d7kpBN;y)i&s^<sjDy8
zTUdCnMNB{3R^QLn9(Qyk+c>2ZR9D+S(>@iUTJNREuaDWX21fN0EgT}77^^1akR=lP
z>GpJDC?Nr#gk&NiAz^=?1Oo$B{CkwBzA*-i{xf0`?+@9A?N=vsQDn_RjJsdb)A^~^
z{T`ZU7Zx}i*V*bkOgG-&Tu?+28PC38f<U4xA~7D=*pTy_9j>ko1TM&yf6(`{KYJF=
z-y<RhfpARD!Ir;#5CG5gR_@gk!oQrzS8ni8he}e-DhJeMbf}am2DtdqjNbj{68K5M
zrKlEXEUmMGYLWk*;ftU1svtR7AaReev;62cIozSkrh}hL(anNgDA+IVaX|<8w7b^t
z3EFH_j5yR!QA&9^QksbNKT>-GJ{o6tGL)R-##XQk+?V#Cf)2$3FLqVN4kK_<diKx0
zJ4&8lG14^D;}K95uJDCJ?%=G4!5$whSg>C(p$l624JsPg{N?-T>&M4cckMkrJ&`a-
zEpk(~1HfvNlb4_OdlH(XQLcNn`?Y?nWfbqvjTKW;Q@=0R;WQt9rc*aKF`-uVE;2H5
z^7v)i2Yy1fHytGxh{x|9Q$irh2zNIZN6YQ)85#P^Z9aVu6q|-Gw5+VGx)DRlbsLSW
ztcr_@`0ba33f6zG^~OF`93LHJ<KYqUyBC^Qa&Y*y(C8$kG}-RwCn3?b*z86^MD*Le
zrOoHYZlU25R!n?6xBIW3<iegU7fW7BnIg1-GE<f#9@!;-rr^~ZGcz8WnJ@87n!sX9
z(iOeEy_Y<;(!&T?clY)<Y4@fp{C@p>E+zF1nEAruVroiC(s7|uW)({G?DFAKtJm&i
zQFL^4RaI53^>lDh&|`6LAD_j=MX*2*7aF_Pbz)rR{Ped4l3+o&dnGo(r8qHNVL*Ty
zG?2(jz-(XE2Y!Z)gA*j4-Pq_MDG5)tUYP0I<hT(U5CEgLa=6$$_*_>vt*J@CsWQ?c
z1c&aWkoV;;w`Cvc31=rKPOA0Iq10-#p{g%m=vi3o%3gX63p)H1OK#<+L<eT`W{4l+
zf80Mfm}hz26G0M)6`FJDEkZ@Z&3y(YvW%OZmp3Xr91R(n&-0XC&B(+gub?0yCMG5^
zQS<d{i#Kl^_NJJ{KQuL+8YF_@Mumlu2)f!B8Lbwn6(Uo;N5T|w`03x=e3QoSl)$WW
zJ|;~e3!Pcht0{jj8UOnyDPt7|?fQ|QfJ>tbC*h66%E`^eAtIWsw_o<V+cSuzQ_5gB
z?g8_vZCz#Di^0muDk#`|vFw-0Fk538TUfZ|4+DpYMu_$J@z=HAb0S4iQ6sD0!qCyt
zldIL$)%U?;|N0I=MMVXi$koj)QG4sh$fJtLPW_)TxSTMk=;-l(f)67s!E<P;vGwL(
zL7ZAlPuwv|1sqZ){b%g{Nes0{xwNJkNPDR%#=oL{K?nFMG`_o_yhI-a%ZQ!~x{SeM
zY#<<nh#}GMT(YoSz+=6K|1AHr8c{50%o&7@ZNgB;I4}TIq(7^%ga3~+$j{50_>}(s
zBSNwS>?AEcD#<e#e^{+{UtuRKVq(T+853lR>R*g(2v3ph?Ce}!U4Q)eq30Glb<ZZ?
zvKyyNkBb_FE5(ik?C)^fKt<th`0fA?7gt?RkBp3L@nc>3y>(R1=iS}ipFe*Nb0b+u
z7_BmdI_lO~SQDHXXlv8DB1D;>K%8N*Df#){u6Az>B%-6CH9btK6(}@%p6&i9(L|vd
z{M!8yXK!~`VC)s0HXc5{h{thvM@Pr<ayyQ>Hy$D)VidVBBO~MP=E=MMo86M?>+7av
z@7USVQTn6TkSsVbOCJ+424AM~lmVj^6<zM>F`N9XQdd`pfPgTlhAV}Dh*<u*@}0+P
zZEXR&1wJICkg;58&X4j63gKduU+U`#kl|rqU;?8%JH>%DsN}wAY-+l{zd2Iq`W8m;
zD5z5^48N628-&Eo7GGaqe0=<+rKQ8eL)d^f_qSIu=7~0Vq@*^MmOFcUOx)TkZ{NNJ
z6AAtc#42LV%=rv%d46sVHAws%{W0xqdsvvfp&=F3`mdEPVBq%D5MJK;nVFfyHWJ9e
z#mPv!euHvS+HK#-mW%oDI*zzS%Khb<t+qCcr{}{`+g;LROmCF+Q$<t|+<AD;h5YX6
zjxVx?2a^qniHA=%ZOKKKGDqBw&mxSJ)^~{~n=iTp17mZ{?aMNM{=95-5<MEefDvOD
z8$Fn**Q3PBD=eJg^4T0Dl9!i1p9Nm?OFS7VX=rGuMGEj`b+xtJiW6XFz%+6xiu&Fr
z?O1hxc)T@|S!n5bwA5PoGTlgkfsxVk{?^0Vz-Y|z*sVuHU;lo8mUA<!pdc9QiHGah
z_25HLP>_OY(O4)42S=0NgUGzb@dl3g%S;i)iPMibbb;d8CWA3|baZqT`mHGiJ76(B
z%+*@k!t3hk30sV2CHlOD=)c1fpGY2Tk02pPN+qeSF}d9mH8vk2R+>o0!wW&CTK2BK
zpDY^6$iT@<c&5X1knR><QW6D^)V#NIW@#g2pn8l)WpcFis<M)429BGXJ7w4;<NA2O
zR7FMJ^L+C5WQ0>emgLU+bnIqpM7r`hN7#AS{nMk1ijta>>E!L+L=zqH?+%YSL<NmE
z`r~J3XP-ZReqax)2ZIt#`bCsch`b^@JD^~PfK~r<NlEnx4=-<Z{Er_Gjmqi0YhzqK
zx0i1*F{5bZ6E3f=*!3#!K4j$N=Lgx{^{QII(wyT`NgnUlNW#*1J}EkbMj%B+MH|z;
zL?vWHIS>wJc_q1C_T6U+dzo2UUIC+lx-Wc)Q&UgRi@s=xK&Ya>wl+sF23d!1yQSsX
z=c23f%HOx4coXPor%T?|M@=qHmI7*3-Cv(mUTbcTh!(Pa1P?oS1|}8K>i$Vz(=7qZ
zac>IdylCng%oJ<N9VHC*D@{#0Ev@5;irgf-`8BXcPqs!1E$8OvZ@_~|7bN=*U(nGc
zDabkvrn1#x1(u42iD_VPFq~Oa?PhBa_;ht`ZMlh45MkHW)=;Q2GBW1tY{McV^qQO*
z=9ON)#Go?S8cqlC_edGdHdd&aW(=oR&p<~<=d_=yh*cDXa4g5e1%5TPiSzD>W;gps
zkHTJ+Xbhzb)*nECr>Uu}6}%^h$Y?4nYiOJgG&-r!(i-SB*A+H4ZghW?2U&GXLBV+l
zMI8d-aQFv48RSpT*f~6n2MGtfE+T<lRu~-FzRBu!{(es{d;jZjE<PdJp~_rosD5d8
z0KaZ3s!5=t#Gu(oyTKv5tgI|Q-_+HWNA1Z~0*BK@VD#;+ceb*Hwe{Y?!J=!u5zd{I
zloW897#J8#8l_l!b;618Y?`oG3jIv5jRgjbB?r6-KENQR`}_NchlhK5o{EYZSj~e_
zKL-~5{QUgPOq#G)LctEV^%NR~i1&D&ELd>BvkW9K^Yim-XlU$ni#ZG4XHgxHz{Cg%
zGPA?dXw%n<4D|JVOm5-i;VCaIjq|<=jBa$=0%v^v`t|zerd-dn+J}ikrHjMGo7rmf
zGK7xqgw#|)!%p}e18jd+YQHE5vks4Khrcf~GtppIrE!Q-n#KHh%*q<4lzfSFg?`H8
z$8CdRpI*zFn)Yvx;R|J?d{TMn3hA0L%;3RDOM7v;o1dIS`0QGp<j%nf{zJMLFE6k8
zqkM8Kad_D0+S<g56TmlM`)C|rP+vXZ+=06oG?(}EY%-~5ZKd&V#fHQlJBA!sHNl_5
z#4z&nUxA#aM6<%KOgyp8er07PI5=2eUte!h)B#>frQe+?{L2@%&DZhgFxXNm>Jk!g
znInF`SEYalA|WB^Tc%*(QY<MdV$Wn&K#@`bi?O^svZ$h{h~c`_WCS>E5WPl@uWm&j
zZevHbc)7Svx5p$(bt+T9I#Zw%B9G!XE4WV%Nl8huLD=?9g5AUZ?wfb~>(}?8A=@>i
zHq8osJ?Gtmf&%d1-P|r%b}1n1k;!68N=o%LH71X&t*!G9{S58we9!l_>R!!D($RwR
zR##OaQvr8i(_An~<Z&(sQRp8abA1<l*tK;+{p1Nq456uG5nht1wcg4~SIFbXk8=`b
z;QT}RJx{k&xUExCQ*m%`lCdc$GC?!~b|9+(rl>wDO6m3MBw&*kjmq>UQM4Dwl!5yo
z`y9)W0>cOK&ekuFhL+aD!{hhWZBI|nuU`%YqjPgjrKN-Y{l$5C-90@8xfPF1kU6;_
z5Hf!Twn&|NyT$LHsP**p)Kpb@Z0DTUdLl5m%`4zL@>&*FFjrXuto<Pn^>GlNTU%T0
z7n@9tjAEjrN5?kF$;mm*20vF+jEsz6qM+=AB4?-nfg@@XTU&j!w6qFSIW=M9;^N+@
z>L30(go8Mv9ZI2Abar=3E>S_KWc-_uH`^iVNgVocG)GtvT#SUTe=?@OK@b|RL7uGR
zNGK$t9Ry8tpotPhDi~hoJo*m&MbG!IjOaBYCS;WT^(%}l*l0)}`Qdw*tT|9e_@j2<
z5`ypj2Xs;ua>WXcAcTOdEGu@-!xmjlv9xNtD=RCVpa0v}ufMAvp+odxK@KK1U0fnK
z-%}kFw4szC1d7A+?XiiR9Kl6=JV-AUOpNdX5}dyvK1+B_?OAP2T4uV>dj`W0*BLlw
zW`a#h(ROuu-8a^Idk3w_2UIMF4XN`M;vZ7yw`XS77V-EX)6g<tyJcsB?BsZr*G~6~
zgW<Y7(@5rnl>238OUoq@C+TeG=_xD;iJJI__#dOEr|-%i;Xx$-`q}TbWval2rn!Xp
zyC>Q#F6@%BviV_Q+*I9teWA>y#n*~T6_`|#1_t%TyU(YCA3^*iU}?NwBOrE=5fN!3
zQ|;^^BqY3_?VOwQEYdtlO2riLs`Iz~Haay`T;lZ{xv0b|yKJ#~fEp1Zj_mpl5#o*~
z9i{)e+RV+#N#4kaO>K3J({%E4RC?MA8DNxx-+Spep4n7@nq9}jR=B2gpMZ%eHYP^S
zj0FwS1Y<V`@GTgC%$#cw_VpDWEqb+h)|$ItibzQKu(A>mxejO1_d-`U9~YPU<{cb8
zwL(B2xkdnt*o}uf-_|Dn^fd4KR$^1LV4ol<q+AS?oRmu5ZJv^W_Oi03l7SUX0!m9O
z5C?>EFr(3&II%Ft7%=`$06Xz&C<VBm*w;T57i9P=um!Q+niKNRkgV@eGm$cMf`P=-
zUQe|8-g)xBfQ3}R{wrzzSANc>1+~Yt_t0wbKY=$B%nN8;rR?y}Jf41tk!_HvFS^Qm
z3>33XA2<%+6(^F9F`nbSA@BodPzV5r|Hk-K3K-a;@y;<Kv$M00BS0N3#=-_WSv)?@
z80u*9P^Q}$%kWA2>i1d-vyN&LuNe5{HcdFBRr19PE+@7(Vxr8<=t?6fswKkSm(t3k
z!|_b!F2)w%TcfgsFrFXp?;gJ0a&ql!s-0{F!0iM^gR@+E7pC(1y>&syM&A4}&8v{v
z7Kz2-d8#_5@+8#p8FQJD+`IQ{Tf=v^;G(jz@3^_rA|ix=Ny<i6JOZW2Ks2N^FnKm)
zu)W!hqB7|Io^$^I;i$D<fO@U}{>~aC0+FP%V#tl|>~*!i86surg3~T{*Lg^oz7?PO
zxNPTMyIr6wDh@6FCI+MY`Ot+sBmcop1mp?dNPoFo85*ASL|tU^JEbY}<;4d-*jImT
z;1hLmS!#0e0@b+b8@6<Y7O#u3j(}@DY+i^zwraAledTiLDyV3Pz-db~kE*`7-)xVS
zE-b`+q8>^*mX69ezS<3po}3Jeq7cQi%_$$I4kRRM&4yN+*eQvc+OOT`JH#q(-XlSj
zO&GsyF`uWtLIvJG{MRoZu<GfQ>{2*PC)4;zGDRym*+x0JCNudtZAP>1W9jCHk{)}W
z+XR?&DW-Z`q>!_{3C>)0<*W`6B42_&YJTMcuYjVCOoUMX9MZ1N&Lrb~ICu!E6t~DO
zL%)iaZ@nW?K?nGr3EIsNqlm&+Fuk3PzOCZUOxmH20N|U;2;SGHiAkNUE97^r-M|P3
zV2OVx5!W`l8O7Y&wcD6jO%meW`nvTx+Z^bZME?DyogeZOV=CL*^fZApb1D1+s5hrO
zJ{$eaOeIm5-gG#z{Gig62l>!r>Zas_!^OhzaI@d;Yd7cVO>fsk#AP%zR(^g3(MiGm
zsP&an<`lO0jGis67yjZ8*YUicmBxu6Z%^-E`Q5YJ{?I_OOcIR_^}$)Bn?v(9mRGJS
zWBN);=HN-Q>T}5@eBge(ICwr;v>%NXRaNC<J?%?~Uzdory4U<;agl+Q^&X^vgD)QT
z%j?R{2KTK5{qEPp2*P~t&ieXd6VuYmmfY9Q4t?mv5aTRS(F6ey<}e#Ug4fqqqNs@e
z{{3QCXH0Pk#h=UQsqwtcIaujRUiL|pfPxf{pdiJrR&|fo>lQuTwA*nf_Km^vIxwu=
zT`LMf*OhsDR=?lha#*~FMor@wU{nKYKZQa(Xdv`OhF#%px5qLvAEf2_F)Lc9_R8w7
z<q~dhPb$i|0gmaVo3=btneg%Ba=Jjg1TvA(<q#awaAULJP;&L#*(ys4pHmUFld;^w
zKle1Bi{v+)hLXy2@URxOWoMV$yz%3GxFHnXijz<sFD}uve*}MWexxMoOs}q{CQ+3a
zu_+>=hR+(A!o`pWiUcfGmA8Id!~PN>!}BxGh=nc{-Q4KJk()~n<h{<%Gn_9Db1_8-
zbAiL&)8}v|vkCmpKZE=jf}2p~JqhxYh1MHTLCr4v-dyF$Qh&?%)?2FDfs6&*P47aB
zmaPTf#GuX3K$NNDNCW}dWT+2?D8s);YWLWi3J8EZOO}5pM)b#lZWD?a_<WD9UnfIo
z!Ty&kqn|*=nz9G3&|iUG4K@!~9uAk{SO%=7%kX!H*$Pl3<FgRnr49jqnra6Wj{G-o
zq0SEz8Y$9A3ZQl6hBueL5Z)ts?a!W&>C9xjOtMmC3OgIQ_p%I8V6$&OXmhca^D>Gi
z9+yWzI2i0>z`%$+>Sh3EQ%_|yfLlMJ*xTYw=Wp}m{sf(@hjcgZ&5_K7vGU#B;kv>H
zS0l#d=8Nw$?l0f`ER95*Apbj}*I7^3OG&vsd$x2KS`AJ|&ycU+9~yf2OqZ~4?RRNe
zNKZFu{?6d|c=5NeTw>xB`q1v4Ym^{~g@q|BabS7Ggxl<87AfVQ8(5pH%@qd6^qSj#
zjP1NqQ`=iL!ojOGxxZy?X{C!GGHwJ{x;PTWKu_<ToE&$Yt?cp}$vE;n{VD3FzqPXB
zeRb?od9QVKl~3W<qNtZXy|7Sa9MWEUrYw#u#g7O-Xk%q%_P){Wh<!qX!@a;)d31lG
z@C3Nu-@jqNj~)@cu(J3yG!&6Uu5JA-Ex-H_!RfsbZ~a(hWiJjkZ1Xx32s~M7aU3wm
z=S#O&TNH{(Z+s3H9*m44vBkZ;pRBIIA-sFOv2kHGqMw<W8J$A>QYF&HwNruQY-d7{
zWjN}fu<H1^<1w9v##5z?$(H-;$<Lo@oi-Kt9DXh&u_wsN7PjACtBu71N6pE~y0ozH
zxvtLl=G<8IhAyyFYt3b~`<v~2f`Fh-x^Qayo9B{-D+cc+%FB6JSa{gkrDywZE-F3|
z3!Utz@#Bcxol20U_kkNb+48IOILTp9+i$yJp<~!_CMip*MkD6(>I%LJ#9}JR_Vumg
z@VNoE7MG#=R17@T$VhSV?_g;v$lBR`3<~0P8eEfY{35&C)X#4GEH?*ZZ`bPN$`Ab!
zaEfrStL6Hwi`C|s)VcRL@lj+q`zIrqlarHH7N5O58tcX$HiwXweBAgZbl(0Rv1zQX
zj<?u&_pa(<NoQk+KfCrP^RuM_`cQrrh9c*;l}`it__b>9VgN$;>aL)0Is_}HqC)4@
znb>hH9EAR9DOJc}b{tA{QIVmBMs{`ek8fd83Lil|RZ}x05rT1fHce+~IeW0*JK<z3
z_3f+go%6uJ5xXWAC}|Ya_>Q|UdCRmns5GwD`{bM5kSwjN00ueIY2<5ru*1{Y?68s&
zJMp2kR2+mKo5qy6hk?P;QU!9M%hrgWv-=@fMs_0G`?K%BJaTZ9*FXmeYS$k>TDKQ<
zO3Dv|>Rd-$+o&KA#}FU?EH8Rf*c!K^VyUn?07HQI!7+VGLtA!!jJkF5gM=itv&$#R
zs;39>)hkRi^fR5k-etewuz`Nw<$Y^29%V|x8n9BqDx0nD?d{FH{P~{UC_W+r-Nx3(
z#o2Renpg70HJI59VJcwe5hI%Rc6PJXba}PafEa78*RcK?Hv6C1q}sSEll5M<scHLb
zt>m~k^|_g(I(%qG#;d}mI3O78noS>iSN&$ONtjw1!^x#qR`$wpq5zK9j;3$-8L0Z2
zUGw!?Jq1NX#58>Rr5ulUye`Nq^bd&0+eSu}mj?!dd_w;U&TFHi%2(Y;5Xy*c>DJ>;
z;31X!A7_2Uv2AT_Z*VD@>+YtcGR#Nwii{MgGL@GzGpj+niF<^Jxkbb&zPCqmd?GI)
z-d%VCM#lG&fmghyo**v%z}m8po_VoX*X|h;3=HSdqM(%#hgh&rKSE{&`QsHGRaK(L
zD@;wt6cDkX#>TSBY8_p@yXfzS;-of=CB<=$@W^u#2;+PZe+>S&tEx^Xn1k9_MI<w>
zxIFQ%4CVNt#0z7^moE#$cE3NXP&79o-re6+-`=W{q)O$!@UgMp(@|FLnarl|{rS^f
ze&DLDO+}%v#xj$GS_}Y*!0GMp;|uaV)2lQR6r`j%qhxakDX|`Hc<YOSArF#$0L$8L
z7Bw`i<)rqz4(tWny@R6IxMR0h1~zjwY=T}P&CP1A=Mh&Y?U%PFQGh73S!j6k^&N8E
z99Y9FdZCIke0@R+is<I`pU;5LnKgd|4*EO*L~&$e*Gf%Cr{3o#R6fxtHda&%5R?o`
zN~~}2$F;T46_r?{@511(pxHWvKBu#D-ni#Awm2XhWRQ~u&Txvn215^tn8w~;mN!1D
z#2XzR)=(=bjakscPwg*e`;#X<;o#;5QQ~Rf{(^_m!@aXvl$Q918S?5fQ_=M!Jtq{Z
z{qn}}xw&gl%;nGmGk@{oPG0_Can%@bS%0(u7h}$wcQ?JOYY$C+PpXTaQNe?AlmB&Y
zIR!MWDwEV;L<8x<t!#<xr%w?NW{oxC*2^0Mu_!Vbz~t|*bBUK$O)i>N7L}r^Z9Jyj
zJj4%YZM)Rg^AU2|`*=R-cNXhvf$%gz3l{Q$h=05^>&^7Wz}rG4>GPe5`Kc+eujzUo
z+0x<;tY3l5by{*$%o#^2Wmw4Lcsv;Wq`IoDrjERyCH(Hl?|r%6e6{VoYGoY;#ye0q
zf++<BC7r?-vy9_oM}9A!Ostp;eafcXXP+UjUi#nOJv2QMP@F)*%rI#9)fyK^F{ftm
zl+N}6RlzlRBUf7K+Y3_|NY=#Dmo@0fA0|c}?)R%JT=#z+Nn(<d4>vY`8!V_gJbcL!
zg|#ljP}uSRFIMU`Iu3mQ>?hWtpfnOOkoXX?6PQDqT$;)MW)CEjmupe=MI|RGsXE|#
z=J(L55Ra)KQ}jU;%);3jI<Q$A+o8Zts%BT8lH7@sf`X}U-<~pBecYC<t<gO`Ud?yK
z!{q|Wu8@}(j8hkSrD*~RN`Rw>CJaO!t=jsq<kVl$^i`5-Bt*8{=JfYRES<I_5a^H%
z@g)xD-CV!EV*q|F5Kw9cdFOpo_O|&O#~TyCuxV)1F)%OshL<YcjxOTkF=Jvy8@>4t
zJA;yJ=i43&GEn8Ehw)SnVnf6XlatWgx5$ibm`gmt0+w+!H3o5L{aEUSn%c?N_gk~_
zP8g&z%U=vdZc5i%-^j}`=9kxa-yHCM!{`aG3=b73Eh!n=l7Fbqsx9xvw>3(p1z8%e
zTK{9pzW4~$L{^URiANwQ8FzlFXpWEn^l&+I_^EIV6IJpsI8WUAPUGA8I$D5lC$OYX
zX{Q}%)qFHf06u9^fkE1zMw3TQug${7M)}p*o8`9ZlTAe<xo6Bs?dRGRfSo=+hwY1x
zR=5-P5}#`vAOGKa^=Ab*pkx=95p3?{kcU7LO6`nLM|tENF=W_PaKEu=>DJqgeE-y?
zt7ogK>N``j(-A=;dmO$WPfM5C=63XZ_eaLc$_<Db&7S$RQv86lWbXx~ubw9h#Q&vE
zyKifYL^O=|Amg)qQkWFJv8nl+FrE5hMFli$Y>j@wG|i2b6(Qpn^wonLG~E)Q;0LLt
z2uRoTeN1!3zd{G(Z&v_f?Cw`s@Hcys&^wm=xRMU=HHbdKzmzkkDX?90GT=xwO1`YW
zWa3^)&tJO)|E)AnNzaN$kXm6z0LifPzv%S;%QZO+A=}#)oBlcUeIW;9_bK2e8KZJ6
zwU^jG<A(0W)W;pvwYBN1sj2N7dU;y-DT2@ALmp?bobJz7H#9V?t{U}Whvp=(8rWG|
zGvT5>LPbTUVrOTE4d_@}(x=3Nhlgi7V+ch>Lo-3NFD@xTq0-jY2K-hI=E=#4t&Po#
z2x3!f>jCF)Txb{=bu~4oXJ@8zH8nLf17V?|`}_N(q@)_9ufL{kY>(wyT3QYb4cQFF
z0P}{(MIj~|EsX;Z^6KgeBs*^(?(bOjTcV#)1*VDk04@k{&&WaIDFtw_u&Ai07Ad~B
zm+Ut#;8T95;DZEVEFXF-<nf6K%M=l(&G7tuS{;1=fUBud&nnj}^!M+A+v8F!EG*=t
zZNEF8H_!ArKWsjFAuavzyO%;07z!kgtf0drJm)jBP94BeFG?!fh}n(c)f!y(G%CT2
z5EBz$dfx-A-V-3{Gc!pkDc3{1%iFuV08WNZ_@20mx|36NN(!;y);H1*BJ021U0hte
zMcRRB1Kc<wB0|AKUjC7kN({Qxz?JuXrr&*E&B0hM(#_E5%nVQnd<8T<V3GlFFT)H{
zS!Mm*V+=6_DACc@wzRyw45n&+z8MGzVrT=S0c%b`km$5EoSc$^EiNQ1%*4oeeYU5m
zuRpB6rhu%X=GDiQUsSXc^oSrWEe)sx1_uXcj;G2!@tJwKxrh4u9bH}9+<!mOd9ANc
zPC?-ZluzHke+THZ{GV&vIg)s(s_g5`jgJ00n>G;S=LbxzTmqK(=5V^Tv9YnC;iuG8
z`H52iPX}XCh**y2`TIix#J-pg;EyeZM?^3&G0kF+g)}xc0=OSAB0M}i;HerJMo(=G
zTciw+j8L!}1p*Km)EI!JRh;<!`#0cF6M@lLS{ho(L7f%7AVB|;))~KSZkmxt(P?y=
zkSvm<;O<S8k?=d_m6TY^$@Lc~rUH!x6}NUJHu!~U2*Vc^x@6&B?k)PQo_(~0?7(DB
z&(GUj_CSp;D=rReNvrJ<hzO9eAOH#)>(%@bn0&`Nht|6P_h{{;CTd!Yx5c3nw!re7
zIRif6(OB|Xjv!5>ist=-@Uwqw*t-8yzyslvJ}c}{{{hS(`8_m`1vn-o%Ng8hdF_C8
zPHt4q;^>fVMEc_D?rum`6biUy6I7JwhNh-!)q%S^<9R#x)$aU(#5FXu(<VxK@NqOP
z%TqBREh8duYiYPNFQNqrBhYX-qG3eV*Q6cokw_uGb<&YQE-Lp0Y&y4HTITz%@v+=Q
zF#D;Npl}Qb5JaY$DDctNyJLI0`B{u@WXboV7#k}kWh9pB>(_SX_3i*X*3*0M`*4?R
zLI<)<8TkR=OAIAqo`Dqr(OS`fb-p>*^Lv;{=IpvY-4QnVuA?gd8q}K&&I~+MD>P6k
zNg9^Xo2;!hoXUUXk!Ab4R$b}<tSc$?js_GuNUI1~x^3pq(W#)tIFGG%QhI9_z@7we
zf=%d*d$qx!=ll8|23Vtne6*QrK~@bhkviiQH@SeBYvMLNS~_aK-i>`st)R_B6{s9X
zt!S<qXDly|D5WweQI|I22GU0}t7CV-*ov|#aq~WOtVNhx6%^>-Zl)^e>Dh{85|H@>
z7I6Of(L4PkedFYzX<gTfE-)IfFz=B@LIP>hgc|#Ldep5@NK9V8CUgo9%K}p%5Gqm9
z0oL4WgXNz`6kD4-bMs!RnIf&U@{)V<i&AqSiPE0i%$7j9z21whsj;ckRXoV7<N{e0
z9v;%o*#t9dd#|p5t(8?0P@|cJZw#l?)zo^)9pts#>U-aQ+?!^4LQMb`@M|lmIedo?
z!Om*)G0>^*Vd9&)`~InPXJT4Pin+3e^qJPUwv(~(`{H6GS=o}-md-2hGcfdD4irV)
zcX#Fu4W-^ELv3beQ20QnzJTUw@H4F{MTz$nxf3U&*`v?jFJbM`P_38%P_fE%;>i>5
z<Zk&YcnFP@wDir@Ri7X#L|KG11r}#wVWD%as8(;>R)83-paVjPo4-n71R0fTaCuxq
z-*+mmKN~fvHo#5@N%jIHo35_z+qab_vWAA)>FJA~RdRt&!0+MC4S*#o0RaK!<>i3G
za&mAW6!tv*qb~VpB*PM4SXe-&0wS0E{CuN$pe#vANSIn!7|c)sgKI!*H-*W1wAkh|
zzr5_XIhgEoeM-b(^1-C<_UeS!b}lYG{owF0BmHig_AR(lZEfv*y?wj$j;f>Mac9sY
z6sq|6_`beA;MLk3Ryyl!=aH$3ii!fU;NajWC@3oXje8?oJ<p0`V<!@UNb+<?t%w%V
zVah1txzK}~q}qi`NFP+DQx7Cq|B6MD*0g}|{u5L(Z2|e|<m3b$F%X1dlSfTYPR9NB
zkW?L(47+x6WfY&h1_(f)mkJIHOcU}L2WkQEyd7{tSl%J}+wr&^E?i%G`uX_*;?~~&
zNW|w_CIN)E&Gq$gB2F_v&d<%wIc*M71%56nA|fIJQ-w|@a5`<^rzkH^9q8`qsiCfZ
z3Uq2MEkXhU+NY8+@hDUq8ymo<1Em?zcae&CH%wwfem)C_FwllW0<bM@Y=j)wWsHoB
z)Yap_>0Zm~=`F_4%5!mXIXgRJkO@o{Dp8mzZ;j{6-{0SZ5L#KuE+pjL8Hi#%T@Ehl
zbuz>|G&ne%AuMRW)Y8!*hJzCeLgC%<0IN|v4mLIjcR&wjW^R6Q(J%KKTp7q7<xo(t
z=yU(Xl4;kE92t**u#x4R2KVIzeiQCl{mYv8LD41_>YZUH7=MmVZZSp#uN*OHDq}>5
z9ndyreQ084-LdEyM0`q2HEst{7Lf5*M+)|93h3OVU3_8nMkW{{wgXs6208f>`u<OM
z^^P0Enn$rYr1J75`mLE$H(Q?P5-yLLn!n#1>=TZCms)1==tY2xGKNEH8L8JQB3>Y(
zZPP8w=*xYora((}h}b58rIvtXeStDT|3%@{dtES4=V}QpUAFlYg1{FA#D%Z;+`mXi
zk>f0R+5ea*tPRBK6VNPQ;NU(RpG;%3UotBg`R@`T{<fw=BG#|bD7~^|L@{p45J(^;
zjMe-9;&T9$O@_UyqETmmFo)UIc@A(vpL)Q#ZESp7ZghI+2yhnvU_wTb`Q2@az0I9n
z!@wYM$LW7%cQ_hYsZU4{JW%NQ`V^4+upr-oU{ss7>HTW=$GQ+qbKeU+48@6|A?Cp7
zRNfLG-!V7*?fUkuqqR%99+Q#+8a`?WQ1?hllF|f11++|>c0_~<<|$AR`={8QW@Kyu
zt~)B47+M5>Ris$TrRwEy01(ShvJ52JM}?h`2u^XZ|87<*bcE^z+dY1E@VmJc@;mXc
z06|c0)KX$8D9CV$Jm@LkY>wq>DTuy!VGpc3KQC}|BOXY)c-Tf`W!)7pB!4}J^dt5u
zdwpJaJ+Bg1i3E&d99}`k+_zry{?%_Pu}_0QZi^+($ar|PK;*DJ>H$y}aKW9!Lz>#*
zNV0oCCA+$Y&7K*g@?4E_3BTz;6Ky{LZqh?2x%FXx{avX5{I*#RXJHaGoPT-2su~^c
z#UVoQ4x2J9A-?JlOm?kodTBdf<BpOp+@#{Kw9m8T*rX9zYXMEU32_S!#`ubxgxYz8
zs4T0x^}T^d@qGEA0G*IcLeHl~jO{3dqREme0zCgZ8(GU62D68m^HbM5&!Fv>)wml;
z$sV=B=<|N4{^w98wLc`aZ*;Af8^A->)1G<_SezhSgizS+W}JvXdBx~c^xw0E&dxx3
z`_e+m{yk#rr%#WE_PJ8iS_G)6wdqNpbXma6fkg(P=RMRFzFU=&0Ma5Sr?9sB_By*e
zJ`ks6=Jn5jvf0vzqfoQrV~NIrkzHq3c=})(Q9<^Kkp0r;@3p%tZ#siz`l6xaetrEF
zpkjNtzaUO2C{!|#MkW&WELwN1*jMA`_Tv!Dfno^#yVN4fecdL*7t336t}_6`m6p!V
z&5gz~vbNsbrU%e?y$MqvHe?nmPcD|I4G97&D0?F#2ghR~r<2CuU`{Z=k2MFcM6WG?
zB+1gu%-P51y~Rmi>_MHaPE4Bjbr+^yZf@fJMZ2YHDrbBzc%o<1nHfSJMLDbYpQuTo
z!j2v}yNiC2ZyBabEkNgOPk?uDcIxcvw)|^VD%T_=hE=iZmGvFud+4qKd<4HS1Vgp2
zq!38RmqwLE>CB}8AW*KijEL}!RqHrl{k%9RsD76Db^Glx^1Sz<?lb@)X5h@aF#0wJ
z1ENN7H?y*{KOQ`HY}S<JwNs~|tKi}0M#FH$d?a67?mP1$#J0w&i~^#iatAL%s~P>I
z1kOS<UN#tnh(ZOeTC*Wi0)kYK{DEYjYP?R9jAOkFAQxI~x1tOTq91t74Vt%8DQ9n|
z%B-H)BJBd!^shT3$0RX3-AI%c7Z(Ecy!%0|zJ2SDi>*w*__=KQK8><7I7%iUFGd(2
z6HIX-@n~nK<dpOI8XftvA}{Y1U<AlW6UYV6jg5?uKh?Ebd3(Qk(SwH+LJOo>xA{JG
z=588raKaK2cOb>1srNF?G-9HoEo<^Ts}p0hf4D!D2oVQ_^4!TdjgCt>h5xzQZ**gN
zyhVx9hzP9s6eHi(FB2*Kxw!7HKjVnvGHKY<SF)#bTQBTPc-Yxl``s{~olUzmJr%f8
z`++I3jaV!Sx;{pE;*+V3k%J^O%H%G8bt%Fjp3c`YDF;<k_-h6Lc=IO(V>FtFm(uZh
z2F(#Y1eXk((m%0F|7IZ%7C5pRM1tq<->KFxKLo7BUGG{#qVuk)#a^?QhbJ*Vxb6R{
z{^ITha1{#QhN7nH?*pl=9A*X&P*T3DQOu)~T8t1MR$0F|6T<MbI7hSaSSx)d;o%X!
z0#%@puP#ts_5iknm`_<$L}awjvisrQZDP>}sLG=fm{ZTc5f~)Kc}pR)bKW@gpaB9Y
z3}A5pf%m=rJ@*a)s4?JZQWFz2l9PS-%!dQx;=*NPUlbJBnOvL^EY9L*aW8U87aWTo
zK^(KMK{TW`8+Zr|v<C!;=f#wE`_lZJCw;TIpTeLDU~MlB$xQ2RMIGK;2f%GfrYdFF
zTpTucC9>Q(0_o(#)yT}oKz(m7k_?YIV-%U-?eYV;Fcg#7Xa{lRyKfdw6AO`QU;C;F
z!Yq|DF*c>Lq~r22#m`qViow8vWhqBP0-nU&Bmfw=ZK}2ciw}+f4F=F7uy9f|7t9Z)
z_o0xya_TNs4v5EBWGs4mKy-rt$FPB!Q1~sdXgh+omsB2Rle$|ah1-`(6(f5Udu#*>
z0LBX?14GJu@+479UBie-$eDki4W80X#$W8C;eekq42aX~;%7LNrH_>jXO1b<6|AA5
zDJ_&vEGP5n{vzOFaVbuIOR3=Ahr(^6GG;(v9HgC{Ye1dak_(yb5)rc%b45-Me)R^z
z*txuH0MttmdUT8k$co64+;h|WjCmlv%MkVg%B|nGS583b38d;Q`YjDW6PoiGNb<6k
zU#qLvIIM`1N15B&lHuTV4ZD@Tu3QBf<<!*F+1VLT5CZMi*RNlVY?D)fv=m6K>*|5n
zD+)+%r~}nCHT`Z5>T|ZxF)$KNNB}?^P5+Dw^6j}w9Bkw{Xy1UA4h#2OO#pEK%CF7M
z&A+lzC3*R<s3;(926<Vv`3NY$>+9<7f!38yA;|&s383IS{eq$le$noG2Nab90|RHL
zryv&tXifJV2lt~#kC4!b^Kx^$>hdkM_ghLd%64OT5t_n`?v?2yhwt2Bv0g?%V4Mp<
zO6zlfwFMR|fJ=aEFVpwBC@2Ww1UIUeIuI8hUqC<rTf8TdjA`!ILH#nmAkfv}Sr2^q
z@+DfAp2k%_xt%4tVtbp~*LT7o{}s@(Jlt+A8uzkDN?!I02$;T;ay8=PBL)mamORK~
z9RUynTpLJVD}ic=g9G$|kO(+$SG3=QEdB*D`+wjZM)P{Ib*3_R@C1VPwzg$91_a*|
z+x=|luqo?a85&;2(v9rz2OrFx*{Y0@JqoLDrhJhfkj<UYuj@4m)M=2Wz{<)>AhnB(
zeCgxkV`2i;YqtW7-P;#nA@1&cP(5*L7(Vm(<RqBASDN;FbnFZavZc1x=B35O*n$=N
z287?EQs;@qWn9iAfV%@VG;)&1ou`z9gt3GKj?|}_*P_`DGXE=aELrnPci}A{a09Xa
zW^p%eV<79GYbF5J^2Rab9PQrC?%hvQ6_-9K#Qz;SQj+nUh&|DvRyBj+c=VHpj7p^W
zu%z8gG${oIJr)`xYdf#k`StB>U`GcT@Fsr~yXtiuPHYyV0J0;yyLs3<T$DEMdDiT-
z^~SBGu6%NbLP=Mb7O-agNob(2A?}42;)5XX^HIyPyK$>1pyc-S@>*_k8R+h&p`v<T
z7ZBiRXvQgceXzc7!wuTZ9zC+(q;m3G{tq@*sPE~kSM57HXH<dPdwUwMgrlEtXEDyS
zzH4-1<_8E3Laoyl3Y625X2nA#kd!1f3Hfbo6p0EC*zZJS_!C&z)uevh4MM_(_sKow
zAQ}okZj(EgK(4H>XJultwzOnmX7;&QbTcI+q$e1&ZWM4fEeF;ExYzM<AFgzdhx^LQ
zOEK{eg<Cy<q3-S}f8FGqVuAy#rKyP^FdF<bHz#bs?~13Qtu3VziG-2IiOJAkSyNMd
z@YHtl3Yhc5-4QoHNPKQyo}GmG{LZP&{S91twdsKTVZZmCCxR4z==}gx(KDP(Fh3Tp
zjt$(RGLz<^f}FO`Z=?Nu`M1o>&Q?}@RNX*}^cT&Z$l421F+l6^+W2T{l9-7BnUaz|
zJ6wxEXwIC>`|t>KNol*77!5CvAi&|J3!KFQr3MNWP-N-qYP`%KtumG_7Gty6o5CH_
zn3|Fp==Y@pVFAjYx?Y8;Fv7qH0_bJ7<YMjM?pwOx#rdHg9<cx`)yg{1S_#Z`b%prB
zBOKT?4`)5MH!+bkH<82<2ZAH8eH0`iK*X*I)GN4?mByK1(FdfYXrrUMu(E2_wbVZL
zH8(FgL_5L@@q-YSZ3vY4ykBf-1pLmp4-(RIef<`TARyldOkq|nXcAyCAKBE=O3o`J
zaQA3z(cUjM1JbGz%?Dl)5q}SNpjZOchV^tm61wNw0BfRR3fFOeyw2eviSPZ@^lWu{
zl0X#2^k8x|@VJ?X7?V*^n9h#GzfUa>+?F?VTT}SFFW-oN2X_F<%Y;9{kr1#$U*9k1
z<^WmJZ0pTrPlN%e9VPS@mwbIWr^?S#M107oOis7+=j$u5!k*WZtgru2Agrr11A6hY
zZ_hNIgt%#_7{VjtP6Ba~>k)>4hoc&hABOar+jv-0-&$EMUJQlrBbnqJpj4F4eD3M$
z;^(bzXltVqZJ%6Rl-;~zs=d7I5cX;t7{0gW?`-i%WoBMxVVv9B+1WpATlp6D;veNz
zQMIqnI4CMK)k#x$Y)hMOf(r^ZLogpG13`tvjt45g$r?*P+tV{}%L|R=F^WKzg@N*$
zo@u_`^&rI1&<ll1I?{$RP`8DUiRitBW(@1|Dqm}12sE-jGd70P(J>%P&j7^Qr%!F`
zM~2>Jfe%BxHz~>JCND1G;LJbP6&HKHvG}~~5<qpM!XDZ}l`&|%cJhPzi8mmwz`p=J
z(WM<S6<>)q9VlSdu8H?>UwZ*qb}KctuAgr%zI@38Ip=hFJl#`7U^at85l^0AV2k@+
z?`+01)uW-^YrDU_IHcYrKAEpS;*j9*y6^?^|B-N|-fvfc2AnFJr=Budm7MPi;cUNQ
z2`Sjw+{7P?rZIlgpIlC3@Xq9J$`b-Y0&YU)vUBB`?jT#+<YQk~ekQ@mk>{beVY;9C
z*wcM>62l8Dll`<56%fDINxZ_w=Q;Ydg0|^C!<Nh1E`*J}`YGnP%evysbFZvzbMwWg
zPa&|dW&m9IHVL`~Boq~yX=%AwD{8*{0<Mfas*uNWT!yvcmy$@b6Hr~nGr5)O@~0LJ
z<~@s1OkiCmC)nb3Ej2Y-bt`<i@#U+K=czhJFu?oc59DJ08ZHByKZao<6B8w|fK=r2
zOWRDnw#v7$K!9;DugTU65H=u5Va6JqZx_8A%~n=ai~uQ?lVj+?K7RFHJCE&gwxwr>
zKasER{LmmGhv4J=S)B2T%)|XzlFrU^7HzJx2_;cn;UE(nKtqQSNGqn`j*pLvBNu&c
zuz!<fZt+>v$t=kP&9;|St36lP0TuD&d4Mu%BX{!5OKaSM4zU7yOJkw^izH}t$FK>c
z$6078eD=a0A`o0)Y1S>Z6yP5kJy`h35Y8D6NdCxr6w)b?V6`3(xdSb>GbT8c9!QF8
z@}bWQx=#Y#4*~n1g=dwVPd~jpeKyBPZ(;uO<y!{_Z;~^Z1_%mP2h-Qg{n7N>J7W;{
z{|?9iw5$2N9jPDzr_3>fgbWem|56VRO7mR$UVs1O=?YD-qItNuRB%5=oZ+B`ba#_3
z*6!($rR#HZ*8)KiXy}pD`Sy*>&51-20M#U9Bwj*PRLaAwvgHm+%8?SV@S$Njq=Kz4
zxdpC~tD{y+oME$+Rn@u}`aiWUR+N+|+SwKVR&@I>Ex=oE?<_I4&n>r0`?Gr|CpbyX
z2*7Cxd8nRT@2Nq3Nu8V$>kQy@sk-~EK4%)3BgU$uh!DMA7)1C439vf8h{BtfA#Nh7
zHjJ6HjRmcUcel6e*zt^SUF(3lG#;pwPNHXnDr%b%IE#yYjSqihRa7u}YI;C0034My
z3V@}ah!ZD=*8-lW<3KCO83ckIDXG0B|ME0%D3+?abMLTSB>>>@nCdwFdcPRoE8GFG
zT3{!_KC^F@Aiy|f@vm=g-27;YrGZKoAjg(FA}PZyeh;s`y(um4?7pJ?GuAZ=8bPF>
z3o9i`sr&qZ3999Id2h1PDO2YSbc~5C-=5N>(FD4C*#l_+0@!VPXcImG`ZPYOz;uS!
zRqOBN6IWdiuIuKzG~bS72#1A*F@YY@TuFI(YXB+&N+?%43LiBH^gBTN<Dvn!2@VwG
z=W|0_rfB8G(43kL&J9(^tyn7@K!3Mdp)Ut$sHO^R)cLjEM<wW*$Kmz}-`4amp}DvW
zP`*b*6s76I`-=myKYh)@0(RwN-{7Ec^ZVB)ot=)-(o|F?`>*AT(t+DFtZcFYz^)(*
zOL<L=^Kcr!L@?SX?N04RM^k<M4A2T|YkP2hFb`-_hENVRHb7Q_^0yP9iXuSE<Z-gu
zdOl|jl3hHePZN7;y88#d$$Oflr0^ad5BATSCz}zf%UW7=hckxit2ktpSbrTm?i@S7
z;1a&@7t5B7{KYAWLkyfFP-=;P2MRD%!RP1HKnP>!;^YMScCSIVp|G$pHy0NTfcb$!
z6$sKqGeH9;5PJdGbH-6vxD|Bm78DkOHc61eY;JAICph1PslEM6nE^aGkOBg6#xVwx
zSOyy`JZc2d%HOK3ys6n{w;wrDIv`26u~h`EX-&UkiB5RACXagFG#Y_o08}9Wb_LG_
zbT$IW8wiBU{EpZAKyQh)mDN(CQ*UQyPF-DsPcZ;|MMUla-}LFzr>+ppL~U4(?yVAO
z$;*T|^%s(tRie+tR3Zlw6bJek>?|x6S_Nl7g{ek}#l|Uk^TOCT7W7s%Hk$Tg_yJu9
z5bcHG+h)_tNf%CMOYAwj)NYW8I73q;-9gIs8D!DNS}pygAnUgTqCX%Q1c*fvNIf&K
zQyC~<A2SO20G_DYOc8Wrf1;KyP|767!!rdrpH}A-FAooBUi>jOR#Z^|&}b96;^N}A
zhx?n-(o)lb1Sv^Lwp?cv6ci&`N~ir1<PTsisw)g0$I`Jf>k@iw^xGAT{`j%EKYRO6
z-J&5V*$jY+Es{d?2~Z>g1rz{{)=BuCQ{wQ7A;*9WrW=nNNUZSk@_W0dQTy@ZbMel8
zx8?ZXUts<%d8j(jMd0G)J#lZTlQ)@<Ruj08_)3<3{~OoG7^IfjE2Nnf_p4IIM@u*)
zBqN+bLqnn#7JPr`qaP&1#9n79fH>9%S|YV4Yno3q7jEOafTuVGYEV<t8_)<SCx6i=
zbQ6#mqo6gH-0j>%<v(a@q6-*v!3$9!Fs=iEWoUBpS7(rQVDw+A!9XlvmT755;@<&N
z1f<A`YAuv-jPYHt^pQxI<fH=5-$9kSu%Ig~Ee(VhVmfX2*SB-EAA!Yv{P;Cz!|OcI
z`}Q}Fh(RlOt|J*(;sE3S9z#3N#dRqlAdE@2+W+RG9Khm6Y3-I;k^$eHkwH#C06K8Q
zzS7c`VKW&%{SK5psHm<V6QW2N^kL;tQLw}ku~35^;XiW+?X?{Na2sTgAT{}#tcu`u
z1djf|JB9Tx#473N2(m>_)XxQ%cPwqxPn5lT=X$>-dPFYhO7)~ub83vCWNSoeKoC9}
z1gxyrxDH>#`qxdeU<KR~4gRMB5V8Tz4h=bOSKMr)#&tW*zO6ag*_8l*%aO4u%~a;2
zdAhj`u)E#uQ}B8Km$#K4L$#mGG5)i|2L**N5B{)|!yN+Ipma?%(9}$wn-i#PM$ps{
zk$HI!-fYqEh`^}M_U1+DD^E`tCrou9X9Zn3$DUM>Pzbdc&_(pk&RX@yy)trpM9$g6
z0bUUStUr_0R4u=_c=`178cY22%th*maYQj`aq~|bl$`8e{{0`!;Ge=KH1s`qk48e`
za#*CulPO6ZsO%H8&S|^2umW1JpV|r`$6u4Q{}Hd#bEpo69(|LgeP3eJ?kms&7QVbQ
z`6=cj{-ON=jUX{TmM&y}<`W|p8X!ldYT|3pMgdfbOhro@Kd4IxF$dW(M9lKT;>PsX
z=ajDXKmVs}-`S%9f{F&fD15ufZdhl`e@ZEZ*2ysZg@EWBL41PCs|BFmpgAWi=F<D@
z1M+fAO#cUD0~ePC&vS|y!<hFD=s;v10-OR=dG)9HN3!zrrngOw$u*=8fSLGsi=Qkl
zMqdGk2wHi9$(}YsDWT7RDc5q5Qi<DMCx-Zco}6?Db;MmX<lwF66A=MAR&{+}`}6&?
zt1Fa2jM%@6W2ovmrwpjDcx;lCkSnW*cekdKztU{`Li>Pli8T<NIrrK69{<@R0DGd)
zy#{2^@6v!FsNjeNk|~J)-j^;KB&ecZ8G}QY2vQY9_B8&lw`%C4xF)H;0CJ-r(i2=7
zop54_ol7xtNKkY5w{HG_e&0{S%i}|QGFv>{8cw=GK0dy-h-)a~2KeOZs~fjX{6m|P
z&dy`-_Ji43bg$EGO8|N#2P5hs+(5qq8fVL>0MI1L^?#mdq0GTR$J}9ARI~!+J%u;3
zL0V;NyZDcELR<#C<79nZiNzqY*@4PzzRtc|JHL>C?Lw@!iZ}&m7Apu~$^N{k!{3ij
zP)9Mjs=u={)#LkG(PQ!dl*=_vNWJ<2-VNe|Oa)#FkmDAQ1R4Z^SoJ5xU((KraUM)E
zfuGX`nR)r9I6ySRtD#Q1Kdn^Xa+|S^H!(K{T?YUP1+8zO>rIVZMIz)+cSghT%#4`x
z`cnqW+C<F;kYN?6i4yTCXJV}$iFSQ6-S{gRL4|)`XQ%l1Kl2e<P6EVGOt%m4<sEm*
zF#Z5l1p1BQ`t|jRi$h`k);Ufg@67D%w#3A+QqMzjkj~-b_mGAJ2lsO)9R6uF^VeKm
zSxHOP(KT3(&NSEsq|%W?mfoKy*@7)%ApE4WJ}-|0csM=1{#WB!{tl11z-*UruoF=p
zVPzTrvGjkx;RtXu|LA~(Kpv)-(nF-)(%3*M5X~Sc@Yv6JpBUj|tz*F{eDJ40L_oJT
zQRI3O`QhCdAtr`O?#DNhXp-=adRWT2N$y_)3GvW(Lv<N{esiZ}3VX2@fgN4aE-D}>
zXvnv*oxF2#@$2$*Qr%@byrV_^l^Yyrcl%?3vdfD(g=HG$3eTRk5R;}&x~0Fn4}yRt
zsk?PVF`cThu@MiNwCd|A?tZOQ%O~2MSx#rQ{}lLRM&#tyC{*0sn84#P^z#GmZe!q8
zM1*2Q#1O93>Z-<T9TMAl*Ecuk6ty*6R@QsEdIvc<2{Lt|QKIWBD>BHxe>sGQ3C5+7
zem|CfX9s#;91s*IaHT32A3>t|wX_Tav3z{=HnUSxK?|&p&HnN2Z9{lC>+S6m6e{q_
zkdg0~tNXK;fK#$vyp~ASXl&d{^2(Z<3GW{g?wxuRKo06@F#8V*X%=gTZFA$}As(Mg
zOC^!tI#z{-Uh7Ls$M#xpy(IYYqkU)B3P(H`ZR}G^iO_crcuL?49#m9SIk-quVyitS
zKd%7u817@B40QLfEiIlaDJ)de^3e4BR#Q;m>2o(Qt*=&5;RoJG^C3cCBI>_P^tFNG
z`cq+_2xY>}pTDj`D16zCy8pk{z66@8zU_M-#3@9EP#KOP<Bh0fmdsP6k|bozoOvEH
zg^CQBBU7f#5pv8SW5`%3v&{1p=e<t%`@HY-JnLQG_pR^y*1FeyV(qh?z0cnN>$-l^
zru?&7>kOq)NZpBzj5Ia6;L!2XJL;{qjiP?dHnXgfe2WcuGfkKwhHT6mp=Y59vU5XN
zrXt3PIS(xD7#I|nzk8RPJ=3`}%ug7Ak$r7tu;gy28RH1iO=Wnm<n03?`#)D%FK?Oo
zbv~YI5RBcq!MeWbWK<*G`xhF%HKY~<9ddGfc{%SHPn9UiXQkZgV+kn6uZ3xqYHGn{
z-;T{O;1$()L*)PZCFF-s4${j%U!%8K{^e6F7&~+V0;2Z|wR`I*{g6>vC4wJkd~xr;
zm-7e|dHvq4sy&<wp-6?Gf&A+=#D~X*@G>urjnzA<=-ga)n66Z{x<QaHU{GjjZ4Lir
zb5YS%f)&<ctb%Z?5|@*erKP7g`^%D!_MKemEwA4g3JOKpCm|um_rAWKnv!{GK;=ZJ
z;FmTo2{}N}2SYSM9|z#;+uPeKwL7nplEy&Ir=p?)2<msw6-j>?0NO>fh5iUrAne2Z
zGH6fEtHnc9%8$9ZJGXBupq16s%FD_efp4g&c>d%`8kglrsVN9AM@JJ!LZ@t7ywkXN
zu3Q=Z^vM!T-fE0sH}{wMF*(_EbGX7LDJZDr{i8`fK0X2hf>E0<**Ml0IqKsl&s~WG
zfk|H<t5l)Waikc8c~9|{lnx0e$Fh9L#dxOwDwR3z#ad9R0Xt@Dd+C6I!5~@ktndD2
z#algJi+&!FopaEYoK4b#>wVY*)60gI>5YK)ZGL4%8iZIjHa2W*Z1Yij8?$z!<+*8T
z_5J;2X=(T{6fo~YSjbttr`gcoO&SIYP~UVaz|CcCZ4KEe3JSrgsmvI5E-o%f$-~YB
zVUP#{$R0=u*7}Kw3G%a-1!>t`c}HqR9cQLyXCV|s*txN>F)TdXyfeN*!t-Ez>FLv_
zKxe#?^7a7aoAF)LVqH;@T@v;gvoscb?kz1G=g-eT=)uxU@TDbO`JA1T(+Kxvdh)ZU
zW^pgSv*67-^77uez1a%}zO~xb%FbJM)zzbck(g^v>?=GJrDP(l!AGSqCIHKyBJPUa
z=oV*;&B@6b7#f16{W1k)4#1cOGZ-2JX>sM{T-@9j&cb{FT1_=?Q`2c6U|^<Q9(|V&
z15?i|X^<>XLLk3kir877h8x-QZEmizLnXYUb4Nm63yvNF3M!w_4Y}{FXMvPdy&uf;
z(!W;&o<Bbs(Hj2z`SJ(aer8bnWZQMRKqLkP0qDHF8=I11V{SfVdmJIlyzCnAhRb{g
zQ)Xnn82itw$?BH#P;dObTkmwPUk4Lc;fv4K?VkcEZESWD6Az1Ov*8O{Atn}1m1sAb
zyi_Y@`<<N0$}g?X&C?TN5_S&`Jl))OcXz=sq#6g}AjrKD6BUKi3#AnfAHIRnmX_&(
zTx~Nmvk84}ZthSKGIDZ92M5ptI|DhAoP17J351|3Dq)F<qabSnTh4I|5KbVRYK>q9
zO)A7<E#EE;i3(4FlLwUI3`ncu;#y<e+}&^8x-~yPe+zCAMa9aoJat^wfdV=gtW7E^
z)n0oJz{kX2FdhZrstd!}1s$Dn5kdM!3AO76Y&5}ZZamNo8yR5(DSdGag@sq`YA+3U
zS_cNTv_WFjF=8K9TT?6XU!(7EAnApOH?x^WnQdrZ_jTax9vvP40FaTM4x{2|41DJT
zx}||Vv%n>onwi}Ps;sO>YI4mD3`Q_N0&6!FAw6KRrr_g)t*eucXoYF{1Sx6K#fLYX
zoHm~`io-PotQZ&)>rC3IKxhRi7l2-6W@e&^9)s+9%~n-Kg?;Dzcesewwzj4>_6Yo0
zFc`>^ab6glo|^iwHK+$?7c>Y-B6jx;4GoiS16de#Sm!XUl7!{p<OGPoa=tGM)*m&8
zD1MZm|Bx9`PMna?bG&G#>kN2=^ofbD1<DR#M>pz!%%CX=D9IurnGUYgZq@z3D;Xae
z%e-yt?_WYTmBxu7v}cAvc+lLeF!d6z6YhwdhsR-CxVsApl<yUk$&}tY;3l!Ku-I(1
zHR$rIwL}b0MZBRpRg#lF;Ud?}TBRzT90bFt#r+R%4K8#LU-dsP^$_m%KB$VBXYhy+
zkr#zpU`R~>Rn-3Zl)+UHPV;RO4L{}<gxc`q9KKG%3tuo8`0?=%f4r-Z=z!n;|MbQF
zq@%cCg(nmnYgq)U0f>J8f4#5-QhsG5L;SQU{bbgZLy|7<T+4zS$a()I8U!gmjzZHg
z+u}|lhz%4uPNyh;!QX^P{Z+I~J*^tCC3Qfg56lL~>kj=L<9nOfF<v-A5a=oR`8gJ|
zLkmmk=NBID&rF7cBRvfW?F`rIDw)q$kf;Wp7-K{%NYqnJYDm2!(vwG);jn(Av<>0l
z>P7z);CfL|XV71P)7kkEz?zXI(0aDQHEt58bW>fcd!i^;d+0+W>w_?d)1i6dMg7CW
zH1zRl`QqxgocrECQteKz8b~@>cUKQV=#^k5(T$6vQ}1^&oz|DGYfDTdX$o1`+QVS?
zd2Gh928~U0*tOu9?ImfA1S+qCZLG-m-d`Jp;8}kP-&dQMx%t9z>W><UCi!sP7Z&c%
zX)VQYH+UV%85<W-bMi;xp4Xs*jJ%GTANCLSUDUtp(KK)~C;Re4(AIQnh*{E}OP*R{
zeD&(cQT8z`_2BWDq+lG~E%I&2%Ud5C0N-DG?<%$F^bQHdk^SUH{R#6o8u}ZfR?(A_
z6rtja3ukll#O9kQ>MU$*On)8{fKx;UA<%8@^kq2XQ)<{i0xS#DnM5DlQ8cW`^Zl)!
z9<~;sN6v$SV%GCYpsZ{oKhI}t>)AQ+!QIY;_fRI{&BZOZ7Ijl9E5|Yv-?1r>aRhcI
zRl4`GRF)WftE$LNoD_5h65Q}h-pEkl(%nj1TP3B$-4W$zYZ04u(i1Ab4|j;On+IJ6
zmcLnnBF6gGms*q?1PA<}g<Hc!U%o{nF&jjV!ZxF$tE)i}PATwL?du}kg^k4&af$?T
z0|QsHjFOVQiIz_gu4!e(=IGe;<VkH{<ny~NtwowzT1N{8<6_>`UY+rE!666ko;9^N
zY@G>7yqJjXfEVtty(xtBVWREBz46}ebb02!i@I2eZQy#<+TWyVm|ljZ{a}(DzP<0)
z;5?aITGsyt)qjR!4;eWwJu|c1ZhU{@ftLH8I%E!>6|rnfEn>E@wWViBV4xJ-sQ1@a
zQ&xNn8qedHaJuVyWoDjuJs8&3#3VbaFI7PyL9F9t%g5Ftdg<>xm$p`~OVfs>0>oVM
z?wxZl%R8ecVhCeQ<=TubKp`~5aMeo*=BB@k{a)T4mp%Wp$-LmsDe#)g>Q<$!{0t<*
zH8$pNZ-=+c`Z|AyWpExiQ0$S%n~0v7zb`np+Uo`eJAjC1tLe5BEav9z$8t-1l)EjB
z#>B^G{rZ*XeGmnD3fzzThAfU;VNv0FMo;9vn3*}&jNb}#IC=cIQN<%h76fs@LmT)!
zN)-ABZ9?LiwiYE?1W|(X1Hb+6<s?eyo9K`jC#U)1aLEexV0pO281%X%X*z+Cb8~b4
zqOfSy^ET-ku7{;pAJz5u_w(}cfdj0v<I^Wdd0hEg#m2_C;6UO1g+Vu<tR8N3BL2WO
zsjzhD?)VL`Um-6Fd?H#mA)66`*)|3~#qvg+6BPncDBM?3QB=~>(o(75s_ibP4V44a
z%1c{XO3L1^Ukfrboi^vR1O$p8I*f*v_MILMRJPEJK_nGaFo@<dE(MPY^rzB~CIa8S
zwSh>>EY&zja<aF#uW5~1d>s-(f`OREnN|?uKv+~>-Y?ia+#HY<_cdcj4ns#bsj!A1
zrG#uUiy2(M069N<*;+|O1tKD097?`qbz52a_{L3l_dUoOf|ki55nMuFKe(4ckR$j{
zAiDBlqKlK0b>$bp+@V(#(65FsXtzV4j*L<4B0GEY$cSz=7CssDBbmz4fWLzMg#8hc
zS5Pnjr*U8aiuC}n9esTc_V#n7Ayaj1GEjC~T3VnP1MxH{IiT<^e?FU@gF@rc2_XX1
z6YoFWTTWiyWf9z?1uj!lQ?sP>oWa4{Vd?QVU#F+vFfizuT)U6;%FWJJ=)VZHz48`F
zYNDe0K%Nas5Htp?E}(azV3LR|ge`$pcZDu(co=rc!|-6#8hS>jk!z2l|Fs)zeAu78
zHAjxGL4H0#^1VV=m6h88kYcC$eDQFhsO~%mM`-H)#$Sb<&=4u0+dDdpRm3b?zIOcr
zcM=c+H1b-2yU%XyEe%2kB?-U4OhF%=;#w*$Nz>8YtpU61?uJn!UeePgV*C^gnn!_`
zWJ*~jCH1*z*4-c)EgQr)E(>tc?C$S_JRDk)<?>MwF@YRA-ai3s@Gc8)va-DQ=ifl5
zN8m3bpH;RJvb+frOKWQo+k@kaj}rZNXT!?I=DDungc0+=h0!waV4>LAL%7NNW%#fj
zpuG6@^(#;+m2k|wI)%mGGWfIWxjt2O94}oSU~t3dlSVSqqb91`qd5<DcfY=W)CA%Y
zQBjB{DUXfc?O_x@nV+|Q|3eO>-%X5^#r**SPBKZ<dLKkU${4H}g@rCa`9UW>eGVuF
zo?o8X&#_qkj#>!T)(t|MoxuuF<Fa&yH)Oe+HsJANs_^jW&MxwWUuPZ|Q<#|sX~mRb
zvCB(iJHkTP;*tyQzu#|niAb9eP-2?9x@<dM_QZ=F;_xv-_b~{{$|7-Dh>%fY*V%2?
z75=stHcWHwJiqII&-&Ug3#1>VtNS|B0V0Sdpe)YqAOpuhYE<bB^=G~dgZkjbc6L^b
zcMvFgcI%cWXhwN>!H>2=H)O8i3*Pp*bMT(0?J}Lgn`IwA?h`by{`K}MIr*~}FT&%a
ze*HSYYdrJ=zI#{|Cyby;!(V`Fjg;&+464ps-Y}~ZZu7uL#s1)fXdz#0%!G19P5+Ml
zX?nzOvEB>Sc4AEvRv;N)a2XV*MW+Rj0RTgYpwRcV?4nc@sf#-K=!IZ|O%WoNLeJ^)
z&$Ich)sDI>Z~;mABbn%ZV?i@N3?y&W%g7>8m{MVS;d*=rW9WxLww_+ea4HR(j&<$s
zqV(H@Lm{L<&Cxp3IIZe_XH$}fH=VdgGDrKF(XhtAA)ER34e_0&lPE+61Mel<@PC#D
zZ($h%Ym<;Vd*1yISMo|q64I6KeLVr?4WEKhbWe1l?ZpHPyHQaDDk^e5J}<nadcJ;*
zTsngL$P3?RTr?PeGCVxJxAzFf+1)+)u#VZzgculflatla3DUTvV!^tJiA)CJWZeaD
zI<?V)EkTW!C$G4C)2Jdg78f@Jij31m*NSr9Fa5GqMT5zNVV4Q^F42hJ`?aRmte^Q4
zrS=wzNTQ<%TBf7Se<mbFNVqJX!>|h!#RT!grswdRmTzuek~N}_cmvX~bEjv<Y*S)l
zVzJm47|cTg{}IHM0zsx|3LE>3-#e-MW<bAqz4Ti+R#B@PgTZueL${{8L<+F&ACTuy
z&4D6=FFpVH;;{gCl!k@|kg4#0SoM|$t9)@jYHDgA9Rv#V&mWLELqNHCTT`<aoRZzC
z(gHM)c|kDx7DW47Q&UrL{{s?CX1@cw%=~%LZSF0&=Gf1lr;-I04Qtkw=(2D}Pfy@Z
z@ejy9Wm9-M*Ddwvx;9*&IsgRdfgRC%@|g%41Ij)|@>L5<OGs#~IJj9uvvtv}q6YTq
z3uNr(%ZiF^$RG@rqk<|K`3V0`etv$)vI~ra$&ikYE*n^l!Y*RCz83M@4+7H)wx=Y#
zj&G#OkyG2k*qDtflwAaNXhH&q^U~kH0Tzleny_mWeQ*-nSpH$${To8UH%~7bQ!i)$
z=Gt$)17AlC^yM>3=kd<C)1H047KsYP1TeH@*CWFXCM;p;!^?0|>EPBb29?8k;*xK$
zT6Q<Ectse^$gUM1`F=t(-s^`g+VIZ^@PIYtJu#b1y|db`p({OczY$#JWGM6%b&1VJ
z526Mq`agFD!Lp_B8awH!z%Be*NJKzse^ar;_D%##L4-UCu}2jW65Sg(f2j0^+(m~&
zIOO9e3s|575TfL!=9J5?6^S#5`Cp=uUSDYc9W&X2I=e+eXD2BG5M=-KAlxfQtRblL
zq^f1m9#Ifb`kj-3Bbw7g%jjFVwxij^#60S22+swTHNp0j=bfrQs(Auf0X7HaRLMXQ
zO;p<uF2if<G$M1^i0BEW>?>(syb}~+cr{d@fI{ZraSY^T1K|e@JrfgCU?g;dgd`{7
znt}EH39o7#vPr8Jf<iW#h6sDRl0*){2-ckpiS0HfCIhyicQiFA|CFP@VI2T6@c8N>
z1V6{c##X(5-`w0R;ko^kl2xCeH$;#TWZ8NbL%g8{f;tVcvMZT^M=Q_L(V$&AhY3^z
zZCgf!6m%(6(k)<K?`&(M7jv?JcwI#fmZYg2lB+(RCy~RDuA2>cOtq@X*prc!m9E#W
z1=Q8mg@lBFeiphLr%;o_#YO9xaiH3D@7^8!@+CAC+J=9J5#}5(;!pe1>-lJFSEDqo
z7{{JplRD=A1_)%T##7LTrB~Q~`?a#N^5aJ@WP<x1{qB)E=xlDD+FhH3jL8j9|Gwnc
zx3shC=~Q9o<gDaIF>nrDAfQtvLX>Ib9|<E{b3<w8aD6L|03yJ_rNosVTo_3SW|^E4
zLoU$#;6P+jWsqMdHLm-=!!YVrGd#Fog^^)ygzL-xo`nThS&7f#K0mMHA)g>3FFUy?
zh|C3#`*;f3;JJ*Uh5+e%C9KQS9ofs}RH1p?pWHVs>}G!EXvzK=^$yD396|@=3lmO7
zaWQ46oV6=anoj&F7P4a~8BQ-RY;GYo^<~9=L%^Gc2IaiG4|dqS@+2Ex-W4g2o2vaz
zx4sk|j<z2KpJI_kw|91ymzGvTc^zX!&7J*o0vX-53zk=ZHh!xa>Pp-?>dWf)-NkHv
zbL~=5wHqGhn_9c4rZ)5Yx8te36}JdY`j4~MlP}x6-L=aDXOWcWw!_s1+Oub=v)MVO
zIj=QckBJ>;me_52cGmUX*zM}>y^SGw&Vhx68u&KFg`=RS{g*-V$qx0OQStli3L#YR
zz|Qy!laSpFD?yrokr){=y7i+0@)WD8FdM6OzMgjbn`;o5Tv6(A(3b^5uh3Vo&NfFs
zm~4$0DVyzBT=ZIVi^#~BP7sbeaiZ|bl{-Ql(uX&TEx#;U4Y|D46A@u&SNCFRujq3=
z&HsC_yL)r0eJ(gyA=}5oV*l{qdS0Fo7}{3mt6o>_MbvOhc;22}S{j5;mR*l-NHo>d
zj6X?;Jp2PZCW)+oh@Dclug|A2-|D?X77v^8v)tUP_QmE(N*?N6gxRG<MdD?jhXKU8
zB6e3^VfmJp*8P$PA7B1;fW|~~l7g~f>St5XMRiF03Zq~jxm~T{z6UJ-f6j*S@rQwt
zq;!RVe)bOG;vYKCc3(4Nlky1)QyKSFGsZLV_|wB)dsO`~hI{2ikWt9VLtg&nUNAcW
zE5Rf=DtO+kPU$8<`8!)fmx9U9cHVr+q{JlB{rhW`6$i)A$7jOkDlh*Ehkj<HbXwSP
z<3-dZjxm*?3qofqoEIo&dkiR!E1Rpp{5UaX;=Hr$Ur<ootH}(+OZErpJ_=}se-OZ;
z;+M%Nej7l)&ct^ZcJ?LEv;AK0sG6V8@AzbU_fF?nt+<G=V{PJ@x{L}qZ)}Q3ro+Vz
z9v)(9p@0g&XN4pfOB)-G!19_acdIpS+%UX<KR2K$3XDX8&Y+*mdg!sc%D{WOIWggx
z=I!P2Cyz_kaP!@2C^KprTE!!C(RCrz6%Bs=!1rG61t}@>oT+M895RQSjKA5{nbz)Q
z-?np6`nyKExE2yZON|SlAl7tye}@%mLt9y8e94cV?f!Pr>;3obCI4DA=^|*Y{Pdbt
zAH(A9Cl9G^US8S7!>9rj!H;u^*(E|}kSixqIVABEWM0;O5Af?a|25>-%gg4yKa2@!
z2)p6>=x#idR`~8<%`Y}Hjo!XQ4hfRe>b7>hI*37>Uq?$nUrRupAT$p_anX-RlVf|f
zE^Zi|C=k}yAU9mbPtQ$%kSVeL6zL~x{(o<YxU#@oJIDfc2_pqkk~`@c8P)AwU}YgB
z&>RvAy`m(|@&-buvq)iKPawyCDUD66b2=fL8A>z{X;&c!8l?B4MvZ|msJY%uFD!f&
z8CeWD`nPU<fw<ewSCR*ix$viIq^GmOFTs2XgVl_rD5Uno*cijD9TR&n{i+k+AhOAP
zV?C_Op-+uTGyFGlA;U$r`SIh&5be;DEE=7fIu3M5Y^*%`^Ux5pw2zmrZUUsJtEqKD
zf59CV#pk}g$RJ)sj-*{TBFd>@r&C}#^dlREw5GdvN4rzR$Klxu&sEqNCENrhBtHBD
zm48%KSh!pbNe^%DzH?oHbc}ugWI=-^s|0<AcGMqyT|`je1ahCekZ^#5D2+)oQ<q9p
z0u)m4H~>&fL4A~xk^-Y_A4k+ySy>q*=)&w|3mLf&AL>GawohJZsSr2!JfQv{mNNeM
z^!3B)($c7&SxA&k;AU8*BS9ns77%CU`)}&GUXrc89`Q-K`ihK60`Q4<0FX0-u>mG-
zFNivxr)u8^J1_7;pFckWS2FBRO&JDTa2<n>SQHdnFcbD92#55{3UdHCBIz)N)^6;B
zk~1f~F7^tnB8{zjVGb|*ag3t!+=Hw4!KasWsiTjhs5i2GI&4z`#l^($C8v_XH5(a8
zY32!SqW)mq&?y#VF4<{ten#|Oib!({6-wp;Aek}|7(x_R{M;NYD`1^2!j2l5T^?$D
z@apYS<HST5>I&EV&-Ij8UTRX(B4QHGt@SyyjL=`3b<l0e=)vvc$GWx?!4~LsU^DY2
zAIJZfIwa~yUUL4DENTQ~$f38UtdjR(iS1?Xe`oYW6ypvMcB)(2F=e|}zXmQ96^r?&
zC(Eb*Vq$D-GPa5E81CmswMoHM+lB=ed1Oq$#eNsk_3q3xDY56h5;O`5XqtWgJT)%%
z8+)K&ss*shRMa>~1k+T1b{)+iJX1t+(%RzT!@sysjf{BjfA>s1P88mqQuA@~WqLBO
zjs*oX0(WV?*oJOued^#{TB57l`EG7&%bP0U&M(D<k<<V7E=e);Ux?>{Bv*xHLP|CP
zfqjr29ZfRxIy#()cP+!6Z1%GGIycsJ{_fp?4<F8N8N?yOL1aWM9bR6SeGj)D0}q|6
z-Fkroi#=6R(y_5IDI|nl-3Vt7G%<zeeE=DrpYMBCbX{Pg0{n*?Zam;1qh`Vur?D7K
zemq8cTJA||im>?&AD?>;4lXqueTw)2NImKIi4#;3lKN24o=|)$Uz*W!aO@cwNuZL2
z5SQthR|{R@87!!_kr9u^z>?_mBRt&Px%v4}`Nd6D1XHD<0xdL$l1|k%3Br7nD*b4*
z{M|)$C@X@OX!CN_6GiNV%c7s(Jx0Rm?inKN9DLF{VDHRjYx|lSpi8Sm+s~0dYX=pp
zIq^$ND_`7l%~uy*RpwJNOi+Df%wpqoAR>@j_G3il1C_8a9=^Z4xjv1wS-3o$CvX4M
z6ikkFUMSrCS?!z){?OX6urb_@uQ3|a-94yNbfovYAZvOoF)@HWN%f@?bJmC7+0oGu
z`TzYxJF}PJcy{VH36+21`SS8t>iYE7Nsb+t=`4?V{gadQw3ndU>cZ>S^N`b+oA(LQ
zXFj}{4F=VD_UP`K@%G}LkhpkV-Y*@4@wO7<XFbWGXNBZK+$%C}!=r)#V7)K~pkYGM
z3Raw7s(Q+n?w>k>k1jPlx>Xr$1Z|A?3-i3Tc7XPqPscIl-S-|qNel^-tFhRhDym~r
zQ#lb+@WKA)KrC;x53bgq(&6a$)(W<R@v?PsZf?VTKizT68;#hcglCjGFOS^g_+Chb
zL6>0k^A<?%CZt_gx?`8kU7x4t=H55JMN!@`z?G{1{>6Q)ipuH#8BsPnef*uL>9O{2
zpd+JMxqRNtcQ!UF;>v^O$op7Ygs<^SAIe1i?&z=U(%;gvKhmMqZs7so`FX3rMnR_Q
z5K1G;w-_;f4ls=`Uv`EH*6vpFJ9ow(v$XVbcK*`Yxh3)H({sjrsRL_Xn40_gs*PLo
zY?*ZSxpH&!U-FH7n%yWbCpI-Jq+=eaH$-DHlN3wdF*+}e`dVA7@$lFRI~o<KT_u2o
zMbw6XdOrjt2w(h-2kNli3*q7N)6*hbTh4Z0b1=Rqqh@A;U%W^F2>`{pD=jfj17Um5
zjglpFKU(MHt}QL$-j`HN**<$3404aAQd4F?hE!|x4;^J}J)5y^!pJZ?6NxMtLFBQK
zk-f8*J6#>iz`sC89Suq+5|Z$ViHg}sgF0-|$nXdEpEF&g9H~_3&hC`4@7Y+lD`^?z
z^BErwY{w4a-n%&8tp%){ajOa(0^Eehg9;fx%-L#1atjh~SXKUyh<98<<PU>8ZePCp
zl<fX4S}so%G&;5c*y_QXY)+12U}6`$!soufDIdqU+<gi)brR~oN$XVmV?RGPDc^}9
zgB3NURr4D0+Do3>&FSg+fGcruuwK6&_kB_2K1sgmw%B+_T<hpag3o$;Ae&;Cq{QIi
zw%%Zpon`H4p@+vUyE%@|Z<|%!<2OG1L=NT5q*)J|w-#`@kQ~^nX-r(+?6LnkmqpvK
zv<c)CTfe5N97V{P3oE@nfAGFx_VW>nEFpxExp#JS>Xl9~GSCX`(C)69Q4Jl!m{(N9
z+}3pAGf99X!eUiCM<ipUMf1*jM95#p(8dPBN||-Yv~_gi_~}CBsL!hbEN$=P#K+6a
z76_ol=*WmDWKihoDay$?xy0LAxGGZ)9!DYJAW}(d17N)pRJ;(|F*~aR?SNJls0D7^
zhzbgl2M)AAw+z%8&}o3c04QkCRzEN{_8g~%JC%(6>*HKiAk)GY4|m2n1K(Fwd2fDJ
zOo^eRrG-IK=sGtqFSRUyk@QSV_x1ETW;cRljZ&TPumIt;bw#qu{^cj<NLZTn=JZau
zpQ;1hw2saY3>Qg>i7q!l8XX@UEo?cE<GHg8JTE0YZS3FshanyP8*Mub@U#Kg%`vIg
z2>(Em+Da(yKn=r84|u%G4S2E!Kg|hu34FE}*g!GOU^iu<gc1fDKvwv+O%eN>Cdy#M
zk9K`OU$I2Mp}yYPkNDMNZ+h2F2a{RT2e&AZV)^Haen^@l0OpcB%z{_;NRc}s2vJ%w
zIJR&;e2lR>sh30FbRAz6iVqRwI+nHyx|_7|cS)QkE~n3StRU|ZI$3;jPIm)3(ra$|
z9O~l+aINg^kC2H0L1zJKGCeCk$`3Lcp+$@#)Pg9QSU8*neVJaJeZik4v~p9tZWn4}
zQ?#3_uCeD`7Ea>zxnh%e?e^_EieF$|1b*$|Lury@-i<Mf-)jdutf(-7>B+o2E+CX}
zawu3HKq35*lL%31gjEBn2b9^w5qgQ;Ef-#khvW|)cL$JM*C|vZJFy?gO@UV0{Xyu-
z$k^pS&xvpm^F1a$CRayQ;o0SUEd<-(1=5pv%Jrqn12>7dg(2MJOhsSggZtpsv{_n#
zSZP)C-tJ@(8qkqcVRC>cs?EBjn-94Esx>k$i)?kga3Nu1qX%+bb8|J-ZTi68l^_<u
z^aTjf&e`i1FK>%InrKAoZXl7z;EM8<p?VOPFmi8Zp=RYdwe0Uh^QULc*DCAYws-J;
ztMyDtJY#Ur5!m;@NMZAd_z-1fe{q*{{9NxFC6Yz#;K?#$ar{~C?&_PHUsu;nql@gO
zhD$!0cQ=zWq&E#5Cs(iY#VOyqH3K}Uq@>72kxH^T)nf=lS}`i;fYjo@MR=*-P=5Tq
zo60i_8$CD;wASt0Cypn$PAYVb<CaZqYzCCC!BCT>`o?#E{`AbxSl(M5alYX6pggy@
zx2UVH-W3o|$E));(Z))ghuwrpd$uuXAuCH{b4&X9li`CO4gKP-Oxqjbgh)aL{N*HQ
zn4ojFwUgcl7B7zf+k+Z$gbz>%TgRf^%gf_+%+%D{nwpw=dSkxduDF*z-Q(f=pn`sA
zYpYvkRs*%2<YY1rPhMmpZuO_|nu}7~2LLdIfqp&vv3Zd$G>?sS8w=xWu~9%*7dac7
zFbFOnwLv^VEI8N~#CX-7J2G%dS>!|j6^X0mM<Uh3DE+uTxsR0E0LpH)aBQ|)pE}NN
z%%#5Z!FM3Q`S@mz5j9iG&h+4B3~<#-=n?E;Yj3ZUtkS<|!Z0rP5yVqSSom#0L7{%l
zpmGXi;(%x=Bq&JIeLWNBA!O8eV#aE)0D9Ux!-ebXpB5L@mzP%{EPSmc+~W~&sQLih
z3!4W&QN4JHq~#;Oc}0J}4m7Cc#qpJ%uC`_~9+xip$UgRkGVgiN!m4#i+r0n0L1H$D
z+)5tE7XS}nYAV00jz%O|i_Cwkd?$aEo*Z#56qH`T1sT*yy)C~O#0|z{QO|9;vuC3r
z7-ZaQ;~K!&9RhTK8<^a<Q4fa;4NhOL{ao9NGH4K?Z=38+3DM9{wfi>OF_XV9{FR)E
zSO$XZ)cfJ-D$xeVdQzo<rab@>aDVkcb6xSy;15L#KT?{hi@Q7H%mAG`Qp2;9bS7ju
zIrDRJR-BzKx=Wa51B)ld!h$VWoJqTy7aV-;ID|0$mo5@;ryhlI)Np1&!B<m8(C@(W
zzff~zNWGs{BoY&+1G(+4zjxi+7n0onNgydA<{^!N=U+TrpK^uayWC^TIvbww^RJ4@
zl<$PVKh)odOjwch)Ibx34;GBPN<72Izqyn8^VgZp29kWp58~rfupKFlpcJwiJb)$z
zLKrx+pTAwou^Kvpw6mP|Hs(VkVw%V@JmJX-(AP9W8WSQeNpI&QDl_+nkIzWiN#XfL
zF!6LJPQzIIDFz)>*!nyc6h>1suc%MxlVp}5rSSM41$HWBTLj^vm#0Vd^=dAdb-^5U
z_Ob~PQ72^_%+Dn`bC$5^D2KN7_h<Qvp;;D23;a%pFl90$nm5A)2{tEMUf2%87Yb~<
zc4=U%cIcBkH?<y#vp#qcrZSX&6_r-B`E$t!g?Ol(BG43oP*U?6Qsf?c$D0OF+8}eT
zVSnex;Wd4*XxEE6NE{0`vV?!SU0Ofm$A10padL9g5>EI9i|aq4<`De)p3GLHZ5U-=
zV}`f~ntCDitn#o2mI!+w$p1j<fa5ztY53p0*q@O=iV4k=2$68u+V9x=6lSEDRND~V
y_+Q$Um?@cy@H0YZ_+Pv`{Pa&8$p6((vpAH#doDxpwVPV_oh!?0$Q8;OKK>73){^u9

literal 0
HcmV?d00001

diff --git a/doc/devel/uml/index.html b/doc/devel/uml/index.html
index 55bbadb38..5257dd3f7 100644
--- a/doc/devel/uml/index.html
+++ b/doc/devel/uml/index.html
@@ -17,6 +17,12 @@ Documentation</title>
 <!-- ============================================================= -->
 
 <a name="refpackage129"></a>
+<p>Properties:<ul>
+<li>:<br /><div class="sub"></div></p></li>
+<li>CopyrightClaim:<br /><div class="sub"><br />  Copyright (C)         Lumiera.org<br />    2008,               Christian Thaeter &lt;ct@pipapo.org&gt;<br /><br /></div></p></li>
+<li>GPLHeader:<br /><div class="sub">  This program is free software; you can redistribute it and/or<br />  modify it under the terms of the GNU General Public License as<br />  published by the Free Software Foundation; either version 2 of the<br />  License, or (at your option) any later version.<br /><br />  This program is distributed in the hope that it will be useful,<br />  but WITHOUT ANY WARRANTY; without even the implied warranty of<br />  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the<br />  GNU General Public License for more details.<br /><br />  You should have received a copy of the GNU General Public License<br />  along with this program; if not, write to the Free Software<br />  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.<br /></div></p></li>
+<li>html dir:<br /><div class="sub">/mnt/Lager/heim/devel/lumi/doc/devel/uml/</div></p></li>
+</ul></p>
 <a name="refpackage128005"></a>
 <h1 class ="package">1 Package design</h1>
 <p>All things concering the big picture.<br />Not a real code package, rather a container for design drafts, specifications, decisions.<br /></p><div class="sub">
@@ -32,26 +38,32 @@ Documentation</title>
 <p>provided classes : <a href="class135557.html#refclass135557"><b>Error</b></a>, <a href="class134917.html#refclass134917"><b>Time</b></a></p>
 <a name="refcomponent128005"></a>
 <table><tr><td><div class="element">Component <b>Builder</b></div></td></tr></table>
+<p>Stereotype: subsystem</p>
 <p>provided classes : <a href="class132741.html#refclass132741"><b>State</b></a></p>
 <p>required classes : <a href="class128261.html#refclass128261"><b>Fixture</b></a>, <a href="class128005.html#refclass128005"><b>SessionImpl</b></a></p>
 <a name="refcomponent128133"></a>
 <table><tr><td><div class="element">Component <b>Session</b></div></td></tr></table>
+<p>Stereotype: subsystem</p>
 <p>provided classes : <a href="class128133.html#refclass128133"><b>Seq</b></a>, <a href="class128261.html#refclass128261"><b>Fixture</b></a>, <a href="class128517.html#refclass128517"><b>MObject</b></a>, <a href="class134661.html#refclass134661"><b>ParamProvider</b></a>, <a href="class128005.html#refclass128005"><b>SessionImpl</b></a></p>
 <div class="sub">
 <a name="refcomponent128389"></a>
 <table><tr><td><div class="element">Component <b>EDL</b></div></td></tr></table>
+<p>Stereotype: entity</p>
 <p>nested in <a href="index.html#refcomponent128133"><b>Session</b></a></p>
 <a name="refcomponent128517"></a>
 <table><tr><td><div class="element">Component <b>Fixture</b></div></td></tr></table>
+<p>Stereotype: entity</p>
 <p>nested in <a href="index.html#refcomponent128133"><b>Session</b></a></p>
 </div>
 <a name="refcomponent128261"></a>
 <table><tr><td><div class="element">Component <b>Controller</b></div></td></tr></table>
-<p>Depends on <a href="index.html#refcomponent128005"><b>Builder</b></a></p><p>provided classes : <a href="class130565.html#refclass130565"><b>BuilderFacade</b></a></p>
+<p>Depends on <a href="index.html#refcomponent128005"><b>Builder</b></a></p><p>Stereotype: subsystem</p>
+<p>provided classes : <a href="class130565.html#refclass130565"><b>BuilderFacade</b></a></p>
 <div class="sub">
 </div>
 <a name="refcomponent128645"></a>
 <table><tr><td><div class="element">Component <b>AssetManagement</b></div></td></tr></table>
+<p>Stereotype: subsystem</p>
 <a name="refcomponent128773"></a>
 <table><tr><td><div class="element">Component <b>Dispatcher</b></div></td></tr></table>
 <p>provided classes : <a href="class141957.html#refclass141957"><b>ProcDispatcher</b></a></p>
@@ -61,6 +73,7 @@ Documentation</title>
 <div class="sub">
 <a name="refcomponent130053"></a>
 <table><tr><td><div class="element">Component <b>ProcNode</b></div></td></tr></table>
+<p>Stereotype: entity</p>
 <p>nested in <a href="index.html#refcomponent128901"><b>Engine</b></a></p>
 <p>provided classes : <a href="class134533.html#refclass134533"><b>Parameter</b></a></p>
 <p>required classes : <a href="class134661.html#refclass134661"><b>ParamProvider</b></a></p>
@@ -76,9 +89,11 @@ Documentation</title>
 <p>provided classes : <a href="class130437.html#refclass130437"><b>PathManager</b></a></p>
 <a name="refcomponent130181"></a>
 <table><tr><td><div class="element">Component <b>MediaFactory</b></div></td></tr></table>
+<p>Stereotype: component</p>
 <p>required classes : <a href="class139525.html#refclass139525"><b>MediaAccessFacade</b></a></p>
 <a name="refcomponent130309"></a>
 <table><tr><td><div class="element">Component <b>AssetDB</b></div></td></tr></table>
+<p>Stereotype: service</p>
 <a name="refcomponent131077"></a>
 <table><tr><td><div class="element">Component <b>client code</b></div></td></tr></table>
 <p>required classes : <a href="class141957.html#refclass141957"><b>ProcDispatcher</b></a></p>
@@ -108,12 +123,14 @@ Documentation</title>
 <p>required classes : <a href="class130565.html#refclass130565"><b>BuilderFacade</b></a>, <a href="class130437.html#refclass130437"><b>PathManager</b></a></p>
 <a name="refcomponent129797"></a>
 <table><tr><td><div class="element">Component <b>ConManager</b></div></td></tr></table>
+<p>Stereotype: component</p>
 <p>required classes : <a href="class134661.html#refclass134661"><b>ParamProvider</b></a></p>
 <a name="refcomponent diagram130693"></a>
 <p align="center"><img src="fig130693.png" alt="" /></p>
  <p align="center"><b>backend-components</b></p><p><br /></p><p><br /></p>
 <a name="refcomponent130437"></a>
 <table><tr><td><div class="element">Component <b>Media Access</b></div></td></tr></table>
+<p>Stereotype: service</p>
 <p>provided classes : <a href="class139525.html#refclass139525"><b>MediaAccessFacade</b></a></p>
 </div>
 <a name="refpackage128645"></a>
@@ -128,18 +145,21 @@ Documentation</title>
  <p align="center"><b>Source Overview</b></p><p><br /></p><p><br /></p>
 <a name="refartifact128005"></a>
 <table><tr><td><div class="element">Artifact <b>Lumiera</b></div></td></tr></table>
-<p>Depends on <a href="index.html#refpackage129413"><b>common</b></a></p><p>Depends on <a href="index.html#refpackage129797"><b>gui</b></a></p><p>Depends on <a href="index.html#refpackage129669"><b>proc</b></a></p><p>Depends on <a href="index.html#refpackage129541"><b>backend</b></a></p><p>the main executable to be built<br /></p>
-<p><i>executable</i> associated with : <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, <a href="index.html#refartifact132101"><b>processor</b></a>, <a href="index.html#refartifact133125"><b>pluginadapter</b></a>, <a href="index.html#refartifact129541"><b>effect</b></a>, <a href="index.html#refartifact131205"><b>buildertool</b></a>, <a href="index.html#refartifact131333"><b>segmentationtool</b></a>, <a href="index.html#refartifact133893"><b>aframe</b></a>, <a href="index.html#refartifact130821"><b>assembler</b></a>, <a href="index.html#refartifact132485"><b>trafo</b></a>, <a href="index.html#refartifact129157"><b>explicitplacement</b></a>, <a href="index.html#refartifact130309"><b>auto</b></a>, <a href="index.html#refartifact133637"><b>glrender</b></a>, <a href="index.html#refartifact132613"><b>link</b></a>, <a href="index.html#refartifact134405"><b>parameter</b></a>, <a href="index.html#refartifact131973"><b>renderengine</b></a>, <a href="index.html#refartifact130053"><b>allocation</b></a>, <a href="index.html#refartifact134021"><b>vframe</b></a>, <a href="index.html#refartifact130565"><b>toolfactory</b></a>, <a href="index.html#refartifact133381"><b>arender</b></a>, <a href="index.html#refartifact131845"><b>renderstate</b></a>, <a href="index.html#refartifact130181"><b>label</b></a>, <a href="index.html#refartifact134149"><b>glbuf</b></a>, <a href="index.html#refartifact132357"><b>procnode</b></a>, <a href="index.html#refartifact130949"><b>stateproxy</b></a>, <a href="index.html#refartifact132741"><b>hub</b></a>, <a href="index.html#refartifact131077"><b>buildable</b></a>, <a href="index.html#refartifact129285"><b>abstractmo</b></a>, <a href="index.html#refartifact131461"><b>nodecreatertool</b></a>, <a href="index.html#refartifact132869"><b>projector</b></a>, <a href="index.html#refartifact134661"><b>interpolator</b></a>, <a href="index.html#refartifact128645"><b>edl</b></a>, <a href="index.html#refartifact128773"><b>fixture</b></a>, <a href="index.html#refartifact133253"><b>glpipe</b></a>, <a href="index.html#refartifact133509"><b>vrender</b></a>, <a href="index.html#refartifact132229"><b>exitnode</b></a>, <a href="index.html#refartifact131717"><b>pathmanager</b></a>, <a href="index.html#refartifact128901"><b>track</b></a>, <a href="index.html#refartifact134533"><b>paramprovider</b></a>, <a href="index.html#refartifact132997"><b>mask</b></a>, <a href="index.html#refartifact128133"><b>main</b></a>, <a href="index.html#refartifact130693"><b>conmanager</b></a>, <a href="index.html#refartifact129413"><b>clip</b></a>, <a href="index.html#refartifact129669"><b>meta</b></a>, <a href="index.html#refartifact129797"><b>fixedlocation</b></a>, <a href="index.html#refartifact129925"><b>relativelocation</b></a>, <a href="index.html#refartifact128261"><b>mobject</b></a>, <a href="index.html#refartifact134277"><b>source</b></a>, <a href="index.html#refartifact133765"><b>frame</b></a>, <a href="index.html#refartifact129029"><b>placement</b></a>, <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, <a href="index.html#refartifact130437"><b>builderfacade</b></a></p>
+<p>the main executable to be built<br /></p>
+<p>Depends on <a href="index.html#refpackage129413"><b>common</b></a></p><p>Depends on <a href="index.html#refpackage129797"><b>gui</b></a></p><p>Depends on <a href="index.html#refpackage129669"><b>proc</b></a></p><p>Depends on <a href="index.html#refpackage129541"><b>backend</b></a></p><p>Stereotype: executable</p>
+<p><i>executable</i> associated with : <a href="index.html#refartifact132229"><b>exitnode</b></a>, <a href="index.html#refartifact131717"><b>pathmanager</b></a>, <a href="index.html#refartifact128901"><b>track</b></a>, <a href="index.html#refartifact129669"><b>meta</b></a>, <a href="index.html#refartifact129797"><b>fixedlocation</b></a>, <a href="index.html#refartifact129925"><b>relativelocation</b></a>, <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, <a href="index.html#refartifact132101"><b>rendergraph</b></a>, <a href="index.html#refartifact133125"><b>pluginadapter</b></a>, <a href="index.html#refartifact129157"><b>explicitplacement</b></a>, <a href="index.html#refartifact130309"><b>auto</b></a>, <a href="index.html#refartifact133637"><b>glrender</b></a>, <a href="index.html#refartifact133381"><b>arender</b></a>, <a href="index.html#refartifact131845"><b>renderstate</b></a>, <a href="index.html#refartifact130181"><b>label</b></a>, <a href="index.html#refartifact131461"><b>nodecreatertool</b></a>, <a href="index.html#refartifact132869"><b>projector</b></a>, <a href="index.html#refartifact134661"><b>interpolator</b></a>, <a href="index.html#refartifact134533"><b>paramprovider</b></a>, <a href="index.html#refartifact132997"><b>mask</b></a>, <a href="index.html#refartifact128261"><b>mobject</b></a>, <a href="index.html#refartifact134277"><b>source</b></a>, <a href="index.html#refartifact133765"><b>frame</b></a>, <a href="index.html#refartifact129541"><b>effect</b></a>, <a href="index.html#refartifact131205"><b>buildertool</b></a>, <a href="index.html#refartifact131333"><b>segmentationtool</b></a>, <a href="index.html#refartifact132613"><b>link</b></a>, <a href="index.html#refartifact134405"><b>parameter</b></a>, <a href="index.html#refartifact131973"><b>renderengine</b></a>, <a href="index.html#refartifact134149"><b>glbuf</b></a>, <a href="index.html#refartifact132357"><b>procnode</b></a>, <a href="index.html#refartifact130949"><b>stateproxy</b></a>, <a href="index.html#refartifact128645"><b>edl</b></a>, <a href="index.html#refartifact128773"><b>fixture</b></a>, <a href="index.html#refartifact133253"><b>glpipe</b></a>, <a href="index.html#refartifact128133"><b>main</b></a>, <a href="index.html#refartifact130693"><b>conmanager</b></a>, <a href="index.html#refartifact129413"><b>clip</b></a>, <a href="index.html#refartifact133509"><b>vrender</b></a>, <a href="index.html#refartifact129029"><b>placement</b></a>, <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, <a href="index.html#refartifact130437"><b>builderfacade</b></a>, <a href="index.html#refartifact133893"><b>aframe</b></a>, <a href="index.html#refartifact130821"><b>assembler</b></a>, <a href="index.html#refartifact132485"><b>trafo</b></a>, <a href="index.html#refartifact130053"><b>allocation</b></a>, <a href="index.html#refartifact134021"><b>vframe</b></a>, <a href="index.html#refartifact130565"><b>toolfactory</b></a>, <a href="index.html#refartifact132741"><b>hub</b></a>, <a href="index.html#refartifact131077"><b>buildable</b></a>, <a href="index.html#refartifact129285"><b>abstractmo</b></a></p>
 <a name="refartifact128133"></a>
 <table><tr><td><div class="element">Artifact <b>main</b></div></td></tr></table>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i></p>
 </div>
 <a name="refpackage129413"></a>
 <h3 class ="package">1.4.2 Package common</h3>
-<p></p><ul>
+<p>sourcecode package<br /><br />Common library and helper classes<br /></p><p></p><ul>
 <li>C++ namespace : lumiera</li>
 </ul>
-<p>sourcecode package<br /><br />Common library and helper classes<br /></p><p>Diagram : <a href="index.html#refdeployment diagram129797"><b>Source Overview</b></a></p>
+<p>Diagram : <a href="index.html#refdeployment diagram129797"><b>Source Overview</b></a></p>
+<p>Stereotype: src</p>
 <div class="sub">
 <a name="refdeployment view128261"></a>
 <h4 class ="view">1.4.2.1 Deployment View gen</h4>
@@ -148,55 +168,63 @@ Documentation</title>
 <a name="refartifact139141"></a>
 <table><tr><td><div class="element">Artifact <b>visitor</b></div></td></tr></table>
 <p>Acyclic Visitor library<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class140165.html#refclass140165"><b>Visitable</b></a>, <a href="class140037.html#refclass140037"><b>Tool</b></a>, <a href="class140293.html#refclass140293"><b>Applicable</b></a></p>
 <a name="refartifact135813"></a>
 <table><tr><td><div class="element">Artifact <b>error</b></div></td></tr></table>
 <p>Lumiera Exception Interface<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class135557.html#refclass135557"><b>Error</b></a>, <a href="class135685.html#refclass135685"><b>Logic</b></a>, <a href="class135813.html#refclass135813"><b>Config</b></a>, <a href="class135941.html#refclass135941"><b>State</b></a>, <a href="class136069.html#refclass136069"><b>Invalid</b></a>, <a href="class136197.html#refclass136197"><b>External</b></a></p>
 <a name="refartifact135173"></a>
 <table><tr><td><div class="element">Artifact <b>appconfig</b></div></td></tr></table>
 <p>for global initialization and configuration <br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class135429.html#refclass135429"><b>Appconfig</b></a></p>
 <a name="refartifact134789"></a>
 <table><tr><td><div class="element">Artifact <b>time</b></div></td></tr></table>
 <p>unified representation of a time point, including conversion functions<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134917.html#refclass134917"><b>Time</b></a></p>
 <a name="refartifact139653"></a>
 <table><tr><td><div class="element">Artifact <b>streamtype</b></div></td></tr></table>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class144773.html#refclass144773"><b>StreamType</b></a>, <a href="class144901.html#refclass144901"><b>Prototype</b></a>, <a href="class145029.html#refclass145029"><b>ImplFacade</b></a></p>
 </div>
 <a name="refpackage130821"></a>
 <h4 class ="package">1.4.2.2 Package error</h4>
-<p></p><ul>
+<p>Namespace for Exception Kinds<br /></p><p></p><ul>
 <li>C++ namespace : lumiera::error</li>
 </ul>
-<p>Namespace for Exception Kinds<br /></p><a name="refpackage130949"></a>
+<a name="refpackage130949"></a>
 <h4 class ="package">1.4.2.3 Package visitor</h4>
-<p></p><ul>
+<p>sub-namespace for visitor library implementation<br /></p><p></p><ul>
 <li>C++ namespace : lumiera::visitor</li>
 </ul>
-<p>sub-namespace for visitor library implementation<br /></p></div>
+</div>
 <a name="refpackage129541"></a>
 <h3 class ="package">1.4.3 Package backend</h3>
-<p></p><ul>
+<p>sourcecode package<br /><br />Data backend classes here...<br /></p><p></p><ul>
 <li>C++ namespace : backend_interface</li>
 </ul>
-<p>sourcecode package<br /><br />Data backend classes here...<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view128389"></a>
 <h4 class ="view">1.4.3.1 Deployment View gen</h4>
 <div class="sub">
 <a name="refartifact138629"></a>
 <table><tr><td><div class="element">Artifact <b>mediaaccessfacade</b></div></td></tr></table>
 <p>functions for querying media file and channels.<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class139525.html#refclass139525"><b>MediaAccessFacade</b></a></p>
 </div>
 </div>
 <a name="refpackage129669"></a>
 <h3 class ="package">1.4.4 Package proc</h3>
-<p></p><ul>
+<p>sourcecode package<br /><br />All classes belonging to the (middle) processing layer<br /></p><p></p><ul>
 <li>C++ namespace : proc_interface</li>
 </ul>
-<p>sourcecode package<br /><br />All classes belonging to the (middle) processing layer<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view128517"></a>
 <h4 class ="view">1.4.4.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -204,30 +232,36 @@ Documentation</title>
 <a name="refartifact136197"></a>
 <table><tr><td><div class="element">Artifact <b>assetmanager</b></div></td></tr></table>
 <p>Facade for the Asset subsystem<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class136581.html#refclass136581"><b>AssetManager</b></a></p>
 <a name="refartifact136069"></a>
 <table><tr><td><div class="element">Artifact <b>asset</b></div></td></tr></table>
 <p>Superinterface: bookeeping view of "things" present in the session<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class136453.html#refclass136453"><b>Asset</b></a></p>
 <a name="refartifact130949"></a>
 <table><tr><td><div class="element">Artifact <b>stateproxy</b></div></td></tr></table>
 <p>Key Interface representing a render process and encapsulating state<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class132741.html#refclass132741"><b>State</b></a></p>
 <a name="refartifact131589"></a>
 <table><tr><td><div class="element">Artifact <b>controllerfacade</b></div></td></tr></table>
 <p>Facade and service access point for the Proc Layer Controller<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130309.html#refclass130309"><b>ControllerFacade</b></a></p>
 <a name="refartifact133765"></a>
 <table><tr><td><div class="element">Artifact <b>frame</b></div></td></tr></table>
 <p>Key Abstraction: render process and buffer holding frame data.<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class133253.html#refclass133253"><b>Frame</b></a></p>
 </div>
 <a name="refpackage130053"></a>
 <h4 class ="package">1.4.4.2 Package asset</h4>
-<p></p><ul>
+<p>sourcecode package<br /><br />Asset Management<br /></p><p></p><ul>
 <li>C++ namespace : asset</li>
 </ul>
-<p>sourcecode package<br /><br />Asset Management<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view128645"></a>
 <h4 class ="view">1.4.4.2.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -235,79 +269,97 @@ Documentation</title>
 <a name="refartifact137733"></a>
 <table><tr><td><div class="element">Artifact <b>dataset</b></div></td></tr></table>
 <p>meta asset describing a collection of control data<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138245.html#refclass138245"><b>Dataset</b></a></p>
 <a name="refartifact135941"></a>
 <table><tr><td><div class="element">Artifact <b>category</b></div></td></tr></table>
 <p>tree like classification of Assets<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137221.html#refclass137221"><b>Category</b></a></p>
 <a name="refartifact136453"></a>
 <table><tr><td><div class="element">Artifact <b>media</b></div></td></tr></table>
 <p>key abstraction: media-like assets<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class136709.html#refclass136709"><b>Media</b></a>, <a href="class139397.html#refclass139397"><b>MediaFactory</b></a></p>
 <a name="refartifact136581"></a>
 <table><tr><td><div class="element">Artifact <b>proc</b></div></td></tr></table>
 <p>key abstraction: media-like assets<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class136837.html#refclass136837"><b>Proc</b></a></p>
 <a name="refartifact136709"></a>
 <table><tr><td><div class="element">Artifact <b>struct</b></div></td></tr></table>
 <p>key abstraction: structural asset<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class136965.html#refclass136965"><b>Struct</b></a></p>
 <a name="refartifact136837"></a>
 <table><tr><td><div class="element">Artifact <b>meta</b></div></td></tr></table>
 <p>key abstraction: metadata and organisational asset<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137093.html#refclass137093"><b>Meta</b></a></p>
 <a name="refartifact136325"></a>
 <table><tr><td><div class="element">Artifact <b>clip</b></div></td></tr></table>
 <p>bookkeeping (asset) view of a media clip.<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137349.html#refclass137349"><b>Clip</b></a></p>
 <a name="refartifact138245"></a>
 <table><tr><td><div class="element">Artifact <b>compoundmedia</b></div></td></tr></table>
 <p>a special clip as a compound of several elementary media tracks,<br />e.g. the individual media streams found in one media file<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138501.html#refclass138501"><b>CompoundMedia</b></a></p>
 <a name="refartifact136965"></a>
 <table><tr><td><div class="element">Artifact <b>preview</b></div></td></tr></table>
 <p>alternative version of the media data, probably with lower resolution<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137605.html#refclass137605"><b>Preview</b></a></p>
 <a name="refartifact137093"></a>
 <table><tr><td><div class="element">Artifact <b>unknown</b></div></td></tr></table>
 <p>placeholder for unknown or unavailable media source<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137477.html#refclass137477"><b>Unknown</b></a></p>
 <a name="refartifact137221"></a>
 <table><tr><td><div class="element">Artifact <b>effect</b></div></td></tr></table>
 <p>Effect or media processing component<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137733.html#refclass137733"><b>Effect</b></a></p>
 <a name="refartifact137349"></a>
 <table><tr><td><div class="element">Artifact <b>codec</b></div></td></tr></table>
 <p>description of some media data decoder or encoder facility<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137861.html#refclass137861"><b>Codec</b></a></p>
 <a name="refartifact137605"></a>
 <table><tr><td><div class="element">Artifact <b>pipe</b></div></td></tr></table>
 <p>structural asset corresponding to some port generating media output<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138117.html#refclass138117"><b>Pipe</b></a></p>
 <a name="refartifact137477"></a>
 <table><tr><td><div class="element">Artifact <b>track</b></div></td></tr></table>
 <p>structural asset holding the configuration of a track in the EDL<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class137989.html#refclass137989"><b>Track</b></a></p>
 <a name="refartifact137989"></a>
 <table><tr><td><div class="element">Artifact <b>procpatt</b></div></td></tr></table>
 <p>template for building some render processing network<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138757.html#refclass138757"><b>ProcPatt</b></a></p>
 <a name="refartifact138117"></a>
 <table><tr><td><div class="element">Artifact <b>buildinstruct</b></div></td></tr></table>
 <p>Instructions for building some configuration of render nodes.<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class139013.html#refclass139013"><b>BuildInstruct</b></a>, <a href="class139269.html#refclass139269"><b>DoRecurse</b></a>, <a href="class139141.html#refclass139141"><b>DoAttach</b></a></p>
 <a name="refartifact137861"></a>
 <table><tr><td><div class="element">Artifact <b>db</b></div></td></tr></table>
 <p>registry holding known Asset instances.<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138373.html#refclass138373"><b>DB</b></a></p>
 </div>
 </div>
 <a name="refpackage130693"></a>
 <h4 class ="package">1.4.4.3 Package control</h4>
-<p></p><ul>
+<p>sourcecode package<br /><br />The Processing and Render Controller,<br />and the Proc-Layer dispatcher<br /></p><p></p><ul>
 <li>C++ namespace : control</li>
 </ul>
-<p>sourcecode package<br /><br />The Processing and Render Controller,<br />and the Proc-Layer dispatcher<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view129157"></a>
 <h4 class ="view">1.4.4.3.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -315,22 +367,26 @@ Documentation</title>
 <a name="refartifact131717"></a>
 <table><tr><td><div class="element">Artifact <b>pathmanager</b></div></td></tr></table>
 <p>Manager for deciding the actual render strategy<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130437.html#refclass130437"><b>PathManager</b></a></p>
 <a name="refartifact131845"></a>
 <table><tr><td><div class="element">Artifact <b>renderstate</b></div></td></tr></table>
 <p>renderengine state manager<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130949.html#refclass130949"><b>RenderState</b></a></p>
 <a name="refartifact139781"></a>
 <table><tr><td><div class="element">Artifact <b>stypemanager</b></div></td></tr></table>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class145413.html#refclass145413"><b>STypeManager</b></a></p>
 </div>
 </div>
 <a name="refpackage130181"></a>
 <h4 class ="package">1.4.4.4 Package mobject</h4>
-<p></p><ul>
+<p>sourcecode package<br /><br />MObject Subsystem<br />including the Session (EDL), Builder and Processing Controller<br /></p><p></p><ul>
 <li>C++ namespace : mobject</li>
 </ul>
-<p>sourcecode package<br /><br />MObject Subsystem<br />including the Session (EDL), Builder and Processing Controller<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view128773"></a>
 <h4 class ="view">1.4.4.4.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -338,46 +394,56 @@ Documentation</title>
 <a name="refartifact138757"></a>
 <table><tr><td><div class="element">Artifact <b>session</b></div></td></tr></table>
 <p>Interface: the session edited by the user<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class139653.html#refclass139653"><b>Session</b></a></p>
 <a name="refartifact128261"></a>
 <table><tr><td><div class="element">Artifact <b>mobject</b></div></td></tr></table>
 <p>Key Abstraction: A Media Object in the Session<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128517.html#refclass128517"><b>MObject</b></a></p>
 <a name="refartifact129029"></a>
 <table><tr><td><div class="element">Artifact <b>placement</b></div></td></tr></table>
 <p>Key Abstraction: a way to place and locate a Media Object<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128645.html#refclass128645"><b>Placement</b></a></p>
 <a name="refartifact129157"></a>
 <table><tr><td><div class="element">Artifact <b>explicitplacement</b></div></td></tr></table>
 <p>special Placement yielding an absolute location (Time,Track)-location for a MObject<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129797.html#refclass129797"><b>ExplicitPlacement</b></a></p>
 <a name="refartifact130437"></a>
 <table><tr><td><div class="element">Artifact <b>builderfacade</b></div></td></tr></table>
 <p>Facade and service access point for the Builder Subsystem<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130565.html#refclass130565"><b>BuilderFacade</b></a></p>
 <a name="refartifact131077"></a>
 <table><tr><td><div class="element">Artifact <b>buildable</b></div></td></tr></table>
 <p>marker interface denoting any MObject able to be treated by Tools<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134021.html#refclass134021"><b>Buildable</b></a></p>
 <a name="refartifact134405"></a>
 <table><tr><td><div class="element">Artifact <b>parameter</b></div></td></tr></table>
 <p>representation of an automatable effect/plugin parameter<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134533.html#refclass134533"><b>Parameter</b></a></p>
 <a name="refartifact134533"></a>
 <table><tr><td><div class="element">Artifact <b>paramprovider</b></div></td></tr></table>
 <p>interface denoting a source for actual Parameter values<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134661.html#refclass134661"><b>ParamProvider</b></a></p>
 <a name="refartifact134661"></a>
 <table><tr><td><div class="element">Artifact <b>interpolator</b></div></td></tr></table>
 <p>denotes a facility to get (continuously interpolated) parameter values<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134789.html#refclass134789"><b>Interpolator</b></a></p>
 </div>
 <a name="refpackage130437"></a>
 <h4 class ="package">1.4.4.4.2 Package session</h4>
-<p></p><ul>
+<p>sourcecode package<br /><br />Everything concerning the EDL and Session, within the MObject Subsystem<br /></p><p></p><ul>
 <li>C++ namespace : mobject::session</li>
 </ul>
-<p>sourcecode package<br /><br />Everything concerning the EDL and Session, within the MObject Subsystem<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view128901"></a>
 <h4 class ="view">1.4.4.4.2.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -385,93 +451,115 @@ Documentation</title>
 <a name="refartifact128517"></a>
 <table><tr><td><div class="element">Artifact <b>sessionimpl</b></div></td></tr></table>
 <p>holds the complete session data to be edited by the user<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128005.html#refclass128005"><b>SessionImpl</b></a></p>
 <a name="refartifact138885"></a>
 <table><tr><td><div class="element">Artifact <b>sessmanager</b></div></td></tr></table>
 <p>global session access and lifecycle<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class139781.html#refclass139781"><b>SessManager</b></a></p>
 <a name="refartifact128645"></a>
 <table><tr><td><div class="element">Artifact <b>edl</b></div></td></tr></table>
 <p>the (high level) Edit Decision List within the current Session<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128133.html#refclass128133"><b>Seq</b></a></p>
 <a name="refartifact128773"></a>
 <table><tr><td><div class="element">Artifact <b>fixture</b></div></td></tr></table>
 <p>the (low level) representation of the EDL with concrete placement data<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128261.html#refclass128261"><b>Fixture</b></a></p>
 <a name="refartifact135045"></a>
 <table><tr><td><div class="element">Artifact <b>segment</b></div></td></tr></table>
 <p>Segment of the Timeline.<br />Used at the moment (7/07) for partitioning the timeline/fixture into segments<br />to be rendered by a specialized render node network for each, without the need<br />to change any connections within a given segment. <br />Note this concept may be superfluos alltogether; is a draft and the real<br />use still needs to be worked out...<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class135173.html#refclass135173"><b>Segment</b></a></p>
 <a name="refartifact128901"></a>
 <table><tr><td><div class="element">Artifact <b>track</b></div></td></tr></table>
 <p>A grouping device within the EDL. The corresponding Placement<br />by which this Track object is refered defines fallback placing<br />properties to be used by all objects placed on this track in<br />case they don't specify more concrete placements.<br />Typically, tracks are used do make default Port connections,<br />define a layer or pan for sound and for for disabling groups<br />of clips. Note tracks are grouped in a tree like fashion.<br /><br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128389.html#refclass128389"><b>Track</b></a></p>
 <a name="refartifact129285"></a>
 <table><tr><td><div class="element">Artifact <b>abstractmo</b></div></td></tr></table>
 <p>abstract base class for all Media Objects<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128773.html#refclass128773"><b>AbstractMO</b></a></p>
 <a name="refartifact129413"></a>
 <table><tr><td><div class="element">Artifact <b>clip</b></div></td></tr></table>
 <p>a Media Clip<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class128901.html#refclass128901"><b>Clip</b></a></p>
 <a name="refartifact138373"></a>
 <table><tr><td><div class="element">Artifact <b>simpleclip</b></div></td></tr></table>
 <p>Elementary clip (single media stream only)<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138885.html#refclass138885"><b>SimpleClip</b></a></p>
 <a name="refartifact138501"></a>
 <table><tr><td><div class="element">Artifact <b>compoundclip</b></div></td></tr></table>
 <p>compound of several clips (multichannel)<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class138629.html#refclass138629"><b>CompoundClip</b></a></p>
 <a name="refartifact129541"></a>
 <table><tr><td><div class="element">Artifact <b>effect</b></div></td></tr></table>
 <p>EDL representation of a pluggable and automatable effect.<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129029.html#refclass129029"><b>Effect</b></a></p>
 <a name="refartifact129669"></a>
 <table><tr><td><div class="element">Artifact <b>meta</b></div></td></tr></table>
 <p>abstract base class of all MObjects representing meta data or processing instructions<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129157.html#refclass129157"><b>Meta</b></a></p>
 <a name="refartifact139013"></a>
 <table><tr><td><div class="element">Artifact <b>locatingpin</b></div></td></tr></table>
 <p>Chaining and constraining the Placement of a Media Object<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class139909.html#refclass139909"><b>LocatingPin</b></a></p>
 <a name="refartifact129797"></a>
 <table><tr><td><div class="element">Artifact <b>fixedlocation</b></div></td></tr></table>
 <p>implements fixed placement of a MObject<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129285.html#refclass129285"><b>FixedLocation</b></a></p>
 <a name="refartifact129925"></a>
 <table><tr><td><div class="element">Artifact <b>relativelocation</b></div></td></tr></table>
 <p>Placement implemnetaion providing various ways of attaching a MObject to another one<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129413.html#refclass129413"><b>RelativeLocation</b></a></p>
 <a name="refartifact130053"></a>
 <table><tr><td><div class="element">Artifact <b>allocation</b></div></td></tr></table>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129541.html#refclass129541"><b>Allocation</b></a></p>
 <a name="refartifact139397"></a>
 <table><tr><td><div class="element">Artifact <b>constraint</b></div></td></tr></table>
 <p>LocatingPin representing an directive by the user that<br />must not be violated<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130181.html#refclass130181"><b>Constraint</b></a></p>
 <a name="refartifact139269"></a>
 <table><tr><td><div class="element">Artifact <b>wish</b></div></td></tr></table>
 <p>LocatingPin representing a low-priority directive by the user,<br />to be fulfilled only if possible (and after satisfying the<br />more important LocatingPins)<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130053.html#refclass130053"><b>Wish</b></a></p>
 <a name="refartifact139525"></a>
 <table><tr><td><div class="element">Artifact <b>plug</b></div></td></tr></table>
 <p>LocatingPin for requesting connection to some Port<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class140421.html#refclass140421"><b>Plug</b></a></p>
 <a name="refartifact130181"></a>
 <table><tr><td><div class="element">Artifact <b>label</b></div></td></tr></table>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129669.html#refclass129669"><b>Label</b></a></p>
 <a name="refartifact130309"></a>
 <table><tr><td><div class="element">Artifact <b>auto</b></div></td></tr></table>
 <p>Media Object holding automation data<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class129925.html#refclass129925"><b>Auto</b></a></p>
 </div>
 </div>
 <a name="refpackage130565"></a>
 <h4 class ="package">1.4.4.4.3 Package builder</h4>
-<p></p><ul>
+<p>sourcecode package<br /><br />The Builder creating the Render Engine,<br />located within the MObject Subsystem<br /></p><p></p><ul>
 <li>C++ namespace : mobject::builder</li>
 </ul>
-<p>sourcecode package<br /><br />The Builder creating the Render Engine,<br />located within the MObject Subsystem<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view129029"></a>
 <h4 class ="view">1.4.4.4.3.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -479,36 +567,43 @@ Documentation</title>
 <a name="refartifact130565"></a>
 <table><tr><td><div class="element">Artifact <b>toolfactory</b></div></td></tr></table>
 <p>supply of Tool implementations for the Builder<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130693.html#refclass130693"><b>ToolFactory</b></a></p>
 <a name="refartifact130693"></a>
 <table><tr><td><div class="element">Artifact <b>conmanager</b></div></td></tr></table>
 <p>manages the creation of additional ProcNode connections for the Renderengine<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class130821.html#refclass130821"><b>ConManager</b></a></p>
 <a name="refartifact130821"></a>
 <table><tr><td><div class="element">Artifact <b>assembler</b></div></td></tr></table>
 <p>building facility (implementation of the build process)<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class131077.html#refclass131077"><b>Assembler</b></a></p>
 <a name="refartifact131205"></a>
 <table><tr><td><div class="element">Artifact <b>buildertool</b></div></td></tr></table>
 <p>Interface, any tool for processing MObjects<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134149.html#refclass134149"><b>BuilderTool</b></a></p>
 <a name="refartifact131333"></a>
 <table><tr><td><div class="element">Artifact <b>segmentationtool</b></div></td></tr></table>
 <p>Tool for creating a partitioning of the current timeline<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134277.html#refclass134277"><b>SegmentationTool</b></a></p>
 <a name="refartifact131461"></a>
 <table><tr><td><div class="element">Artifact <b>nodecreatertool</b></div></td></tr></table>
 <p>central Tool implementing the Renderengine building<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class134405.html#refclass134405"><b>NodeCreatorTool</b></a></p>
 </div>
 </div>
 </div>
 <a name="refpackage130309"></a>
 <h4 class ="package">1.4.4.5 Package engine</h4>
-<p></p><ul>
+<p>sourcecode package<br /><br />The Core Render Engine<br /></p><p></p><ul>
 <li>C++ namespace : engine</li>
 </ul>
-<p>sourcecode package<br /><br />The Core Render Engine<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view129285"></a>
 <h4 class ="view">1.4.4.5.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -516,95 +611,116 @@ Documentation</title>
 <a name="refartifact131973"></a>
 <table><tr><td><div class="element">Artifact <b>renderengine</b></div></td></tr></table>
 <p>a complete network of processing nodes usable for rendering<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class131333.html#refclass131333"><b>RenderEngine</b></a></p>
 <a name="refartifact132101"></a>
-<table><tr><td><div class="element">Artifact <b>processor</b></div></td></tr></table>
+<table><tr><td><div class="element">Artifact <b>rendergraph</b></div></td></tr></table>
 <p>a single render pipeline for one segment of the timeline<br /></p>
-<p>Artifact <i>source</i> associated with : <a href="class131461.html#refclass131461"><b>Processor</b></a></p>
+<p>Stereotype: source</p>
+<p>Artifact <i>source</i> associated with : <a href="class131461.html#refclass131461"><b>RenderGraph</b></a></p>
 <a name="refartifact132229"></a>
 <table><tr><td><div class="element">Artifact <b>exitnode</b></div></td></tr></table>
 <p>special Processing Node providing "pullable" output<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class131589.html#refclass131589"><b>ExitNode</b></a></p>
 <a name="refartifact132357"></a>
 <table><tr><td><div class="element">Artifact <b>procnode</b></div></td></tr></table>
 <p>Key abstraction of the Render Engine: a Processing Node<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class131717.html#refclass131717"><b>ProcNode</b></a></p>
 <a name="refartifact132485"></a>
 <table><tr><td><div class="element">Artifact <b>trafo</b></div></td></tr></table>
 <p>transforming processing Node <br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class131845.html#refclass131845"><b>Trafo</b></a></p>
 <a name="refartifact132613"></a>
 <table><tr><td><div class="element">Artifact <b>link</b></div></td></tr></table>
 <p>forwarding, adapting or connecting ProcNode<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class131973.html#refclass131973"><b>Link</b></a></p>
 <a name="refartifact132741"></a>
 <table><tr><td><div class="element">Artifact <b>hub</b></div></td></tr></table>
 <p>special ProcNode used to build data distributing connections<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i></p>
 <a name="refartifact132869"></a>
 <table><tr><td><div class="element">Artifact <b>projector</b></div></td></tr></table>
 <p>video ProcNode for scaling and translating image data<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class132229.html#refclass132229"><b>Projector</b></a></p>
 <a name="refartifact132997"></a>
 <table><tr><td><div class="element">Artifact <b>mask</b></div></td></tr></table>
 <p>Video ProcNode for masking regions of the image (automatable)<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class132357.html#refclass132357"><b>Mask</b></a></p>
 <a name="refartifact133125"></a>
 <table><tr><td><div class="element">Artifact <b>pluginadapter</b></div></td></tr></table>
 <p>Adapter for integrating various Effect processors in the render pipeline<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class132485.html#refclass132485"><b>PluginAdapter</b></a></p>
 <a name="refartifact134917"></a>
 <table><tr><td><div class="element">Artifact <b>codecadapter</b></div></td></tr></table>
 <p>Processing Node for (de)coding media data<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class135045.html#refclass135045"><b>CodecAdapter</b></a></p>
 <a name="refartifact133253"></a>
 <table><tr><td><div class="element">Artifact <b>glpipe</b></div></td></tr></table>
 <p>specialized connection element for handling OpenGL implementation details<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i></p>
 <a name="refartifact133381"></a>
 <table><tr><td><div class="element">Artifact <b>arender</b></div></td></tr></table>
 <p>Representation of a Audio Render process<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i></p>
 <a name="refartifact133509"></a>
 <table><tr><td><div class="element">Artifact <b>vrender</b></div></td></tr></table>
 <p>Representation of a Video render process<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i></p>
 <a name="refartifact133637"></a>
 <table><tr><td><div class="element">Artifact <b>glrender</b></div></td></tr></table>
 <p>Representation of a OpenGL accellerated Video render process<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i></p>
 <a name="refartifact133893"></a>
 <table><tr><td><div class="element">Artifact <b>aframe</b></div></td></tr></table>
 <p>a buffer and render process holding a Audio frame<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class133381.html#refclass133381"><b>AFrame</b></a></p>
 <a name="refartifact134021"></a>
 <table><tr><td><div class="element">Artifact <b>vframe</b></div></td></tr></table>
 <p>a buffer and render process holding a Video frame<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class133509.html#refclass133509"><b>VFrame</b></a></p>
 <a name="refartifact134149"></a>
 <table><tr><td><div class="element">Artifact <b>glbuf</b></div></td></tr></table>
 <p>a buffer and render process holding a Video frame for OpenGL rendering<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class133637.html#refclass133637"><b>GLBuf</b></a></p>
 <a name="refartifact134277"></a>
 <table><tr><td><div class="element">Artifact <b>source</b></div></td></tr></table>
 <p>Representation of a Media source<br /></p>
+<p>Stereotype: source</p>
 <p>Artifact <i>source</i> associated with : <a href="class133765.html#refclass133765"><b>Source</b></a></p>
 </div>
 </div>
 </div>
 <a name="refpackage129797"></a>
 <h3 class ="package">1.4.5 Package gui</h3>
-<p></p><ul>
+<p>sourcecode package<br /><br />User Interface classes go here<br /></p><p></p><ul>
 <li>C++ namespace : gui</li>
 </ul>
-<p>sourcecode package<br /><br />User Interface classes go here<br /></p><div class="sub">
+<p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view129413"></a>
 <h4 class ="view">1.4.5.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
 </div>
 <a name="refpackage129925"></a>
 <h3 class ="package">1.4.6 Package tool</h3>
-<p>sourcecode package<br /><br />Tools and Utilities <br />(separate from the main cinelrra binary)<br /></p><div class="sub">
+<p>sourcecode package<br /><br />Tools and Utilities <br />(separate from the main cinelrra binary)<br /></p><p>Stereotype: src</p>
+<div class="sub">
 <a name="refdeployment view129541"></a>
 <h4 class ="view">1.4.6.1 Deployment View gen</h4>
 <p>defines source files to be generated by BOUML<br /></p>
@@ -730,6 +846,7 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class <b><a href="class145797.html#refclass145797"><b>TimelineView</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class128133.html#refclass128133"><b>Seq</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class128261.html#refclass128261"><b>Fixture</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class147333.html#refclass147333"><b>Segmentation</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class135173.html#refclass135173"><b>Segment</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class128389.html#refclass128389"><b>Track</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class128517.html#refclass128517"><b>MObject</b></a></b></div></td></tr></table>
@@ -838,7 +955,7 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <p>Defined in <a href="index.html#refactivity128005"><b>building the Engine</b></a></p></div>
 <a name="refclass diagram129285"></a>
 <p align="center"><img src="fig129285.png" alt="" /></p>
- <p align="center"><b>Builder Entities</b></p><p><br /></p><p><br /></p>
+ <p align="center"><b>Builder Tool (Visitor)</b></p><p><br /></p><p><br /></p>
 <table><tr><td><div class="element">Class <b><a href="class130565.html#refclass130565"><b>BuilderFacade</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class130693.html#refclass130693"><b>ToolFactory</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class130821.html#refclass130821"><b>ConManager</b></a></b></div></td></tr></table>
@@ -848,6 +965,9 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class <b><a href="class134149.html#refclass134149"><b>BuilderTool</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class134277.html#refclass134277"><b>SegmentationTool</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class134405.html#refclass134405"><b>NodeCreatorTool</b></a></b></div></td></tr></table>
+<a name="refclass diagram132868"></a>
+<p align="center"><img src="fig132868.png" alt="" /></p>
+ <p align="center"><b>Builder Entities</b></p><p><br /></p><p><br /></p>
 </div>
 </div>
 <a name="refuse case view128261"></a>
@@ -878,11 +998,11 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <p align="center"><img src="fig128261.png" alt="" /></p>
  <p align="center"><b>Overview Render Engine</b></p><p><br /></p><p><br /></p>
 <a name="refnode128005"></a>
-<table><tr><td><div class="element">Node <b>timeline</b></div></td></tr></table>
+<table><tr><td><div class="element">Node <b>effective timeline (Fixture)</b></div></td></tr></table>
 <a name="refnode128261"></a>
 <table><tr><td><div class="element">Node <b>playlist</b></div></td></tr></table>
 <a name="refnode128389"></a>
-<table><tr><td><div class="element">Node <b>proc</b></div></td></tr></table>
+<table><tr><td><div class="element">Node <b>graph</b></div></td></tr></table>
 <a name="refnode128517"></a>
 <table><tr><td><div class="element">Node <b>pnode</b></div></td></tr></table>
 <a name="refnode128645"></a>
@@ -906,7 +1026,7 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <p align="center"><img src="fig132357.png" alt="" /></p>
  <p align="center"><b>StateAdapter composition</b></p><p><br /></p><p><br /></p>
 <table><tr><td><div class="element">Class <b><a href="class131333.html#refclass131333"><b>RenderEngine</b></a></b></div></td></tr></table>
-<table><tr><td><div class="element">Class <b><a href="class131461.html#refclass131461"><b>Processor</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class131461.html#refclass131461"><b>RenderGraph</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class131589.html#refclass131589"><b>ExitNode</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class131717.html#refclass131717"><b>ProcNode</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class131845.html#refclass131845"><b>Trafo</b></a></b></div></td></tr></table>
@@ -1015,17 +1135,17 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class instance  <b></div></td></tr></table><p>type :<a href="class131333.html#refclass131333"><b>RenderEngine</b></a></p><p>relations :<ul>
 <li><a href="class131333.html#refrelation132485"><b>renderSegments</b></a> = <a href="index.html#refclass instance130949"><b>video1</b></a></li>
 </ul></p><a name="refclass instance130821"></a>
-<table><tr><td><div class="element">Class instance  <b>audio1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>Processor</b></a></p><p>attributes :<ul>
+<table><tr><td><div class="element">Class instance  <b>audio1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>RenderGraph</b></a></p><p>attributes :<ul>
 <li><a href="class131461.html#refattribute129541"><b>end</b></a> = 7/25</li>
 <li><a href="class131461.html#refattribute129413"><b>start</b></a> = 2/25</li>
 </ul></p><p>relations :<ul>
-<li><a href="class131461.html#refrelation132613"><b>output</b></a> = <a href="index.html#refclass instance131205"><b>audio</b></a></li>
+<li><a href="class131461.html#refrelation132613"><b>pipes</b></a> = <a href="index.html#refclass instance131205"><b>audio</b></a></li>
 </ul></p><a name="refclass instance130949"></a>
-<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>Processor</b></a></p><p>attributes :<ul>
+<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>RenderGraph</b></a></p><p>attributes :<ul>
 <li><a href="class131461.html#refattribute129541"><b>end</b></a> = 7/25</li>
 <li><a href="class131461.html#refattribute129413"><b>start</b></a> = 2/25</li>
 </ul></p><p>relations :<ul>
-<li><a href="class131461.html#refrelation132613"><b>output</b></a> = <a href="index.html#refclass instance131077"><b>video</b></a></li>
+<li><a href="class131461.html#refrelation132613"><b>pipes</b></a> = <a href="index.html#refclass instance131077"><b>video</b></a></li>
 </ul></p><a name="refclass instance131077"></a>
 <table><tr><td><div class="element">Class instance  <b>video</div></td></tr></table><p>type :<a href="class131589.html#refclass131589"><b>ExitNode</b></a></p><p>relations :<ul>
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance131333"><b>ouput</b></a></li>
@@ -1056,11 +1176,11 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class instance  <b>input</div></td></tr></table><p>type :<a href="class132229.html#refclass132229"><b>Projector</b></a></p><p>relations :<ul>
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance134021"><b>vid_a</b></a></li>
 </ul></p><a name="refclass instance132997"></a>
-<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>Processor</b></a></p><p>attributes :<ul>
+<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>RenderGraph</b></a></p><p>attributes :<ul>
 <li><a href="class131461.html#refattribute129541"><b>end</b></a> = 8/25</li>
 <li><a href="class131461.html#refattribute129413"><b>start</b></a> = 7/25</li>
 </ul></p><p>relations :<ul>
-<li><a href="class131461.html#refrelation132613"><b>output</b></a> = <a href="index.html#refclass instance132741"><b>video</b></a></li>
+<li><a href="class131461.html#refrelation132613"><b>pipes</b></a> = <a href="index.html#refclass instance132741"><b>video</b></a></li>
 </ul></p><a name="refclass instance133125"></a>
 <table><tr><td><div class="element">Class instance  <b>ouput</div></td></tr></table><p>type :<a href="class132229.html#refclass132229"><b>Projector</b></a></p><p>relations :<ul>
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance133253"><b>HUE</b></a></li>
@@ -1069,11 +1189,11 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance132869"><b>input</b></a></li>
 </ul></p><a name="refclass instance133509"></a>
 <table><tr><td><div class="element">Class instance  <b></div></td></tr></table><p>type :<a href="class133509.html#refclass133509"><b>VFrame</b></a></p><a name="refclass instance133637"></a>
-<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>Processor</b></a></p><p>attributes :<ul>
+<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>RenderGraph</b></a></p><p>attributes :<ul>
 <li><a href="class131461.html#refattribute129541"><b>end</b></a> = 7/25</li>
 <li><a href="class131461.html#refattribute129413"><b>start</b></a> = 5/25</li>
 </ul></p><p>relations :<ul>
-<li><a href="class131461.html#refrelation132613"><b>output</b></a> = <a href="index.html#refclass instance133765"><b>video</b></a></li>
+<li><a href="class131461.html#refrelation132613"><b>pipes</b></a> = <a href="index.html#refclass instance133765"><b>video</b></a></li>
 </ul></p><a name="refclass instance133765"></a>
 <table><tr><td><div class="element">Class instance  <b>video</div></td></tr></table><p>type :<a href="class131589.html#refclass131589"><b>ExitNode</b></a></p><p>relations :<ul>
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance133125"><b>ouput</b></a></li>
@@ -1085,11 +1205,11 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class instance  <b>input</div></td></tr></table><p>type :<a href="class132229.html#refclass132229"><b>Projector</b></a></p><p>relations :<ul>
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance134021"><b>vid_a</b></a></li>
 </ul></p><a name="refclass instance134277"></a>
-<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>Processor</b></a></p><p>attributes :<ul>
+<table><tr><td><div class="element">Class instance  <b>video1</div></td></tr></table><p>type :<a href="class131461.html#refclass131461"><b>RenderGraph</b></a></p><p>attributes :<ul>
 <li><a href="class131461.html#refattribute129541"><b>end</b></a> = 5/25</li>
 <li><a href="class131461.html#refattribute129413"><b>start</b></a> = 2/25</li>
 </ul></p><p>relations :<ul>
-<li><a href="class131461.html#refrelation132613"><b>output</b></a> = <a href="index.html#refclass instance134533"><b>video</b></a></li>
+<li><a href="class131461.html#refrelation132613"><b>pipes</b></a> = <a href="index.html#refclass instance134533"><b>video</b></a></li>
 </ul></p><a name="refclass instance134405"></a>
 <table><tr><td><div class="element">Class instance  <b>ouput</div></td></tr></table><p>type :<a href="class132229.html#refclass132229"><b>Projector</b></a></p><p>relations :<ul>
 <li><a href="class131717.html#refrelation136965"><b>datasrc</b></a> = <a href="index.html#refclass instance134149"><b>input</b></a></li>
diff --git a/doc/devel/uml/index_60.html b/doc/devel/uml/index_60.html
index 75ccc147d..8712d7074 100644
--- a/doc/devel/uml/index_60.html
+++ b/doc/devel/uml/index_60.html
@@ -30,8 +30,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129029" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131717" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130181" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131077" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130949" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131077" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130053" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128901" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130565" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
diff --git a/doc/devel/uml/index_65.html b/doc/devel/uml/index_65.html
index ab57596c5..da137cab0 100644
--- a/doc/devel/uml/index_65.html
+++ b/doc/devel/uml/index_65.html
@@ -58,9 +58,9 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131845" target = "projectFrame"><b>aud_a</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128773" target = "projectFrame"><b>aud_A</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131205" target = "projectFrame"><b>audio</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130821" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128901" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128389" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130821" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact130309" target = "projectFrame"><b>auto</b></a></td><td>artifact</td><td>Media Object holding automation data</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129925.html#refclass129925" target = "projectFrame"><b>Auto</b></a></td><td>class</td><td>Automation data for some parameter (i.e. a time varying function)</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129669" target = "projectFrame"><b>Automation Entities</b></a></td><td>class diagram</td><td></td></tr>
diff --git a/doc/devel/uml/index_66.html b/doc/devel/uml/index_66.html
index 3a6ba7379..5a4df3c38 100644
--- a/doc/devel/uml/index_66.html
+++ b/doc/devel/uml/index_66.html
@@ -39,7 +39,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128005" target = "projectFrame"><b>Builder</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128901" target = "projectFrame"><b>Builder</b></a></td><td>package</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130565" target = "projectFrame"><b>builder</b></a></td><td>package</td><td>sourcecode package<br /><br />The Builder creating the Render Engine,<br />located within the MObject Subsystem</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129285" target = "projectFrame"><b>Builder Entities</b></a></td><td>class diagram</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132868" target = "projectFrame"><b>Builder Entities</b></a></td><td>class diagram</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129285" target = "projectFrame"><b>Builder Tool (Visitor)</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128261" target = "projectFrame"><b>Builder Workings</b></a></td><td>class view</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130565.html#refclass130565" target = "projectFrame"><b>BuilderFacade</b></a></td><td>class</td><td>Provides unified access to the builder functionality. While individual components of the builder subsystem may be called if necessary or suitable, it is usually better to do all extern invocations via the high level methods of this Facade</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact130437" target = "projectFrame"><b>builderfacade</b></a></td><td>artifact</td><td>Facade and service access point for the Builder Subsystem</td></tr>
diff --git a/doc/devel/uml/index_67.html b/doc/devel/uml/index_67.html
index b906f4d25..a17989712 100644
--- a/doc/devel/uml/index_67.html
+++ b/doc/devel/uml/index_67.html
@@ -32,39 +32,39 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134277" target = "projectFrame"><b>chain</b></a></td><td>operation</td><td>create and add another Placement for this media object, thus increasingly constraining the (possible) position of this object.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation129633" target = "projectFrame"><b>checked_in</b></a></td><td>relation</td><td>checked_in objects are subject of cache aging and must be not in use</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation129290" target = "projectFrame"><b>checked_out</b></a></td><td>relation</td><td>this list keeps all mappings which are in use, and thus prevents them from Cache aging</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135301" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135045" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135557" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135429" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135173" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134917" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135685" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135045" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134789" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134661" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134789" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135813" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135301" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135557" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129797" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132229" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135173" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130565" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133509" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130309" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132229" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129029" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130693" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131589" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132357" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132485" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130053" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130181" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130437" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129541" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129285" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128133" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128005" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129797" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130053" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132485" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132357" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128261" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130565" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128005" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131589" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130181" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128133" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130437" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129285" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130309" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation133765" target = "projectFrame"><b>clear</b></a></td><td>operation</td><td>clear current session contents <br />without resetting overall session config.<br />Afterwards, the session will contain only one <br />empty EDL, while all Assets are retained.<br /></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent131077" target = "projectFrame"><b>client code</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a></td><td>class</td><td>bookkeeping (asset) view of a media clip.</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136325" target = "projectFrame"><b>clip</b></a></td><td>artifact</td><td>bookkeeping (asset) view of a media clip.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129413" target = "projectFrame"><b>clip</b></a></td><td>artifact</td><td>a Media Clip</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136325" target = "projectFrame"><b>clip</b></a></td><td>artifact</td><td>bookkeeping (asset) view of a media clip.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128901" target = "projectFrame"><b>clips</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a></td><td>class</td><td>description of some media data decoder or encoder facility</td></tr>
diff --git a/doc/devel/uml/index_69.html b/doc/devel/uml/index_69.html
index 4fe57adfd..37fab2669 100644
--- a/doc/devel/uml/index_69.html
+++ b/doc/devel/uml/index_69.html
@@ -23,9 +23,10 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refobject diagram128901" target = "projectFrame"><b>EDL Example2</b></a></td><td>object diagram</td><td>More complex example showing the Object graph in the EDL and how it is linked into the Fixture to yield the actual locations. In this example, an HUE Effect is applied on a part of the Clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128005" target = "projectFrame"><b>edls</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137733.html#refclass137733" target = "projectFrame"><b>Effect</b></a></td><td>class</td><td>Effect or media processing component</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129541" target = "projectFrame"><b>effect</b></a></td><td>artifact</td><td>EDL representation of a pluggable and automatable effect.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137221" target = "projectFrame"><b>effect</b></a></td><td>artifact</td><td>Effect or media processing component</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129541" target = "projectFrame"><b>effect</b></a></td><td>artifact</td><td>EDL representation of a pluggable and automatable effect.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129029.html#refclass129029" target = "projectFrame"><b>Effect</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refnode128005" target = "projectFrame"><b>effective timeline (Fixture)</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation131717" target = "projectFrame"><b>effectiveTimeline</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation138885" target = "projectFrame"><b>elements</b></a></td><td>relation</td><td>relevant MObjects comprising this segment. TODO: actually necessary??</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation132997" target = "projectFrame"><b>enable</b></a></td><td>operation</td><td>change the enabled status of this asset. Note the corresponding #isActive predicate may depend on the enablement status of parent assets as well</td></tr>
diff --git a/doc/devel/uml/index_70.html b/doc/devel/uml/index_70.html
index 5f2c83e88..777bf389c 100644
--- a/doc/devel/uml/index_70.html
+++ b/doc/devel/uml/index_70.html
@@ -37,8 +37,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class129285.html#refclass129285" target = "projectFrame"><b>FixedLocation</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity object128005" target = "projectFrame"><b>Fixture</b></a></td><td>activity object</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact128773" target = "projectFrame"><b>fixture</b></a></td><td>artifact</td><td>the (low level) representation of the EDL with concrete placement data</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class128261.html#refclass128261" target = "projectFrame"><b>Fixture</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128517" target = "projectFrame"><b>Fixture</b></a></td><td>component</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class128261.html#refclass128261" target = "projectFrame"><b>Fixture</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reffork activity node129029" target = "projectFrame"><b>fork activity node</b></a></td><td>fork activity node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128821.html#refclass128821" target = "projectFrame"><b>Frame</b></a></td><td>class</td><td>Frames are just a low level lump of continous memory, most parts are opaque. Frames are memory sensitive, they will be small constant sized structures which can be efficently managed in a pool.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refnode128645" target = "projectFrame"><b>Frame</b></a></td><td>node</td><td></td></tr>
diff --git a/doc/devel/uml/index_71.html b/doc/devel/uml/index_71.html
index 75f10c74f..a95c02ef8 100644
--- a/doc/devel/uml/index_71.html
+++ b/doc/devel/uml/index_71.html
@@ -49,6 +49,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation160005" target = "projectFrame"><b>globalBusses</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact133253" target = "projectFrame"><b>glpipe</b></a></td><td>artifact</td><td>specialized connection element for handling OpenGL implementation details</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact133637" target = "projectFrame"><b>glrender</b></a></td><td>artifact</td><td>Representation of a OpenGL accellerated Video render process</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refnode128389" target = "projectFrame"><b>graph</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute131077" target = "projectFrame"><b>groups</b></a></td><td>attribute</td><td>additional classification, selections or departments this asset belongs to. Groups are optional, non-exclusive and may be overlapping.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129797" target = "projectFrame"><b>gui</b></a></td><td>package</td><td>sourcecode package<br /><br />User Interface classes go here</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128773" target = "projectFrame"><b>GUI</b></a></td><td>package</td><td>GUI is here just a container to hold any entities considered to be User Interface related, which is not in focus for this Design draft</td></tr>
diff --git a/doc/devel/uml/index_73.html b/doc/devel/uml/index_73.html
index 7f152ccfe..844b1bf03 100644
--- a/doc/devel/uml/index_73.html
+++ b/doc/devel/uml/index_73.html
@@ -21,8 +21,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class145029.html#refclass145029" target = "projectFrame"><b>ImplFacade</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128309" target = "projectFrame"><b>In Memory Database</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity action pin128133" target = "projectFrame"><b>inFixture</b></a></td><td>activity action pin</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131461" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132869" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131461" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134149" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation131461" target = "projectFrame"><b>instance</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class147205.html#refclass147205" target = "projectFrame"><b>InstanceHandle</b></a></td><td>class</td><td></td></tr>
diff --git a/doc/devel/uml/index_77.html b/doc/devel/uml/index_77.html
index c88824279..56c268d60 100644
--- a/doc/devel/uml/index_77.html
+++ b/doc/devel/uml/index_77.html
@@ -34,8 +34,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class145285.html#refclass145285" target = "projectFrame"><b>MediaKind</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refmerge activity node128773" target = "projectFrame"><b>merge activity node</b></a></td><td>merge activity node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137093.html#refclass137093" target = "projectFrame"><b>Meta</b></a></td><td>class</td><td>key abstraction: metadata and organisational asset</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136837" target = "projectFrame"><b>meta</b></a></td><td>artifact</td><td>key abstraction: metadata and organisational asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129669" target = "projectFrame"><b>meta</b></a></td><td>artifact</td><td>abstract base class of all MObjects representing meta data or processing instructions</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136837" target = "projectFrame"><b>meta</b></a></td><td>artifact</td><td>key abstraction: metadata and organisational asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129157.html#refclass129157" target = "projectFrame"><b>Meta</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact128261" target = "projectFrame"><b>mobject</b></a></td><td>artifact</td><td>Key Abstraction: A Media Object in the Session</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130181" target = "projectFrame"><b>mobject</b></a></td><td>package</td><td>sourcecode package<br /><br />MObject Subsystem<br />including the Session (EDL), Builder and Processing Controller</td></tr>
diff --git a/doc/devel/uml/index_79.html b/doc/devel/uml/index_79.html
index e17eadde8..d7e2263c6 100644
--- a/doc/devel/uml/index_79.html
+++ b/doc/devel/uml/index_79.html
@@ -20,11 +20,10 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute129029" target = "projectFrame"><b>offset</b></a></td><td>attribute</td><td>Offset the actual position by this (time) value relative to the anchor point. TODO: Representation?</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143493.html#refclass143493" target = "projectFrame"><b>OperationBase</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130821" target = "projectFrame"><b>org</b></a></td><td>attribute</td><td>origin or authorship id. Can be a project abbreviation, a package id or just the authors nickname or UID. This allows for the compnent name to be more generic (e.g. "blur"). Default for all assets provided by the core Lumiera codebase is "lumi".</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131333" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134405" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133125" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131333" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation147973" target = "projectFrame"><b>outPort</b></a></td><td>relation</td><td>the Port this MObject wants to be conected to</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation132613" target = "projectFrame"><b>output</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent diagram128005" target = "projectFrame"><b>Overview</b></a></td><td>component diagram</td><td>This drawing shows the top level compoents and relations</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refdeployment diagram128261" target = "projectFrame"><b>Overview Render Engine</b></a></td><td>deployment diagram</td><td></td></tr>
 </table>
diff --git a/doc/devel/uml/index_80.html b/doc/devel/uml/index_80.html
index d024e3dca..5f43290e4 100644
--- a/doc/devel/uml/index_80.html
+++ b/doc/devel/uml/index_80.html
@@ -27,6 +27,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact131717" target = "projectFrame"><b>pathmanager</b></a></td><td>artifact</td><td>Manager for deciding the actual render strategy</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class138117.html#refclass138117" target = "projectFrame"><b>Pipe</b></a></td><td>class</td><td>structural asset representing a basic building block within the high level model: a port for building a processing chain and generating media output</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137605" target = "projectFrame"><b>pipe</b></a></td><td>artifact</td><td>structural asset corresponding to some port generating media output</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation132613" target = "projectFrame"><b>pipes</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation147717" target = "projectFrame"><b>pipes</b></a></td><td>relation</td><td>the global ports (busses) of the session</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129029" target = "projectFrame"><b>placement</b></a></td><td>artifact</td><td>Key Abstraction: a way to place and locate a Media Object</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128645.html#refclass128645" target = "projectFrame"><b>Placement</b></a></td><td>class</td><td>used to specify the position of a MObject in the EDL. This can be done in various ways (absolute, relative). <br />Placement at the same time acts as (refcounting) smart pointer for accessing the MObject.</td></tr>
@@ -49,7 +50,6 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136965" target = "projectFrame"><b>preview</b></a></td><td>artifact</td><td>alternative version of the media data, probably with lower resolution</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136837.html#refclass136837" target = "projectFrame"><b>Proc</b></a></td><td>class</td><td>key abstraction: data processing asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129669" target = "projectFrame"><b>proc</b></a></td><td>package</td><td>sourcecode package<br /><br />All classes belonging to the (middle) processing layer</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refnode128389" target = "projectFrame"><b>proc</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136581" target = "projectFrame"><b>proc</b></a></td><td>artifact</td><td>key abstraction: media-like assets</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute129797" target = "projectFrame"><b>proc</b></a></td><td>attribute</td><td>holds the Processor (Render Engine Element) to be built by the current build step</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram131077" target = "projectFrame"><b>Proc-Asset Relations</b></a></td><td>class diagram</td><td></td></tr>
@@ -58,8 +58,6 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation136069" target = "projectFrame"><b>process</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class144389.html#refclass144389" target = "projectFrame"><b>ProcessData</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129285" target = "projectFrame"><b>ProcessingLayer</b></a></td><td>package</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class131461.html#refclass131461" target = "projectFrame"><b>Processor</b></a></td><td>class</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132101" target = "projectFrame"><b>processor</b></a></td><td>artifact</td><td>a single render pipeline for one segment of the timeline</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent130053" target = "projectFrame"><b>ProcNode</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131717.html#refclass131717" target = "projectFrame"><b>ProcNode</b></a></td><td>class</td><td>Key abstraction of the Render Engine: A Data processing Node</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132357" target = "projectFrame"><b>procnode</b></a></td><td>artifact</td><td>Key abstraction of the Render Engine: a Processing Node</td></tr>
diff --git a/doc/devel/uml/index_82.html b/doc/devel/uml/index_82.html
index fd3368437..8c7b345eb 100644
--- a/doc/devel/uml/index_82.html
+++ b/doc/devel/uml/index_82.html
@@ -24,8 +24,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129925" target = "projectFrame"><b>relativelocation</b></a></td><td>artifact</td><td>Placement implemnetaion providing various ways of attaching a MObject to another one</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129413.html#refclass129413" target = "projectFrame"><b>RelativeLocation</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation136197" target = "projectFrame"><b>releaseBuffer</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class133893.html#refclass133893" target = "projectFrame"><b>RelType</b></a></td><td>class</td><td>the possible kinds of RelativePlacements</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute128133" target = "projectFrame"><b>relType</b></a></td><td>attribute</td><td>the kind of relation denoted by this Placement</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class133893.html#refclass133893" target = "projectFrame"><b>RelType</b></a></td><td>class</td><td>the possible kinds of RelativePlacements</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation132741" target = "projectFrame"><b>remove</b></a></td><td>operation</td><td>remove the given asset &lt;i&gt;together with all its dependants&lt;/i&gt; from the internal DB</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128389" target = "projectFrame"><b>Render Entities</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram131973" target = "projectFrame"><b>Render Mechanics</b></a></td><td>class diagram</td><td></td></tr>
@@ -35,6 +35,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact131973" target = "projectFrame"><b>renderengine</b></a></td><td>artifact</td><td>a complete network of processing nodes usable for rendering</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128389" target = "projectFrame"><b>RenderEngine</b></a></td><td>package</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refuse case view128005" target = "projectFrame"><b>Renderengine Use</b></a></td><td>use case view</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class131461.html#refclass131461" target = "projectFrame"><b>RenderGraph</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132101" target = "projectFrame"><b>rendergraph</b></a></td><td>artifact</td><td>a single render pipeline for one segment of the timeline</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent129285" target = "projectFrame"><b>RenderPathManager</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation132485" target = "projectFrame"><b>renderSegments</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130949.html#refclass130949" target = "projectFrame"><b>RenderState</b></a></td><td>class</td><td>Encapsulates the logic used to get a "current render process" in accordance to the currentyl applicable controller settings. The provided StateProxy serves to hold any mutalbe state used in the render process, so the rest of the render engine can be stateless.</td></tr>
diff --git a/doc/devel/uml/index_83.html b/doc/devel/uml/index_83.html
index 9c9ebb223..028888285 100644
--- a/doc/devel/uml/index_83.html
+++ b/doc/devel/uml/index_83.html
@@ -23,6 +23,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact135045" target = "projectFrame"><b>segment</b></a></td><td>artifact</td><td>Segment of the Timeline.<br />Used at the moment (7/07) for partitioning the timeline/fixture into segments<br />to be rendered by a specialized render node network for each, without the need<br />to change any connections within a given segment. <br />Note this concept may be superfluos alltogether; is a draft and the real<br />use still needs to be worked out...</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135173.html#refclass135173" target = "projectFrame"><b>Segment</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity object128005" target = "projectFrame"><b>segment Tool</b></a></td><td>activity object</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class147333.html#refclass147333" target = "projectFrame"><b>Segmentation</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134277.html#refclass134277" target = "projectFrame"><b>SegmentationTool</b></a></td><td>class</td><td>Tool implementation for deriving a partitioning of the current timeline such, that each segement has a constant configuration. "Constant" means here, that any remaining changes over time can be represented by automation solely, without the need to change the node connections.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact131333" target = "projectFrame"><b>segmentationtool</b></a></td><td>artifact</td><td>Tool for creating a partitioning of the current timeline</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity object128389" target = "projectFrame"><b>segments</b></a></td><td>activity object</td><td></td></tr>
@@ -50,8 +51,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class138885.html#refclass138885" target = "projectFrame"><b>SimpleClip</b></a></td><td>class</td><td>Elementary clip consisting of only one media stream</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128906.html#refclass128906" target = "projectFrame"><b>SmartPointer</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128266" target = "projectFrame"><b>SmartPointers</b></a></td><td>class view</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation141957" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>media source of this clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation142469" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>the media source this clip referes to</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation141957" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>media source of this clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133765.html#refclass133765" target = "projectFrame"><b>Source</b></a></td><td>class</td><td>Source Node: represents a media source to pull data from.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134277" target = "projectFrame"><b>source</b></a></td><td>artifact</td><td>Representation of a Media source</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refdeployment diagram129797" target = "projectFrame"><b>Source Overview</b></a></td><td>deployment diagram</td><td></td></tr>
diff --git a/doc/devel/uml/index_84.html b/doc/devel/uml/index_84.html
index 8f80d7c8d..361bf1d1f 100644
--- a/doc/devel/uml/index_84.html
+++ b/doc/devel/uml/index_84.html
@@ -24,7 +24,6 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute128261" target = "projectFrame"><b>time</b></a></td><td>attribute</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134789" target = "projectFrame"><b>time</b></a></td><td>artifact</td><td>unified representation of a time point, including conversion functions</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134917.html#refclass134917" target = "projectFrame"><b>Time</b></a></td><td>class</td><td>denotes a temporal position (time point), based on timeline start.<br /><br />investigate posix.4 realtime timers, wrap these here</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refnode128005" target = "projectFrame"><b>timeline</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145541.html#refclass145541" target = "projectFrame"><b>Timeline</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132741" target = "projectFrame"><b>TimelineSequences</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145797.html#refclass145797" target = "projectFrame"><b>TimelineView</b></a></td><td>class</td><td></td></tr>
@@ -45,13 +44,13 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132485" target = "projectFrame"><b>trafo</b></a></td><td>artifact</td><td>transforming processing Node </td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134405" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129797" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td>This operation is to be overloaded for the specific MObject subclasses to be treated.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130693" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130309" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130565" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130693" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130437" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130181" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129925" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130053" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130181" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140805.html#refclass140805" target = "projectFrame"><b>TypeHandler</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141317.html#refclass141317" target = "projectFrame"><b>TypeHandler&lt;Pipe&gt;</b></a></td><td>class</td><td></td></tr>
 </table>
diff --git a/doc/devel/uml/index_86.html b/doc/devel/uml/index_86.html
index 203265efb..1ab403ad8 100644
--- a/doc/devel/uml/index_86.html
+++ b/doc/devel/uml/index_86.html
@@ -21,21 +21,21 @@
 <tr bgcolor=#f0f0f0><td><a href="class133509.html#refclass133509" target = "projectFrame"><b>VFrame</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134021" target = "projectFrame"><b>vframe</b></a></td><td>artifact</td><td>a buffer and render process holding a Video frame</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance137093" target = "projectFrame"><b>vid1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134021" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131717" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128645" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129413" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129925" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132741" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131077" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133765" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134021" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128645" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131717" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129413" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134533" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128517" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134277" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133637" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129157" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130949" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133765" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131077" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132741" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132997" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130949" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129157" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128517" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133637" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134277" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140165.html#refclass140165" target = "projectFrame"><b>Visitable</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130949" target = "projectFrame"><b>visitor</b></a></td><td>package</td><td>sub-namespace for visitor library implementation</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact139141" target = "projectFrame"><b>visitor</b></a></td><td>artifact</td><td>Acyclic Visitor library</td></tr>
diff --git a/doc/devel/uml/style.css b/doc/devel/uml/style.css
index 2f256177f..3a10a8149 100644
--- a/doc/devel/uml/style.css
+++ b/doc/devel/uml/style.css
@@ -1,6 +1,6 @@
 div.title { font-size: 150%; background: #87ceff; text-align: center; font-weight: bold; }
 
-div.sub { margin-left : 20; }
+div.sub { margin-left : 20px; }
 div.element { background: #d3d3d3; }
 
 h1.package { background: #ffe4c4; }

From 011018c5c11c6ffddfe6bccf63b08d480931fc63 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 7 Jun 2009 20:17:46 +0200
Subject: [PATCH 092/368] tag all Tiddlers containing images

---
 wiki/renderengine.html | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 20ef06d76..229003ee3 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -528,7 +528,7 @@ Even if the low-level memory manager(s) may use raw storage, we require that the
 &amp;rarr; see MemoryManagement
 </pre>
 </div>
-<div title="Asset" modifier="Ichthyostega" modified="200801061942" created="200708100337" tags="def classes" changecount="15">
+<div title="Asset" modifier="Ichthyostega" modified="200906071813" created="200708100337" tags="def classes img" changecount="16">
 <pre>Asset management is a subsystem on its own. Assets are &quot;things&quot; that can be loaded into a session, like Media, Clips, Effects, Transitions. It is the &quot;bookkeeping view&quot;, while the EDL is the &quot;manipulation and process view&quot;. Some Assets can be //loaded// and a collection of Assets is saved with each Session. Besides, there is a collection of basic Assets always available by default.
 
 The Assets are important reference points holding the information needed to access external resources. For example, an Clip asset can reference a Media asset, which in turn holds the external filename from which to get the media stream. For Effects, the situation is similar. Assets thus serve two quite distinct purposes. One is to load, list, group search and browse them, and to provide an entry point to create new or get at existing MObjects in the EDL, while the other purpose is to provide attribute and property informations to the inner parts of the engine, while at the same time isolating and decoupling them from environmental details. 
@@ -598,7 +598,7 @@ The attachment relation is hierarchical and has a clearly defined //active// and
 Attachment on itself does //not// keep an object alive. Rather, it's implemented by an opaque ID entry (&amp;rarr; PlacementRef), which can be resolved by the PlacementIndex. The existence of attachments should be taken into account when deleting an object, preferably removing any dangling attachments to prevent an exception to be thrown later on. On the other hand, contrary to the elements of the HighLevelModel, processing nodes in the render engine never depend on placements &amp;mdash; they always refer directly to the MObject instance or even the underlying asset. In the case of MObject instances, the pointer from within the engine will //share ownership// with the placement (remember: both are derived from {{{boost::shared_ptr}}}).
 </pre>
 </div>
-<div title="Automation" modifier="Ichthyostega" modified="200708100315" created="200706250751" tags="def" changecount="5">
+<div title="Automation" modifier="Ichthyostega" modified="200906071813" created="200706250751" tags="def img" changecount="6">
 <pre>Automation is treated as a function over time. It is always tied to a specific Parameter (which can thus be variable over the course of the timeline). All details //how// this function is defined are completely abstracted away. The Parameter uses a ParamProvider to get the value for a given Time (point). Typically, this will use linear or bezier interpolation over a set of keyframes internally. Parameters can be configured to have different value ranges and distribution types (on-off, stepped, continuous, bounded)
 
 [img[how to implement Automation|uml/fig129669.png]]
@@ -767,7 +767,7 @@ config.macros.timeline.handler = function(place,macroName,params,wikifier,paramS
 On the implementation side, we use a special kind of MObject, acting as an anchor and providing an unique identity. Like any ~MObject, actually a placement establishes the connection and the scope, and typically constitutes a nested scope (e.g. the scope of all objects //within// the sequence to be bound into a timeline)
 </pre>
 </div>
-<div title="BuildProcess" modifier="Ichthyostega" modified="200805300042" created="200706190658" tags="dynamic Builder" changecount="29">
+<div title="BuildProcess" modifier="Ichthyostega" modified="200906071813" created="200706190658" tags="dynamic Builder img" changecount="30">
 <pre>All decisions on //how // the RenderProcess has to be carried out are concentrated in this rather complicated Builder Subsystem. The benefit of this approach is, besides decoupling of subsystems, to keep the actual performance-intensive video processing code as simple and transparent as possible. The price, in terms of increased complexity &amp;mdash; to pay in the Builder &amp;mdash; can be handled by making the Build Process generic to a large degree. Using a Design By Contract approach we can decompose the various decisions into small decision modules without having to trace the actual workings of the Build Process as a whole.
 
 [&gt;img[Outline of the Build Process|uml/fig129413.png]]
@@ -894,7 +894,7 @@ Any wiring (outside the chain of effects within a pipe) is always done from exit
 @@clear(right):display(block):@@
 </pre>
 </div>
-<div title="BuilderStructures" modifier="Ichthyostega" modified="200805210227" created="200706250734" tags="overview design Builder" changecount="21">
+<div title="BuilderStructures" modifier="Ichthyostega" modified="200906071812" created="200706250734" tags="overview design Builder img" changecount="22">
 <pre>* the MObjects implement //Buildable//
 * each Buildable can &quot;receive&quot; a Tool object and apply it
 * the different Tool objects are iterated/mapped onto the list of MObjects in the [[Timeline]]
@@ -1193,7 +1193,7 @@ Basically, each elementary operation has to record the informations necessary to
 {{red{to be defined in more detail later...}}}
 </pre>
 </div>
-<div title="Example1" modifier="Ichthyostega" modified="200806291628" created="200706220239" tags="example" changecount="4">
+<div title="Example1" modifier="Ichthyostega" modified="200906071812" created="200706220239" tags="example img" changecount="5">
 <pre>The &amp;raquo;Timeline&amp;laquo; is a sequence of ~MObjects -- here clips -- together with an ExplicitPlacement, locating each clip at a given time and track. (Note: I simplified the time format and wrote frame numbers to make it more clear)
 [img[Example1: Objects in the EDL/Fixture|uml/fig128773.png]]
 
@@ -1203,7 +1203,7 @@ After beeing processed by the Builder, we get the following Render Engine config
 [img[Example1: generated Render Engine|uml/fig129029.png]]
 </pre>
 </div>
-<div title="Example2" modifier="Ichthyostega" modified="200806291627" created="200706220251" tags="example" changecount="3">
+<div title="Example2" modifier="Ichthyostega" modified="200906071812" created="200706220251" tags="example img" changecount="4">
 <pre>{{red{TODO: seemingly this example is slightly outdated, as the implementation of placements is now indirect via LocatingPin objects}}}
 This Example showes the //high level// EDL as well. This needs to be transformed into a Fixture by some facility still to be designed. Basically, each [[Placement]] needs to be queried for this to get the corresponding ExplicitPlacement. The difficult part is to handle possible Placement constraints, e.g. one clip can't be placed at a timespan covered by another clip on the same track. In the current Cinelerra2, all of this is done directly by the GUI actions.
 
@@ -1439,7 +1439,7 @@ Now, when invoking an operation on some public interface, the code in the lower
 <pre>A specially configured LumieraPlugin, which actually contains or loads the complete code of the (GTK)GUI, and additionally is linked dynamically against the application core lib. During the [[UI startup process|GuiStart]], loading of this Plugin is triggered from {{{main()}}}. Actually this causes spawning of the GTK event thread and execution of the GTK main loop.
 </pre>
 </div>
-<div title="HighLevelModel" modifier="Ichthyostega" modified="200808160329" created="200808152311" tags="spec design discuss" changecount="32">
+<div title="HighLevelModel" modifier="Ichthyostega" modified="200906071811" created="200808152311" tags="spec design discuss img" changecount="33">
 <pre>While the low-level model holds the data used for carrying out the actual media data processing (=rendering), the high-level model is what the user works upon when performing edit operations through the GUI (or script driven in &amp;raquo;headless mode&amp;laquo;). Its building blocks and combination rules determine largely what structures can be created within the [[Session]].
 On the whole, it is a collection of [[media objects|MObjects]] stuck together and arranged by [[placements|Placement]].
 
@@ -1856,7 +1856,7 @@ From experiences with other middle scale projects, I prefer having the test code
 
 </pre>
 </div>
-<div title="InterfacesSession" modifier="Ichthyostega" modified="200708081535" created="200708080639" changecount="7">
+<div title="InterfacesSession" modifier="Ichthyostega" modified="200906071811" created="200708080639" tags="img" changecount="8">
 <pre>* Subdir src/proc contains Interface within namespace proc_interface
 * Subdir src/proc/mobject contains commonly used entities (namespace mobject)
 ** nested namespace controller
@@ -1967,7 +1967,7 @@ Presumably, none of the both models is usable as-is; rather we try to reconstruc
 {{red{WIP}}}
 </pre>
 </div>
-<div title="MObjects" modifier="Ichthyostega" modified="200905130116" created="200706190636" tags="overview" changecount="15">
+<div title="MObjects" modifier="Ichthyostega" modified="200906071811" created="200706190636" tags="overview img" changecount="17">
 <pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects |MObject]](&amp;rarr; def) being:
 * audio/video clips
 * effects and plugins
@@ -2024,7 +2024,7 @@ __10/2008__: the allocation mechanism can surely be improved later, but for now
 
 &lt;style type=&quot;text/css&quot;&gt;#contentWrapper {display:none;}&lt;/style&gt;&lt;div id=&quot;SplashScreen&quot; style=&quot;border: 3px solid #ccc; display: block; text-align: center; width: 320px; margin: 100px auto; padding: 50px; color:#000; font-size: 28px; font-family:Tahoma; background-color:#eee;&quot;&gt;loading &lt;b&gt;Proc-Layer&lt;/b&gt; devel doku&lt;blink&gt; ...&lt;/blink&gt;&lt;br&gt;&lt;br&gt;&lt;span style=&quot;font-size: 14px; color:red;&quot;&gt;Requires Javascript.&lt;/span&gt;&lt;/div&gt;</pre>
 </div>
-<div title="MediaAsset" modifier="Ichthyostega" modified="200806030152" created="200709021530" tags="def classes" changecount="7">
+<div title="MediaAsset" modifier="Ichthyostega" modified="200906071810" created="200709021530" tags="def classes img" changecount="8">
 <pre>The Interface asset::Media is a //key abstraction// It ties together several concepts and enables to deal with them on the interfaces in a uniform manner. Besides, as every Asset kind it belongs rather to the bookkeeping view: an asset::Media holds the specific properties and parametrisation of the media source it stands for. Regarding the __inward interface__ &amp;mdash; as used from within the [[EDL]] or the [[Render Nodes|ProcNode]], it is irrelevant if any given asset::Media object stands for a complete media source, just a clip taken from this source or if a placeholder version of the real media source is used instead.
 [img[Asset Classess|uml/fig130437.png]]
 
@@ -2173,7 +2173,7 @@ The operation point is provided by the current BuilderMould and used by the [[pr
 This is possible because the operation point has been provided (by the mould) with informations about the media stream type to be wired, which, together with information accessible at the the [[render node interface|ProcNode]] and from the [[referred processing assets|ProcAsset]], with the help of the [[connection manager|ConManager]] allows to figure out what's possible and how to do the desired connections.
 </pre>
 </div>
-<div title="Overview" modifier="Ichthyostega" modified="200804130018" created="200706190300" tags="overview" changecount="12">
+<div title="Overview" modifier="Ichthyostega" modified="200906071810" created="200706190300" tags="overview img" changecount="13">
 <pre>The Lumiera Processing Layer is comprised of various subsystems and can be separated into a low-level and a high-level part. At the low-level end is the [[Render Engine|OverviewRenderEngine]] which basically is a network of render nodes cooperating closely with the Backend Layer in order to carry out the actual playback and media transforming calculations. Whereas on the high-level side we find several different [[Media Objects|MObjects]] that can be placed into the [[EDL]], edited and manipulated. This is complemented by the [[Asset Management|Asset]], which is the &quot;bookkeeping view&quot; of all the different &quot;things&quot; within each [[Session|SessionOverview]].
 
 There is rather strong separation between these two levels, and &amp;mdash; &lt;br/&gt;correspondingly you'll encounter the data held within the Processing Layer organized in two different views, the ''high-level-model'' and the ''low-level-model''
@@ -2183,7 +2183,7 @@ There is rather strong separation between these two levels, and &amp;mdash; &lt;
 [img[Block Diagram|uml/fig128005.png]]
 </pre>
 </div>
-<div title="OverviewRenderEngine" modifier="Ichthyostega" modified="200806010250" created="200706190647" tags="Rendering overview" changecount="19">
+<div title="OverviewRenderEngine" modifier="Ichthyostega" modified="200906071810" created="200706190647" tags="Rendering overview img" changecount="20">
 <pre>Render Engine, [[Builder]] and [[Controller]] are closely related Subsystems. Actually, the [[Builder]] //creates// a newly configured Render Engine //for every// RenderProcess. Before doing so, it queries from the Session (or, to be more precise, from the [[Fixture]] within the current Session) all necessary Media Object Placement information. The [[Builder]] then derives from this information the actual assembly of [[Processing Nodes|ProcNode]] comprising the Render Engine. Thus:
  * the source of the build process is a sequence of absolute (explicit) [[Placements|Placement]] called the [[Playlist]]
  * the [[build process|BuildProcess]] is driven, configured and controlled by the [[Controller]] subsystem component. It encompasses the actual playback configuration and State of the System.
@@ -3017,7 +3017,7 @@ This is a difficult untertaking, because there are several dependencies (most of
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
-<div title="PlayerDummy" modifier="Ichthyostega" modified="200902090408" created="200901300209" tags="GuiIntegration dynamic" changecount="16">
+<div title="PlayerDummy" modifier="Ichthyostega" modified="200906071810" created="200901300209" tags="GuiIntegration dynamic img" changecount="17">
 <pre>__Joelholdsworth__ and __Ichthyo__ created this player mockup in 1/2009 to find out about the implementation details regarding integration and colaboration between the layers. There is no working render engine yet, thus we use a ~DummyImageGenerator for creating faked yuv frames to display. Within the GUI, there is a ~PlaybackController hooked up with the transport controls on the timeline pane.
 # first everything was contained within ~PlaybackController, which spawns a thread for periodically creating those dummy frames
 # then, a ~PlayerService was factored out, now implemented within Proc-Layer (probably to be relocated into the backend for the final version). A new LayerSeparationInterface called ''~DummyPlayer'' was created and set up as a [[Subsystem]] within main().
@@ -3089,7 +3089,7 @@ We need to work out guidelines for dealing with operations going on simultaneous
 
 While the Backend is responsible for Data access and management and for carrying out the computation intensive media opteratons, the middle Layer or ~Proc-Layer contains [[assets|Asset]] and [[Session]], i.e. the user-visible data model and provides configuration and behaviour for these entities. Besides, he is responsible for [[building and configuring|Builder]] the [[render engine|RenderEngine]] based on the current Session state.</pre>
 </div>
-<div title="ProcAsset" modifier="Ichthyostega" created="200709221343" tags="def classes" changecount="1">
+<div title="ProcAsset" modifier="Ichthyostega" modified="200906071810" created="200709221343" tags="def classes img" changecount="2">
 <pre>All Assets of kind asset::Proc represent //processing algorithms// in the bookkeeping view. They enable loading, browsing and maybe even parametrizing all the Effects, Plugins and Codecs available for use within the Lumiera Session.
 
 Besides, they provide an important __inward interface__ for the [[ProcNode]]s, which will use these asset entries to dispatch the actual processing call when rendering. 
@@ -3438,7 +3438,7 @@ At first sight the link between asset and clip-MO is a simple logical relation b
 &amp;rarr; OverviewRenderEngine
 </pre>
 </div>
-<div title="RenderEntities" modifier="Ichthyostega" modified="200806010249" created="200706190715" tags="Rendering classes" changecount="9">
+<div title="RenderEntities" modifier="Ichthyostega" modified="200906071810" created="200706190715" tags="Rendering classes img" changecount="10">
 <pre>The [[Render Engine|Rendering]] only carries out the low-level and performance critical tasks. All configuration and decision concerns are to be handled by [[Builder]] and [[Controller]]. While the actual connection of the Render Nodes can be highly complex, basically each Segment of the Timeline with uniform characteristics is handled by one Processor, which is a graph of [[Processing Nodes|ProcNode]] discharging into a ExitNode. The Render Engine Components as such are //stateless// themselves; for the actual calculations they are combined with a StateProxy object generated by and connected internally to the [[Controller]], while at the same time holding the Data Buffers (Frames) for the actual calculations.
 
 [img[Entities comprising the Render Engine|uml/fig128389.png]]
@@ -3480,7 +3480,7 @@ We //do employ//&amp;nbsp; some virtual calls for the buffer management in order
 @@clear(right):display(block):@@
 </pre>
 </div>
-<div title="RenderMechanics" modifier="Ichthyostega" modified="200806280029" created="200806030230" tags="Rendering impl dynamic" changecount="27">
+<div title="RenderMechanics" modifier="Ichthyostega" modified="200906071809" created="200806030230" tags="Rendering impl dynamic img" changecount="28">
 <pre>While the render process, with respect to the dependencies, the builder and the processing function is sufficiently characterized by referring to the ''pull principle'' and by defining a [[protocol|NodeOperationProtocol]] each node has to adhere to &amp;mdash; for actually get it coded we have to care for some important details, especially //how to manage the buffers.// It may well be that the length of the code path necessary to invoke the individual processing functions is finally not so important, compared with the time spent at the inner pixel loop within these functions. But my guess is (as of 5/08), that the overall number of data moving and copying operations //will be//&amp;nbsp; of importance.
 
 !requirements
@@ -3894,7 +3894,7 @@ Instead, we should try to just connect the various subsystems via Interfaces and
 * to shield the rendering code of all complexities of thread communication and synchronization, we use the StateProxy
 </pre>
 </div>
-<div title="StructAsset" modifier="Ichthyostega" modified="200801101402" created="200709221353" tags="def classes" changecount="8">
+<div title="StructAsset" modifier="Ichthyostega" modified="200906071813" created="200709221353" tags="def classes img" changecount="9">
 <pre>Structural Assets are intended mainly for internal use, but the user should be able to see and query them. They are not &quot;loaded&quot; or &quot;created&quot; direcly, rather they //leap into existance // by creating or extending some other structures in the EDL/Session, hence the name. Some of the structural Asset parametrisation can be modified to control of some aspects of the Proc Layer's (default) behaviour.
 * [[Processing Patterns|ProcPatt]] encode information how to set up some parts of the render network to be created automatically: for example, when building a clip, we use the processing pattern how to decode and preprocess the actual media data.
 * [[Tracks|Track]] are one of the dimensions used for organizing the EDL. They serve as an Anchor to attach parametrisation of output pipe, overlay mode etc. By [[placing|Placement]] to a track, some media object inherits placement properties from this track.

From 529d4bd45929b9d009e5bac71bab6d0855fc9df9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 8 Jun 2009 03:50:02 +0200
Subject: [PATCH 093/368] Planning / Design: Session interface, Commands

---
 doc/devel/uml/class141957.html       |   3 +-
 doc/devel/uml/class148485.html       |  40 +++
 doc/devel/uml/class148613.html       |  24 ++
 doc/devel/uml/class148741.html       |  22 ++
 doc/devel/uml/class148869.html       |  25 ++
 doc/devel/uml/class148997.html       |  26 ++
 doc/devel/uml/class149125.html       |  22 ++
 doc/devel/uml/class149253.html       |  22 ++
 doc/devel/uml/class149381.html       |  22 ++
 doc/devel/uml/class149509.html       |  22 ++
 doc/devel/uml/class149637.html       |  20 ++
 doc/devel/uml/classdiagrams.html     |   1 +
 doc/devel/uml/classes.html           |  12 +-
 doc/devel/uml/classes_list.html      |  10 +
 doc/devel/uml/fig134021.png          | Bin 0 -> 23301 bytes
 doc/devel/uml/index.html             |  25 +-
 doc/devel/uml/index_67.html          |  48 +--
 doc/devel/uml/index_68.html          |   5 +-
 doc/devel/uml/index_69.html          |   1 +
 doc/devel/uml/index_72.html          |   3 +-
 doc/devel/uml/index_73.html          |   3 +-
 doc/devel/uml/index_77.html          |   3 +-
 doc/devel/uml/index_78.html          |   1 +
 doc/devel/uml/index_80.html          |   1 +
 doc/devel/uml/index_82.html          |   1 +
 doc/devel/uml/index_83.html          |   4 +-
 doc/devel/uml/index_84.html          |   8 +-
 doc/devel/uml/index_85.html          |   4 +
 doc/devel/uml/packages.html          |   2 +-
 doc/devel/uml/public_operations.html |   1 +
 doc/devel/uml/public_properties.html |   4 +
 uml/lumiera/128261                   |  17 +-
 uml/lumiera/129029                   | 433 +++++++++++++++++++++++++--
 uml/lumiera/134021.diagram           | 146 +++++++++
 uml/lumiera/lumiera.prj              |   4 +-
 wiki/renderengine.html               |  60 +++-
 36 files changed, 962 insertions(+), 83 deletions(-)
 create mode 100644 doc/devel/uml/class148485.html
 create mode 100644 doc/devel/uml/class148613.html
 create mode 100644 doc/devel/uml/class148741.html
 create mode 100644 doc/devel/uml/class148869.html
 create mode 100644 doc/devel/uml/class148997.html
 create mode 100644 doc/devel/uml/class149125.html
 create mode 100644 doc/devel/uml/class149253.html
 create mode 100644 doc/devel/uml/class149381.html
 create mode 100644 doc/devel/uml/class149509.html
 create mode 100644 doc/devel/uml/class149637.html
 create mode 100644 doc/devel/uml/fig134021.png
 create mode 100644 uml/lumiera/134021.diagram

diff --git a/doc/devel/uml/class141957.html b/doc/devel/uml/class141957.html
index 9158a22a5..6ad99d6c7 100644
--- a/doc/devel/uml/class141957.html
+++ b/doc/devel/uml/class141957.html
@@ -16,5 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass141957"></a>
-<p>Declaration :</p><ul><li>C++ : class ProcDispatcher </li></ul><p>Component(s) : <a href="index.html#refcomponent128773"><b>Dispatcher</b></a></p></body>
+<p>Declaration :</p><ul><li>C++ : class ProcDispatcher </li></ul><p>Component(s) : <a href="index.html#refcomponent128773"><b>Dispatcher</b></a></p><p>Stereotype: control</p>
+</body>
 </html>
diff --git a/doc/devel/uml/class148485.html b/doc/devel/uml/class148485.html
new file mode 100644
index 000000000..ea2fc33b3
--- /dev/null
+++ b/doc/devel/uml/class148485.html
@@ -0,0 +1,40 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class Command</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class Command</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass148485"></a>
+<p>Key abstraction for all proc/edit operations and UNDO management<br /></p><p>Declaration :</p><ul><li>C++ : class Command </li><li>Java : public interface Command </li><li>Php : public interface Command </li></ul><p>Stereotype: interface</p>
+<div class="sub">
+<a name="refattribute132613"></a>
+<table><tr><td><div class="element">Attribut <b>ID</b></div></td></tr></table>
+<p>Declaration :</p><ul><li>Uml : + ID : </li><li>C++ : public: const  ID</li></ul><a name="refattribute132741"></a>
+<table><tr><td><div class="element">Attribut <b>name</b></div></td></tr></table>
+<p>Declaration :</p><ul><li>Uml : + name : Symbol</li><li>C++ : public: const Symbol name</li></ul><a name="refattribute132869"></a>
+<table><tr><td><div class="element">Attribut <b>do</b></div></td></tr></table>
+<p>Declaration :</p><ul><li>Uml : + do : <a href="class148741.html#refclass148741"><b>Mutation</b></a></li><li>C++ : public: <a href="class148741.html#refclass148741"><b>Mutation</b></a> do</li></ul><a name="refattribute132997"></a>
+<table><tr><td><div class="element">Attribut <b>undo</b></div></td></tr></table>
+<p>Declaration :</p><ul><li>Uml : + undo : <a href="class148869.html#refclass148869"><b>UndoMutation</b></a></li><li>C++ : public: <a href="class148869.html#refclass148869"><b>UndoMutation</b></a> undo</li></ul><a name="refattribute133125"></a>
+<table><tr><td><div class="element">Attribut <b>closure</b></div></td></tr></table>
+<p>Declaration :</p><ul><li>Uml : - closure : <a href="class148997.html#refclass148997"><b>CmdClosure</b></a></li><li>C++ : private: <a href="class148997.html#refclass148997"><b>CmdClosure</b></a> closure</li></ul><a name="refoperation137733"></a>
+<table><tr><td><div class="element">Operation <b>execute</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : + execute(in context : HandlingPattern) : void</li><li>C++ : public: void execute () </li></ul><a name="refrelation172805"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class148997.html#refclass148997"><b>CmdClosure</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class148997.html#refclass148997"><b>CmdClosure</b></a>* </li></ul><p>Stereotype: has_a</p>
+<a name="refrelation173189"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class148741.html#refclass148741"><b>Mutation</b></a></li><li>C++ : protected: <a href="class148741.html#refclass148741"><b>Mutation</b></a>* </li></ul><p>Stereotype: has_a</p>
+<a name="refrelation173317"></a>
+<table><tr><td><div class="element">Relation <b>&lt;unidirectional association&gt;</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : #  : <a href="class148869.html#refclass148869"><b>UndoMutation</b></a></li><li>C++ : protected: <a href="class148869.html#refclass148869"><b>UndoMutation</b></a>* </li></ul></div>
+<p>All public operations : <a href="class148485.html#refoperation137733"><b>execute</b></a> </p>
+</body>
+</html>
diff --git a/doc/devel/uml/class148613.html b/doc/devel/uml/class148613.html
new file mode 100644
index 000000000..5af4f3e1d
--- /dev/null
+++ b/doc/devel/uml/class148613.html
@@ -0,0 +1,24 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class HandlingPattern</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class HandlingPattern</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass148613"></a>
+<p>Declaration :</p><ul><li>C++ : class HandlingPattern </li></ul><p>Directly inherited by : <a href="class149253.html#refclass149253"><b>DoAsync</b></a> <a href="class149125.html#refclass149125"><b>DoSync</b></a> <a href="class149509.html#refclass149509"><b>RedoLast</b></a> <a href="class149381.html#refclass149381"><b>UndoSync</b></a> </p>
+<p>Stereotype: interface</p>
+<div class="sub">
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class148741.html b/doc/devel/uml/class148741.html
new file mode 100644
index 000000000..0026a259f
--- /dev/null
+++ b/doc/devel/uml/class148741.html
@@ -0,0 +1,22 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class Mutation</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class Mutation</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass148741"></a>
+<p>Declaration :</p><ul><li>C++ : class Mutation </li></ul><p>Directly inherited by : <a href="class148869.html#refclass148869"><b>UndoMutation</b></a> </p>
+<p>Stereotype: func</p>
+</body>
+</html>
diff --git a/doc/devel/uml/class148869.html b/doc/devel/uml/class148869.html
new file mode 100644
index 000000000..7e0586b00
--- /dev/null
+++ b/doc/devel/uml/class148869.html
@@ -0,0 +1,25 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class UndoMutation</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class UndoMutation</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass148869"></a>
+<p>Declaration :</p><ul><li>C++ : class UndoMutation : public <a href="class148741.html#refclass148741"><b>Mutation</b></a> </li></ul><p>Stereotype: func</p>
+<div class="sub">
+<a name="refrelation172933"></a>
+<table><tr><td><div class="element">Relation <b>capture (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # capture : <a href="class148741.html#refclass148741"><b>Mutation</b></a></li><li>C++ : protected: <a href="class148741.html#refclass148741"><b>Mutation</b></a>* capture</li></ul><a name="refrelation173061"></a>
+<table><tr><td><div class="element">Relation <b>undoOp (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # undoOp : <a href="class148741.html#refclass148741"><b>Mutation</b></a></li><li>C++ : protected: <a href="class148741.html#refclass148741"><b>Mutation</b></a>* undoOp</li></ul></div>
+</body>
+</html>
diff --git a/doc/devel/uml/class148997.html b/doc/devel/uml/class148997.html
new file mode 100644
index 000000000..85ab6a55d
--- /dev/null
+++ b/doc/devel/uml/class148997.html
@@ -0,0 +1,26 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class CmdClosure</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class CmdClosure</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass148997"></a>
+<p>Declaration :</p><ul><li>C++ : class CmdClosure </li></ul><div class="sub">
+<a name="refrelation172549"></a>
+<table><tr><td><div class="element">Relation <b>targets (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # targets : <a href="class149637.html#refclass149637"><b>Target</b></a></li><li>C++ : protected: <a href="class149637.html#refclass149637"><b>Target</b></a> targets</li></ul><p>Stereotype: list</p>
+<a name="refrelation172677"></a>
+<table><tr><td><div class="element">Relation <b>params (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # params : <a href="class134533.html#refclass134533"><b>Parameter</b></a></li><li>C++ : protected: <a href="class134533.html#refclass134533"><b>Parameter</b></a> params</li></ul><p>Stereotype: list</p>
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class149125.html b/doc/devel/uml/class149125.html
new file mode 100644
index 000000000..9426554d2
--- /dev/null
+++ b/doc/devel/uml/class149125.html
@@ -0,0 +1,22 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class DoSync</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class DoSync</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass149125"></a>
+<p>Declaration :</p><ul><li>C++ : class DoSync : public <a href="class148613.html#refclass148613"><b>HandlingPattern</b></a> </li></ul><div class="sub">
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class149253.html b/doc/devel/uml/class149253.html
new file mode 100644
index 000000000..0bc1f1ae6
--- /dev/null
+++ b/doc/devel/uml/class149253.html
@@ -0,0 +1,22 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class DoAsync</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class DoAsync</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass149253"></a>
+<p>Declaration :</p><ul><li>C++ : class DoAsync : public <a href="class148613.html#refclass148613"><b>HandlingPattern</b></a> </li></ul><div class="sub">
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class149381.html b/doc/devel/uml/class149381.html
new file mode 100644
index 000000000..72a009390
--- /dev/null
+++ b/doc/devel/uml/class149381.html
@@ -0,0 +1,22 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class UndoSync</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class UndoSync</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass149381"></a>
+<p>Declaration :</p><ul><li>C++ : class UndoSync : public <a href="class148613.html#refclass148613"><b>HandlingPattern</b></a> </li></ul><div class="sub">
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class149509.html b/doc/devel/uml/class149509.html
new file mode 100644
index 000000000..e5c2ee5ab
--- /dev/null
+++ b/doc/devel/uml/class149509.html
@@ -0,0 +1,22 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class RedoLast</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class RedoLast</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass149509"></a>
+<p>Declaration :</p><ul><li>C++ : class RedoLast : public <a href="class148613.html#refclass148613"><b>HandlingPattern</b></a> </li></ul><div class="sub">
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class149637.html b/doc/devel/uml/class149637.html
new file mode 100644
index 000000000..da4da6a27
--- /dev/null
+++ b/doc/devel/uml/class149637.html
@@ -0,0 +1,20 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class Target</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class Target</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass149637"></a>
+<p>Declaration :</p><ul><li>C++ : class Target </li></ul></body>
+</html>
diff --git a/doc/devel/uml/classdiagrams.html b/doc/devel/uml/classdiagrams.html
index 8e9652413..bfd20dbab 100644
--- a/doc/devel/uml/classdiagrams.html
+++ b/doc/devel/uml/classdiagrams.html
@@ -20,6 +20,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129669" target = "projectFrame"><b>Automation Entities</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132868" target = "projectFrame"><b>Builder Entities</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129285" target = "projectFrame"><b>Builder Tool (Visitor)</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram134021" target = "projectFrame"><b>Command structure</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128645" target = "projectFrame"><b>Controller Entities</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128181" target = "projectFrame"><b>File Mapping</b></a></td><td></td><td>Shows whats used to access Frames</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram130181" target = "projectFrame"><b>Hierarchy</b></a></td><td></td><td>Lumiera Exception hierarchy</td></tr>
diff --git a/doc/devel/uml/classes.html b/doc/devel/uml/classes.html
index b30de8c8b..8c54eb58f 100644
--- a/doc/devel/uml/classes.html
+++ b/doc/devel/uml/classes.html
@@ -38,8 +38,10 @@
 <tr bgcolor=#f0f0f0><td><a href="class137221.html#refclass137221" target = "projectFrame"><b>Category</b></a></td><td></td><td>tree like classification of Assets</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a></td><td></td><td>bookkeeping (asset) view of a media clip.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148997.html#refclass148997" target = "projectFrame"><b>CmdClosure</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a></td><td></td><td>description of some media data decoder or encoder facility</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135045.html#refclass135045" target = "projectFrame"><b>CodecAdapter</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refclass148485" target = "projectFrame"><b>Command</b></a></td><td>interface</td><td>Key abstraction for all proc/edit operations and UNDO management</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class138629.html#refclass138629" target = "projectFrame"><b>CompoundClip</b></a></td><td></td><td>Clip MObject which is actually a compound of several elementary clips,<br />e.g. the several streams found within multichannels media.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class138501.html#refclass138501" target = "projectFrame"><b>CompoundMedia</b></a></td><td></td><td>compound of several elementary media tracks,<br />e.g. the individual media streams found in one media file</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128266.html#refclass128266" target = "projectFrame"><b>Condition</b></a></td><td></td><td>I provided a reworked Condition class in my Cinelerra2 repository</td></tr>
@@ -52,8 +54,10 @@
 <tr bgcolor=#f0f0f0><td><a href="class138373.html#refclass138373" target = "projectFrame"><b>DB</b></a></td><td></td><td>Implementation of the registry holding all Asset instances known to the Asset Manager subsystem. As of 8/2007 implemented by a hashtable.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141445.html#refclass141445" target = "projectFrame"><b>DefaultsManager</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141573.html#refclass141573" target = "projectFrame"><b>DefaultsRegistry</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149253.html#refclass149253" target = "projectFrame"><b>DoAsync</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139141.html#refclass139141" target = "projectFrame"><b>DoAttach</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139269.html#refclass139269" target = "projectFrame"><b>DoRecurse</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149125.html#refclass149125" target = "projectFrame"><b>DoSync</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137733.html#refclass137733" target = "projectFrame"><b>Effect</b></a></td><td></td><td>Effect or media processing component</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129029.html#refclass129029" target = "projectFrame"><b>Effect</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135557.html#refclass135557" target = "projectFrame"><b>Error</b></a></td><td></td><td></td></tr>
@@ -77,6 +81,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class128949.html#refclass128949" target = "projectFrame"><b>FrameDescriptor</b></a></td><td>interface</td><td>A FrameDescriptor implements the higher level interfaces for frames. Further refinements are made by subclassing and policy classes</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128225.html#refclass128225" target = "projectFrame"><b>FrameReference</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133637.html#refclass133637" target = "projectFrame"><b>GLBuf</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148613.html#refclass148613" target = "projectFrame"><b>HandlingPattern</b></a></td><td>interface</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145029.html#refclass145029" target = "projectFrame"><b>ImplFacade</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class147205.html#refclass147205" target = "projectFrame"><b>InstanceHandle</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134789.html#refclass134789" target = "projectFrame"><b>Interpolator</b></a></td><td></td><td>Provides the implementation for getting the acutal value of a time varying or automated effect/plugin parameter</td></tr>
@@ -97,6 +102,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class129157.html#refclass129157" target = "projectFrame"><b>Meta</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128517.html#refclass128517" target = "projectFrame"><b>MObject</b></a></td><td>interface</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class146053.html#refclass146053" target = "projectFrame"><b>Monitor</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148741.html#refclass148741" target = "projectFrame"><b>Mutation</b></a></td><td>func</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128394.html#refclass128394" target = "projectFrame"><b>Mutex</b></a></td><td></td><td>I provided a reworked Mutex class in my Cinelerra2 repository</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134405.html#refclass134405" target = "projectFrame"><b>NodeCreatorTool</b></a></td><td></td><td>This Tool implementation plays the central role in the buld process: given a MObject from Session, it is able to attach ProcNodes to the render engine under construction such as to reflect the properties of the MObject in the actual render.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143365.html#refclass143365" target = "projectFrame"><b>NodeWiring</b></a></td><td></td><td></td></tr>
@@ -113,7 +119,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class129077.html#refclass129077" target = "projectFrame"><b>Prefetch</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137605.html#refclass137605" target = "projectFrame"><b>Preview</b></a></td><td></td><td>alternative version of the media data, probably with lower resolution</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136837.html#refclass136837" target = "projectFrame"><b>Proc</b></a></td><td></td><td>key abstraction: data processing asset</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class141957.html#refclass141957" target = "projectFrame"><b>ProcDispatcher</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class141957.html#refclass141957" target = "projectFrame"><b>ProcDispatcher</b></a></td><td>control</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class144389.html#refclass144389" target = "projectFrame"><b>ProcessData</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131717.html#refclass131717" target = "projectFrame"><b>ProcNode</b></a></td><td>interface</td><td>Key abstraction of the Render Engine: A Data processing Node</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class138757.html#refclass138757" target = "projectFrame"><b>ProcPatt</b></a></td><td></td><td>special type of structural Asset representing information how to build some part of the render engine's processing nodes network.</td></tr>
@@ -126,6 +132,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class140677.html#refclass140677" target = "projectFrame"><b>QueryHandler</b></a></td><td>interface</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141189.html#refclass141189" target = "projectFrame"><b>QueryHandlerImpl</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143877.html#refclass143877" target = "projectFrame"><b>ReadSource</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149509.html#refclass149509" target = "projectFrame"><b>RedoLast</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129413.html#refclass129413" target = "projectFrame"><b>RelativeLocation</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133893.html#refclass133893" target = "projectFrame"><b>RelType</b></a></td><td>enum</td><td>the possible kinds of RelativePlacements</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131333.html#refclass131333" target = "projectFrame"><b>RenderEngine</b></a></td><td></td><td></td></tr>
@@ -157,6 +164,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class145157.html#refclass145157" target = "projectFrame"><b>StreamTypeID</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136965.html#refclass136965" target = "projectFrame"><b>Struct</b></a></td><td></td><td>key abstraction: structural asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145413.html#refclass145413" target = "projectFrame"><b>STypeManager</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149637.html#refclass149637" target = "projectFrame"><b>Target</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128138.html#refclass128138" target = "projectFrame"><b>Thread</b></a></td><td></td><td>We can basically reuse the Thread class design from Cinelerra2, Thread becomes a baseclass for all Threads </td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134917.html#refclass134917" target = "projectFrame"><b>Time</b></a></td><td></td><td>denotes a temporal position (time point), based on timeline start.<br /><br />investigate posix.4 realtime timers, wrap these here</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145541.html#refclass145541" target = "projectFrame"><b>Timeline</b></a></td><td></td><td></td></tr>
@@ -168,6 +176,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class131845.html#refclass131845" target = "projectFrame"><b>Trafo</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140805.html#refclass140805" target = "projectFrame"><b>TypeHandler</b></a></td><td>interface</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141317.html#refclass141317" target = "projectFrame"><b>TypeHandler&lt;Pipe&gt;</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148869.html#refclass148869" target = "projectFrame"><b>UndoMutation</b></a></td><td>func</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149381.html#refclass149381" target = "projectFrame"><b>UndoSync</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137477.html#refclass137477" target = "projectFrame"><b>Unknown</b></a></td><td></td><td>placeholder for unknown or unavailable media source</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141701.html#refclass141701" target = "projectFrame"><b>User</b></a></td><td>actor</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133509.html#refclass133509" target = "projectFrame"><b>VFrame</b></a></td><td></td><td></td></tr>
diff --git a/doc/devel/uml/classes_list.html b/doc/devel/uml/classes_list.html
index 94c71e519..c9f7a4cd0 100644
--- a/doc/devel/uml/classes_list.html
+++ b/doc/devel/uml/classes_list.html
@@ -39,8 +39,10 @@
 <a href="class137221.html#refclass137221" target = "projectFrame"><b>Category</b></a><br />
 <a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a><br />
 <a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a><br />
+<a href="class148997.html#refclass148997" target = "projectFrame"><b>CmdClosure</b></a><br />
 <a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a><br />
 <a href="class135045.html#refclass135045" target = "projectFrame"><b>CodecAdapter</b></a><br />
+<a href="class148485.html#refclass148485" target = "projectFrame"><b>Command</b></a><br />
 <a href="class138629.html#refclass138629" target = "projectFrame"><b>CompoundClip</b></a><br />
 <a href="class138501.html#refclass138501" target = "projectFrame"><b>CompoundMedia</b></a><br />
 <a href="class128266.html#refclass128266" target = "projectFrame"><b>Condition</b></a><br />
@@ -53,8 +55,10 @@
 <a href="class138373.html#refclass138373" target = "projectFrame"><b>DB</b></a><br />
 <a href="class141445.html#refclass141445" target = "projectFrame"><b>DefaultsManager</b></a><br />
 <a href="class141573.html#refclass141573" target = "projectFrame"><b>DefaultsRegistry</b></a><br />
+<a href="class149253.html#refclass149253" target = "projectFrame"><b>DoAsync</b></a><br />
 <a href="class139141.html#refclass139141" target = "projectFrame"><b>DoAttach</b></a><br />
 <a href="class139269.html#refclass139269" target = "projectFrame"><b>DoRecurse</b></a><br />
+<a href="class149125.html#refclass149125" target = "projectFrame"><b>DoSync</b></a><br />
 <a href="class137733.html#refclass137733" target = "projectFrame"><b>Effect</b></a><br />
 <a href="class129029.html#refclass129029" target = "projectFrame"><b>Effect</b></a><br />
 <a href="class135557.html#refclass135557" target = "projectFrame"><b>Error</b></a><br />
@@ -78,6 +82,7 @@
 <a href="class128949.html#refclass128949" target = "projectFrame"><b>FrameDescriptor</b></a><br />
 <a href="class128225.html#refclass128225" target = "projectFrame"><b>FrameReference</b></a><br />
 <a href="class133637.html#refclass133637" target = "projectFrame"><b>GLBuf</b></a><br />
+<a href="class148613.html#refclass148613" target = "projectFrame"><b>HandlingPattern</b></a><br />
 <a href="class145029.html#refclass145029" target = "projectFrame"><b>ImplFacade</b></a><br />
 <a href="class147205.html#refclass147205" target = "projectFrame"><b>InstanceHandle</b></a><br />
 <a href="class134789.html#refclass134789" target = "projectFrame"><b>Interpolator</b></a><br />
@@ -98,6 +103,7 @@
 <a href="class129157.html#refclass129157" target = "projectFrame"><b>Meta</b></a><br />
 <a href="class128517.html#refclass128517" target = "projectFrame"><b>MObject</b></a><br />
 <a href="class146053.html#refclass146053" target = "projectFrame"><b>Monitor</b></a><br />
+<a href="class148741.html#refclass148741" target = "projectFrame"><b>Mutation</b></a><br />
 <a href="class128394.html#refclass128394" target = "projectFrame"><b>Mutex</b></a><br />
 <a href="class134405.html#refclass134405" target = "projectFrame"><b>NodeCreatorTool</b></a><br />
 <a href="class143365.html#refclass143365" target = "projectFrame"><b>NodeWiring</b></a><br />
@@ -127,6 +133,7 @@
 <a href="class140677.html#refclass140677" target = "projectFrame"><b>QueryHandler</b></a><br />
 <a href="class141189.html#refclass141189" target = "projectFrame"><b>QueryHandlerImpl</b></a><br />
 <a href="class143877.html#refclass143877" target = "projectFrame"><b>ReadSource</b></a><br />
+<a href="class149509.html#refclass149509" target = "projectFrame"><b>RedoLast</b></a><br />
 <a href="class129413.html#refclass129413" target = "projectFrame"><b>RelativeLocation</b></a><br />
 <a href="class133893.html#refclass133893" target = "projectFrame"><b>RelType</b></a><br />
 <a href="class131333.html#refclass131333" target = "projectFrame"><b>RenderEngine</b></a><br />
@@ -158,6 +165,7 @@
 <a href="class145157.html#refclass145157" target = "projectFrame"><b>StreamTypeID</b></a><br />
 <a href="class136965.html#refclass136965" target = "projectFrame"><b>Struct</b></a><br />
 <a href="class145413.html#refclass145413" target = "projectFrame"><b>STypeManager</b></a><br />
+<a href="class149637.html#refclass149637" target = "projectFrame"><b>Target</b></a><br />
 <a href="class128138.html#refclass128138" target = "projectFrame"><b>Thread</b></a><br />
 <a href="class134917.html#refclass134917" target = "projectFrame"><b>Time</b></a><br />
 <a href="class145541.html#refclass145541" target = "projectFrame"><b>Timeline</b></a><br />
@@ -169,6 +177,8 @@
 <a href="class131845.html#refclass131845" target = "projectFrame"><b>Trafo</b></a><br />
 <a href="class140805.html#refclass140805" target = "projectFrame"><b>TypeHandler</b></a><br />
 <a href="class141317.html#refclass141317" target = "projectFrame"><b>TypeHandler&lt;Pipe&gt;</b></a><br />
+<a href="class148869.html#refclass148869" target = "projectFrame"><b>UndoMutation</b></a><br />
+<a href="class149381.html#refclass149381" target = "projectFrame"><b>UndoSync</b></a><br />
 <a href="class137477.html#refclass137477" target = "projectFrame"><b>Unknown</b></a><br />
 <a href="class141701.html#refclass141701" target = "projectFrame"><b>User</b></a><br />
 <a href="class133509.html#refclass133509" target = "projectFrame"><b>VFrame</b></a><br />
diff --git a/doc/devel/uml/fig134021.png b/doc/devel/uml/fig134021.png
new file mode 100644
index 0000000000000000000000000000000000000000..c3acb367712339244e02e7d4a2162a58d493ae2c
GIT binary patch
literal 23301
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
TkwY+I8gWM3P%BTv=8yjYlT|l%

literal 0
HcmV?d00001

diff --git a/doc/devel/uml/index.html b/doc/devel/uml/index.html
index 5257dd3f7..2e6e4c680 100644
--- a/doc/devel/uml/index.html
+++ b/doc/devel/uml/index.html
@@ -19,7 +19,7 @@ Documentation</title>
 <a name="refpackage129"></a>
 <p>Properties:<ul>
 <li>:<br /><div class="sub"></div></p></li>
-<li>CopyrightClaim:<br /><div class="sub"><br />  Copyright (C)         Lumiera.org<br />    2008,               Christian Thaeter &lt;ct@pipapo.org&gt;<br /><br /></div></p></li>
+<li>CopyrightClaim:<br /><div class="sub"><br />  Copyright (C)         Lumiera.org<br />    2008,               Hermann Vosseler &lt;Ichthyostega@web.de&gt;<br /><br /></div></p></li>
 <li>GPLHeader:<br /><div class="sub">  This program is free software; you can redistribute it and/or<br />  modify it under the terms of the GNU General Public License as<br />  published by the Free Software Foundation; either version 2 of the<br />  License, or (at your option) any later version.<br /><br />  This program is distributed in the hope that it will be useful,<br />  but WITHOUT ANY WARRANTY; without even the implied warranty of<br />  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the<br />  GNU General Public License for more details.<br /><br />  You should have received a copy of the GNU General Public License<br />  along with this program; if not, write to the Free Software<br />  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.<br /></div></p></li>
 <li>html dir:<br /><div class="sub">/mnt/Lager/heim/devel/lumi/doc/devel/uml/</div></p></li>
 </ul></p>
@@ -147,7 +147,7 @@ Documentation</title>
 <table><tr><td><div class="element">Artifact <b>Lumiera</b></div></td></tr></table>
 <p>the main executable to be built<br /></p>
 <p>Depends on <a href="index.html#refpackage129413"><b>common</b></a></p><p>Depends on <a href="index.html#refpackage129797"><b>gui</b></a></p><p>Depends on <a href="index.html#refpackage129669"><b>proc</b></a></p><p>Depends on <a href="index.html#refpackage129541"><b>backend</b></a></p><p>Stereotype: executable</p>
-<p><i>executable</i> associated with : <a href="index.html#refartifact132229"><b>exitnode</b></a>, <a href="index.html#refartifact131717"><b>pathmanager</b></a>, <a href="index.html#refartifact128901"><b>track</b></a>, <a href="index.html#refartifact129669"><b>meta</b></a>, <a href="index.html#refartifact129797"><b>fixedlocation</b></a>, <a href="index.html#refartifact129925"><b>relativelocation</b></a>, <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, <a href="index.html#refartifact132101"><b>rendergraph</b></a>, <a href="index.html#refartifact133125"><b>pluginadapter</b></a>, <a href="index.html#refartifact129157"><b>explicitplacement</b></a>, <a href="index.html#refartifact130309"><b>auto</b></a>, <a href="index.html#refartifact133637"><b>glrender</b></a>, <a href="index.html#refartifact133381"><b>arender</b></a>, <a href="index.html#refartifact131845"><b>renderstate</b></a>, <a href="index.html#refartifact130181"><b>label</b></a>, <a href="index.html#refartifact131461"><b>nodecreatertool</b></a>, <a href="index.html#refartifact132869"><b>projector</b></a>, <a href="index.html#refartifact134661"><b>interpolator</b></a>, <a href="index.html#refartifact134533"><b>paramprovider</b></a>, <a href="index.html#refartifact132997"><b>mask</b></a>, <a href="index.html#refartifact128261"><b>mobject</b></a>, <a href="index.html#refartifact134277"><b>source</b></a>, <a href="index.html#refartifact133765"><b>frame</b></a>, <a href="index.html#refartifact129541"><b>effect</b></a>, <a href="index.html#refartifact131205"><b>buildertool</b></a>, <a href="index.html#refartifact131333"><b>segmentationtool</b></a>, <a href="index.html#refartifact132613"><b>link</b></a>, <a href="index.html#refartifact134405"><b>parameter</b></a>, <a href="index.html#refartifact131973"><b>renderengine</b></a>, <a href="index.html#refartifact134149"><b>glbuf</b></a>, <a href="index.html#refartifact132357"><b>procnode</b></a>, <a href="index.html#refartifact130949"><b>stateproxy</b></a>, <a href="index.html#refartifact128645"><b>edl</b></a>, <a href="index.html#refartifact128773"><b>fixture</b></a>, <a href="index.html#refartifact133253"><b>glpipe</b></a>, <a href="index.html#refartifact128133"><b>main</b></a>, <a href="index.html#refartifact130693"><b>conmanager</b></a>, <a href="index.html#refartifact129413"><b>clip</b></a>, <a href="index.html#refartifact133509"><b>vrender</b></a>, <a href="index.html#refartifact129029"><b>placement</b></a>, <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, <a href="index.html#refartifact130437"><b>builderfacade</b></a>, <a href="index.html#refartifact133893"><b>aframe</b></a>, <a href="index.html#refartifact130821"><b>assembler</b></a>, <a href="index.html#refartifact132485"><b>trafo</b></a>, <a href="index.html#refartifact130053"><b>allocation</b></a>, <a href="index.html#refartifact134021"><b>vframe</b></a>, <a href="index.html#refartifact130565"><b>toolfactory</b></a>, <a href="index.html#refartifact132741"><b>hub</b></a>, <a href="index.html#refartifact131077"><b>buildable</b></a>, <a href="index.html#refartifact129285"><b>abstractmo</b></a></p>
+<p><i>executable</i> associated with : <a href="index.html#refartifact129029"><b>placement</b></a>, <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, <a href="index.html#refartifact130437"><b>builderfacade</b></a>, <a href="index.html#refartifact133893"><b>aframe</b></a>, <a href="index.html#refartifact130821"><b>assembler</b></a>, <a href="index.html#refartifact132485"><b>trafo</b></a>, <a href="index.html#refartifact130053"><b>allocation</b></a>, <a href="index.html#refartifact134021"><b>vframe</b></a>, <a href="index.html#refartifact130565"><b>toolfactory</b></a>, <a href="index.html#refartifact132741"><b>hub</b></a>, <a href="index.html#refartifact131077"><b>buildable</b></a>, <a href="index.html#refartifact129285"><b>abstractmo</b></a>, <a href="index.html#refartifact132229"><b>exitnode</b></a>, <a href="index.html#refartifact131717"><b>pathmanager</b></a>, <a href="index.html#refartifact128901"><b>track</b></a>, <a href="index.html#refartifact129669"><b>meta</b></a>, <a href="index.html#refartifact129797"><b>fixedlocation</b></a>, <a href="index.html#refartifact129925"><b>relativelocation</b></a>, <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, <a href="index.html#refartifact132101"><b>rendergraph</b></a>, <a href="index.html#refartifact133125"><b>pluginadapter</b></a>, <a href="index.html#refartifact129157"><b>explicitplacement</b></a>, <a href="index.html#refartifact130309"><b>auto</b></a>, <a href="index.html#refartifact133637"><b>glrender</b></a>, <a href="index.html#refartifact133381"><b>arender</b></a>, <a href="index.html#refartifact131845"><b>renderstate</b></a>, <a href="index.html#refartifact130181"><b>label</b></a>, <a href="index.html#refartifact131461"><b>nodecreatertool</b></a>, <a href="index.html#refartifact132869"><b>projector</b></a>, <a href="index.html#refartifact134661"><b>interpolator</b></a>, <a href="index.html#refartifact134533"><b>paramprovider</b></a>, <a href="index.html#refartifact132997"><b>mask</b></a>, <a href="index.html#refartifact128261"><b>mobject</b></a>, <a href="index.html#refartifact134277"><b>source</b></a>, <a href="index.html#refartifact133765"><b>frame</b></a>, <a href="index.html#refartifact129541"><b>effect</b></a>, <a href="index.html#refartifact131205"><b>buildertool</b></a>, <a href="index.html#refartifact131333"><b>segmentationtool</b></a>, <a href="index.html#refartifact132613"><b>link</b></a>, <a href="index.html#refartifact134405"><b>parameter</b></a>, <a href="index.html#refartifact131973"><b>renderengine</b></a>, <a href="index.html#refartifact134149"><b>glbuf</b></a>, <a href="index.html#refartifact132357"><b>procnode</b></a>, <a href="index.html#refartifact130949"><b>stateproxy</b></a>, <a href="index.html#refartifact128645"><b>edl</b></a>, <a href="index.html#refartifact128773"><b>fixture</b></a>, <a href="index.html#refartifact133253"><b>glpipe</b></a>, <a href="index.html#refartifact128133"><b>main</b></a>, <a href="index.html#refartifact130693"><b>conmanager</b></a>, <a href="index.html#refartifact129413"><b>clip</b></a>, <a href="index.html#refartifact133509"><b>vrender</b></a></p>
 <a name="refartifact128133"></a>
 <table><tr><td><div class="element">Artifact <b>main</b></div></td></tr></table>
 <p>Stereotype: source</p>
@@ -774,7 +774,7 @@ Documentation</title>
 </div>
 <a name="refpackage129029"></a>
 <h2 class ="package">2.2 Package Control</h2>
-<div class="sub">
+<p>Command handling, Proc-Layer dispatcher, controller and administrative facilities<br /></p><div class="sub">
 <a name="refclass view128389"></a>
 <h3 class ="view">2.2.1 Class View Controller Workings</h3>
 <div class="sub">
@@ -829,6 +829,24 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class <b><a href="class130949.html#refclass130949"><b>RenderState</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class145413.html#refclass145413"><b>STypeManager</b></a></b></div></td></tr></table>
 </div>
+<a name="refclass view130693"></a>
+<h3 class ="view">2.2.2 Class View Command Handling</h3>
+<div class="sub">
+<a name="refclass diagram134021"></a>
+<p align="center"><img src="fig134021.png" alt="" /></p>
+ <p align="center"><b>Command structure</b></p><p><br /></p><p><br /></p>
+<table><tr><td><div class="element">Class <b><a href="class148485.html#refclass148485"><b>Command</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class148613.html#refclass148613"><b>HandlingPattern</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class148741.html#refclass148741"><b>Mutation</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class148869.html#refclass148869"><b>UndoMutation</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class148997.html#refclass148997"><b>CmdClosure</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class149125.html#refclass149125"><b>DoSync</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class149253.html#refclass149253"><b>DoAsync</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class149381.html#refclass149381"><b>UndoSync</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class149509.html#refclass149509"><b>RedoLast</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class149637.html#refclass149637"><b>Target</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class141957.html#refclass141957"><b>ProcDispatcher</b></a></b></div></td></tr></table>
+</div>
 </div>
 <a name="refpackage128261"></a>
 <h2 class ="package">2.3 Package MObject</h2>
@@ -870,7 +888,6 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class <b><a href="class134661.html#refclass134661"><b>ParamProvider</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class134789.html#refclass134789"><b>Interpolator</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class139909.html#refclass139909"><b>LocatingPin</b></a></b></div></td></tr></table>
-<table><tr><td><div class="element">Class <b><a href="class141957.html#refclass141957"><b>ProcDispatcher</b></a></b></div></td></tr></table>
 </div>
 <a name="refpackage128901"></a>
 <h3 class ="package">2.3.2 Package Builder</h3>
diff --git a/doc/devel/uml/index_67.html b/doc/devel/uml/index_67.html
index a17989712..128becdac 100644
--- a/doc/devel/uml/index_67.html
+++ b/doc/devel/uml/index_67.html
@@ -24,54 +24,60 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation136581" target = "projectFrame"><b>callDown</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation136453" target = "projectFrame"><b>callDown</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143237.html#refclass143237" target = "projectFrame"><b>Caller</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation172933" target = "projectFrame"><b>capture</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation140421" target = "projectFrame"><b>category</b></a></td><td>relation</td><td>primary tree like classification of the asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137221.html#refclass137221" target = "projectFrame"><b>Category</b></a></td><td>class</td><td>tree like classification of Assets</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact135941" target = "projectFrame"><b>category</b></a></td><td>artifact</td><td>tree like classification of Assets</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130309" target = "projectFrame"><b>cause</b></a></td><td>attribute</td><td>a copy of the first exception encountered in this exception chain</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation145413" target = "projectFrame"><b>chain</b></a></td><td>relation</td><td>Chain of additional Placements further constraining the position of this MObject</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134277" target = "projectFrame"><b>chain</b></a></td><td>operation</td><td>create and add another Placement for this media object, thus increasingly constraining the (possible) position of this object.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation145413" target = "projectFrame"><b>chain</b></a></td><td>relation</td><td>Chain of additional Placements further constraining the position of this MObject</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation129633" target = "projectFrame"><b>checked_in</b></a></td><td>relation</td><td>checked_in objects are subject of cache aging and must be not in use</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation129290" target = "projectFrame"><b>checked_out</b></a></td><td>relation</td><td>this list keeps all mappings which are in use, and thus prevents them from Cache aging</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135301" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135045" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135813" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135557" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135429" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134917" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135685" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134661" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134789" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135813" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134917" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135045" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135173" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130565" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133509" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132229" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129029" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130693" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129541" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129797" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130053" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135301" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135685" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135429" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132485" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132357" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128261" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132229" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130053" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129797" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128005" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131589" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130181" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128133" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128261" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130693" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133509" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130565" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129029" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130437" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129285" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130309" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130181" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129541" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132357" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129285" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation133765" target = "projectFrame"><b>clear</b></a></td><td>operation</td><td>clear current session contents <br />without resetting overall session config.<br />Afterwards, the session will contain only one <br />empty EDL, while all Assets are retained.<br /></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent131077" target = "projectFrame"><b>client code</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a></td><td>class</td><td>bookkeeping (asset) view of a media clip.</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129413" target = "projectFrame"><b>clip</b></a></td><td>artifact</td><td>a Media Clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136325" target = "projectFrame"><b>clip</b></a></td><td>artifact</td><td>bookkeeping (asset) view of a media clip.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129413" target = "projectFrame"><b>clip</b></a></td><td>artifact</td><td>a Media Clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128901" target = "projectFrame"><b>clips</b></a></td><td>relation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refattribute133125" target = "projectFrame"><b>closure</b></a></td><td>attribute</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148997.html#refclass148997" target = "projectFrame"><b>CmdClosure</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a></td><td>class</td><td>description of some media data decoder or encoder facility</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137349" target = "projectFrame"><b>codec</b></a></td><td>artifact</td><td>description of some media data decoder or encoder facility</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135045.html#refclass135045" target = "projectFrame"><b>CodecAdapter</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134917" target = "projectFrame"><b>codecadapter</b></a></td><td>artifact</td><td>Processing Node for (de)coding media data</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128645" target = "projectFrame"><b>codegen</b></a></td><td>package</td><td>This package is used to organize code generation by BOUML. It is considered useless after having generated the initial code skeleton.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refclass148485" target = "projectFrame"><b>Command</b></a></td><td>class</td><td>Key abstraction for all proc/edit operations and UNDO management</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass view130693" target = "projectFrame"><b>Command Handling</b></a></td><td>class view</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram134021" target = "projectFrame"><b>Command structure</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129413" target = "projectFrame"><b>common</b></a></td><td>package</td><td>sourcecode package<br /><br />Common library and helper classes</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent129925" target = "projectFrame"><b>CommonLib</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128517" target = "projectFrame"><b>CommonLib</b></a></td><td>package</td><td></td></tr>
@@ -99,7 +105,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact139397" target = "projectFrame"><b>constraint</b></a></td><td>artifact</td><td>LocatingPin representing an directive by the user that<br />must not be violated</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130181.html#refclass130181" target = "projectFrame"><b>Constraint</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130693" target = "projectFrame"><b>control</b></a></td><td>package</td><td>sourcecode package<br /><br />The Processing and Render Controller,<br />and the Proc-Layer dispatcher</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129029" target = "projectFrame"><b>Control</b></a></td><td>package</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129029" target = "projectFrame"><b>Control</b></a></td><td>package</td><td>Command handling, Proc-Layer dispatcher, controller and administrative facilities</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128261" target = "projectFrame"><b>Controller</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128645" target = "projectFrame"><b>Controller Entities</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128389" target = "projectFrame"><b>Controller Workings</b></a></td><td>class view</td><td></td></tr>
diff --git a/doc/devel/uml/index_68.html b/doc/devel/uml/index_68.html
index e9e768a1e..40b7b291d 100644
--- a/doc/devel/uml/index_68.html
+++ b/doc/devel/uml/index_68.html
@@ -32,13 +32,16 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128138" target = "projectFrame"><b>design</b></a></td><td>package</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128005" target = "projectFrame"><b>design</b></a></td><td>package</td><td>All things concering the big picture.<br />Not a real code package, rather a container for design drafts, specifications, decisions.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refuse case128261" target = "projectFrame"><b>detect Channels</b></a></td><td>use case</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refopaque activity action128389" target = "projectFrame"><b>determine Render Params</b></a></td><td>opaque activity action</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refexpansion region128005" target = "projectFrame"><b>determine Render Params</b></a></td><td>expansion region</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refopaque activity action128389" target = "projectFrame"><b>determine Render Params</b></a></td><td>opaque activity action</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132613" target = "projectFrame"><b>devnull</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128773" target = "projectFrame"><b>Dispatcher</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134917" target = "projectFrame"><b>dispatchOp</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132869" target = "projectFrame"><b>do</b></a></td><td>attribute</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149253.html#refclass149253" target = "projectFrame"><b>DoAsync</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139141.html#refclass139141" target = "projectFrame"><b>DoAttach</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139269.html#refclass139269" target = "projectFrame"><b>DoRecurse</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149125.html#refclass149125" target = "projectFrame"><b>DoSync</b></a></td><td>class</td><td></td></tr>
 </table>
 </body>
 </html>
diff --git a/doc/devel/uml/index_69.html b/doc/devel/uml/index_69.html
index 37fab2669..0c6f365e7 100644
--- a/doc/devel/uml/index_69.html
+++ b/doc/devel/uml/index_69.html
@@ -43,6 +43,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact135813" target = "projectFrame"><b>error</b></a></td><td>artifact</td><td>Lumiera Exception Interface</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refexpansion region128133" target = "projectFrame"><b>establish partitioning</b></a></td><td>expansion region</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refdeployment view128133" target = "projectFrame"><b>EXE Deployment</b></a></td><td>deployment view</td><td>defines and lists how the Lumiera executable has to be created</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation137733" target = "projectFrame"><b>execute</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131589.html#refclass131589" target = "projectFrame"><b>ExitNode</b></a></td><td>class</td><td>The output of the render pipeline. Pulling from such exit nodes actually ivokes the render process</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132229" target = "projectFrame"><b>exitnode</b></a></td><td>artifact</td><td>special Processing Node providing "pullable" output</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129157" target = "projectFrame"><b>explicitplacement</b></a></td><td>artifact</td><td>special Placement yielding an absolute location (Time,Track)-location for a MObject</td></tr>
diff --git a/doc/devel/uml/index_72.html b/doc/devel/uml/index_72.html
index 7e5b73a00..90532e3e5 100644
--- a/doc/devel/uml/index_72.html
+++ b/doc/devel/uml/index_72.html
@@ -20,11 +20,12 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128225" target = "projectFrame"><b>handle</b></a></td><td>relation</td><td>weak pointer</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128737" target = "projectFrame"><b>handles</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute128225" target = "projectFrame"><b>handles_available</b></a></td><td>attribute</td><td>initialized to the maximum number of filehandles the backend may use for mapped files. When no handles are available, the handle which is last in the handles list is closed and (re-)used.<br />Else this number is decremented for each new filehandle used and incremented for any one explicitly freed.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148613.html#refclass148613" target = "projectFrame"><b>HandlingPattern</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram130181" target = "projectFrame"><b>Hierarchy</b></a></td><td>class diagram</td><td>Lumiera Exception hierarchy</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation133381" target = "projectFrame"><b>howtoProc</b></a></td><td>operation</td><td>@return descriptor how to build a render pipeline corresponding to this media</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132741" target = "projectFrame"><b>hub</b></a></td><td>artifact</td><td>special ProcNode used to build data distributing connections</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133253" target = "projectFrame"><b>HUE</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133893" target = "projectFrame"><b>HUE</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133253" target = "projectFrame"><b>HUE</b></a></td><td>class instance</td><td></td></tr>
 </table>
 </body>
 </html>
diff --git a/doc/devel/uml/index_73.html b/doc/devel/uml/index_73.html
index 844b1bf03..8dc64d64b 100644
--- a/doc/devel/uml/index_73.html
+++ b/doc/devel/uml/index_73.html
@@ -18,12 +18,13 @@
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130437" target = "projectFrame"><b>id</b></a></td><td>attribute</td><td>Asset primary key.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132613" target = "projectFrame"><b>ID</b></a></td><td>attribute</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145029.html#refclass145029" target = "projectFrame"><b>ImplFacade</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128309" target = "projectFrame"><b>In Memory Database</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity action pin128133" target = "projectFrame"><b>inFixture</b></a></td><td>activity action pin</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132869" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131461" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134149" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131461" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation131461" target = "projectFrame"><b>instance</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class147205.html#refclass147205" target = "projectFrame"><b>InstanceHandle</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation143621" target = "projectFrame"><b>instructions</b></a></td><td>relation</td><td></td></tr>
diff --git a/doc/devel/uml/index_77.html b/doc/devel/uml/index_77.html
index 56c268d60..bef78819f 100644
--- a/doc/devel/uml/index_77.html
+++ b/doc/devel/uml/index_77.html
@@ -34,8 +34,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class145285.html#refclass145285" target = "projectFrame"><b>MediaKind</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refmerge activity node128773" target = "projectFrame"><b>merge activity node</b></a></td><td>merge activity node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137093.html#refclass137093" target = "projectFrame"><b>Meta</b></a></td><td>class</td><td>key abstraction: metadata and organisational asset</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129669" target = "projectFrame"><b>meta</b></a></td><td>artifact</td><td>abstract base class of all MObjects representing meta data or processing instructions</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact136837" target = "projectFrame"><b>meta</b></a></td><td>artifact</td><td>key abstraction: metadata and organisational asset</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129669" target = "projectFrame"><b>meta</b></a></td><td>artifact</td><td>abstract base class of all MObjects representing meta data or processing instructions</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129157.html#refclass129157" target = "projectFrame"><b>Meta</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact128261" target = "projectFrame"><b>mobject</b></a></td><td>artifact</td><td>Key Abstraction: A Media Object in the Session</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130181" target = "projectFrame"><b>mobject</b></a></td><td>package</td><td>sourcecode package<br /><br />MObject Subsystem<br />including the Session (EDL), Builder and Processing Controller</td></tr>
@@ -43,6 +43,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class128517.html#refclass128517" target = "projectFrame"><b>MObject</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class146053.html#refclass146053" target = "projectFrame"><b>Monitor</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refobject diagram131333" target = "projectFrame"><b>multichannel clip</b></a></td><td>object diagram</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148741.html#refclass148741" target = "projectFrame"><b>Mutation</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128394.html#refclass128394" target = "projectFrame"><b>Mutex</b></a></td><td>class</td><td>I provided a reworked Mutex class in my Cinelerra2 repository</td></tr>
 </table>
 </body>
diff --git a/doc/devel/uml/index_78.html b/doc/devel/uml/index_78.html
index 74fa8a9d8..2671839d3 100644
--- a/doc/devel/uml/index_78.html
+++ b/doc/devel/uml/index_78.html
@@ -18,6 +18,7 @@
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130565" target = "projectFrame"><b>name</b></a></td><td>attribute</td><td>element ID, comprehensible but sanitized. The tuple (category, name, org) is unique.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132741" target = "projectFrame"><b>name</b></a></td><td>attribute</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refuse case129157" target = "projectFrame"><b>need sub object</b></a></td><td>use case</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation146053" target = "projectFrame"><b>next</b></a></td><td>relation</td><td>next additional LocatingPin, if any</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance136197" target = "projectFrame"><b>node1</b></a></td><td>class instance</td><td></td></tr>
diff --git a/doc/devel/uml/index_80.html b/doc/devel/uml/index_80.html
index 5f43290e4..a9a67427a 100644
--- a/doc/devel/uml/index_80.html
+++ b/doc/devel/uml/index_80.html
@@ -22,6 +22,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class134533.html#refclass134533" target = "projectFrame"><b>Parameter</b></a></td><td>class</td><td>Descriptor and access object for a plugin parameter. Parameters may be provided with values from the session, and this values may be automated.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134533" target = "projectFrame"><b>paramprovider</b></a></td><td>artifact</td><td>interface denoting a source for actual Parameter values</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134661.html#refclass134661" target = "projectFrame"><b>ParamProvider</b></a></td><td>class</td><td>A facility to get the actual value of a plugin/effect parameter</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation172677" target = "projectFrame"><b>params</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation137861" target = "projectFrame"><b>params</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130437.html#refclass130437" target = "projectFrame"><b>PathManager</b></a></td><td>class</td><td>While building a render engine, this Strategy class decides on the actual render strategy in accordance to the current controller settings (system state)</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact131717" target = "projectFrame"><b>pathmanager</b></a></td><td>artifact</td><td>Manager for deciding the actual render strategy</td></tr>
diff --git a/doc/devel/uml/index_82.html b/doc/devel/uml/index_82.html
index 8c7b345eb..3f9b13363 100644
--- a/doc/devel/uml/index_82.html
+++ b/doc/devel/uml/index_82.html
@@ -18,6 +18,7 @@
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143877.html#refclass143877" target = "projectFrame"><b>ReadSource</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149509.html#refclass149509" target = "projectFrame"><b>RedoLast</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129669" target = "projectFrame"><b>refPoint</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation132357" target = "projectFrame"><b>reg</b></a></td><td>operation</td><td>registers an asset object in the internal DB, providing its unique key</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation142085" target = "projectFrame"><b>registry</b></a></td><td>relation</td><td>@internal Table or DB holding all registered asset instances.</td></tr>
diff --git a/doc/devel/uml/index_83.html b/doc/devel/uml/index_83.html
index 028888285..ceab40c4a 100644
--- a/doc/devel/uml/index_83.html
+++ b/doc/devel/uml/index_83.html
@@ -36,8 +36,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class146821.html#refclass146821" target = "projectFrame"><b>ServiceImpl</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128133" target = "projectFrame"><b>Session</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact138757" target = "projectFrame"><b>session</b></a></td><td>artifact</td><td>Interface: the session edited by the user</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128005" target = "projectFrame"><b>Session</b></a></td><td>class view</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130437" target = "projectFrame"><b>session</b></a></td><td>package</td><td>sourcecode package<br /><br />Everything concerning the EDL and Session, within the MObject Subsystem</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128005" target = "projectFrame"><b>Session</b></a></td><td>class view</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139653.html#refclass139653" target = "projectFrame"><b>Session</b></a></td><td>class</td><td>Primary Interface for all editing tasks.<br />The session contains defaults, all the assets being edited, and a set of EDL with the individual MObjects to be manipulated and rendered.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128133" target = "projectFrame"><b>Session structure</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact128517" target = "projectFrame"><b>sessionimpl</b></a></td><td>artifact</td><td>holds the complete session data to be edited by the user</td></tr>
@@ -51,8 +51,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class138885.html#refclass138885" target = "projectFrame"><b>SimpleClip</b></a></td><td>class</td><td>Elementary clip consisting of only one media stream</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128906.html#refclass128906" target = "projectFrame"><b>SmartPointer</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128266" target = "projectFrame"><b>SmartPointers</b></a></td><td>class view</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation142469" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>the media source this clip referes to</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation141957" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>media source of this clip</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation142469" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>the media source this clip referes to</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133765.html#refclass133765" target = "projectFrame"><b>Source</b></a></td><td>class</td><td>Source Node: represents a media source to pull data from.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134277" target = "projectFrame"><b>source</b></a></td><td>artifact</td><td>Representation of a Media source</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refdeployment diagram129797" target = "projectFrame"><b>Source Overview</b></a></td><td>deployment diagram</td><td></td></tr>
diff --git a/doc/devel/uml/index_84.html b/doc/devel/uml/index_84.html
index 361bf1d1f..58b8a6bf5 100644
--- a/doc/devel/uml/index_84.html
+++ b/doc/devel/uml/index_84.html
@@ -17,6 +17,8 @@
 
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149637.html#refclass149637" target = "projectFrame"><b>Target</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation172549" target = "projectFrame"><b>targets</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity diagram129541" target = "projectFrame"><b>the render configuration flow</b></a></td><td>activity diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130181" target = "projectFrame"><b>theApp_</b></a></td><td>attribute</td><td>holds the single instance and triggers initialization</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128261" target = "projectFrame"><b>theFixture</b></a></td><td>relation</td><td></td></tr>
@@ -34,8 +36,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class137989.html#refclass137989" target = "projectFrame"><b>Track</b></a></td><td>class</td><td>structural asset holding the configuration of a track in the EDL</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute128389" target = "projectFrame"><b>track</b></a></td><td>attribute</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation147589" target = "projectFrame"><b>track</b></a></td><td>relation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137477" target = "projectFrame"><b>track</b></a></td><td>artifact</td><td>structural asset holding the configuration of a track in the EDL</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact128901" target = "projectFrame"><b>track</b></a></td><td>artifact</td><td>A grouping device within the EDL. The corresponding Placement<br />by which this Track object is refered defines fallback placing<br />properties to be used by all objects placed on this track in<br />case they don't specify more concrete placements.<br />Typically, tracks are used do make default Port connections,<br />define a layer or pan for sound and for for disabling groups<br />of clips. Note tracks are grouped in a tree like fashion.<br /></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137477" target = "projectFrame"><b>track</b></a></td><td>artifact</td><td>structural asset holding the configuration of a track in the EDL</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation147333" target = "projectFrame"><b>track</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128389.html#refclass128389" target = "projectFrame"><b>Track</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation142341" target = "projectFrame"><b>tracks</b></a></td><td>relation</td><td>elementary media assets comprising this compound</td></tr>
@@ -45,12 +47,12 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134405" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129797" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td>This operation is to be overloaded for the specific MObject subclasses to be treated.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130693" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130309" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130565" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130309" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130437" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129925" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130053" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130181" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130053" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140805.html#refclass140805" target = "projectFrame"><b>TypeHandler</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141317.html#refclass141317" target = "projectFrame"><b>TypeHandler&lt;Pipe&gt;</b></a></td><td>class</td><td></td></tr>
 </table>
diff --git a/doc/devel/uml/index_85.html b/doc/devel/uml/index_85.html
index dafc717cb..ce1f36dc0 100644
--- a/doc/devel/uml/index_85.html
+++ b/doc/devel/uml/index_85.html
@@ -17,6 +17,10 @@
 
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132997" target = "projectFrame"><b>undo</b></a></td><td>attribute</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148869.html#refclass148869" target = "projectFrame"><b>UndoMutation</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation173061" target = "projectFrame"><b>undoOp</b></a></td><td>relation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149381.html#refclass149381" target = "projectFrame"><b>UndoSync</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137477.html#refclass137477" target = "projectFrame"><b>Unknown</b></a></td><td>class</td><td>placeholder for unknown or unavailable media source</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137093" target = "projectFrame"><b>unknown</b></a></td><td>artifact</td><td>placeholder for unknown or unavailable media source</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refuse case view128133" target = "projectFrame"><b>usage</b></a></td><td>use case view</td><td></td></tr>
diff --git a/doc/devel/uml/packages.html b/doc/devel/uml/packages.html
index 25b52f427..7b039a400 100644
--- a/doc/devel/uml/packages.html
+++ b/doc/devel/uml/packages.html
@@ -27,7 +27,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128517" target = "projectFrame"><b>CommonLib</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage131077" target = "projectFrame"><b>ConfigQuery</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130693" target = "projectFrame"><b>control</b></a></td><td>src</td><td>sourcecode package<br /><br />The Processing and Render Controller,<br />and the Proc-Layer dispatcher</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129029" target = "projectFrame"><b>Control</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129029" target = "projectFrame"><b>Control</b></a></td><td></td><td>Command handling, Proc-Layer dispatcher, controller and administrative facilities</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128138" target = "projectFrame"><b>design</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128005" target = "projectFrame"><b>design</b></a></td><td></td><td>All things concering the big picture.<br />Not a real code package, rather a container for design drafts, specifications, decisions.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130309" target = "projectFrame"><b>engine</b></a></td><td>src</td><td>sourcecode package<br /><br />The Core Render Engine</td></tr>
diff --git a/doc/devel/uml/public_operations.html b/doc/devel/uml/public_operations.html
index fe9b01e39..717b3562d 100644
--- a/doc/devel/uml/public_operations.html
+++ b/doc/devel/uml/public_operations.html
@@ -32,6 +32,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class139653.html#refoperation133509"><b>currEDL</b></a></td><td><a href="class139653.html#refclass139653"><b>Session</b></a></td><td>The EDL currently in focus. In most cases, Session and EDL are almost the same, just EDL emphasizes the collection aspect. But generally (for larger editing projects) one Session can contain several EDLs, which may even be nested. At any given time, only one of these EDLs has focus and recieves the editing commands.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140165.html#refoperation134917"><b>dispatchOp</b></a></td><td><a href="class140165.html#refclass140165"><b>Visitable</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refoperation132997"><b>enable</b></a></td><td><a href="class136453.html#refclass136453"><b>Asset</b></a></td><td>change the enabled status of this asset. Note the corresponding #isActive predicate may depend on the enablement status of parent assets as well</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refoperation137733"><b>execute</b></a></td><td><a href="class148485.html#refclass148485"><b>Command</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class132741.html#refoperation135813"><b>fetch</b></a></td><td><a href="class132741.html#refclass132741"><b>State</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140805.html#refoperation135045"><b>find</b></a></td><td><a href="class140805.html#refclass140805"><b>TypeHandler</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135429.html#refoperation131589"><b>get</b></a></td><td><a href="class135429.html#refclass135429"><b>Appconfig</b></a></td><td>access the configuation value for a given key.<br />@return empty string for unknown keys, else the corresponding configuration value</td></tr>
diff --git a/doc/devel/uml/public_properties.html b/doc/devel/uml/public_properties.html
index 6fa20439e..58690294f 100644
--- a/doc/devel/uml/public_properties.html
+++ b/doc/devel/uml/public_properties.html
@@ -19,12 +19,16 @@
 <tr bgcolor=#f0f0f0><td align=center><b>Property</b></td><td align=center><b>Class</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refrelation140421"><b>category</b></a></td><td><a href="class136453.html#refclass136453"><b>Asset</b></a></td><td>primary tree like classification of the asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139653.html#refrelation144773"><b>current</b></a></td><td><a href="class139653.html#refclass139653"><b>Session</b></a></td><td>Standard access path to get at the current session via the Session Manager, which acts as a "PImpl" smart pointer</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refattribute132869"><b>do</b></a></td><td><a href="class148485.html#refclass148485"><b>Command</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refattribute130437"><b>id</b></a></td><td><a href="class136453.html#refclass136453"><b>Asset</b></a></td><td>Asset primary key.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refattribute132613"><b>ID</b></a></td><td><a href="class148485.html#refclass148485"><b>Command</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refattribute130565"><b>name</b></a></td><td><a href="class136453.html#refclass136453"><b>Asset</b></a></td><td>element ID, comprehensible but sanitized. The tuple (category, name, org) is unique.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refattribute132741"><b>name</b></a></td><td><a href="class148485.html#refclass148485"><b>Command</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139141.html#refrelation144133"><b>nodes</b></a></td><td><a href="class139141.html#refclass139141"><b>DoAttach</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refattribute130821"><b>org</b></a></td><td><a href="class136453.html#refclass136453"><b>Asset</b></a></td><td>origin or authorship id. Can be a project abbreviation, a package id or just the authors nickname or UID. This allows for the compnent name to be more generic (e.g. "blur"). Default for all assets provided by the core Lumiera codebase is "lumi".</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139141.html#refattribute131461"><b>point</b></a></td><td><a href="class139141.html#refclass139141"><b>DoAttach</b></a></td><td>identifying the point where the nodes should be attached</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128389.html#refrelation147205"><b>subTracks</b></a></td><td><a href="class128389.html#refclass128389"><b>Track</b></a></td><td>Child tracks in a tree structure</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class148485.html#refattribute132997"><b>undo</b></a></td><td><a href="class148485.html#refclass148485"><b>Command</b></a></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refattribute130949"><b>version</b></a></td><td><a href="class136453.html#refclass136453"><b>Asset</b></a></td><td>version number of the thing or concept represented by this asset. Of each unique tuple (name, category, org) there will be only one version in the whole system. Version 0 is reserved for internal purposes. Versions are considered to be ordered, and any higher version is supposed to be fully backwards compatible to all previous versions.</td></tr>
 </table>
 </body>
diff --git a/uml/lumiera/128261 b/uml/lumiera/128261
index dc029b147..a6af8fb25 100644
--- a/uml/lumiera/128261
+++ b/uml/lumiera/128261
@@ -1,6 +1,6 @@
 format 58
 "MObject" // ProcessingLayer::MObject
-  revision 35
+  revision 36
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
@@ -1432,21 +1432,6 @@ ${inlines}
 	  b parent class_ref 139909 // LocatingPin
       end
     end
-
-    class 141957 "ProcDispatcher"
-      visibility package 
-      cpp_decl "${comment}${template}class ${name}${inherit}
-  {
-${members}  };
-${inlines}
-"
-      java_decl ""
-      php_decl ""
-      python_2_2 python_decl ""
-      idl_decl ""
-      explicit_switch_type ""
-      
-    end
   end
 
   package_ref 128901 // Builder
diff --git a/uml/lumiera/129029 b/uml/lumiera/129029
index e091ca09b..ffbb809fb 100644
--- a/uml/lumiera/129029
+++ b/uml/lumiera/129029
@@ -1,57 +1,57 @@
-format 40
+format 58
 "Control" // ProcessingLayer::Control
-  revision 7
+  revision 8
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   //use case diagram settings
-  package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+  package_name_in_tab default show_context default auto_label_position default draw_all_relations default class_drawing_mode default shadow default show_stereotype_properties default
   //sequence diagram settings
-  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+  show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
   //collaboration diagram settings
-  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+  show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
   //object diagram settings
-   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+   write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
   //component diagram settings
   package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //deployment diagram settings
   package_name_in_tab default show_context default write_horizontally default auto_label_position default draw_all_relations default shadow default
-  draw_component_as_icon default show_component_req_prov default show_component_rea default
+  draw_component_as_icon default show_component_req_prov default show_component_rea default show_stereotype_properties default
   //state diagram settings
   package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-  show_activities default region_horizontally default drawing_language default
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
   //activity diagram settings
   package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-  show_infonote default drawing_language default
+  show_infonote default drawing_language default show_stereotype_properties default
   
+  comment "Command handling, Proc-Layer dispatcher, controller and administrative facilities"
   classview 128389 "Controller Workings"
     //class diagram settings
-    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
     //collaboration diagram settings
-    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
     //object diagram settings
-     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
     //sequence diagram settings
-    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
     //state diagram settings
     package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
-    show_activities default region_horizontally default drawing_language default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
     //class settings
     //activity diagram settings
     package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-    show_infonote default drawing_language default
-    
+    show_infonote default drawing_language default show_stereotype_properties default
     classdiagram 128645 "Controller Entities"
-      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
       size A4
     end
 
     activity 128133 "configure Render"
       activitydiagram 129541 "the render configuration flow"
 	package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
-	show_infonote default drawing_language default
+	show_infonote default drawing_language default show_stereotype_properties default
 	size A4
       end
 
@@ -123,6 +123,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
 ${members}};
 "
@@ -139,12 +141,14 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
       comment "While building a render engine, this Strategy class decides on the actual render strategy in accordance to the current controller settings (system state)"
       operation 128261 "buildProcessor"
-	public return_type class_ref 131461 // Processor
+	public return_type class_ref 131461 // RenderGraph
 	nparams 0
 	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
 	cpp_def "${comment}${inline}${type}
@@ -156,6 +160,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -167,6 +173,8 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
@@ -184,6 +192,8 @@ ${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
 "
 	
 	
+	
+	
       end
     end
 
@@ -195,6 +205,387 @@ ${members}  };
 ${inlines}
 "
       java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+    end
+  end
+
+  classview 130693 "Command Handling"
+    //class diagram settings
+    draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+    //collaboration diagram settings
+    show_full_operations_definition default show_hierarchical_rank default write_horizontally default drawing_language default package_name_in_tab default show_context default draw_all_relations default shadow default show_stereotype_properties default
+    //object diagram settings
+     write_horizontally default package_name_in_tab default show_context default auto_label_position default draw_all_relations default shadow default show_stereotype_properties default
+    //sequence diagram settings
+    show_full_operations_definition default write_horizontally default class_drawing_mode default drawing_language default draw_all_relations default shadow default show_stereotype_properties default
+    //state diagram settings
+    package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition default draw_all_relations default shadow default
+    show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+    //class settings
+    //activity diagram settings
+    package_name_in_tab default show_context default show_opaque_action_definition default auto_label_position default write_flow_label_horizontally default draw_all_relations default shadow default
+    show_infonote default drawing_language default show_stereotype_properties default
+    classdiagram 134021 "Command structure"
+      draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+      size A4
+    end
+
+    class 148485 "Command"
+      visibility public stereotype "interface"
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl "${comment}${@}${visibility}interface ${name}${extends} {
+${members}}
+"
+      php_decl "${comment}${visibility}interface ${name} {
+${members}}
+"
+      python_2_2 python_decl ""
+      idl_decl "${comment}${abstract}${local}interface ${name}${inherit} {
+${members}};
+"
+      explicit_switch_type ""
+      
+      comment "Key abstraction for all proc/edit operations and UNDO management"
+      attribute 132613 "ID"
+	const_attribute public explicit_type ""
+	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	java_decl ""
+	php_decl ""
+	python_decl ""
+	idl_decl ""
+      end
+
+      attribute 132741 "name"
+	const_attribute public explicit_type "Symbol"
+	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	java_decl ""
+	php_decl ""
+	python_decl ""
+	idl_decl ""
+      end
+
+      attribute 132869 "do"
+	public type class_ref 148741 // Mutation
+	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	java_decl ""
+	php_decl ""
+	python_decl ""
+	idl_decl ""
+      end
+
+      attribute 132997 "undo"
+	public type class_ref 148869 // UndoMutation
+	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	java_decl ""
+	php_decl ""
+	python_decl ""
+	idl_decl ""
+      end
+
+      attribute 133125 "closure"
+	private type class_ref 148997 // CmdClosure
+	cpp_decl "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	java_decl ""
+	php_decl ""
+	python_decl ""
+	idl_decl ""
+      end
+
+      operation 137733 "execute"
+	public explicit_return_type "void"
+	nparams 1
+	  param in name "context" explicit_type "HandlingPattern"
+	cpp_decl "    ${comment}${friend}${static}${inline}${virtual}${type} ${name} ${(}${)}${const}${volatile} ${throw}${abstract};"
+	cpp_def "${comment}${inline}${type}
+${class}::${name} ${(}${)}${const}${volatile} ${throw}${staticnl}
+{
+  ${body}
+}
+
+"
+	
+	
+	
+	
+      end
+
+      classrelation 172805 // <unidirectional association>
+	relation 162821 --->
+	  stereotype "has_a"
+	  a role_name "" multiplicity "1" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 172805 // <unidirectional association>
+	  b multiplicity "1" parent class_ref 148997 // CmdClosure
+      end
+
+      classrelation 173189 // <unidirectional association>
+	relation 163205 --->
+	  stereotype "has_a"
+	  a role_name "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 173189 // <unidirectional association>
+	  b parent class_ref 148741 // Mutation
+      end
+
+      classrelation 173317 // <unidirectional association>
+	relation 163333 --->
+	  a role_name "" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 173317 // <unidirectional association>
+	  b parent class_ref 148869 // UndoMutation
+      end
+
+      classrelation 173573 // <dependency>
+	relation 163589 -_->
+	  stereotype "invokes"
+	  a package
+	    cpp default "#include in source"
+	    classrelation_ref 173573 // <dependency>
+	  b parent class_ref 148613 // HandlingPattern
+      end
+    end
+
+    class 148613 "HandlingPattern"
+      abstract visibility public stereotype "interface"
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 173701 // <dependency>
+	relation 163717 -_->
+	  stereotype "involves"
+	  a package
+	    cpp default "#include in source"
+	    classrelation_ref 173701 // <dependency>
+	  b parent class_ref 141957 // ProcDispatcher
+      end
+    end
+
+    class 148741 "Mutation"
+      visibility package stereotype "func"
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+    end
+
+    class 148869 "UndoMutation"
+      visibility package stereotype "func"
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 171909 // <generalisation>
+	relation 161925 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 171909 // <generalisation>
+	  b parent class_ref 148741 // Mutation
+      end
+
+      classrelation 172933 // capture (<unidirectional association>)
+	relation 162949 --->
+	  a role_name "capture" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 172933 // capture (<unidirectional association>)
+	  b parent class_ref 148741 // Mutation
+      end
+
+      classrelation 173061 // undoOp (<unidirectional association>)
+	relation 163077 --->
+	  a role_name "undoOp" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 173061 // undoOp (<unidirectional association>)
+	  b parent class_ref 148741 // Mutation
+      end
+    end
+
+    class 148997 "CmdClosure"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 172549 // targets (<directional composition>)
+	relation 162565 *-->
+	  stereotype "list"
+	  a role_name "targets" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	    classrelation_ref 172549 // targets (<directional composition>)
+	  b multiplicity "*" parent class_ref 149637 // Target
+      end
+
+      classrelation 172677 // params (<directional composition>)
+	relation 162693 *-->
+	  stereotype "list"
+	  a role_name "params" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	    classrelation_ref 172677 // params (<directional composition>)
+	  b multiplicity "*" parent class_ref 134533 // Parameter
+      end
+    end
+
+    class 149125 "DoSync"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 172037 // <generalisation>
+	relation 162053 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 172037 // <generalisation>
+	  b parent class_ref 148613 // HandlingPattern
+      end
+    end
+
+    class 149253 "DoAsync"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 172165 // <generalisation>
+	relation 162181 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 172165 // <generalisation>
+	  b parent class_ref 148613 // HandlingPattern
+      end
+    end
+
+    class 149381 "UndoSync"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 172293 // <generalisation>
+	relation 162309 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 172293 // <generalisation>
+	  b parent class_ref 148613 // HandlingPattern
+      end
+    end
+
+    class 149509 "RedoLast"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 172421 // <generalisation>
+	relation 162437 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 172421 // <generalisation>
+	  b parent class_ref 148613 // HandlingPattern
+      end
+    end
+
+    class 149637 "Target"
+      visibility package 
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+    end
+
+    class 141957 "ProcDispatcher"
+      visibility package stereotype "control"
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
       idl_decl ""
       explicit_switch_type ""
       
diff --git a/uml/lumiera/134021.diagram b/uml/lumiera/134021.diagram
new file mode 100644
index 000000000..47e68f995
--- /dev/null
+++ b/uml/lumiera/134021.diagram
@@ -0,0 +1,146 @@
+format 58
+
+classcanvas 128005 class_ref 148485 // Command
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  color verylightorange
+  xyz 177 87 1994
+end
+classcanvas 128133 class_ref 148613 // HandlingPattern
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 424 293 2000
+end
+classcanvas 128261 class_ref 148741 // Mutation
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 338 102 2000
+end
+classcanvas 128389 class_ref 148869 // UndoMutation
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 327 173 2000
+end
+classcanvas 128517 class_ref 148997 // CmdClosure
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 25 178 2000
+end
+classcanvas 128773 class_ref 149125 // DoSync
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 488 371 2000
+end
+classcanvas 128901 class_ref 149253 // DoAsync
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 488 416 2000
+end
+classcanvas 129029 class_ref 149381 // UndoSync
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 488 462 2000
+end
+classcanvas 129157 class_ref 149509 // RedoLast
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 488 507 2000
+end
+classcanvas 130565 class_ref 134533 // Parameter
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 112 298 2005
+end
+classcanvas 130693 class_ref 149637 // Target
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 112 249 2010
+end
+classcanvas 133765 class_ref 141957 // ProcDispatcher
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  color lightred
+  xyz 279 401 2000
+end
+relationcanvas 128645 relation_ref 161925 // <generalisation>
+  from ref 128389 z 1999 to ref 128261
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 129285 relation_ref 162053 // <generalisation>
+  geometry VHr
+  from ref 128773 z 1999 to point 467 388
+  line 130309 z 1999 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 129669 relation_ref 162181 // <generalisation>
+  geometry VHr
+  from ref 128901 z 1999 to point 467 433
+  line 129797 z 1999 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 129925 relation_ref 162309 // <generalisation>
+  geometry VHr
+  from ref 129029 z 1999 to point 467 479
+  line 130053 z 1999 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 130181 relation_ref 162437 // <generalisation>
+  geometry VHr
+  from ref 129157 z 1999 to point 467 524
+  line 130437 z 1999 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 130821 relation_ref 162565 // <directional composition>
+  geometry VH
+  from ref 128517 z 1999 stereotype "<<list>>" xyz 67 239 3000 to point 59 266
+  line 130949 z 1999 to ref 130693
+  role_a_pos 69 251 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 47 222 3000
+end
+relationcanvas 131077 relation_ref 162693 // <directional composition>
+  geometry VH
+  from ref 128517 z 1999 stereotype "<<list>>" xyz 66 300 3000 to point 59 327
+  line 131205 z 1999 to ref 130565
+  role_a_pos 67 312 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 47 222 3000
+end
+relationcanvas 131333 relation_ref 162821 // <unidirectional association>
+  decenter_begin 780
+  from ref 128005 z 1999 stereotype "<<has_a>>" xyz 110 184 3000 to ref 128517
+  no_role_a no_role_b
+  multiplicity_a_pos 107 202 3000 multiplicity_b_pos 160 202 3000
+end
+relationcanvas 131461 relation_ref 162949 // <unidirectional association>
+  decenter_begin 543
+  from ref 128389 z 1999 to point 453 201
+  line 132229 z 1999 to point 453 128
+  line 131717 z 1999 to ref 128261
+  role_a_pos 410 174 3000 no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 131845 relation_ref 163077 // <unidirectional association>
+  decenter_begin 280
+  from ref 128389 z 1999 to point 453 186
+  line 131973 z 1999 to point 453 128
+  line 132101 z 1999 to ref 128261
+  role_a_pos 409 203 3000 no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 132613 relation_ref 163205 // <unidirectional association>
+  from ref 128005 z 1999 stereotype "<<has_a>>" xyz 255 165 3000 to point 246 162
+  line 132741 z 1999 to ref 128261
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 132869 relation_ref 163333 // <unidirectional association>
+  from ref 128005 z 1999 to point 246 180
+  line 133125 z 1999 to ref 128389
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 133509 relation_ref 163589 // <dependency>
+  from ref 128005 z 1993 stereotype "<<invokes>>" xyz 263 248 3000 to point 245 214
+  line 133637 z 1993 to ref 128133
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 133893 relation_ref 163717 // <dependency>
+  from ref 128133 z 1999 stereotype "<<involves>>" xyz 314 370 3000 to ref 133765
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+preferred_whz 575 622 1
+end
diff --git a/uml/lumiera/lumiera.prj b/uml/lumiera/lumiera.prj
index a0b1cba7b..c978054a5 100644
--- a/uml/lumiera/lumiera.prj
+++ b/uml/lumiera/lumiera.prj
@@ -1,6 +1,6 @@
 format 58
 "lumiera"
-  revision 51
+  revision 52
   modified_by 5 "hiv"
   cpp_root_dir "../../src/"
 
@@ -54,7 +54,7 @@ format 58
 "
   key "CopyrightClaim" value "
   Copyright (C)         Lumiera.org
-    2008,               Christian Thaeter <ct@pipapo.org>
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
 
 "
   key "html dir" value "/mnt/Lager/heim/devel/lumi/doc/devel/uml/"
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 229003ee3..14914c15e 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -951,6 +951,34 @@ TertiaryMid: #99a
 TertiaryDark: #667
 Error: #f88</pre>
 </div>
+<div title="Command" modifier="Ichthyostega" modified="200906072100" created="200906072020" tags="def SessionLogic draft" changecount="5">
+<pre>Within Proc-Layer, a Command is the abstract representation of a single operation or a compound of operations mutating the HighLevelModel.
+Thus, each command is a ''Functor'' and a ''Closure'' ([[command pattern|http://en.wikipedia.org/wiki/Command_pattern]]), allowing commands to be treated uniformly, enqueued in a [[dispatcher|ProcDispatcher]], logged to the SessionStorage and registered with the UndoManager.
+
+&amp;rarr; see CommandHandling</pre>
+</div>
+<div title="CommandHandling" modifier="Ichthyostega" modified="200906080146" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="17">
+<pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
+
+
+!Defining commands
+[&gt;img[Structure of Commands|uml/fig134021.png]] Basically, a command could contain arbitrary operations, but we'll assume that it causes a well defined mutation within the HighLevelModel, which can be ''undone''. Thus, when defining a command, we need to specify not only a function doing the mutation, but also another function which might be called later to reverse the effect of the action. Besides, the action operates on a number of ''target'' objects and additionally may require a set of ''parameter'' values. These are to be stored explicitly within the command object, thus creating a ''closure'' &amp;mdash; the operation //must not//&amp;nbsp; rely on other hidden parameters (maybe with the exception of very generic singleton system services?).
+
+Theoretically, defining the &quot;undo&quot; operation might utilise two different approaches:
+* specifying an //inverse operation,// known to cancel out the effect of the command operation
+* capturing a //state memento,// which can be played back to restore the state found prior to executing the command.
+
+while obviously the first solution is much simpler to implement on behalf of the command framework, the second solution has distinct advantages, especially in the context of an editing application: there might be rounding or calculation errors, the inverse might be difficult to define correctly, the effect of the operation might depend on circumstances, be random, or might even trigger a resolution operation to yield the final result. Thus the decision is within Lumiera to //favour state capturing// &amp;mdash; but in a modified, semi-manual and not completely exclusive way.
+
+!Undo state
+While the usual implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function'' and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense.
+
+!Handling of commands
+A command may be defined completely from scratch, or it might just instantiate a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
+
+By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation.
+</pre>
+</div>
 <div title="ConManager" modifier="Ichthyostega" modified="200810060300" created="200806050208" tags="def Builder" changecount="4">
 <pre>The Connection Manager is a service for wiring connections and for querying information and deriving decisions regarding various aspects of data streams and the possibility of connections. The purpose of the Connection Manager is to isolate the [[Builder]], which is client of this information and decision services, from the often convoluted details of type information and organizing a connection.
 
@@ -2978,7 +3006,7 @@ We need a way of addressing existing [[pipes|Pipe]]. Besides, as the Pipes and T
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
-<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200905310301" created="200904252258" tags="impl SessionLogic draft" changecount="19">
+<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200906071927" created="200904252258" tags="impl SessionLogic draft" changecount="24">
 <pre>//This page is a scrapbook for working out the implementation of the [[Session Datastructure in Memory|SessionDataMem]]//
 This is a difficult untertaking, because there are several dependencies (most of which aren't fully designed yet as of 5/09)
 * the GUI uses an adapted version of the HighLevelModel; these datastructures are intended to be backed by the Session
@@ -2998,6 +3026,8 @@ This is a difficult untertaking, because there are several dependencies (most of
 
 &lt;&lt;tasksum start&gt;&gt;
 &lt;&lt;taskadder below&gt;&gt;
+&lt;&lt;task &gt;&gt; implement a system for defining parameters and targets
+&lt;&lt;task &gt;&gt; implement a system for generating operations
 &lt;&lt;task &gt;&gt; define the general structure of operations
 &lt;&lt;task &gt;&gt; specify the editing operations
 
@@ -3005,6 +3035,8 @@ This is a difficult untertaking, because there are several dependencies (most of
 &lt;&lt;task 1 1 1&gt;&gt; evaluate models for the [[reference problem|MObjectRef]]
 &lt;&lt;task 2 3 3&gt;&gt; implement an hash-ID
 &lt;&lt;task 1 2 2&gt;&gt; incorporate this ID into class Placement
+&lt;&lt;task 2 2&gt;&gt; define PlacementRef and MObjectRef behaviour
+&lt;&lt;task 1 0&gt;&gt; wire up [[Session]] interface as a LayerSeparationInterface
 &lt;&lt;task 1 1 0&gt;&gt; implement PlacementRef
 &lt;&lt;task 2 2 0&gt;&gt; implement MObjectRef
 
@@ -3567,17 +3599,31 @@ Currently as of 5/09, this is an ongoing [[implementation and planning effort|Pl
 
 {{red{TODO...}}}</pre>
 </div>
-<div title="SessionInterface" modifier="Ichthyostega" modified="200904242109" created="200904242108" tags="SessionLogic GuiIntegration design draft discuss" changecount="2">
-<pre>{{red{WIP}}}</pre>
+<div title="SessionInterface" modifier="Ichthyostega" modified="200906071959" created="200904242108" tags="SessionLogic GuiIntegration design draft discuss" changecount="7">
+<pre>&quot;Session Interface&quot;, when used in a more general sense, denotes a compound of several interfaces and facilities, together forming the primary access point to the user visible contents and state of the editing project.
+* the API of the session class
+* the accompanying management interface (SessionManager API)
+* an LayerSeparationInterfaces allowing to access these interfaces from outside the Proc-Layer
+* the primary public ~APIs exposed on the objects to be queried and retrieved via the session class API
+** Sequence
+** Placement
+** Clip
+** Track
+** Effect
+** Automation
+* the [[command|CommandHandling]] interface, including the [[undo|UndoManager]] facility
+
+{{red{WIP}}}</pre>
 </div>
-<div title="SessionLogic" modifier="Ichthyostega" modified="200905232229" created="200904242110" tags="overview" changecount="11">
+<div title="SessionLogic" modifier="Ichthyostega" modified="200906072005" created="200904242110" tags="overview" changecount="13">
 <pre>The Session contains all informations, state and objects to be edited by the User (&amp;rarr;[[def|Session]]).
 As such, the SessionInterface is the main entrance point to Proc-Layer functionality, both for the primary EditingOperations and for playback/rendering processes.
 
 Currently (as of 5/09), Ichthyo is [[targeting|PlanningSessionInMem]] a first preliminary implementation of the [[Session in Memory|SessionDataMem]]
 
 !Design and handling of Objects within the Session
-Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. Effectively, such a placement within the session behaves like an //instances// of a given object, and at the same time it defines the &quot;non-substantial&quot; properties of the object, e.g. its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render processes within the engine, but also to external parts within the GUI and in plugins. The actual implementation of these object references is built on top of the PlacementRef tags, thus relying on the PlacementIndex the session maintains to keep track of all placements and their relations.</pre>
+Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. Effectively, such a placement within the session behaves like an //instances// of a given object, and at the same time it defines the &quot;non-substantial&quot; properties of the object, e.g. its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render processes within the engine, but also to external parts within the GUI and in plugins. The actual implementation of these object references is built on top of the PlacementRef tags, thus relying on the PlacementIndex the session maintains to keep track of all placements and their relations. While &amp;mdash; using these references &amp;mdash; an external client can access the objects and structures within the session, any actual ''mutations'' should be done based on the CommandHandling: a single operation of a sequence of operations is defined as [[Command]], to be [[dispatched as mutation operation|ProcDispatcher]]. Following this policy ensures integration with the SessionStorage and provides (unlimited) [[UNDO|UndoManager]].
+</pre>
 </div>
 <div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design" changecount="29">
 <pre>&lt;&lt;&lt;
@@ -5232,13 +5278,13 @@ A good starting point for understanding our library implementation of the visito
 ** when creating a new &quot;~Visitable-and-Tool&quot; hierarchy, the user should derive (or typedef) and parametrize the {{{Visitable}}}, {{{Tool}}} and {{{Applicable}}} templates, typically into a new namespace. An example can be seen in {{{proc/mobject/builder/buildertool.hpp}}}
 </pre>
 </div>
-<div title="VisitorUse" modifier="Ichthyostega" modified="200801041025" created="200711280302" tags="impl discuss" changecount="16">
+<div title="VisitorUse" modifier="Ichthyostega" modified="200906072024" created="200711280302" tags="impl discuss" changecount="17">
 <pre>Using the ''Visitor Design Pattern'' is somewhat controversial, mainly because this pattern is rather complicated, requires certain circumstances to be usefull, and &amp;mdash; especially when used in the original form described by Gamma et al &amp;mdash; puts quite some burden on the implementor. Contrary to some patterns commonly used today (like e.g. singleton or factory), visitor is by no way a popular pattern. Ichthyo thinks that until now it's potential stregths remain still to be discovered, due to obvious and well known weaknesses. This problems can be ameliorated a good deal by using template based library implementation techniques along the lines of the [[Loki library|http://loki-lib.sourceforge.net/]].
 &amp;rarr; [[implementation deatails|VisitingToolImpl]]
 
 !why bothering with visitor?
 In the Lumiera Proc layer, Ichthyo uses the visitor pattern to overcome another notorious problem when dealing with more complex class hierarchies: either, the //interface// (root class) is so unspecific to be almost useless, or, in spite of having a useful contract, this contract will effectively be broken by some subclasses (&quot;problem of elliptical circles&quot;). Initially, when designing the classes, the problems aren't there (obviously, because they could be taken as design flaws). But then, under the pressure of real features, new types are added later on, which //need to be in this hierarchy// and at the same time //need to have this and that special behaviour// and here we go ...
-Visitor helps us to circumvent this trap: the basic operations can be written against the top level interface, such, that they include visiting some object collection internally. Now, on a case-by-case base, local operations can utilize some sub interface or the given concrete type's public interface. So visitor helps to encapsulate cooperating specific technical details within some concrete visiting tool implementation, while forcing them to be implemented against some interface or sub-interface of the target objects.
+Visitor helps us to circumvent this trap: the basic operations can be written against the top level interface, such as to include visiting some object collection internally. Now, on a case-by-case base, local operations can utilise a more specific sub interface or the given concrete type's public interface. So visitor helps to encapsulate specific technical details of cooperating objects within the concrete visiting tool implementation, while still forcing them to be implemented against some interface or sub-interface of the target objects.
 
 !!well suited for using visitors
 generally speaking, visitors are preferable when the underlying element type hierarchy is rather stable, but new operations are to be added frequently.

From ba37045b48fe9af5d8ae084810ddafa40e933dbc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 8 Jun 2009 04:46:07 +0200
Subject: [PATCH 094/368] WIP: interface/framwork skeleton

---
 src/proc/Makefile.am                  |  3 ++
 src/proc/control/command-closure.hpp  | 65 ++++++++++++++++++++++
 src/proc/control/command.cpp          | 48 +++++++++++++++++
 src/proc/control/command.hpp          | 69 ++++++++++++++++++++++++
 src/proc/control/handling-pattern.cpp | 41 ++++++++++++++
 src/proc/control/handling-pattern.hpp | 68 +++++++++++++++++++++++
 src/proc/control/mutation.hpp         | 77 +++++++++++++++++++++++++++
 src/proc/control/proc-dispatcher.cpp  | 41 ++++++++++++++
 src/proc/control/proc-dispatcher.hpp  | 67 +++++++++++++++++++++++
 9 files changed, 479 insertions(+)
 create mode 100644 src/proc/control/command-closure.hpp
 create mode 100644 src/proc/control/command.cpp
 create mode 100644 src/proc/control/command.hpp
 create mode 100644 src/proc/control/handling-pattern.cpp
 create mode 100644 src/proc/control/handling-pattern.hpp
 create mode 100644 src/proc/control/mutation.hpp
 create mode 100644 src/proc/control/proc-dispatcher.cpp
 create mode 100644 src/proc/control/proc-dispatcher.hpp

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 3c87d3695..8480e0703 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -120,6 +120,9 @@ liblumiproccontrol_la_CFLAGS = $(AM_CFLAGS) -std=gnu99 -Wall -Wextra -Werror
 liblumiproccontrol_la_CXXFLAGS = $(AM_CXXFLAGS) -Wall -Wextra
 
 liblumiproccontrol_la_SOURCES =					\
+	$(liblumiproccontrol_la_srcdir)/command.cpp		\
+	$(liblumiproccontrol_la_srcdir)/handling-pattern.cpp	\
+	$(liblumiproccontrol_la_srcdir)/proc-dispatcher.cpp	\
 	$(liblumiproccontrol_la_srcdir)/pathmanager.cpp		\
 	$(liblumiproccontrol_la_srcdir)/stypemanager.cpp
 
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
new file mode 100644
index 000000000..8b38eacab
--- /dev/null
+++ b/src/proc/control/command-closure.hpp
@@ -0,0 +1,65 @@
+/*
+  COMMAND-CLOSURE.hpp  -  defining execution targets and parameters for commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-closure.hpp
+ ** A closure enabling self-contained execution of commands within the ProcDispatcher.
+ ** //TODO
+ **  
+ ** @see Command
+ ** @see ProcDispatcher
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_CLOSURE_H
+#define CONTROL_COMMAND_CLOSURE_H
+
+//#include "pre.hpp"
+
+//#include <tr1/memory>
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class CommandClosure
+    {
+      
+    public:
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
new file mode 100644
index 000000000..e0d82fdf7
--- /dev/null
+++ b/src/proc/control/command.cpp
@@ -0,0 +1,48 @@
+/*
+  Command  -  Key abstraction for proc/edit operations and UNDO management
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file command.cpp 
+ ** //TODO 
+ ** 
+ ** @see command.hpp
+ **
+ */
+
+
+#include "proc/control/command.hpp"
+//#include "proc/mobject/mobject-ref.hpp"
+//#include "proc/mobject/mobject.hpp"
+//#include "proc/mobject/placement.hpp"
+
+//#include <boost/format.hpp>
+//using boost::str;
+
+namespace control {
+  
+  /** */
+  
+  
+  
+  
+  
+} // namespace control
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
new file mode 100644
index 000000000..3939ae3d7
--- /dev/null
+++ b/src/proc/control/command.hpp
@@ -0,0 +1,69 @@
+/*
+  COMMAND.hpp  -  Key abstraction for proc/edit operations and UNDO management
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command.hpp
+ ** //TODO 
+ **
+ ** @see ProcDispatcher
+ ** @see Session
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_H
+#define CONTROL_COMMAND_H
+
+//#include "pre.hpp"
+#include "include/symbol.hpp"
+#include "proc/control/mutation.hpp"
+#include "proc/control/command-closure.hpp"
+
+//#include <tr1/memory>
+
+///////////////////////////////////////////TODO: define an C-API representation here, make the header multilingual!
+
+
+
+namespace control {
+  
+  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class Command
+    {
+      
+    public:
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
new file mode 100644
index 000000000..05b702c00
--- /dev/null
+++ b/src/proc/control/handling-pattern.cpp
@@ -0,0 +1,41 @@
+/*
+  HandlingPattern  -  A skeleton for executing commands, including standard implementations
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "proc/control/handling-pattern.hpp"
+//#include "proc/mobject/mobject-ref.hpp"
+//#include "proc/mobject/mobject.hpp"
+//#include "proc/mobject/placement.hpp"
+
+//#include <boost/format.hpp>
+//using boost::str;
+
+namespace control {
+  
+  /** */
+  
+  
+  ///////////////////////////////////////////////////////////////////////TODO: is this implementation file actually required??
+  
+  
+} // namespace control
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
new file mode 100644
index 000000000..6c7a005f7
--- /dev/null
+++ b/src/proc/control/handling-pattern.hpp
@@ -0,0 +1,68 @@
+/*
+  HANDLILNG-PATTERN.hpp  -  A skeleton for executing commands, including standard implementations
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file handling-pattern.hpp
+ ** //TODO 
+ **
+ ** @see ProcDispatcher
+ ** @see Session
+ **
+ */
+
+
+
+#ifndef CONTROL_HANDLING_PATTERN_H
+#define CONTROL_HANDLING_PATTERN_H
+
+//#include "pre.hpp"
+//#include "include/symbol.hpp"
+
+//#include <tr1/memory>
+
+
+
+namespace control {
+  
+  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  
+  
+  class Command;
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class HandlingPattern
+    {
+      
+    public:
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/mutation.hpp b/src/proc/control/mutation.hpp
new file mode 100644
index 000000000..d0791ecd2
--- /dev/null
+++ b/src/proc/control/mutation.hpp
@@ -0,0 +1,77 @@
+/*
+  MUTATION.hpp  -  a functor encapsulating the actual operation of a proc-Command
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file mutation.hpp
+ ** The core of a proc-Layer command: functor containing the actual operation to be executed.
+ ** //TODO
+ **  
+ ** @see Command
+ ** @see ProcDispatcher
+ **
+ */
+
+
+
+#ifndef CONTROL_MUTATION_H
+#define CONTROL_MUTATION_H
+
+//#include "pre.hpp"
+
+//#include <tr1/memory>
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class Mutation
+    {
+      
+    public:
+      
+    };
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class UndoMutation
+    : public Mutation
+    {
+      
+    public:
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/proc-dispatcher.cpp b/src/proc/control/proc-dispatcher.cpp
new file mode 100644
index 000000000..a20fabe90
--- /dev/null
+++ b/src/proc/control/proc-dispatcher.cpp
@@ -0,0 +1,41 @@
+/*
+  ProcDispatcher  -  Proc-Layer command dispatch and execution
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "proc/control/proc-dispatcher.hpp"
+//#include "proc/mobject/mobject-ref.hpp"
+//#include "proc/mobject/mobject.hpp"
+//#include "proc/mobject/placement.hpp"
+
+//#include <boost/format.hpp>
+//using boost::str;
+
+namespace control {
+  
+  /** */
+  
+  
+  
+  
+  
+} // namespace control
diff --git a/src/proc/control/proc-dispatcher.hpp b/src/proc/control/proc-dispatcher.hpp
new file mode 100644
index 000000000..d6e221838
--- /dev/null
+++ b/src/proc/control/proc-dispatcher.hpp
@@ -0,0 +1,67 @@
+/*
+  PROC-DISPATCHER.hpp  -  Proc-Layer command dispatch and execution
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file proc-dispatcher.hpp
+ ** Dispatch and execute mutation operations on the High-level model.
+ ** //TODO 
+ **
+ ** @see Command
+ ** @see Session
+ **
+ */
+
+
+
+#ifndef CONTROL_PROC_DISPATCHER_H
+#define CONTROL_PROC_DISPATCHER_H
+
+//#include "pre.hpp"
+//#include "include/symbol.hpp"
+#include "proc/control/command.hpp"
+
+//#include <tr1/memory>
+
+
+
+namespace control {
+  
+  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class ProcDispatcher
+    {
+      
+    public:
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif

From 3a7de1654a5bb4a39854d5d5cb63ac86f4f670db Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 8 Jun 2009 21:29:09 +0200
Subject: [PATCH 095/368] WIP: create a "scrapbook" test for trying out some
 ideas

---
 src/proc/control/command-def.hpp              | 81 ++++++++++++++++
 tests/45controller.tests                      |  4 +
 tests/components/Makefile.am                  |  1 +
 .../proc/control/command-basic-test.cpp       | 94 +++++++++++++++++++
 wiki/renderengine.html                        | 11 +--
 5 files changed, 185 insertions(+), 6 deletions(-)
 create mode 100644 src/proc/control/command-def.hpp
 create mode 100644 tests/components/proc/control/command-basic-test.cpp

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
new file mode 100644
index 000000000..fa3be7f3d
--- /dev/null
+++ b/src/proc/control/command-def.hpp
@@ -0,0 +1,81 @@
+/*
+  COMMAND-DEF.hpp  -  defining and binding a Proc-Layer command
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-def.hpp
+ ** Actually defining a command and binding it to execution parameters.
+ ** While the header command.hpp contains everything needed for executing and
+ ** commands and referring to them, this more heavy-weight header is needed when
+ ** \em defining the concrete operations to be encapsulated into a command. To
+ ** create a command, you need to provide three functors (for the actual operation,
+ ** the undo operation and for capturing undo state prior to invoking the operation).
+ ** Besides, you provide a \em binding, thus creating a closue out of these three
+ ** function objects and a set of actual parameters. This closure effectively is 
+ ** the command, which in a last step can be either dispatched, stored or 
+ ** invoked immediately.
+ ** //TODO 
+ **
+ ** @see Command
+ ** @see Mutation
+ ** @see CommandClosure
+ ** @see ProcDispatcher
+ ** @see CommandBasic_test simple usage example
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_H
+#define CONTROL_COMMAND_H
+
+//#include "pre.hpp"
+#include "proc/control/command.hpp"
+#include "proc/control/mutation.hpp"
+#include "proc/control/command-closure.hpp"
+
+//#include <tr1/memory>
+
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class CommandDef
+    {
+      
+    public:
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 8288dd721..f1cca4d94 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -3,4 +3,8 @@ TESTING "Component Test Suite: Proc-Layer controller" ./test-components --group=
 
 
 
+PLANNED "CommandBasic_test" CommandBasic_test <<END
+END
+
+
 #
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 32a0d8962..b8594f4f5 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -47,6 +47,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/asset/makecliptest.cpp			\
 	$(testcomponents_srcdir)/proc/asset/orderingofassetstest.cpp		\
 	$(testcomponents_srcdir)/proc/asset/testasset.cpp			\
+	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
 	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
new file mode 100644
index 000000000..5652a717e
--- /dev/null
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -0,0 +1,94 @@
+/*
+  CommandBasic(Test)  -  checking simple ProcDispatcher command definition and execution
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command-def.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+//#include <iostream>
+#include <string>
+
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+//using std::cout;
+
+
+namespace control {
+namespace test    {
+
+//  using session::test::TestClip;
+
+  namespace command1 {
+  
+    ////////////////////////////////////////////TODO braindump
+    ////////////////////////////////////////////TODO braindump
+  
+  }
+  
+  
+  
+  /***************************************************************************
+   * @test basic usage of the Proc-Layer command dispatch system.
+   *       Shows how to define a simple command inline and another
+   *       simple command as dedicated class. Finally triggers
+   *       execution of both commands and verifies the command
+   *       action has been invoked.
+   *       
+   * @todo currently rather a scrapbook for trying out first ideas on the command system !!!!!!!!!!!!!!!
+   *       
+   * @see  control::Command
+   * @see  control::CommandDef
+   * @see  mobject::ProcDispatcher
+   */
+  class CommandBasic_test : public Test
+    {
+      typedef shared_ptr<PlacementIndex> PIdx;
+      
+      virtual void
+      run (Arg) 
+        {
+          /////////////////////////////////TODO
+        }
+      
+      void
+      checkExecution ()
+        {
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandBasic_test, "unit controller");
+      
+      
+}} // namespace control::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 14914c15e..afe23720d 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -957,7 +957,7 @@ Thus, each command is a ''Functor'' and a ''Closure'' ([[command pattern|http://
 
 &amp;rarr; see CommandHandling</pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200906080146" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="17">
+<div title="CommandHandling" modifier="Ichthyostega" modified="200906080316" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="21">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
@@ -965,13 +965,12 @@ Thus, each command is a ''Functor'' and a ''Closure'' ([[command pattern|http://
 [&gt;img[Structure of Commands|uml/fig134021.png]] Basically, a command could contain arbitrary operations, but we'll assume that it causes a well defined mutation within the HighLevelModel, which can be ''undone''. Thus, when defining a command, we need to specify not only a function doing the mutation, but also another function which might be called later to reverse the effect of the action. Besides, the action operates on a number of ''target'' objects and additionally may require a set of ''parameter'' values. These are to be stored explicitly within the command object, thus creating a ''closure'' &amp;mdash; the operation //must not//&amp;nbsp; rely on other hidden parameters (maybe with the exception of very generic singleton system services?).
 
 Theoretically, defining the &quot;undo&quot; operation might utilise two different approaches:
-* specifying an //inverse operation,// known to cancel out the effect of the command operation
-* capturing a //state memento,// which can be played back to restore the state found prior to executing the command.
-
-while obviously the first solution is much simpler to implement on behalf of the command framework, the second solution has distinct advantages, especially in the context of an editing application: there might be rounding or calculation errors, the inverse might be difficult to define correctly, the effect of the operation might depend on circumstances, be random, or might even trigger a resolution operation to yield the final result. Thus the decision is within Lumiera to //favour state capturing// &amp;mdash; but in a modified, semi-manual and not completely exclusive way.
+* specifying an //inverse operation,// known to cancel out the effect of the command
+* capturing a //state memento,// which can later be played back to restore the state found prior to executing the command.
+While obviously the first solution is much simpler to implement on behalf of the command framework, the second solution has distinct advantages, especially in the context of an editing application: there might be rounding or calculation errors, the inverse might be difficult to define correctly, the effect of the operation might depend on circumstances, be random, or might even trigger a resolution operation to yield the final result. Thus the decision is within Lumiera Proc-Layer to //favour state capturing// &amp;mdash; but in a modified, semi-manual and not completely exclusive way.
 
 !Undo state
-While the usual implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function'' and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense.
+While the usual implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function'' and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense than capturing state.
 
 !Handling of commands
 A command may be defined completely from scratch, or it might just instantiate a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.

From 102e96891bcf6956082789b76e58059247a8eb94 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 9 Jun 2009 09:05:19 +0200
Subject: [PATCH 096/368] fixing, stubbing, and some chainsaw surgery to get
 half-finished code through the compiler

---
 src/lib/hash-indexed.hpp                      |  11 +-
 src/proc/control/handling-pattern.hpp         |   2 +-
 src/proc/mobject/explicitplacement.hpp        |   9 +-
 src/proc/mobject/mobject-ref.cpp              |   3 +
 src/proc/mobject/mobject-ref.hpp              |   7 +-
 src/proc/mobject/placement-index.cpp          |  77 +++-
 src/proc/mobject/placement-index.hpp          |  84 ++++-
 src/proc/mobject/placement-ref.hpp            |  89 ++++-
 src/proc/mobject/placement.hpp                |  15 +-
 src/proc/mobject/session/locatingpin.cpp      | 343 +++++++++---------
 src/proc/mobject/session/locatingpin.hpp      |  14 +-
 src/proc/mobject/session/relativelocation.hpp |  94 +++--
 .../mobject/session/sess-manager-impl.cpp     |   4 +-
 src/proc/mobject/session/session-impl.hpp     |   2 +-
 src/proc/mobject/session/track.hpp            |   1 +
 .../proc/control/command-basic-test.cpp       |  11 +-
 .../proc/mobject/mobject-ref-test.cpp         |  11 +-
 .../proc/mobject/placement-hierarchy-test.cpp |   3 +-
 .../proc/mobject/placement-ref-test.cpp       |  40 +-
 .../proc/mobject/session/deletecliptest.cpp   |  93 +++--
 .../mobject/session/rebuildfixturetest.cpp    | 109 +++---
 .../mobject/session/sessionmanagertest.cpp    | 212 ++++++-----
 .../proc/mobject/session/testclip.cpp         | 116 +++---
 .../proc/mobject/session/testclip.hpp         |  93 +++--
 24 files changed, 817 insertions(+), 626 deletions(-)

diff --git a/src/lib/hash-indexed.hpp b/src/lib/hash-indexed.hpp
index 6645a9850..5a814b131 100644
--- a/src/lib/hash-indexed.hpp
+++ b/src/lib/hash-indexed.hpp
@@ -108,7 +108,7 @@ namespace lib {
         bool operator!= (LuidH const& o)  const { return !operator== (o); }
         
         /** for passing to C APIs */
-        LUID get() { return &luid_; }
+        LUID get()                        const { return (LUID)&luid_; }
       };
     
     
@@ -172,6 +172,15 @@ namespace lib {
           return id_; 
         }
       
+      /** redefining of the specific type info of the Id is allowed,
+       *  as all share the same implementation */
+      template<typename T>
+      Id<T> const&
+      recastID ()  const
+        {
+          return reinterpret_cast<Id<T> const&> (getID());
+        }
+      
       void
       assignID (HashIndexed const& ref)
         { 
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 6c7a005f7..92bc776b9 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -43,7 +43,7 @@
 
 namespace control {
   
-  using lumiera::Symbol;
+//  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
   
diff --git a/src/proc/mobject/explicitplacement.hpp b/src/proc/mobject/explicitplacement.hpp
index 0e5b20bfd..b9522a111 100644
--- a/src/proc/mobject/explicitplacement.hpp
+++ b/src/proc/mobject/explicitplacement.hpp
@@ -28,8 +28,7 @@
 
 
 
-namespace mobject
-  {
+namespace mobject {
   
   
   
@@ -63,11 +62,11 @@ namespace mobject
       
       
     protected:
-      /*  @todo ichthyo considers a much more elegant implementation utilizing a subclass 
+      /*  @todo ichthyo considers a much more elegant implementation utilising a subclass 
        *        of FixedLocation, which would serve as Placement::LocatingSolution, and
        *        would be used as LocatingPin::chain subobject as well, so that it could
-       *        be initialized directly here in the ExplicitPlacement ctor. 
-       *        (ichthyo: siehe Trac #100)
+       *        be initialised directly here in the ExplicitPlacement ctor. 
+       *        (ichthyo: see Trac #100)
        */
       ExplicitPlacement (const Placement<MObject>& base, const SolutionData found)
         : Placement<MObject>(base),
diff --git a/src/proc/mobject/mobject-ref.cpp b/src/proc/mobject/mobject-ref.cpp
index 8758de088..69b4362f8 100644
--- a/src/proc/mobject/mobject-ref.cpp
+++ b/src/proc/mobject/mobject-ref.cpp
@@ -46,6 +46,9 @@ namespace mobject {
   /** */
   
   
+  LUMIERA_ERROR_DEFINE (INVALID_PLACEMENTREF, "unresolvable placement reference, or of incompatible type");   
+  
+  
   
   
   
diff --git a/src/proc/mobject/mobject-ref.hpp b/src/proc/mobject/mobject-ref.hpp
index 8bbab4c7a..2312c16db 100644
--- a/src/proc/mobject/mobject-ref.hpp
+++ b/src/proc/mobject/mobject-ref.hpp
@@ -64,8 +64,11 @@ namespace mobject {
   class MORef
     : public lib::Handle<MO>
     {
-      PlacementRef<MO> pRef_;
+      typedef lib::Handle<MO> _Par;
       
+      PlacementRef<MO> pRef_; ////////////////////////////////////////////////////////////////////TODO: how to create an "inactive" PlacementRef???
+      
+      using _Par::smPtr_;
       
     public:
       
@@ -74,7 +77,7 @@ namespace mobject {
         {
           REQUIRE (smPtr_.get(), "Lifecycle-Error");
           ENSURE (INSTANCEOF (MO, smPtr_.get()));
-          return smPtr_::operator-> ();
+          return smPtr_.operator-> ();
         }
       
       Placement<MO>& getPlacement();
diff --git a/src/proc/mobject/placement-index.cpp b/src/proc/mobject/placement-index.cpp
index 82c7aa7b3..7fc5d9be0 100644
--- a/src/proc/mobject/placement-index.cpp
+++ b/src/proc/mobject/placement-index.cpp
@@ -65,6 +65,18 @@ namespace mobject {
   typedef PlacementIndex::ID ID;
   
   
+  /** @internal Factory for creating a new placement index.
+   *            For use by the Session and for unit tests.  
+   */
+  PlacementIndex::Factory PlacementIndex::create;
+  
+  PlacementIndex::PlacementIndex()
+    : pTab_()
+    { }
+  
+  PlacementIndex::~PlacementIndex() { }
+ 
+
   PlacementMO&
   PlacementIndex::getRoot()  const
   {
@@ -80,18 +92,54 @@ namespace mobject {
   
   
   bool
-  PlacementIndex::contains (PlacementMO&)  const
+  PlacementIndex::contains (ID id)  const
   {
     UNIMPLEMENTED ("containment test: is the given Placement known within this index");
     return false;
   }
   
   
+  PlacementMO&
+  PlacementIndex::find (ID)  const
+  {
+    UNIMPLEMENTED ("main operation of PlacmentIndex: lookup a Placement by ID");
+  }
+    
+  
+  
+  PlacementMO&
+  PlacementIndex::getScope (ID)  const
+  {
+    UNIMPLEMENTED ("Secondary core operation of PlacmentIndex: find the 'parent' Placement by using the Placement relation index");
+  }
+  
+  
+  vector<PRef>
+  PlacementIndex::getReferrers (ID)  const
+  {
+    UNIMPLEMENTED ("query the Placement relation index and retrieve all other placements bound to this one by a placement-relation");
+  }
+  
+  
+  ID
+  PlacementIndex::insert (PlacementMO& newObj, PlacementMO& targetScope)
+  {
+    UNIMPLEMENTED ("store a new information record into PlacmentIndex: ID -> (ref-to-Placement, parent-Placement)");
+  }
+  
+  
+  bool
+  PlacementIndex::remove (ID)
+  {
+    UNIMPLEMENTED ("remove a information record from PlacementIndex, and also deregister any placement-relations bound to it");
+  }
+  
+  
   
   
   namespace { // implementation detail: default global placement index access
     
-    PIdx globalIndex (0);
+    PIdx globalIndex;
     
     PIdx const&
     getGlobalIndex()
@@ -105,23 +153,20 @@ namespace mobject {
   } // (End) implementation detail
   
   
-  /** @internal Factory for creating a new placement index.
-   *            For use by the Session and for unit tests.  
-   */
-  PlacementIndex::Factory PlacementIndex::create;
   
   
-  PIdx const&
-  reset_PlachementIndex(PIdx const& alternativeIndex)
+  
+  void
+  reset_PlacementIndex (PIdx const& alternativeIndex)
   {
     globalIndex = alternativeIndex;
   }
   
   /** @internal restore the implicit PlacementIndex to its default implementation (=the session) */
-  PIdx const&
-  reset_PlachementIndex()
+  void
+  reset_PlacementIndex()
   {
-    globalIndex.reset(0);
+    globalIndex.reset();
   }
   
   /** by default, this reaches for the PlacementIndex maintained within
@@ -129,11 +174,17 @@ namespace mobject {
    *  PlacementIndex may have been \link #reset_PlacementIndex installed \endlink 
    */
   Placement<MObject> &
-  fetch_PlachementIndex(Placement<MObject>::ID const& pID)
+  fetch_PlacementIndex (Placement<MObject>::ID const& pID)
   {
     return getGlobalIndex()->find (pID);
   }
-
+  
+  /** @internal used by PlacementRef to implement a self-check */
+  bool
+  checkContains_PlacementIndex (Placement<MObject>::ID const& pID)
+  {
+    return getGlobalIndex()->contains (pID);
+  }
 
 
 } // namespace mobject
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index 1f1635e7d..cc2616ae8 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -36,6 +36,7 @@
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
 //#include "proc/asset/pipe.hpp"
+#include "lib/util.hpp"
 #include "lib/factory.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
@@ -47,11 +48,12 @@
 
 
 namespace mobject {
-
+  
+  using lumiera::factory::RefcountFac;
   using std::tr1::shared_ptr;
   using boost::scoped_ptr;
   using std::vector;
-
+  
   class MObject;
   
   
@@ -67,7 +69,7 @@ namespace mobject {
     public:
       typedef Placement<MObject> PlacementMO;
       typedef PlacementRef<MObject> PRef;
-      typedef PlacementMO::ID ID;
+      typedef PlacementMO::ID const& ID;
       
       
       PlacementMO& find (ID)  const;
@@ -75,21 +77,21 @@ namespace mobject {
       template<class MO>
       Placement<MO>&  find (PlacementMO::Id<MO>)  const;
       template<class MO>
-      Placement<MO>&  find (PlacementRef<MO>)     const;
+      Placement<MO>&  find (PlacementRef<MO> const&)  const;
       
-      PlacementMO& getScope (PlacementMO&)  const;
-      PlacementMO& getScope (ID)            const;
+      PlacementMO& getScope (PlacementMO const&)  const;
+      PlacementMO& getScope (ID)                  const;
       
-      vector<PRef> getReferrers (ID)        const;
+      vector<PRef> getReferrers (ID)              const;
       
       
       /** retrieve the logical root scope */
-      PlacementMO& getRoot()                const;
+      PlacementMO& getRoot()                      const;
       
       /** diagnostic: number of indexed entries */
-      size_t size()                         const;
-      bool contains (PlacementMO const&)    const;
-      bool contains (ID const&)             const;
+      size_t size()                               const;
+      bool contains (PlacementMO const&)          const;
+      bool contains (ID)                          const;
       
       
       /* == mutating operations == */
@@ -99,13 +101,16 @@ namespace mobject {
       bool remove (ID);
       
       
-      typedef lumiera::factory::RefcountFac<PlacementIndex> Factory;
+      typedef RefcountFac<PlacementIndex> Factory;
       
       static Factory create;
       
+      ~PlacementIndex();
+      
     protected:
       PlacementIndex() ;
-      friend class Factory;
+      
+      friend class lumiera::factory::Factory<PlacementIndex, lumiera::factory::Wrapper<PlacementIndex, shared_ptr<PlacementIndex> > >;
     };
   ////////////////TODO currently just fleshing  out the API; probably have to split off an impl.class; but for now a PImpl is sufficient...
   
@@ -114,16 +119,59 @@ namespace mobject {
   /** @internal there is an implicit PlacementIndex available on a global scale,
    *            by default implemented within the current session. This function allows
    *            to re-define this implicit index temporarily, e.g. for unit tests. */
-  shared_ptr<PlacementIndex> const&
-  reset_PlachementIndex(shared_ptr<PlacementIndex> const&) ;
+  void
+  reset_PlacementIndex(shared_ptr<PlacementIndex> const&) ;
   
   /** @internal restore the implicit PlacementIndex to its default implementation (=the session) */
-  shared_ptr<PlacementIndex> const&
-  reset_PlachementIndex() ;
+  void
+  reset_PlacementIndex() ;
   
   /** @internal access point for PlacementRef to the implicit global PlacementIndex */
   Placement<MObject> &
-  fetch_PlachementIndex(Placement<MObject>::ID const&) ;
+  fetch_PlacementIndex(Placement<MObject>::ID const&) ;
+  
+  
+  
+  
+  /* === forwarding implementations of the templated API === */
+  
+  template<class MO>
+  inline Placement<MO>&
+  PlacementIndex::find (PlacementMO::Id<MO> id)  const
+  {
+    PlacementMO& result (find (id));
+    REQUIRE (INSTANCEOF (MO, &result) );
+    return static_cast<Placement<MO>&> (result);
+  }
+  
+    
+  template<class MO>
+  inline Placement<MO>&
+  PlacementIndex::find (PlacementRef<MO> const& pRef)  const
+  {
+    PlacementMO::Id<MO> id (pRef);
+    return find (id);
+  }
+  
+  
+  inline Placement<MObject>&
+  PlacementIndex::getScope (PlacementMO const& p)  const
+  {
+    return getScope(p.getID()); 
+  }
+  
+  inline bool
+  PlacementIndex::contains (PlacementMO const& p)  const
+  {
+    return contains (p.getID());
+  }
+  
+  inline bool
+  PlacementIndex::remove (PlacementMO& p)
+  {
+    return remove (p.getID());
+  }
+  
   
   
 } // namespace mobject
diff --git a/src/proc/mobject/placement-ref.hpp b/src/proc/mobject/placement-ref.hpp
index 64a04704f..9b8d8843a 100644
--- a/src/proc/mobject/placement-ref.hpp
+++ b/src/proc/mobject/placement-ref.hpp
@@ -22,6 +22,16 @@
 
 
 /** @file placement-ref.hpp 
+ **
+ ** @note there is a twist concerning the nominal Placement hierarchy
+ **       as generated by the return type of PlacementRef::operator*().
+ **       While the original Placement (as added to the session) might been
+ **       defined to mimic a more elaborate hierarchy (e.g. Placement<Track> 
+ **       inherits from Placement<Meta>), the Placement returned here in
+ **       these cases will just be a subclass or Placement<MObject>
+ **       (which in the mentioned example would mean it couldn't be
+ **       passed to a API function expecting a Placement<Meta>).
+ **       This is uggly, but doesn't seem to bear any danger.
  **
  ** @see Placement
  ** @see PlacementRef_test
@@ -36,7 +46,9 @@
 //#include "pre.hpp"
 //#include "proc/mobject/session/locatingpin.hpp"
 //#include "proc/asset/pipe.hpp"
+#include "lib/error.hpp"
 #include "proc/mobject/placement.hpp"
+#include "proc/mobject/explicitplacement.hpp"  /////////////TODO this is ugly! Why can't placement::resolve() return a reference??
 
 //#include <tr1/memory>
 
@@ -50,8 +62,13 @@ namespace mobject {
   
   // see placement-index.cpp 
   Placement<MObject> &
-  fetch_PlachementIndex(Placement<MObject>::ID const&) ;
+  fetch_PlacementIndex(Placement<MObject>::ID const&) ;
   
+  bool
+  checkContains_PlacementIndex (Placement<MObject>::ID const& pID) ;
+  
+  
+  LUMIERA_ERROR_DECLARE (INVALID_PLACEMENTREF);  ///< unresolvable placement reference, or of incompatible type
   
   /**
    */
@@ -59,7 +76,7 @@ namespace mobject {
   class PlacementRef
     {
       typedef Placement<MO>      PlacementMO;
-      typedef Placement<MObject>::ID     _ID;         ////TODO: superfluous...
+      typedef Placement<MObject>::ID     _ID;         ////TODO: could we define const& here??
       typedef Placement<MObject>::Id<MO> _Id;
       
       _Id id_;
@@ -96,7 +113,7 @@ namespace mobject {
       
       template<class X>
       PlacementRef (PlacementRef<X> const& r) ///< extended copy ctor, when type X is assignable to MO
-        : id_(r.id_)
+        : id_(recast(r))
         {
           validate(id_); 
         }
@@ -114,8 +131,8 @@ namespace mobject {
       PlacementRef&
       operator= (PlacementRef<X> const& r)
         {
-          validate(r.id_);
-          id_ = r.id_;
+          validate(recast (r));
+          id_ = recast(r);
           return *this;
         }
       
@@ -133,19 +150,65 @@ namespace mobject {
       
       PlacementMO& operator*()  const { return access(id_); } ///< dereferencing fetches referred Placement from Index
       
-      MO* operator->()          const { return access(id_); } ///< provide access to pointee API by smart-ptr chaining 
+      PlacementMO& operator->() const { return access(id_); } ///< provide access to pointee API by smart-ptr chaining 
       
       operator string()         const { return access(id_).operator string(); }
       size_t use_count()        const { return access(id_).use_count(); }
       
+      
+      /* == accessing the embedded ID == */
+      operator _Id const&()     const { return id_; }
+      LumieraUid getLUID()      const { return id_.get(); }
+      
+      template<class O>
+      bool operator== (PlacementRef<O> const& o)  const { return id_ == o; }
+      template<class O>
+      bool operator!= (PlacementRef<O> const& o)  const { return id_ != o; }
+      
+      
+      typedef _Id PlacementRef::*__unspecified_bool_type;
+      
+      /** implicit conversion to "bool" */ 
+      operator __unspecified_bool_type()  const { return  isValid()? &PlacementRef::id_ : 0; }  // never throws
+      bool operator! ()                   const { return !isValid(); }                         //  ditto
+      
+      
+      
+      /* == forwarding part of the Placement-API == */
+      
+      bool isValid()  const
+        { 
+          if (checkValidity())
+            try
+              {
+                return access(id_).isValid();
+              }
+            catch (lumiera::error::Invalid&) {}
+            
+          return false;
+        }
+      
+      ExplicitPlacement resolve() const { return access(id_).resolve();}
+      
+      
       ////////////////TODO more operations to come....
       
     private:
-      static void
-      validate (_Id rId)
+      bool
+      checkValidity ()  const
         {
-          if (!access(rId).isCompatible<MO>())
-            throw error::Invalid(LUMIERA_ERROR_INVALID_PLACEMENTREF);
+          return checkContains_PlacementIndex(this->id_);
+        }
+      
+      static void
+      validate (_Id const& rId)
+        {
+          PlacementMO& pRef (access (rId));
+          if (!(pRef.template isCompatible<MO>()))
+            throw lumiera::error::Invalid("actual type of the resolved placement is incompatible",LUMIERA_ERROR_INVALID_PLACEMENTREF);
+          
+                  ////////////////////////TODO: 1. better message, including type?
+                  ////////////////////////TODO: 2. define a separate error-ID for the type mismatch!
         }
       
       static _Id const&
@@ -162,10 +225,10 @@ namespace mobject {
         }
       
       static PlacementMO&
-      access (_Id placementID)
+      access (_Id const& placementID)
         {
-          Placement<MObject> & pla (fetch_PlachementIndex (placementID));  // may throw
-          REQUIRE (pla);
+          Placement<MObject> & pla (fetch_PlacementIndex (placementID));  // may throw
+          REQUIRE (pla.isValid());
           ASSERT (pla.isCompatible<MO>());
           return static_cast<PlacementMO&> (pla);
         }
diff --git a/src/proc/mobject/placement.hpp b/src/proc/mobject/placement.hpp
index 282cc89c4..4f2ff9d95 100644
--- a/src/proc/mobject/placement.hpp
+++ b/src/proc/mobject/placement.hpp
@@ -120,6 +120,7 @@ namespace mobject {
       public HashIndexed<Placement<MObject>, lib::hash::LuidH>     //////TODO: really need to be inherited publicly?
     {
     protected:
+      typedef HashIndexed<Placement<MObject>, lib::hash::LuidH> HashInd;
       typedef shared_ptr<MObject> _SmartPtr;
       typedef void (*Deleter)(MObject*);
       typedef lumiera::Time Time;
@@ -146,12 +147,14 @@ namespace mobject {
       bool
       isCompatible ()  const
         {
-          return 0 != dynamic_cast<const Y*> (get());
+          return 0 != dynamic_cast<Y*> (get());
         }
       
       
       operator string()   const ;
       size_t use_count()  const { return _SmartPtr::use_count(); }
+      bool   isValid()    const { return _SmartPtr::use_count(); }
+      
       
       virtual ~Placement() {};
       
@@ -168,6 +171,7 @@ namespace mobject {
        *  provide the resulting (explicit) placement.
        */
       virtual ExplicitPlacement resolve ()  const; 
+                               //////////////////////////TODO could resolve() return a reference?  Otherwise placement-ref.hpp needs to include ExplicitPlacement 
       
       
     protected:
@@ -194,6 +198,7 @@ namespace mobject {
     {
     protected:
       typedef Placement<B> _Parent;
+      typedef typename _Parent::template Id<MO> const& _ID;
       typedef typename _Parent::Deleter Deleter;
       typedef typename _Parent::_SmartPtr _SmartPtr;
       
@@ -211,6 +216,13 @@ namespace mobject {
           return static_cast<MO*>
             (_SmartPtr::operator-> ());
         }
+      
+      _ID
+      getID ()  const  ///< @note overrides HashIndexed::getID to pass specific type information,
+        { 
+          return _Parent::template recastID<MO>();
+        }
+      
     };
   
   
@@ -219,6 +231,7 @@ namespace mobject {
   
   
   /** @todo cleanup uses of ref-to-placement. See Trac #115 */
+  typedef Placement<MObject> PlacementMO; 
   typedef Placement<MObject> PMO; 
 
 
diff --git a/src/proc/mobject/session/locatingpin.cpp b/src/proc/mobject/session/locatingpin.cpp
index d1f4ba6dd..9191c818f 100644
--- a/src/proc/mobject/session/locatingpin.cpp
+++ b/src/proc/mobject/session/locatingpin.cpp
@@ -21,182 +21,181 @@
 * *****************************************************/
 
 
+#include "proc/mobject/mobject.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/session/locatingpin.hpp"
 #include "proc/mobject/session/fixedlocation.hpp"
 #include "proc/mobject/session/relativelocation.hpp"
 
-namespace mobject
+
+namespace mobject {
+namespace session {
+  
+  inline LocatingPin*
+  cloneChain (const scoped_ptr<LocatingPin>& chain)
   {
-  namespace session
-    {
-    inline LocatingPin*
-    cloneChain (const scoped_ptr<LocatingPin>& chain)
-    {
-      if (!chain) 
-        return 0;
-      else        
-        return chain->clone(); 
-    }
+    if (!chain) 
+      return 0;
+    else        
+      return chain->clone(); 
+  }
+  
+  
+  /** it's OK to copy a LocainngPin,
+   *  causing duplication of any chained lPins
+   */
+  LocatingPin::LocatingPin (const LocatingPin& other)
+    : next_(cloneChain (other.next_))
+  { }
+  
+  
+  LocatingPin& 
+  LocatingPin::operator= (const LocatingPin& other)
+  {
+    if (this != &other) 
+      this->next_.reset (cloneChain (other.next_));
+    return *this;
+  }
+  
+  
+  LocatingPin* 
+  LocatingPin::clone ()  const
+  {
+    return new LocatingPin(*this);
+  }
+  
+  
+  
+  LocatingPin&
+  LocatingPin::addChain (LocatingPin* newLp)  ///< @note we take ownership of newLp
+  {
+    REQUIRE (newLp);
+    REQUIRE (!newLp->next_, "can insert only single LocatingPins");
     
-    
-    /** it's OK to copy a LocainngPin,
-     *  causing duplication of any chained lPins
-     */
-    LocatingPin::LocatingPin (const LocatingPin& other)
-      : next_(cloneChain (other.next_))
-    { }
-    
-    
-    LocatingPin& 
-    LocatingPin::operator= (const LocatingPin& other)
-    {
-      if (this != &other) 
-        this->next_.reset (cloneChain (other.next_));
-      return *this;
-    }
-    
-    
-    LocatingPin* 
-    LocatingPin::clone ()  const
-    {
-      return new LocatingPin(*this);
-    }
-    
-    
-    
-    LocatingPin&
-    LocatingPin::addChain (LocatingPin* newLp)  ///< @note we take ownership of newLp
-    {
-      REQUIRE (newLp);
-      REQUIRE (!newLp->next_, "can insert only single LocatingPins");
-      
-      if (next_ && newLp->getPrioLevel() > next_->getPrioLevel())
-        return next_->addChain (newLp);
-      else
-        {
-          scoped_ptr<LocatingPin> tmp_next (newLp);
-          tmp_next->next_.swap(next_);
-          next_.swap(tmp_next);
-          return *newLp;
-        }
-    }
-
-    
-    /** implementing the core Placement functionality.
-     *  By combining all the chained locating pins, try
-     *  to get at a definite position (for this chain and
-     *  consequently for the MObject handled by the enclosing
-     *  Placement object).
-     *  @todo this could/should be replaced by a full-blown
-     *        constraint solver at some point in the future
-     *  @todo we are packing and unpacking the information (time,track)
-     *        several times. Ichthyo considers a more elegant solution.
-     */
-    const LocatingPin::SolutionData
-    LocatingPin::resolve ()  const
-    {
-      LocatingSolution solution;
-      resolve (solution);
-      return SolutionData (solution.getTime(), solution.getPipe());
-    }
-    
-    bool 
-    LocatingPin::isOverdetermined () const
-    {
-      LocatingSolution solution;
-      resolve (solution);
-      return solution.is_impossible(); 
-    }
-
-
-    
-    void 
-    LocatingPin::resolve (LocatingSolution& solution)  const
-    {
-      if (!solution.still_to_solve()) 
-        return;
-      this->intersect (solution);
-      if (next_ && solution.still_to_solve())
-        next_->resolve(solution);
-    }
-    
-    
-    void 
-    LocatingPin::intersect (LocatingSolution& solution)  const
-    {
-      REQUIRE (solution.still_to_solve());
-      // base class Implementation is NOP...
-    }
-    
-    
-    /** get some time value which could stand in for this
-     *  solution. This doesn't imply this value is a solution,
-     *  It's just a value we can use. At the moment (10/07),
-     *  LocatingSolution is implemented as interval, and
-     *  we return the lower bound here. 
-     */
-    LocatingPin::Time 
-    LocatingPin::LocatingSolution::getTime()
-    {
-      return minTime;   
-    }
-    
-    LocatingPin::Pipe
-    LocatingPin::LocatingSolution::getPipe()
-    {
-      UNIMPLEMENTED ("get effective Pipe of Solution");
-      return Pipe (); 
-    }
-    
-    
-    bool 
-    LocatingPin::LocatingSolution::is_definite()  ///< found a solution?
-    {
-      return (minTime == maxTime && minTrack == maxTrack);
-    }
-    
-    bool 
-    LocatingPin::LocatingSolution::is_impossible()
-    {
-      if (minTime > maxTime)  impo = true;
-      TODO ("track???");
-      return impo;
-    }
-    
-    bool
-    LocatingPin::LocatingSolution::still_to_solve () 
-    { 
-      return !(is_definite() || is_impossible()); 
-    }
-    
-    
-    
-    
-    
-
-    
-    
-    /* === Factory functions for adding LocatingPins === */
-    
-    FixedLocation&    
-    LocatingPin::operator() (Time start, Track track)
-    {
-      return static_cast<FixedLocation&> 
-                (addChain (new FixedLocation (start, track)));
-    }
-    
-    
-    RelativeLocation& 
-    LocatingPin::operator() (PlacementRef& refObj, Time offset)
-    {
-      return static_cast<RelativeLocation&> 
-                (addChain (new RelativeLocation (refObj, offset)));
-    }
-    
-    
-    
-    
-  } // namespace mobject::session
-
-} // namespace mobject
+    if (next_ && newLp->getPrioLevel() > next_->getPrioLevel())
+      return next_->addChain (newLp);
+    else
+      {
+        scoped_ptr<LocatingPin> tmp_next (newLp);
+        tmp_next->next_.swap(next_);
+        next_.swap(tmp_next);
+        return *newLp;
+      }
+  }
+  
+  
+  /** implementing the core Placement functionality.
+   *  By combining all the chained locating pins, try
+   *  to get at a definite position (for this chain and
+   *  consequently for the MObject handled by the enclosing
+   *  Placement object).
+   *  @todo this could/should be replaced by a full-blown
+   *        constraint solver at some point in the future
+   *  @todo we are packing and unpacking the information (time,track)
+   *        several times. Ichthyo considers a more elegant solution.
+   */
+  const LocatingPin::SolutionData
+  LocatingPin::resolve ()  const
+  {
+    LocatingSolution solution;
+    resolve (solution);
+    return SolutionData (solution.getTime(), solution.getPipe());
+  }
+  
+  bool 
+  LocatingPin::isOverdetermined () const
+  {
+    LocatingSolution solution;
+    resolve (solution);
+    return solution.is_impossible(); 
+  }
+  
+  
+  
+  void 
+  LocatingPin::resolve (LocatingSolution& solution)  const
+  {
+    if (!solution.still_to_solve()) 
+      return;
+    this->intersect (solution);
+    if (next_ && solution.still_to_solve())
+      next_->resolve(solution);
+  }
+  
+  
+  void 
+  LocatingPin::intersect (LocatingSolution& solution)  const
+  {
+    REQUIRE (solution.still_to_solve());
+    // base class Implementation is NOP...
+  }
+  
+  
+  /** get some time value which could stand in for this
+   *  solution. This doesn't imply this value is a solution,
+   *  It's just a value we can use. At the moment (10/07),
+   *  LocatingSolution is implemented as interval, and
+   *  we return the lower bound here. 
+   */
+  LocatingPin::Time 
+  LocatingPin::LocatingSolution::getTime()
+  {
+    return minTime;   
+  }
+  
+  LocatingPin::Pipe
+  LocatingPin::LocatingSolution::getPipe()
+  {
+    UNIMPLEMENTED ("get effective Pipe of Solution");
+    return Pipe (); 
+  }
+  
+  
+  bool 
+  LocatingPin::LocatingSolution::is_definite()  ///< found a solution?
+  {
+    return (minTime == maxTime && minTrack == maxTrack);
+  }
+  
+  bool 
+  LocatingPin::LocatingSolution::is_impossible()
+  {
+    if (minTime > maxTime)  impo = true;
+    TODO ("track???");
+    return impo;
+  }
+  
+  bool
+  LocatingPin::LocatingSolution::still_to_solve () 
+  { 
+    return !(is_definite() || is_impossible()); 
+  }
+  
+  
+  
+  
+  
+  
+  
+  
+  /* === Factory functions for adding LocatingPins === */
+  
+  FixedLocation&    
+  LocatingPin::operator() (Time start, Track track)
+  {
+    return static_cast<FixedLocation&> 
+              (addChain (new FixedLocation (start, track)));
+  }
+  
+  
+  RelativeLocation& 
+  LocatingPin::operator() (PlaRef& refObj, Time offset)
+  {
+    return static_cast<RelativeLocation&> 
+              (addChain (new RelativeLocation (refObj, offset)));
+  }
+  
+  
+  
+  
+}} // namespace mobject::session
diff --git a/src/proc/mobject/session/locatingpin.hpp b/src/proc/mobject/session/locatingpin.hpp
index fb09a0432..be45a1ad2 100644
--- a/src/proc/mobject/session/locatingpin.hpp
+++ b/src/proc/mobject/session/locatingpin.hpp
@@ -61,17 +61,19 @@ namespace asset { class Pipe; }
 namespace mobject {
   
   class MObject;
-
+  
 ///////////////////////////////////////////TODO: all those dependencies are just a plain mess right now.  
 //  
 //template<class MO, class B=MObject> 
 //class Placement ;
 //typedef Placement<MObject> PMO;
-
-  template<class MO =MObject>
+  
+  template<class MO>
   class PlacementRef;    ///TODO: as of 5/09 the idea is to phase out direct dependency on the placement class and recast those dependencies in terms of PlacementRef
-
-
+  
+  typedef PlacementRef<MObject> PlaRef;
+  
+  
   namespace session {
     
     class FixedLocation;
@@ -117,7 +119,7 @@ namespace mobject {
         /* Factory functions for adding LocatingPins */
         
         FixedLocation&    operator() (Time start, Track track=0);
-        RelativeLocation& operator() (PlacementRef<>& refObj, Time offset=Time(0));   //////////TODO: warning, just a dummy placeholder for now!!
+        RelativeLocation& operator() (PlacementRef<MObject>& refObj, Time offset=Time(0));   //////////TODO: warning, just a dummy placeholder for now!!
         
         LocatingPin (const LocatingPin&);
         LocatingPin& operator= (const LocatingPin&);
diff --git a/src/proc/mobject/session/relativelocation.hpp b/src/proc/mobject/session/relativelocation.hpp
index d5967b606..ff0d159f2 100644
--- a/src/proc/mobject/session/relativelocation.hpp
+++ b/src/proc/mobject/session/relativelocation.hpp
@@ -30,56 +30,52 @@
 
 
 
-namespace mobject
-  {
-  namespace session
+namespace mobject {
+namespace session {
+  
+  
+  /**
+   * @todo just a design sketch, nothing finished yet.
+   *       possibly to be reworked or phased out completely.
+   *       See Trac #100
+   */
+  class RelativeLocation : public LocatingPin
     {
-
-
-    /**
-     * @todo just a design sketch, nothing finished yet.
-     *       possibly to be reworked or phased out completely.
-     *       See Trac #100
-     */
-    class RelativeLocation : public LocatingPin
-      {
 //        const PMO & anchor_;  ////////////TODO: ooooops, this is a nasty design problem!!!
-        
-        const PlacementRef anchor_;
-        
-      public:
-
-        /**
-         * the possible kinds of RelativePlacements
-         */
-        enum RelType
-        { SAMETIME    /**< place subject at the same time as the anchor  */
-        , ATTACH      /**< attach subject to anchor (e.g. an effect to a clip) */
-        };
-
-      protected:
-        RelativeLocation (PlacementRef const& a, Time ofs) : anchor_(a), offset_(ofs) { }
-        friend class LocatingPin;
-
-        /** the kind of relation denoted by this Placement */
-        RelType relType;
-
-        /** Offset the actual position by this (time) value relative to the anchor point. */
-        Time offset_;
-        //TODO: suitable representation?
-        
-        
-        virtual void intersect (LocatingSolution&)  const;
-        
-        
-      public:
-        virtual RelativeLocation* clone ()  const;
-
+      
+      const PlaRef anchor_;
+      
+    public:
+      
+      /**
+       * the possible kinds of RelativePlacements
+       */
+      enum RelType
+      { SAMETIME    /**< place subject at the same time as the anchor  */
+      , ATTACH      /**< attach subject to anchor (e.g. an effect to a clip) */
       };
-
-
-
-  } // namespace mobject::session
-
-} // namespace mobject
+      
+    protected:
+      RelativeLocation (PlaRef const& a, Time ofs) : anchor_(a), offset_(ofs) { }
+      friend class LocatingPin;
+      
+      /** the kind of relation denoted by this Placement */
+      RelType relType;
+      
+      /** Offset the actual position by this (time) value relative to the anchor point. */
+      Time offset_;
+      //TODO: suitable representation?
+      
+      
+      virtual void intersect (LocatingSolution&)  const;
+      
+      
+    public:
+      virtual RelativeLocation* clone ()  const;
+      
+    };
+  
+  
+  
+}} // namespace mobject::session
 #endif
diff --git a/src/proc/mobject/session/sess-manager-impl.cpp b/src/proc/mobject/session/sess-manager-impl.cpp
index 9a8ef5d3e..4428e587d 100644
--- a/src/proc/mobject/session/sess-manager-impl.cpp
+++ b/src/proc/mobject/session/sess-manager-impl.cpp
@@ -145,8 +145,8 @@ namespace session {
   }
   
   
-  shared_ptr<PlacementIndex>
-  getCurrentIndex ()
+  shared_ptr<PlacementIndex>&
+  SessManagerImpl::getCurrentIndex ()
   {
     return static_cast<SessManagerImpl&> (Session::current).pImpl_->pIdx_;
   }
diff --git a/src/proc/mobject/session/session-impl.hpp b/src/proc/mobject/session/session-impl.hpp
index 0d98f0861..72b0a9001 100644
--- a/src/proc/mobject/session/session-impl.hpp
+++ b/src/proc/mobject/session/session-impl.hpp
@@ -110,7 +110,7 @@ namespace session {
       /* ==== proc layer internal API ==== */
       
       /** @internal access point for PlacementIndex and PlacementRef */
-      static shared_ptr<PlacementIndex> getCurrentIndex () ;  
+      static shared_ptr<PlacementIndex>& getCurrentIndex () ;  
       
     };
   
diff --git a/src/proc/mobject/session/track.hpp b/src/proc/mobject/session/track.hpp
index d58284dc6..5a9166a31 100644
--- a/src/proc/mobject/session/track.hpp
+++ b/src/proc/mobject/session/track.hpp
@@ -83,6 +83,7 @@ namespace session {
   
   /** Placement<Track> defined to be subclass of Placement<Meta> */
   template class Placement<session::Track, session::Meta>;
+  typedef Placement<session::Track, session::Meta> PTrack;
   
 } // namespace mobject
 #endif
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 5652a717e..b088a52b4 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -51,6 +51,16 @@ namespace test    {
   namespace command1 {
   
     ////////////////////////////////////////////TODO braindump
+/*  
+    bind: opFunc(a,b,c) -> op(void)
+    
+    curry(opFunc) (a) (b) (c)
+    
+    pAppl(func, x) ->  func2 (b, c)
+    
+    return bind( recursion(), param)
+     
+*/  
     ////////////////////////////////////////////TODO braindump
   
   }
@@ -72,7 +82,6 @@ namespace test    {
    */
   class CommandBasic_test : public Test
     {
-      typedef shared_ptr<PlacementIndex> PIdx;
       
       virtual void
       run (Arg) 
diff --git a/tests/components/proc/mobject/mobject-ref-test.cpp b/tests/components/proc/mobject/mobject-ref-test.cpp
index 8c25041d4..fad045ab4 100644
--- a/tests/components/proc/mobject/mobject-ref-test.cpp
+++ b/tests/components/proc/mobject/mobject-ref-test.cpp
@@ -28,6 +28,7 @@
 #include "proc/mobject/mobject-ref.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
+#include "proc/mobject/placement-index.hpp"
 #include "proc/mobject/session/clip.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
@@ -83,6 +84,7 @@ namespace test    {
           ASSERT (2 == pClip2.use_count());
           
           
+#if 0 /////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
           // Prepare an (test)Index
           typedef shared_ptr<PlacementIndex> PIdx;
           PIdx index (PlacementIndex::create());
@@ -125,6 +127,7 @@ namespace test    {
           ASSERT (0 == index->size());
           ASSERT (2 == pClip1.use_count());
           ASSERT (2 == pClip2.use_count());
+#endif ////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
           reset_PlacementIndex();
         }
       
@@ -133,6 +136,7 @@ namespace test    {
       void
       checkBuildMObjectRef (REF refObj, void* placementAdr)
         {
+#if 0 /////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
           MORef<Clip> rMO;
           ASSERT (!rMO);                    // still empty (not bound)
           cout << rMO             << endl;
@@ -167,11 +171,13 @@ namespace test    {
           ASSERT (exPla.time == start);     // recovered Placement resolves to the same time as provided by the proxied API
           ASSERT (4 == refP.use_count());   // but now we've indeed created an additional owner (exPla)
           ASSERT (4 == rMO.use_count());
+#endif ////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
         }
       
       void
-      checkLifecylce (PMObj const& p1, PMObj const& p1)
+      checkLifecylce (PMObj const& p1, PMObj const& p2)
         {
+#if 0 /////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
           ASSERT (2 == p1.use_count());
           ASSERT (2 == p2.use_count());
           
@@ -203,11 +209,13 @@ namespace test    {
           
           VERIFY_ERROR (INVALID_PLACEMENTREF, rMO.getPlacement() );
           VERIFY_ERROR (INVALID_MOBJECTREF,   rMO->getMedia()    );
+#endif ////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
         }
       
       void
       checkTypeHandling (LumieraUid luid)
         {
+#if 0 /////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
           MObjectRef rMObj;
           MORef<Clip> rClip;
           MORef<TestSubMO1> rSub1;
@@ -248,6 +256,7 @@ namespace test    {
           
           cout << rClip << endl;
           cout << rClip->getMedia()->ident << endl;
+#endif ////////////////////////////////////////////////////////////////////////////////////////TODO lots of things unimplemented.....!!!!!
         }
     };
   
diff --git a/tests/components/proc/mobject/placement-hierarchy-test.cpp b/tests/components/proc/mobject/placement-hierarchy-test.cpp
index 3da03055e..5feca7a21 100644
--- a/tests/components/proc/mobject/placement-hierarchy-test.cpp
+++ b/tests/components/proc/mobject/placement-hierarchy-test.cpp
@@ -27,6 +27,7 @@
 #include "proc/mobject/session/clip.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/asset/media.hpp"
+#include "lib/error.hpp"
 #include "lib/util.hpp"
 
 #include <tr1/memory>
@@ -47,7 +48,7 @@ namespace test    {
   using session::Clip;
   using lib::test::showSizeof;
   using namespace mobject::test;
-  using error::LUMIERA_ERROR_ASSERTION;
+  using lumiera::error::LUMIERA_ERROR_ASSERTION;
   
   
   /***************************************************************************************
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index e681843e8..5883b47f1 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -25,6 +25,7 @@
 #include "lib/lumitime.hpp"
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/placement-ref.hpp"
+#include "proc/mobject/placement-index.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
 
@@ -33,6 +34,7 @@
 using lumiera::Time;
 using std::string;
 using std::cout;
+using std::endl;
 
 
 namespace mobject {
@@ -40,7 +42,17 @@ namespace session {
 namespace test    {
   
   using namespace mobject::test;
-
+  typedef TestPlacement<TestSubMO21> PSub;
+  
+  
+  template<class A, class B>
+  inline bool
+  isSameObject (A const& a, B const& b)
+  {
+    return static_cast<const void*> (&a)
+        == static_cast<const void*> (&b);
+  }
+  
   
   /***************************************************************************
    * @test properties and behaviour of the reference-mechanism for Placements.
@@ -57,8 +69,6 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          typedef TestPlacement<TestSubMO21> PSub;
-          
           PSub p1(*new TestSubMO21);
           PSub p2(*new TestSubMO21);
           p2.chain(Time(2));         // define start time of Placement-2 to be at t=2
@@ -73,7 +83,7 @@ namespace test    {
           index->insert (p2, root);
           ASSERT (2 == index->size());
           
-          Placement::Id<TestSubMO21> id2 = p2.getID();
+          PlacementMO::Id<TestSubMO21> id2 = p2.recastID<TestSubMO21>();
           ASSERT (id2);
           ASSERT (id2 != p1.getID());
           
@@ -90,9 +100,9 @@ namespace test    {
           ASSERT (ref2 == refX);
           
           // indeed a "reference": resolves to the same memory location
-          ASSERT (&p1 == &*ref1);
-          ASSERT (&p2 == &*ref2);
-          ASSERT (&p2 == &*refX);
+          ASSERT (isSameObject (p1, *ref1));
+          ASSERT (isSameObject (p2, *ref2));
+          ASSERT (isSameObject (p2, *refX));
 
           cout << string(*ref1) << endl;
           cout << string(*ref2) << endl;
@@ -106,7 +116,7 @@ namespace test    {
           ASSERT (exPla.time == 2);                // indeed get back the time we set on p2 above
           ASSERT (2 == ref2.use_count());          // exPla shares ownership with p2
           
-          ASSERT (indey->contains(ref1));          // ref can stand-in for a placement-ID 
+          ASSERT (index->contains(ref1));          // ref can stand-in for a placement-ID 
           ASSERT (sizeof(id2) == sizeof(ref2));    // (and is actually implemented based on an ID)
           
           // assignment on placement refs
@@ -118,24 +128,24 @@ namespace test    {
           // re-assignment with a new placement
           refX = p2;
           ASSERT (refX == ref2);
-          ASSERT (&*refX == &p2);
+          ASSERT (isSameObject (*refX, p2));
           refX = p1.getID();
           ASSERT (refX == ref1);
           ASSERT (refX != ref2);
-          ASSERT (&*refX == &p1);
+          ASSERT (isSameObject (*refX, p1));
           
           LumieraUid luid2 (p2.getID().get());
           refX = luid2;                            // assignment works even based on a plain LUID
           ref2 = ref1;                             
           ref1 = refX;                             // dynamic type check when downcasting  
-          ASSERT (&p1 == &*ref2);
-          ASSERT (&p2 == &*ref1);
+          ASSERT (isSameObject (p1, *ref2));
+          ASSERT (isSameObject (p2, *ref1));
           refX = ref2;
           ref2 = ref1;
           ref1 = refX;
-          ASSERT (&p1 == &*ref1);
-          ASSERT (&p1 == &*refX);
-          ASSERT (&p2 == &*ref2);
+          ASSERT (isSameObject (p1, *ref1));
+          ASSERT (isSameObject (p1, *refX));
+          ASSERT (isSameObject (p2, *ref2));
           ASSERT (ref1 != ref2);
           ASSERT (ref1 == refX);
           ASSERT (ref2 != refX);
diff --git a/tests/components/proc/mobject/session/deletecliptest.cpp b/tests/components/proc/mobject/session/deletecliptest.cpp
index 0c16a7af2..10b6bb3df 100644
--- a/tests/components/proc/mobject/session/deletecliptest.cpp
+++ b/tests/components/proc/mobject/session/deletecliptest.cpp
@@ -43,56 +43,51 @@ using proc_interface::IDA;
 using std::tr1::dynamic_pointer_cast;        /// TODO only temp
 
 
-namespace mobject
-  {
-  namespace session
+namespace mobject {
+namespace session {
+namespace test    {
+  
+  
+  
+  
+  /*******************************************************************
+   * @test removing a test clip from the EDL.
+   * @see  mobject::session::Clip
+   * @see  mobject::session::EDL
+   */
+  class DeleteClip_test : public Test
     {
-    namespace test
-      {
-      
-      
-      
-      
-      /*******************************************************************
-       * @test removing a test clip from the EDL.
-       * @see  mobject::session::Clip
-       * @see  mobject::session::EDL
-       */
-      class DeleteClip_test : public Test
+      virtual void
+      run (Arg) 
         {
-          virtual void
-          run (Arg) 
-            {
-              buildTestseesion1();
-              PSess sess = Session::current;
-              AssetManager& aMang = AssetManager::instance();
-              
-              UNIMPLEMENTED("typesafe searching for MObjects in the EDL");
+          buildTestsession1();
+          PSess sess = Session::current;
+          AssetManager& aMang = AssetManager::instance();
+          
+          UNIMPLEMENTED("typesafe searching for MObjects in the EDL");
+          
+          
+#if false /////////////////////////////////////////////////////////////////////////////////////////////////////TODO: work out how to search within EDL!!
+                
+          PClipMO clipPlacement = sess->currEDL().find(SESSION1_CLIP); 
+                                                              // global Var asigned in buildTestsession1()
+          PMedia media = clipPlacement->getMedia();
+          IDA clipAID = media->getID();
+          ASSERT (clipPlacement);
+          
+          sess->remove (clipPlacement);
+          
+          ASSERT (!sess->currEDL().find(SESSION1_CLIP));            // EDL forgot the Clip/Placement
+          ASSERT (!aMang.known (clipAID));                          // corresponding Clip Asset has disappeared
+          ASSERT (!clipPlacement->getMedia());                      // internal cross-links removed
+#endif    /////////////////////////////////////////////////////////////////////////////////////////////////////TODO: work out how to search within EDL!!
+        }
+    };
   
-///////TODO: work out how to search within EDL!!
-//              
-//              PClipMO clipPlacement = sess->currEDL().find(SESSION1_CLIP); 
-//                                                              // global Var asigned in buildTestsession1()
-//              PMedia media = clipPlacement->getMedia();
-//              IDA clipAID = media->getID();
-//              ASSERT (clipPlacement);
-//              
-//              sess->remove (clipPlacement);
-//              
-//              ASSERT (!sess->currEDL().find(SESSION1_CLIP));            // EDL forgot the Clip/Placement
-//              ASSERT (!aMang.known (clipAID));                          // corresponding Clip Asset has disappeared 
-//              ASSERT (!clipPlacement->getMedia());                      // internal cross-links removed
-            } 
-        };
-      
-      
-      /** Register this test class... */
-      LAUNCHER (DeleteClip_test, "function session");
-      
-      
-      
-    } // namespace test
   
-  } // namespace session
-
-} // namespace mobject
+  /** Register this test class... */
+  LAUNCHER (DeleteClip_test, "function session");
+  
+  
+  
+}}} // namespace mobject::session::test
diff --git a/tests/components/proc/mobject/session/rebuildfixturetest.cpp b/tests/components/proc/mobject/session/rebuildfixturetest.cpp
index a4e81328d..8a0612a0b 100644
--- a/tests/components/proc/mobject/session/rebuildfixturetest.cpp
+++ b/tests/components/proc/mobject/session/rebuildfixturetest.cpp
@@ -39,62 +39,55 @@ using std::string;
 using std::cout;
 
 
-namespace mobject
-  {
-  namespace session
-    {
-    namespace test
-      {
-      
-      
-      
-      
-      /*******************************************************************
-       * @test (re)building the ExplicitPlacement objects from the objects
-       *       placed into the Session/EDL.
-       * @see  mobject::session::Fixture
-       * @see  mobject::ExplicitPlacement
-       */
-      class RebuildFixture_test : public Test
-        {
-          virtual void
-          run (Arg arg) 
-            {
-              PSess sess = Session::current;
-              sess.clear();
-              buildTestseesion1();
-              ASSERT (sess->isValid());
-              sess->rebuildFixture();
-              TODO ("check the fixture has been touched. e.g. by hash.");
-              TODO ("query all Placements of all Clips (via AssetManager). Verify explicit plac contained in Fixture.");
-
-              UNIMPLEMENTED ("iterate over fixture");
-// TODO              
-//            for_each (sess->getFixture(), 
-//                      bind (&check_is_from_EDL, _1, sess.getEDL()));
-              
-              TODO ("can we check the other direction, from EDL to Fixture??");
-            } 
-          
-          static void 
-          check_is_from_EDL (PMO explicitPlacement, EDL& edl)
-            {
-              
-////TODO do we still support this? can it be replaced by a directly checking predicate on ExplicitPlacement??
-              
-//              PMO originalPlacement = explicitPlacement->subject->getPlacement();
-//              ASSERT (edl.contains(originalPlacement));
-            }
-        };
-      
-      
-      /** Register this test class... */
-      LAUNCHER (RebuildFixture_test, "unit session");
-      
-      
-      
-    } // namespace test
+namespace mobject {
+namespace session {
+namespace test    {
   
-  } // namespace session
-
-} // namespace mobject
+  
+  
+  
+  /*******************************************************************
+   * @test (re)building the ExplicitPlacement objects from the objects
+   *       placed into the Session/EDL.
+   * @see  mobject::session::Fixture
+   * @see  mobject::ExplicitPlacement
+   */
+  class RebuildFixture_test : public Test
+    {
+      virtual void
+      run (Arg arg)
+        {
+          PSess sess = Session::current;
+          sess.clear();
+          buildTestsession1();
+          ASSERT (sess->isValid());
+          sess->rebuildFixture();
+          TODO ("check the fixture has been touched. e.g. by hash.");
+          TODO ("query all Placements of all Clips (via AssetManager). Verify explicit plac contained in Fixture.");
+          
+          UNIMPLEMENTED ("iterate over fixture");
+// TODO              
+//        for_each (sess->getFixture(), 
+//                  bind (&check_is_from_EDL, _1, sess.getEDL()));
+          
+          TODO ("can we check the other direction, from EDL to Fixture??");
+        }
+      
+      static void 
+      check_is_from_EDL (PMO explicitPlacement, EDL& edl)
+        {
+          
+////TODO do we still support this? can it be replaced by a directly checking predicate on ExplicitPlacement??
+          
+//        PMO originalPlacement = explicitPlacement->subject->getPlacement();
+//        ASSERT (edl.contains(originalPlacement));
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (RebuildFixture_test, "unit session");
+  
+  
+  
+}}} // namespace mobject::session::test
diff --git a/tests/components/proc/mobject/session/sessionmanagertest.cpp b/tests/components/proc/mobject/session/sessionmanagertest.cpp
index ee09393be..7611c9ae5 100644
--- a/tests/components/proc/mobject/session/sessionmanagertest.cpp
+++ b/tests/components/proc/mobject/session/sessionmanagertest.cpp
@@ -33,111 +33,109 @@ using std::string;
 using std::cout;
 
 
-namespace mobject
-  {
-  namespace session
-    {
-    namespace test
-      {
-      
-      
-      /*******************************************************************************
-       * Check the session management operations provided by mobject::session::Seesion
-       * This includes accessing the current Session (somewhat a singleton).
-       * @todo load a Mock session
-       * @todo create a session and save (serialize) it
-       * @todo load a real test session
-       */
-      class SessionManager_test : public Test
-        {
-          virtual void
-          run (Arg arg) 
-            {
-              getCurrentSession ();
-              clearSession();
-              loadMockSession();
-              
-              clearSession();
-              buildTestseesion1();
-              string serialized;
-              saveSession (serialized);
-              loadSession (serialized);
-              ASSERT (checkTestsession1());
-            } 
-          
-          /** @test accessing the current (global) session 
-           */
-          void
-          getCurrentSession ()
-            {
-              PSess sess = Session::current;
-              ASSERT (sess->isValid());
-            }
-          
-          /** @test clear current session contents 
-           *        without resetting global session config.
-           * @todo  implement all session content, implement 
-           *        mobject and asset deletion operations.
-           */
-          void
-          clearSession ()
-            {
-              UNIMPLEMENTED ("clear objects in current session");
-              Session::current.clear();
-            }
-          
-          /** @test reset global session config and start with
-           *        a pristine default session. 
-           * @todo  define the "global session config", implement session default ctor
-           */
-          void
-          resetSession ()
-            {
-              UNIMPLEMENTED ("construct a pristine session");
-              Session::current.reset();
-            }
-          
-          /** @test use a mock session serializer to load 
-           *        a preconfigured test session. Verify
-           *        objects are wired correctly.
-           *  @todo implement rebuilding session, implement mock session serializer 
-           */
-          void
-          loadMockSession ()
-            {
-              UNIMPLEMENTED ("rebuild session using a mock serializer");
-            }
-          
-          /** @test load serialized session using the
-           *        real session serializer implementation.
-           * @param src string with serialized session data
-           * @todo  implement real session serializer 
-           */
-          void
-          loadSession (const string& src)
-            {
-              UNIMPLEMENTED ("loding real sesion");
-            }
-          
-          /** @test serialize (save) the current session
-           * @param dest string recieving the generated serialized stream
-           * @todo  implement real session serializer
-           */
-          void
-          saveSession (string& dest)
-            {
-              UNIMPLEMENTED ("serialize current session");
-            }
-        };
-      
-      
-      /** Register this test class... */
-      LAUNCHER (SessionManager_test, "function session");
-      
-      
-      
-    } // namespace test
+namespace mobject {
+namespace session {
+namespace test    {
   
-  } // namespace session
-
-} // namespace mobject
+  
+  /*******************************************************************************
+   * Check the session management operations provided by mobject::session::Session
+   * This includes accessing the current Session (somewhat a singleton).
+   * @todo load a Mock session
+   * @todo create a session and save (serialise) it
+   * @todo load a real test session
+   */
+  class SessionManager_test : public Test
+    {
+      virtual void
+      run (Arg arg) 
+        {
+          getCurrentSession ();
+          clearSession();
+          loadMockSession();
+          
+          clearSession();
+          buildTestsession1();
+          string serialized;
+          saveSession (serialized);
+          loadSession (serialized);
+          ASSERT (checkTestsession1());
+        } 
+      
+      
+      /** @test accessing the current (global) session */
+      void
+      getCurrentSession ()
+        {
+          PSess sess = Session::current;
+          ASSERT (sess->isValid());
+        }
+      
+      
+      /** @test clear current session contents 
+       *        without resetting global session config.
+       * @todo  implement all session content, implement
+       *        mobject and asset deletion operations.
+       */
+      void
+      clearSession ()
+        {
+          UNIMPLEMENTED ("clear objects in current session");
+          Session::current.clear();
+        }
+      
+      
+      /** @test reset global session config and start with
+       *        a pristine default session. 
+       * @todo  define the "global session config", implement session default ctor
+       */
+      void
+      resetSession ()
+        {
+          UNIMPLEMENTED ("construct a pristine session");
+          Session::current.reset();
+        }
+      
+      
+      /** @test use a mock session serialiser to load 
+       *        a preconfigured test session. Verify
+       *        objects are wired correctly.
+       *  @todo implement rebuilding session, implement mock session serialiser
+       */
+      void
+      loadMockSession ()
+        {
+          UNIMPLEMENTED ("rebuild session using a mock serialiser");
+        }
+      
+      
+      /** @test load serialised session using the
+       *        real session serialiser implementation.
+       * @param src string with serialised session data
+       * @todo  implement real session serialiser 
+       */
+      void
+      loadSession (const string& src)
+        {
+          UNIMPLEMENTED ("loading real session");
+        }
+      
+      
+      /** @test serialise (save) the current session
+       * @param dest string receiving the generated serialised stream
+       * @todo  implement real session serialiser
+       */
+      void
+      saveSession (string& dest)
+        {
+          UNIMPLEMENTED ("Serialise current session");
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (SessionManager_test, "function session");
+  
+  
+  
+}}} // namespace mobject::session::test
diff --git a/tests/components/proc/mobject/session/testclip.cpp b/tests/components/proc/mobject/session/testclip.cpp
index e284f0de2..add7277d8 100644
--- a/tests/components/proc/mobject/session/testclip.cpp
+++ b/tests/components/proc/mobject/session/testclip.cpp
@@ -28,65 +28,59 @@
 #include "proc/asset/clip.hpp"
 #include "lib/singleton.hpp"
 
-namespace mobject
-  {
-  namespace session
-    {
-    namespace test
-      {
-      typedef shared_ptr<asset::Media> PM;
-      typedef backend_interface::MediaAccessFacade MAF;
-      using backend_interface::test::MediaAccessMock;
-      using asset::VIDEO;
-
-      
-      
-      asset::Media & 
-      createTestMedia ()
-      {
-        // install Mock-Interface to Lumiera backend
-        MAF::instance.injectSubclass (new MediaAccessMock);
-        PM media = asset::Media::create("test-2", VIDEO); // query magic filename
-        MAF::instance.injectSubclass (0); // remove Mock-Interface
-        
-        return *media;
-      }
-      
-      asset::Clip & 
-      createTestClipAsset (asset::Media& media)
-      {
-        return *(asset::Media::create(media)); 
-      }
-      
-    
-      struct Testbed
-        {
-          asset::Media & media_;
-          asset::Clip & clipA_;
-          
-          Testbed() 
-            : media_ (createTestMedia()),
-              clipA_ (createTestClipAsset(media_))
-            { }
-        };
-          
-      lumiera::Singleton<Testbed> testbed_1; // invoke ctor when creating first TestClip... 
-
-      
-      
-      
-
-      TestClip::TestClip ()
-        : Clip(testbed_1().clipA_,
-               testbed_1().media_)
-      {
-        ASSERT (isValid());
-      }
-      
-
-
-    } // namespace test
+namespace mobject {
+namespace session {
+namespace test    {
   
-  } // namespace session
-
-} // namespace mobject
+  typedef shared_ptr<asset::Media> PM;
+  typedef backend_interface::MediaAccessFacade MAF;
+  using backend_interface::test::MediaAccessMock;
+  using asset::VIDEO;
+  
+  
+  
+  asset::Media & 
+  createTestMedia ()
+  {
+    // install Mock-Interface to Lumiera backend
+    MAF::instance.injectSubclass (new MediaAccessMock);
+    PM media = asset::Media::create("test-2", VIDEO); // query magic filename
+    MAF::instance.injectSubclass (0); // remove Mock-Interface
+    
+    return *media;
+  }
+  
+  asset::Clip & 
+  createTestClipAsset (asset::Media& media)
+  {
+    return *(asset::Media::create(media));
+  }
+  
+  
+  struct Testbed
+    {
+      asset::Media & media_;
+      asset::Clip & clipA_;
+      
+      Testbed() 
+        : media_ (createTestMedia()),
+          clipA_ (createTestClipAsset(media_))
+        { }
+    };
+      
+  lumiera::Singleton<Testbed> testbed_1; // invoke ctor when creating first TestClip...
+  
+  
+  
+  
+  
+  TestClip::TestClip ()
+    : Clip(testbed_1().clipA_,
+           testbed_1().media_)
+  {
+    ASSERT (isValid());
+  }
+  
+  
+  
+}}} // namespace mobject::session::test
diff --git a/tests/components/proc/mobject/session/testclip.hpp b/tests/components/proc/mobject/session/testclip.hpp
index 8f9f58c31..dbac88087 100644
--- a/tests/components/proc/mobject/session/testclip.hpp
+++ b/tests/components/proc/mobject/session/testclip.hpp
@@ -36,54 +36,49 @@ using std::tr1::shared_ptr;
 using std::string;
 
 
-namespace mobject
-  {
-  namespace session
-    {
-    namespace test
-      {
-      class TestPlacement;
-       
-      /**
-       * Sample or Test Clip for checking
-       * various EDL, session and builder operations.
-       * @todo make this usable as Mock object to record invoked operations.
-       * 
-       */
-      class TestClip   : public mobject::session::Clip
-        {
-          
-          TestClip ();
-          static void deleter (MObject* mo) { delete (TestClip*)mo; }
-
-          friend class TestPlacement;  
-          
-        public:
-          static Placement<Clip> create () ;
-        };
-
-        
-      class TestPlacement : public Placement<Clip>
-        {
-          
-        public:
-          TestPlacement (TestClip & subject)
-            : Placement<Clip> (subject, &TestClip::deleter)
-            { }
-        };
-
-        
-      inline Placement<Clip>
-      TestClip::create()
-      { 
-        return TestPlacement (*new TestClip); 
-      }
-    
-    
-    
-    } // namespace test
+namespace mobject {
+namespace session {
+namespace test    {
   
-  } // namespace session
-
-} // namespace mobject
+  
+  class TestPlacement;
+  
+  /**
+   * Sample or Test Clip for checking
+   * various EDL, session and builder operations.
+   * @todo make this usable as Mock object to record invoked operations.
+   * 
+   */
+  class TestClip   : public mobject::session::Clip
+    {
+      
+      TestClip ();
+      static void deleter (MObject* mo) { delete (TestClip*)mo; }
+      
+      friend class TestPlacement;
+      
+    public:
+      static Placement<Clip> create () ;
+    };
+  
+  
+  class TestPlacement : public Placement<Clip>
+    {
+      
+    public:
+      TestPlacement (TestClip & subject)
+        : Placement<Clip> (subject, &TestClip::deleter)
+        { }
+    };
+  
+  
+  inline Placement<Clip>
+  TestClip::create()
+  {
+    return TestPlacement (*new TestClip);
+  }
+  
+  
+  
+}}} // namespace mobject::session::test
 #endif

From e3da08201695dec29d3b6316a2dbbdc3677692a9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 10 Jun 2009 03:42:23 +0200
Subject: [PATCH 097/368] WIP idea to allow arbitrary command parameters

---
 src/proc/control/command-def.hpp              |   4 +
 .../proc/control/command-basic-test.cpp       | 101 +++++++++++++++++-
 2 files changed, 102 insertions(+), 3 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index fa3be7f3d..9850c7abf 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -68,8 +68,12 @@ namespace control {
    */
   class CommandDef
     {
+      Symbol id_;
       
     public:
+      CommandDef (Symbol cmdID)
+        : id_(cmdID)
+        { }
       
     };
   ////////////////TODO currently just fleshing  out the API....
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index b088a52b4..999124c18 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -26,16 +26,21 @@
 //#include "proc/mobject/session.hpp"
 //#include "proc/mobject/session/edl.hpp"
 //#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+#include "lib/p.hpp"
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/util.hpp"
 
+#include <tr1/functional>
 //#include <boost/format.hpp>
 //#include <iostream>
 #include <string>
 
+//using std::tr1::bind;
+using std::tr1::function;
 //using boost::format;
 //using lumiera::Time;
 //using util::contains;
@@ -47,10 +52,71 @@ namespace control {
 namespace test    {
 
 //  using session::test::TestClip;
+  using lib::P;
 
-  namespace command1 {
+  ////////////////////////////////////////////TODO braindump
   
-    ////////////////////////////////////////////TODO braindump
+  template<typename SIG, typename MEM>
+  struct BuildUndoCapturing_Signature;
+  
+  template<typename ARG, typename MEM>
+  struct BuildUndoCapturing_Signature<function(ARG), MEM>
+    {
+      typedef function<MEM(ARG)> type;
+    };
+  
+  template<typename SIG, typename MEM>
+  struct BuildUndoOperation_Signature
+    {
+      typedef function<void(ExtendedArgs)> type;
+    };
+  
+  class CommDef
+    {
+      Symbol id_;
+      
+      template<typename SIG, typename MEM>
+      struct UndoDefinition
+        {
+          UndoDefinition
+          undoOperation (typename BuildUndoOperation_Signature<SIG,MEM>::type how_to_Undo)
+            {
+              
+            }
+          
+        };
+      
+      template<typename SIG>
+      struct BasicDefinition
+        {
+          template<typename MEM>
+          UndoDefinition<SIG,MEM>
+          captureUndo (typename BuildUndoCapturing_Signature<function<SIG>,MEM>::type how_to_capture_UndoState)
+            {
+              
+            }
+          
+        };
+      
+    public:
+      CommDef (Symbol cmdID)
+        : id_(cmdID)
+        { }
+      
+      template<typename SIG>
+      BasicDefinition<SIG>
+      operation (function<SIG> operation_to_define)
+        {
+          
+        }
+    };
+  
+  
+  
+  
+  /////////////////////////////
+  /////////////////////////////
+
 /*  
     bind: opFunc(a,b,c) -> op(void)
     
@@ -61,10 +127,28 @@ namespace test    {
     return bind( recursion(), param)
      
 */  
-    ////////////////////////////////////////////TODO braindump
+  namespace command1 {
+    void
+    command1_do (P<long> dummyObj, int randVal)
+    {
+      *dummyObj += randVal;
+    }
+    
+    long
+    command1_cap (P<long> dummyObj, int)
+    {
+      return *dummyObj;
+    }
+    
+    void
+    command1_undo (P<long> dummyObj, int, long oldVal)
+    {
+      *dummyObj = oldVal;
+    }
   
   }
   
+  ////////////////////////////////////////////TODO braindump
   
   
   /***************************************************************************
@@ -89,6 +173,17 @@ namespace test    {
           /////////////////////////////////TODO
         }
       
+      void
+      defineCommands ()
+        {
+          CommDef ("test.command1")
+              .operation (command1_do)
+              .captureUndo (command1_cap)
+              .undoOperation (command1_undo)
+              .bind (obj, randVal)
+              ;
+        }
+      
       void
       checkExecution ()
         {

From 246529bae93ead9292b32b20ca154fe4d70e5ded Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 10 Jun 2009 05:00:01 +0200
Subject: [PATCH 098/368] concpet draft of parameter type extraction and
 checking works (i.e. compiles)

---
 src/lib/meta/typelist.hpp                     |  10 +-
 src/proc/control/command-def.hpp              |   3 +-
 .../proc/control/command-basic-test.cpp       | 240 ++++++++++++++++--
 3 files changed, 221 insertions(+), 32 deletions(-)

diff --git a/src/lib/meta/typelist.hpp b/src/lib/meta/typelist.hpp
index c2d4568d0..726381bf5 100644
--- a/src/lib/meta/typelist.hpp
+++ b/src/lib/meta/typelist.hpp
@@ -59,10 +59,8 @@ This code is heavily inspired by
 
 
 
-namespace lumiera
-  {
-  namespace typelist
-    {
+namespace lumiera {
+namespace typelist{
     
     class NullType 
       { 
@@ -120,7 +118,5 @@ namespace lumiera
     typedef Node<NullType,NullType> NodeNull;
     
     
-  } // namespace typelist
-
-} // namespace lumiera
+}} // namespace lumiera::typelist
 #endif
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 9850c7abf..a6b6c2c1d 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -48,6 +48,7 @@
 #define CONTROL_COMMAND_H
 
 //#include "pre.hpp"
+#include "include/symbol.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/mutation.hpp"
 #include "proc/control/command-closure.hpp"
@@ -59,7 +60,7 @@
 
 namespace control {
   
-//  using lumiera::Symbol;
+  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
   
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 999124c18..00fac7b28 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -32,45 +32,231 @@
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-def.hpp"
+#include "lib/lumitime.hpp"
 //#include "lib/util.hpp"
 
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/typelistutil.hpp"
+
 #include <tr1/functional>
 //#include <boost/format.hpp>
 //#include <iostream>
 #include <string>
 
-//using std::tr1::bind;
+using std::tr1::bind;
+//using std::tr1::placeholders::_1;
+//using std::tr1::placeholders::_2;
 using std::tr1::function;
 //using boost::format;
-//using lumiera::Time;
+using lumiera::Time;
 //using util::contains;
 using std::string;
 //using std::cout;
 
 
+namespace lumiera {
+namespace typelist{
+
+
+  ////////////////////////////////////////////TODO braindump
+  
+  template< typename SIG>
+  struct FunctionSignature;
+  
+  template< typename RET>
+  struct FunctionSignature< function<RET(void)> >
+  {
+    typedef RET Ret;
+    typedef Types<> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionSignature< function<RET(A1)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionSignature< function<RET(A1,A2)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5> Args;
+  };
+  
+  
+  template<typename RET, typename LI>
+  struct FunctionTypedef;
+  
+  template< typename RET>
+  struct FunctionTypedef<RET, Types<> >
+  {
+    typedef function<RET(void)> Func;
+    typedef          RET Sig();
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionTypedef<RET, Types<A1> >
+  {
+    typedef function<RET(A1)> Func;
+    typedef          RET Sig(A1);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionTypedef<RET, Types<A1,A2> >
+  {
+    typedef function<RET(A1,A2)> Func;
+    typedef          RET Sig(A1,A2);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3> >
+  {
+    typedef function<RET(A1,A2,A3)> Func;
+    typedef          RET Sig(A1,A2,A3);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
+  {
+    typedef function<RET(A1,A2,A3,A4)> Func;
+    typedef          RET Sig(A1,A2,A3,A4);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5);
+  };
+  
+  
+  
+  
+  template<class T, class TYPES>
+  struct Prepend;
+  
+  template< typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename IGN
+          >
+  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
+  {
+    typedef Types<A1,A2,A3,A4,A5> Tuple;
+  };
+
+  template<class LI>
+  struct Tuple;
+
+  template<>
+  struct Tuple<NullType>
+    {
+      typedef Types<> Type;
+    };
+  
+  template<class TY, class TYPES>
+  struct Tuple<Node<TY,TYPES> >
+    {
+      typedef typename Prepend<TY, typename Tuple<TYPES>::Type >::Tuple Type;
+    };
+  
+  
+  
+}} // namespace lumiera::typelist
+  
 namespace control {
 namespace test    {
 
 //  using session::test::TestClip;
-  using lib::P;
-
-  ////////////////////////////////////////////TODO braindump
+  using lumiera::P;
+  
+  using lumiera::typelist::FunctionSignature;
+  using lumiera::typelist::FunctionTypedef;
+  
+  using lumiera::typelist::Tuple;
+  using lumiera::typelist::Append;
   
   template<typename SIG, typename MEM>
-  struct BuildUndoCapturing_Signature;
-  
-  template<typename ARG, typename MEM>
-  struct BuildUndoCapturing_Signature<function(ARG), MEM>
+  struct BuildUndoCapturing_Signature
     {
-      typedef function<MEM(ARG)> type;
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionTypedef<MEM,Args>::Sig           type;
     };
   
   template<typename SIG, typename MEM>
   struct BuildUndoOperation_Signature
     {
-      typedef function<void(ExtendedArgs)> type;
+      typedef typename FunctionSignature< function<SIG> >::Args::List Args;
+      typedef typename Append<Args, MEM>::List                        ExtendedArglist;
+      typedef typename Tuple<ExtendedArglist>::Type                   ExtendedArgs;
+      typedef typename FunctionTypedef<void, ExtendedArgs>::Sig       type;
     };
   
+  
   class CommDef
     {
       Symbol id_;
@@ -78,9 +264,12 @@ namespace test    {
       template<typename SIG, typename MEM>
       struct UndoDefinition
         {
+          typedef typename BuildUndoOperation_Signature<SIG,MEM>::type UndoSig; 
+          
           UndoDefinition
-          undoOperation (typename BuildUndoOperation_Signature<SIG,MEM>::type how_to_Undo)
+          undoOperation (UndoSig& how_to_Undo)
             {
+              function<UndoSig> opera3 (how_to_Undo);
               
             }
           
@@ -91,8 +280,11 @@ namespace test    {
         {
           template<typename MEM>
           UndoDefinition<SIG,MEM>
-          captureUndo (typename BuildUndoCapturing_Signature<function<SIG>,MEM>::type how_to_capture_UndoState)
+          captureUndo (typename BuildUndoCapturing_Signature<SIG,MEM>::type& how_to_capture_UndoState)
             {
+              typedef typename BuildUndoCapturing_Signature<SIG,MEM>::type UndoCapSig;
+              
+              function<UndoCapSig> opera2 (how_to_capture_UndoState);
               
             }
           
@@ -105,9 +297,9 @@ namespace test    {
       
       template<typename SIG>
       BasicDefinition<SIG>
-      operation (function<SIG> operation_to_define)
+      operation (SIG& operation_to_define)
         {
-          
+          function<SIG> opera1 (operation_to_define);
         }
     };
   
@@ -129,19 +321,19 @@ namespace test    {
 */  
   namespace command1 {
     void
-    command1_do (P<long> dummyObj, int randVal)
+    operate (P<Time> dummyObj, int randVal)
     {
-      *dummyObj += randVal;
+      *dummyObj += Time(randVal);
     }
     
-    long
-    command1_cap (P<long> dummyObj, int)
+    Time
+    capture (P<Time> dummyObj, int)
     {
       return *dummyObj;
     }
     
     void
-    command1_undo (P<long> dummyObj, int, long oldVal)
+    undoIt (P<Time> dummyObj, int, Time oldVal)
     {
       *dummyObj = oldVal;
     }
@@ -177,10 +369,10 @@ namespace test    {
       defineCommands ()
         {
           CommDef ("test.command1")
-              .operation (command1_do)
-              .captureUndo (command1_cap)
-              .undoOperation (command1_undo)
-              .bind (obj, randVal)
+              .operation (command1::operate)
+              .captureUndo<Time> (command1::capture)                 /////////////////TODO: can we get rid of the type hint? (i.e. derive the type <Time> automatically?)
+              .undoOperation (command1::undoIt)
+//              .bind (obj, randVal)
               ;
         }
       

From 72d51077f715e0523ee0bc5d9edb17389a1357a8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 12 Jun 2009 19:49:44 +0200
Subject: [PATCH 099/368] change type dissection template to work rather in
 forward direction allowing for the user just to specify a function without
 any type parameters

---
 .../proc/control/command-basic-test.cpp       | 108 +++++++++++++++---
 1 file changed, 89 insertions(+), 19 deletions(-)

diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 00fac7b28..da57f94a0 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -225,6 +225,31 @@ namespace typelist{
     };
   
   
+  template<class TYPES>
+  struct SplitLast;
+  
+  template<>
+  struct SplitLast<NullType>
+    {
+      typedef NullType Type;
+      typedef NullType Prefix;
+    };
+  
+  template<class TY>
+  struct SplitLast<Node<TY,NullType> >
+    {
+      typedef TY Type;
+      typedef NullType Prefix;
+    };
+  
+  template<class TY, class TYPES>
+  struct SplitLast<Node<TY,TYPES> >
+    {
+      typedef typename SplitLast<TYPES>::Type Type;
+      typedef typename Append<TY, typename SplitLast<TYPES>::Prefix>::List Prefix;
+    };
+
+  
   
 }} // namespace lumiera::typelist
   
@@ -239,21 +264,56 @@ namespace test    {
   
   using lumiera::typelist::Tuple;
   using lumiera::typelist::Append;
+  using lumiera::typelist::SplitLast;
   
-  template<typename SIG, typename MEM>
-  struct BuildUndoCapturing_Signature
+  
+  /** 
+   * Type analysis helper template. 
+   * Used for dissecting a given type signature to derive
+   * the related basic operation signature, the signature of a possible Undo-function
+   * and the signature necessary for capturing undo information. The implementation
+   * relies on re-binding an embedded type defining template, based on the actual
+   * case, as identified by the structure of the given parameter signature.
+   */
+  template<typename SIG>
+  struct UndoSignature
     {
+    private:
       typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionTypedef<MEM,Args>::Sig           type;
-    };
-  
-  template<typename SIG, typename MEM>
-  struct BuildUndoOperation_Signature
-    {
-      typedef typename FunctionSignature< function<SIG> >::Args::List Args;
-      typedef typename Append<Args, MEM>::List                        ExtendedArglist;
-      typedef typename Tuple<ExtendedArglist>::Type                   ExtendedArgs;
-      typedef typename FunctionTypedef<void, ExtendedArgs>::Sig       type;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      /** Case1: defining the Undo-Capture function */
+      template<typename RET, typename ARG>
+      struct Case
+        {
+          typedef RET Memento;
+          typedef typename Append<ARG, Memento>::List ExtendedArglist;
+          typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
+          
+          typedef typename FunctionTypedef<void, ARG>::Sig           OperateSig;
+          typedef typename FunctionTypedef<Ret,ARG>::Sig             CaptureSig;
+          typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
+        };
+      /** Case2: defining the actual Undo function */
+      template<typename ARG>
+      struct Case<void,ARG>
+        {
+          typedef typename ARG::List Args;
+          
+          typedef typename SplitLast<Args>::Type Memento;
+          typedef typename SplitLast<Args>::Prefix OperationArglist;
+          typedef typename Tuple<OperationArglist>::Type OperationArgs;
+          
+          typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
+          typedef typename FunctionTypedef<Ret,OperationArgs>::Sig   CaptureSig;
+          typedef typename FunctionTypedef<void, ARG>::Sig           UndoOp_Sig;
+        };
+      
+    public:
+      typedef typename Case<Ret,Args>::CaptureSig CaptureSig;
+      typedef typename Case<Ret,Args>::UndoOp_Sig UndoOp_Sig;
+      typedef typename Case<Ret,Args>::OperateSig OperateSig;
+      typedef typename Case<Ret,Args>::Memento    Memento;
     };
   
   
@@ -264,25 +324,35 @@ namespace test    {
       template<typename SIG, typename MEM>
       struct UndoDefinition
         {
-          typedef typename BuildUndoOperation_Signature<SIG,MEM>::type UndoSig; 
           
+          template<typename SIG2>
           UndoDefinition
-          undoOperation (UndoSig& how_to_Undo)
+          undoOperation (SIG2& how_to_Undo)
             {
+              typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
+              
               function<UndoSig> opera3 (how_to_Undo);
               
             }
           
         };
       
+      /** type re-binding helper: create a suitable UndoDefinition type,
+       *  based on the UndoSignature template instance given as parameter */
+      template<typename U_SIG>
+      struct BuildUndoDefType
+        {
+          typedef UndoDefinition<typename U_SIG::OperateSig, typename U_SIG::Memento> Type;
+        };
+      
       template<typename SIG>
       struct BasicDefinition
         {
-          template<typename MEM>
-          UndoDefinition<SIG,MEM>
-          captureUndo (typename BuildUndoCapturing_Signature<SIG,MEM>::type& how_to_capture_UndoState)
+          template<typename SIG2>
+          typename BuildUndoDefType<UndoSignature<SIG2> >::Type
+          captureUndo (SIG2& how_to_capture_UndoState)
             {
-              typedef typename BuildUndoCapturing_Signature<SIG,MEM>::type UndoCapSig;
+              typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
               
               function<UndoCapSig> opera2 (how_to_capture_UndoState);
               
@@ -370,7 +440,7 @@ namespace test    {
         {
           CommDef ("test.command1")
               .operation (command1::operate)
-              .captureUndo<Time> (command1::capture)                 /////////////////TODO: can we get rid of the type hint? (i.e. derive the type <Time> automatically?)
+              .captureUndo (command1::capture)
               .undoOperation (command1::undoIt)
 //              .bind (obj, randVal)
               ;

From 2914f6685bedd088c14d625ac89e7517aec09563 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 12 Jun 2009 20:10:27 +0200
Subject: [PATCH 100/368] actually create the chain of Definition-Objects

---
 .../proc/control/command-basic-test.cpp       | 34 ++++++++++++++++---
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index da57f94a0..e5b47de85 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -22,6 +22,7 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 //#include "proc/asset/media.hpp"
 //#include "proc/mobject/session.hpp"
 //#include "proc/mobject/session/edl.hpp"
@@ -40,7 +41,7 @@
 
 #include <tr1/functional>
 //#include <boost/format.hpp>
-//#include <iostream>
+#include <iostream>
 #include <string>
 
 using std::tr1::bind;
@@ -51,7 +52,8 @@ using std::tr1::function;
 using lumiera::Time;
 //using util::contains;
 using std::string;
-//using std::cout;
+using std::cout;
+using std::endl;
 
 
 namespace lumiera {
@@ -256,6 +258,8 @@ namespace typelist{
 namespace control {
 namespace test    {
 
+  using lib::test::showSizeof;
+
 //  using session::test::TestClip;
   using lumiera::P;
   
@@ -324,15 +328,25 @@ namespace test    {
       template<typename SIG, typename MEM>
       struct UndoDefinition
         {
+          typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
+          typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
+          
+          UndoDefinition (function<UndoCaptureSig>& undoCapOperation)
+            {
+              cout << showSizeof(undoCapOperation) << endl;
+              UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
+            }
           
           template<typename SIG2>
-          UndoDefinition
+          UndoDefinition&
           undoOperation (SIG2& how_to_Undo)
             {
               typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
               
               function<UndoSig> opera3 (how_to_Undo);
               
+              UNIMPLEMENTED ("store actual Undo-Functor into the command definition held by the enclosing UndoDefinition instance");
+              return *this;
             }
           
         };
@@ -348,14 +362,22 @@ namespace test    {
       template<typename SIG>
       struct BasicDefinition
         {
+          BasicDefinition(function<SIG>& operation)
+            {
+              cout << showSizeof(operation) << endl;
+              UNIMPLEMENTED ("create new command object an store the operation functor");
+            }
+          
+          
           template<typename SIG2>
           typename BuildUndoDefType<UndoSignature<SIG2> >::Type
           captureUndo (SIG2& how_to_capture_UndoState)
             {
               typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
+              typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
               
               function<UndoCapSig> opera2 (how_to_capture_UndoState);
-              
+              return SpecificUndoDefinition (opera2);
             }
           
         };
@@ -370,6 +392,7 @@ namespace test    {
       operation (SIG& operation_to_define)
         {
           function<SIG> opera1 (operation_to_define);
+          return BasicDefinition<SIG>(opera1);
         }
     };
   
@@ -378,6 +401,9 @@ namespace test    {
   
   /////////////////////////////
   /////////////////////////////
+  
+  //////////////////////////// start of the actual Test....
+  
 
 /*  
     bind: opFunc(a,b,c) -> op(void)

From c87970e13b0d7fd9a1ed372f34e54338507ed688 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 12 Jun 2009 20:21:46 +0200
Subject: [PATCH 101/368] Add command explaining what's actually going on
 here...

---
 .../proc/control/command-basic-test.cpp       | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index e5b47de85..2bd55797b 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -319,8 +319,29 @@ namespace test    {
       typedef typename Case<Ret,Args>::OperateSig OperateSig;
       typedef typename Case<Ret,Args>::Memento    Memento;
     };
+
   
   
+  
+  
+  /**
+   * Helper class used solely for \em defining a Command-Object.
+   * This technique is known as "fluent API", see http://en.wikipedia.org/wiki/Fluent_interface
+   * The basic idea is for the user to create a disposable instance of this definition helper,
+   * only for calling a chain of definition functions, which internally build the actual Command object.
+   * Finally, the created Command object will be stored into a registry or handed over to the
+   * ProcDispatcher. To give an example:
+   * \code
+   *    CommandDefinition ("test.command1")
+   *           .operation (command1::operate)          // provide the function to be executed as command
+   *           .captureUndo (command1::capture)        // provide the function capturing Undo state
+   *           .undoOperation (command1::undoIt)       // provide the function which might undo the comand
+   *           .bind (obj, randVal)                    // bind to the actual command parameters
+   *           .executeSync();                         // convenience call, forwarding the Command to dispatch.
+   * \endcode
+   * 
+   * @todo of course, this needs to be extracted into command-definition.hpp 
+   */
   class CommDef
     {
       Symbol id_;

From b937bd08ae92ba3d327a030c687559c99f3aa9bd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 14 Jun 2009 05:38:35 +0200
Subject: [PATCH 102/368] WIP: parameter closure brainstorming

---
 src/lib/meta/generator.hpp                    | 16 ++--
 .../proc/control/command-basic-test.cpp       | 79 ++++++++++++++++++-
 wiki/renderengine.html                        | 44 +++++++++--
 3 files changed, 122 insertions(+), 17 deletions(-)

diff --git a/src/lib/meta/generator.hpp b/src/lib/meta/generator.hpp
index 1eff99500..1a7e11806 100644
--- a/src/lib/meta/generator.hpp
+++ b/src/lib/meta/generator.hpp
@@ -57,15 +57,13 @@ This code is heavily inspired by
 
 
 
-namespace lumiera
-  {
-  namespace typelist
-    {
+namespace lumiera {
+namespace typelist{
     
     /** 
      * Apply a template to a collection of types. 
      * The resulting class ends up inheriting from an instantiation
-     * of the template for each of the types in the list. The iheritance
+     * of the template for each of the types in the list. The inheritance
      * graph is built in a "mixin" (multiple inheritance) style. 
      */
     template
@@ -107,8 +105,8 @@ namespace lumiera
      * Needs the help of the user provided Template, which now has
      * to take a second parameter and use this as Base class. 
      * The resulting class ends up (single) inheriting from an 
-     * instantiation of the templace for each of the types, while
-     * overrideing/implementing the provided base class.
+     * instantiation of the template for each of the types, while
+     * overriding/implementing the provided base class.
      */
     template
       < class TYPES                      // List of Types 
@@ -196,7 +194,5 @@ namespace lumiera
       };
     
     
-  } // namespace typelist
-
-} // namespace lumiera
+}} // namespace lumiera::typelist
 #endif
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 2bd55797b..f6abb97ef 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -38,6 +38,7 @@
 
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelistutil.hpp"
+#include "lib/meta/generator.hpp"
 
 #include <tr1/functional>
 //#include <boost/format.hpp>
@@ -266,10 +267,13 @@ namespace test    {
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::FunctionTypedef;
   
+  using lumiera::typelist::Types;
+  using lumiera::typelist::NullType;
   using lumiera::typelist::Tuple;
   using lumiera::typelist::Append;
   using lumiera::typelist::SplitLast;
   
+  using lumiera::typelist::InstantiateChained;
   
   /** 
    * Type analysis helper template. 
@@ -323,6 +327,79 @@ namespace test    {
   
   
   
+  template< class T1
+          , class T2 =NullType
+          , class T3 =NullType
+          , class T4 =NullType
+          , class T5 =NullType
+          >
+  class Tup
+    : Tup<T2,T3,T4,T5,NullType>
+    {
+      typedef Tup<T2,T3,T4,T5,NullType> Par_;
+      
+      T1 v1_;
+      
+    public:
+      Tup ( T1 a1=T1()
+          , T2 a2=T2()
+          , T3 a3=T3()
+          , T4 a4=T4()
+          , T5 a5=T5()
+          )
+        : Par_(a2,a3,a4,a5),
+          v1_(a1)
+        { }
+      
+      T1   getHead() { return v1_; }
+      Par_ getTail() { return static_cast<Par_&>(*this); }
+      
+      typedef Types<T1,T2,T3,T4,T5> ArgTypes;
+    };
+  
+  template<>
+  class Tup<NullType,NullType,NullType,NullType,NullType>
+    {
+      typedef Types<> ArgTypes;
+    };
+
+  
+  class Closure
+    {
+      
+    };
+  
+  template<typename TY, class B>
+  struct CloseParam
+    : B
+    {
+      TY par_;
+      
+      template<typename TUP>
+      CloseParam (TUP& arg)
+        : B (arg.getTail()),
+          par_(arg.getHead())
+        { }
+    };
+  
+  template<typename TYPES>
+  struct Close
+    : InstantiateChained<typename TYPES::List, CloseParam, Closure>
+    {
+      
+    };
+  
+  struct ClosureBuilder
+    {
+      template<typename TUP>
+      Closure*
+      bind (TUP args)
+        {
+          return new Close<typename TUP::ArgTypes> (args);
+        }
+    };
+  
+  
   
   /**
    * Helper class used solely for \em defining a Command-Object.
@@ -335,7 +412,7 @@ namespace test    {
    *    CommandDefinition ("test.command1")
    *           .operation (command1::operate)          // provide the function to be executed as command
    *           .captureUndo (command1::capture)        // provide the function capturing Undo state
-   *           .undoOperation (command1::undoIt)       // provide the function which might undo the comand
+   *           .undoOperation (command1::undoIt)       // provide the function which might undo the command
    *           .bind (obj, randVal)                    // bind to the actual command parameters
    *           .executeSync();                         // convenience call, forwarding the Command to dispatch.
    * \endcode
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index afe23720d..426e40087 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -951,13 +951,45 @@ TertiaryMid: #99a
 TertiaryDark: #667
 Error: #f88</pre>
 </div>
-<div title="Command" modifier="Ichthyostega" modified="200906072100" created="200906072020" tags="def SessionLogic draft" changecount="5">
+<div title="Command" modifier="Ichthyostega" modified="200906140108" created="200906072020" tags="def SessionLogic draft" changecount="6">
 <pre>Within Proc-Layer, a Command is the abstract representation of a single operation or a compound of operations mutating the HighLevelModel.
 Thus, each command is a ''Functor'' and a ''Closure'' ([[command pattern|http://en.wikipedia.org/wiki/Command_pattern]]), allowing commands to be treated uniformly, enqueued in a [[dispatcher|ProcDispatcher]], logged to the SessionStorage and registered with the UndoManager.
 
-&amp;rarr; see CommandHandling</pre>
+Commands are //defined// using a [[fluent API|http://en.wikipedia.org/wiki/Fluent_interface]], just by providing apropriate functions. Additionally, the Closure necessary for executing a command is built by binding to a set of concrete parameters. After reaching this point, the state of the internal representation could be serialised by plain-C function calls, which is important for integration with the SessionStorage.
+
+&amp;rarr; see CommandDefinition
+&amp;rarr; see CommandHandling
+</pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200906080316" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="21">
+<div title="CommandDefinition" modifier="Ichthyostega" modified="200906140147" created="200906140124" tags="SessionLogic spec draft decision design img" changecount="9">
+<pre>Commands can be identified and accessed //by name// &amp;mdash; consequently there needs to be an internal command registry, including a link to the actual implementing function, thus allowing to re-establish the connection between command and implementing functions when de-serialising a persisted command. To create a command, we need to provide the following informations
+* operation function actually implementing the command
+* function to [[undo|UndoManager]] the effect of the command
+* function to capture state to be used by UNDO.
+* a set of actual parameters to bind into these functions (closure).
+
+!Command definition object
+The process of creating a command by providing these building blocks is governed by a ~CommandDef helper object. According to the [[fluent definition style|http://en.wikipedia.org/wiki/Fluent_interface]], the user is expected to invoke a chain of definition functions, finally leading to the internal registration of the completed command object, which then might be dispatched or persisted. For example
+{{{
+CommandDefinition (&quot;test.command1&quot;)
+     .operation (command1::operate)          // provide the function to be executed as command
+     .captureUndo (command1::capture)        // provide the function capturing Undo state
+     .undoOperation (command1::undoIt)       // provide the function which might undo the command
+     .bind (obj, val1,val2)                  // bind to the actual command parameters (stores command internally)
+     .executeSync();                         // convenience call, forwarding the Command to dispatch.
+}}}
+
+!Operation parameters
+While generally there is //no limitation// on the number and type of parameters, the set of implementing functions and the {{{bind(...)}}} call are required to match. Inconsistencies will be detected by the compiler. In addition to taking the //same parameters as the command operation,// the {{{captureUndo()}}} function is required to return (by value) a //memento//&amp;nbsp; type, which, in case of invoking the {{{undo()}}}-function, will be provided as additional parameter. To summarise:
+|!Function|&gt;|!ret(params)|
+| operation| void |(P1,..PN)|
+| captureUndo| MEM |(P1,..PN)|
+| undoOperation| void |(P1,..PN,MEM)|
+| bind| void |(P1,..PN)|
+Usually, parameters should be passed //by value// &amp;mdash; with the exception of target object(s), which are typically bound as MObjectRef, causing them to be resolved at commad execution time (late binding).
+</pre>
+</div>
+<div title="CommandHandling" modifier="Ichthyostega" modified="200906140100" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="23">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
@@ -970,10 +1002,10 @@ Theoretically, defining the &quot;undo&quot; operation might utilise two differe
 While obviously the first solution is much simpler to implement on behalf of the command framework, the second solution has distinct advantages, especially in the context of an editing application: there might be rounding or calculation errors, the inverse might be difficult to define correctly, the effect of the operation might depend on circumstances, be random, or might even trigger a resolution operation to yield the final result. Thus the decision is within Lumiera Proc-Layer to //favour state capturing// &amp;mdash; but in a modified, semi-manual and not completely exclusive way.
 
 !Undo state
-While the usual implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function'' and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense than capturing state.
+While the usual »Memento« implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function''&amp;nbsp;and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense than capturing state.
 
 !Handling of commands
-A command may be defined completely from scratch, or it might just instantiate a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
+A command may be [[defined|CommandDefinition]] completely from scratch, or it might just instantiate a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
 
 By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation.
 </pre>
@@ -3621,7 +3653,7 @@ As such, the SessionInterface is the main entrance point to Proc-Layer functiona
 Currently (as of 5/09), Ichthyo is [[targeting|PlanningSessionInMem]] a first preliminary implementation of the [[Session in Memory|SessionDataMem]]
 
 !Design and handling of Objects within the Session
-Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. Effectively, such a placement within the session behaves like an //instances// of a given object, and at the same time it defines the &quot;non-substantial&quot; properties of the object, e.g. its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render processes within the engine, but also to external parts within the GUI and in plugins. The actual implementation of these object references is built on top of the PlacementRef tags, thus relying on the PlacementIndex the session maintains to keep track of all placements and their relations. While &amp;mdash; using these references &amp;mdash; an external client can access the objects and structures within the session, any actual ''mutations'' should be done based on the CommandHandling: a single operation of a sequence of operations is defined as [[Command]], to be [[dispatched as mutation operation|ProcDispatcher]]. Following this policy ensures integration with the SessionStorage and provides (unlimited) [[UNDO|UndoManager]].
+Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. Effectively, such a placement within the session behaves like an //instances// of a given object, and at the same time it defines the &quot;non-substantial&quot; properties of the object, e.g. its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render processes within the engine, but also to external parts within the GUI and in plugins. The actual implementation of these object references is built on top of the PlacementRef tags, thus relying on the PlacementIndex the session maintains to keep track of all placements and their relations. While &amp;mdash; using these references &amp;mdash; an external client can access the objects and structures within the session, any actual ''mutations'' should be done based on the CommandHandling: a single operation of a sequence of operations is defined as [[Command]], to be [[dispatched as mutation operation|ProcDispatcher]]. Following this policy ensures integration with the&amp;nbsp;SessionStorage and provides (unlimited) [[UNDO|UndoManager]].
 </pre>
 </div>
 <div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design" changecount="29">

From 7741b50b910f38f7458580849aef21fb01533e7c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 14 Jun 2009 19:40:35 +0200
Subject: [PATCH 103/368] WIP rewrote the Sub-Tuple extractor into a simplistic
 Tuple type

---
 src/lib/meta/typelistutil.hpp                 |   2 +-
 .../proc/control/command-basic-test.cpp       | 118 ++++++++++++------
 2 files changed, 81 insertions(+), 39 deletions(-)

diff --git a/src/lib/meta/typelistutil.hpp b/src/lib/meta/typelistutil.hpp
index 2e9e05d14..ebc39dc3f 100644
--- a/src/lib/meta/typelistutil.hpp
+++ b/src/lib/meta/typelistutil.hpp
@@ -86,7 +86,7 @@ namespace lumiera {
     template<class T, class TAIL>
     struct CondNode<true, T, TAIL>         { typedef Node<T,TAIL>  Next; };
     
-    /** filter away those types which don't fulfill a predicate metafunction */
+    /** filter away those types which don't fulfil a predicate metafunction */
     template< class TYPES 
             , template<class> class _P_    ///< a template providing a boolean member \c ::value
             >
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index f6abb97ef..03f22fa3d 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -196,6 +196,7 @@ namespace typelist{
   
   
   
+  /////////////////////////very basic facility: Typed tuples
   
   template<class T, class TYPES>
   struct Prepend;
@@ -212,21 +213,97 @@ namespace typelist{
     typedef Types<A1,A2,A3,A4,A5> Tuple;
   };
 
-  template<class LI>
+  template<class TYPES>
   struct Tuple;
 
   template<>
   struct Tuple<NullType>
     {
-      typedef Types<> Type;
+      typedef NullType HeadType;
+      typedef Types<>  TailType;
+      typedef Types<>  Type;
+      
+      typedef NullType ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<NullType> Tail;
     };
   
   template<class TY, class TYPES>
   struct Tuple<Node<TY,TYPES> >
+    : Tuple<TYPES>
     {
-      typedef typename Prepend<TY, typename Tuple<TYPES>::Type >::Tuple Type;
+      typedef TY                               HeadType;
+      typedef typename Tuple<TYPES>::Type      TailType;
+      typedef typename Prepend<TY,Tail>::Tuple Type;
+      
+      typedef typename Node<TY,TYPES> ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TYPES> Tail;
+      
+      Tuple ( TY a1 =TY()
+            , Tail tail =Tail()
+            )
+        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
+          val_(a1)
+        { }
+      
+      TY  & getHead() { return val_; }
+      Tail& getTail() { return static_cast<Tail&> (*this); }
+      
+    private:
+      T1 val_;
     };
   
+  template< typename T1
+          , typename T2 =NullType
+          , typename T3 =NullType
+          , typename T4 =NullType
+          , typename T5 =NullType
+          >
+  struct Tuple<Types<T1,T2,T3,T4,T5> >
+    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
+    {
+      typedef T1                          HeadType;
+      typedef Types<T2,T3,T4,T5,NullType> TailType;
+      typedef Types<T1,T2,T3,T4,T5>       Type;
+      
+      typedef typename Type::List ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TailType> Tail;
+      
+      Tuple ( T1 a1 =T1()
+            , T2 a2 =T2()
+            , T3 a3 =T3()
+            , T4 a4 =T4()
+            , T5 a5 =T5()
+            )
+        : Tuple<ArgList_>(a1,makeTuple(a2,a3,a4,a5))
+        { }
+      
+      using ArgList_::getHead;
+      using ArgList_::getTail;
+      
+      template<uint i> struct Shifted   { typedef typename Tail::Shifted<i-1>::Type Tuple; };
+      template<>       struct Shifted<0>{ typedef ThisTuple Tuple; };
+      
+      template<uint i>
+      typename Shifted<i>::Tuple&
+      getShifted ()
+        {
+          typedef typename Shifted<i>::Tuple TailI;
+          return static_cast<TailI&> (*this);
+        }
+      
+      template<uint i>
+      typename Shifted<i>::Tuple::HeadType&
+      getAt ()
+        {
+          return getShifted<i>().getHead();
+        }
+    };
+  
+  
+  ///////////////////////// additional typelist manipulators
   
   template<class TYPES>
   struct SplitLast;
@@ -327,41 +404,6 @@ namespace test    {
   
   
   
-  template< class T1
-          , class T2 =NullType
-          , class T3 =NullType
-          , class T4 =NullType
-          , class T5 =NullType
-          >
-  class Tup
-    : Tup<T2,T3,T4,T5,NullType>
-    {
-      typedef Tup<T2,T3,T4,T5,NullType> Par_;
-      
-      T1 v1_;
-      
-    public:
-      Tup ( T1 a1=T1()
-          , T2 a2=T2()
-          , T3 a3=T3()
-          , T4 a4=T4()
-          , T5 a5=T5()
-          )
-        : Par_(a2,a3,a4,a5),
-          v1_(a1)
-        { }
-      
-      T1   getHead() { return v1_; }
-      Par_ getTail() { return static_cast<Par_&>(*this); }
-      
-      typedef Types<T1,T2,T3,T4,T5> ArgTypes;
-    };
-  
-  template<>
-  class Tup<NullType,NullType,NullType,NullType,NullType>
-    {
-      typedef Types<> ArgTypes;
-    };
 
   
   class Closure

From 441cb6b9e2e9d3c29e2860e5e2b1da4b5350319a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 15 Jun 2009 03:47:05 +0200
Subject: [PATCH 104/368] WIP try to solve the problem of closing a function
 with arbitrary args

---
 src/lib/meta/generator.hpp                    |   2 +-
 .../proc/control/command-basic-test.cpp       | 230 +++++++++++++++---
 2 files changed, 203 insertions(+), 29 deletions(-)

diff --git a/src/lib/meta/generator.hpp b/src/lib/meta/generator.hpp
index 1a7e11806..5469fbaeb 100644
--- a/src/lib/meta/generator.hpp
+++ b/src/lib/meta/generator.hpp
@@ -156,7 +156,7 @@ namespace typelist{
       < class TYPES                           // List of Types
       , template<class,class,uint> class _X_ //  your-template-goes-here
       , class BASE = NullType               //   Base class at end of chain
-      , uint i = 0                         //    incremented on each instantiaton
+      , uint i = 0                         //    incremented on each instantiation
       >
     class InstantiateWithIndex;
     
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 03f22fa3d..becee0e38 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -303,6 +303,177 @@ namespace typelist{
     };
   
   
+  /**
+   * Decorating a tuple type with auxiliary data access operations.
+   * This helper template builds up a subclass of the given BASE type
+   * (which is assumed to be a Tuple or at least need to be copy constructible
+   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
+   * to add a layer of access functions, which in turn might rely on the exact
+   * type of the individual elements within the Tuple. To achieve this, for each
+   * type within the Tuple, the BASE type is decorated with an instance of the
+   * template passed in as template template parameter _X_. Each of these
+   * decorating instances is provided with a member pointer to access "his"
+   * specific element within the underlying tuple.
+   * 
+   * The decorating template _X_ need to take its own base class as template
+   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
+   * calling down into this templated base class. To support this, an instantiation
+   * of _X_ with the 0 member ptr is generated for detecting recursion end
+   * (built as innermost decorator, i.e. immediate subclass of BASE) 
+   */
+  template
+    < typename TYPES
+    , template<class TY,class B, TY B::*getter()> class _X_
+    , class BASE =Tuple<TYPES> 
+    >
+  class BuildTupleAccessor
+    {
+      typedef typename Tuple<TYPES> Tuple;
+      typedef typename Tuple::TailType Tail;
+      typedef typename Tuple::HeadType Head;
+      typedef Head Tuple::*getElm();
+      typedef BuildTupleAccessor<Tail, _X_> NextBuilder;
+      typedef typename NextBuilder::Accessor NextAccessor;
+      
+      Tuple<TYPES>& argData_;
+      
+    public:
+      
+      /** type of the product created by this template.
+       *  Will be a subclass of BASE */
+      typedef _X_<Head, NextAccessor, &Tuple::getHead, > Accessor;
+      
+      BuildTupleAccessor (Tuple<TYPES>& tup)
+        : argData_(tup)
+        { }
+      
+      operator Accessor() { return Accessor(argData_); }
+      
+    };
+
+  template
+    < class BASE
+    , template<class,class> class _X_
+    >
+  class BuildTupleAccessor<Tuple<Types<> >, _X_>
+    {
+      typedef typename Tuple<Types<> > Tuple;
+      typedef NullType Tuple::*getElm();
+      
+    public:
+      typedef _X_<NullType, BASE, 0> Accessor;
+    };
+  
+  
+  ///////////////////////// creating functional closures
+  
+  namespace tuple {
+      template<uint n>
+      struct Apply;
+      
+      template<>       
+      struct Apply<1>
+        {
+          template<class FUN, typename RET, class TUP>
+          static RET
+          invoke (FUN f, TUP & arg)
+            {
+              return f (arg.getAt<1>()); 
+            }
+          
+          template<class FUN, typename RET, class TUP>
+          static RET
+          bind (FUN f, TUP & arg)
+            {
+              return std::tr1::bind (f, arg.getAt<1>()); 
+            }
+        };
+      
+      template<>       
+      struct Apply<2>
+        {
+          template<class FUN, typename RET, class TUP>
+          static RET
+          invoke (FUN f, TUP & arg)
+            {
+              return f ( arg.getAt<1>()
+                       , arg.getAt<2>()
+                       ); 
+            }
+          
+          template<class FUN, typename RET, class TUP>
+          static RET
+          bind (FUN f, TUP & arg)
+            {
+              return std::tr1::bind (f, arg.getAt<1>() 
+                                      , arg.getAt<2>()
+                                     );
+            }
+        };
+  } // (END) sub-namespace 
+  
+  template<typename SIG>
+  class TupleApplicator
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      enum { ARG_CNT = count<Args::List>::value };
+      
+      using tuple::Apply;
+      
+      /** storing a ref to the parameter tuple */
+      Tuple<Args>& params_;
+      
+    public:
+      TupleApplicator (Tuple<Args>& args)
+        : params_(args)
+        { }
+      
+      function<SIG>  bind (SIG& f)                 { return Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (function<SIG> const& f) { return Apply<ARG_CNT>::bind (f, params_); }
+      
+      Ret      operator() (SIG& f)                 { return Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (function<SIG> const& f) { return Apply<ARG_CNT>::invoke (f, params_); }
+    };
+  
+  
+  /**
+   * Closing a function over its arguments.
+   * This is a small usage example or spin-off,
+   * having almost the same effect than invoking tr1::bind.
+   * The notable difference is that the function arguments for
+   * creating the closure are passed in as one compound tuple.
+   */
+  template<typename SIG>
+  class FunctionClosure
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      function<Ret(void)> closure_;
+      
+    public:
+      FunctionClosure (SIG& f, Tuple<Args>& arg)
+        : closure_(TupleApplicator<SIG>(arg).bind(f))
+        { }
+      FunctionClosure (function<SIG> const& f, Tuple<Args>& arg)
+        : closure_(TupleApplicator<SIG>(arg).bind(f))
+        { }
+      
+      Ret operator() () { return closure_(); }
+    };
+  
+  
+/*
+  template<typename TYPES>
+  struct BuildClosure
+    : InstantiateWithIndex<TYPES, Accessor, I>
+    {
+      
+    };
+*/
+  
   ///////////////////////// additional typelist manipulators
   
   template<class TYPES>
@@ -350,7 +521,7 @@ namespace test    {
   using lumiera::typelist::Append;
   using lumiera::typelist::SplitLast;
   
-  using lumiera::typelist::InstantiateChained;
+  using lumiera::typelist::BuildTupleAccessor;
   
   /** 
    * Type analysis helper template. 
@@ -400,46 +571,49 @@ namespace test    {
       typedef typename Case<Ret,Args>::OperateSig OperateSig;
       typedef typename Case<Ret,Args>::Memento    Memento;
     };
-
   
   
   
-
   
-  class Closure
+  
+  /** Interface */
+  class CmdClosure
+    {
+    public:
+      virtual ~CmdClosure() {}
+    };
+  
+  
+  template<typename TY, class BASE, TY BASE::*getElm()>
+  struct ParamAccessor
+    {
+      
+    };
+  template<class BASE>
+  struct ParamAccessor<NullType, BASE, 0>
     {
       
     };
   
-  template<typename TY, class B>
-  struct CloseParam
-    : B
+  template<typename SIG>
+  class Closure
+    : public CmdClosure
     {
-      TY par_;
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+//    typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
       
-      template<typename TUP>
-      CloseParam (TUP& arg)
-        : B (arg.getTail()),
-          par_(arg.getHead())
+      typedef Tuple<Arg> ArgTuple;
+      
+      typedef BuildTupleAccessor<Args,ParamAccessor> BuildAccessor;
+      typedef typename BuildAccessor::Accessor ParamStorageTuple;
+      
+      ParamStorageTuple params_;
+      
+      Closure (ArgTuple& args)
+        : params_(BuildAccessor(args))
         { }
     };
   
-  template<typename TYPES>
-  struct Close
-    : InstantiateChained<typename TYPES::List, CloseParam, Closure>
-    {
-      
-    };
-  
-  struct ClosureBuilder
-    {
-      template<typename TUP>
-      Closure*
-      bind (TUP args)
-        {
-          return new Close<typename TUP::ArgTypes> (args);
-        }
-    };
   
   
   

From df6312a581b20e5b80a5eea2ece9e6bf503bd583 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 15 Jun 2009 04:57:23 +0200
Subject: [PATCH 105/368] got it through the compiler...

---
 .../proc/control/command-basic-test.cpp       | 162 ++++++++++++------
 1 file changed, 112 insertions(+), 50 deletions(-)

diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index becee0e38..15c551834 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -226,19 +226,27 @@ namespace typelist{
       typedef NullType ArgList_;
       typedef Tuple<Type> ThisTuple;
       typedef Tuple<NullType> Tail;
+      enum { SIZE = 0 };
+      
+      NullType getHead() { return NullType(); }
+      Tail&    getTail() { return *this;      }
+      
+      Tuple (HeadType const&, Tail const&) { }
+      Tuple ()                             { }
     };
   
   template<class TY, class TYPES>
   struct Tuple<Node<TY,TYPES> >
     : Tuple<TYPES>
     {
-      typedef TY                               HeadType;
-      typedef typename Tuple<TYPES>::Type      TailType;
-      typedef typename Prepend<TY,Tail>::Tuple Type;
+      typedef TY                                   HeadType;
+      typedef typename Tuple<TYPES>::Type          TailType;
+      typedef typename Prepend<TY,TailType>::Tuple Type;
       
-      typedef typename Node<TY,TYPES> ArgList_;
+      typedef Node<TY,TYPES> ArgList_;
       typedef Tuple<Type> ThisTuple;
       typedef Tuple<TYPES> Tail;
+      enum { SIZE = count<ArgList_>::value };
       
       Tuple ( TY a1 =TY()
             , Tail tail =Tail()
@@ -251,14 +259,28 @@ namespace typelist{
       Tail& getTail() { return static_cast<Tail&> (*this); }
       
     private:
-      T1 val_;
+      TY val_;
     };
   
+  ////TODO move in sub-scope
+  template<class TUP,uint i>
+  struct Shifted
+    {
+      typedef typename TUP::Tail Tail;
+      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
+    };
+  template<class TUP>
+  struct Shifted<TUP,0>
+    { 
+      typedef Tuple<typename TUP::ArgList_> TupleType;
+    };
+      
+  
   template< typename T1
-          , typename T2 =NullType
-          , typename T3 =NullType
-          , typename T4 =NullType
-          , typename T5 =NullType
+          , typename T2
+          , typename T3
+          , typename T4
+          , typename T5
           >
   struct Tuple<Types<T1,T2,T3,T4,T5> >
     : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
@@ -270,6 +292,7 @@ namespace typelist{
       typedef typename Type::List ArgList_;
       typedef Tuple<Type> ThisTuple;
       typedef Tuple<TailType> Tail;
+      enum { SIZE = count<ArgList_>::value };
       
       Tuple ( T1 a1 =T1()
             , T2 a2 =T2()
@@ -277,29 +300,33 @@ namespace typelist{
             , T4 a4 =T4()
             , T5 a5 =T5()
             )
-        : Tuple<ArgList_>(a1,makeTuple(a2,a3,a4,a5))
+        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
         { }
       
-      using ArgList_::getHead;
-      using ArgList_::getTail;
-      
-      template<uint i> struct Shifted   { typedef typename Tail::Shifted<i-1>::Type Tuple; };
-      template<>       struct Shifted<0>{ typedef ThisTuple Tuple; };
+      using Tuple<ArgList_>::getHead;
+      using Tuple<ArgList_>::getTail;
       
       template<uint i>
-      typename Shifted<i>::Tuple&
+      typename Shifted<ThisTuple,i>::TupleType&
       getShifted ()
         {
-          typedef typename Shifted<i>::Tuple TailI;
-          return static_cast<TailI&> (*this);
+          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
+          return static_cast<Tail_I&> (*this);
         }
       
       template<uint i>
-      typename Shifted<i>::Tuple::HeadType&
+      typename Shifted<ThisTuple,i>::TupleType::HeadType&
       getAt ()
         {
           return getShifted<i>().getHead();
         }
+      
+      NullType&
+      getNull()
+        {
+          static NullType nix;
+          return nix; 
+        }
     };
   
   
@@ -323,27 +350,28 @@ namespace typelist{
    */
   template
     < typename TYPES
-    , template<class TY,class B, TY B::*getter()> class _X_
-    , class BASE =Tuple<TYPES> 
+    , template<class,class,uint> class _X_
+    , class BASE =Tuple<TYPES>
+    , uint i = 0
     >
   class BuildTupleAccessor
     {
-      typedef typename Tuple<TYPES> Tuple;
-      typedef typename Tuple::TailType Tail;
-      typedef typename Tuple::HeadType Head;
-      typedef Head Tuple::*getElm();
-      typedef BuildTupleAccessor<Tail, _X_> NextBuilder;
+      typedef Tuple<TYPES> ArgTuple;
+      typedef typename ArgTuple::HeadType Head;
+      typedef typename ArgTuple::TailType Tail;
+//    typedef Head ArgTuple::*getElm();
+      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
       typedef typename NextBuilder::Accessor NextAccessor;
       
-      Tuple<TYPES>& argData_;
+      ArgTuple& argData_;
       
     public:
       
       /** type of the product created by this template.
        *  Will be a subclass of BASE */
-      typedef _X_<Head, NextAccessor, &Tuple::getHead, > Accessor;
+      typedef _X_<Head, NextAccessor, i> Accessor;
       
-      BuildTupleAccessor (Tuple<TYPES>& tup)
+      BuildTupleAccessor (ArgTuple& tup)
         : argData_(tup)
         { }
       
@@ -353,12 +381,13 @@ namespace typelist{
 
   template
     < class BASE
-    , template<class,class> class _X_
+    , template<class,class,uint> class _X_
+    , uint i
     >
-  class BuildTupleAccessor<Tuple<Types<> >, _X_>
+  class BuildTupleAccessor<Types<>, _X_, BASE, i>
     {
-      typedef typename Tuple<Types<> > Tuple;
-      typedef NullType Tuple::*getElm();
+      typedef Tuple<Types<> > ArgTuple;
+//    typedef NullType BASE::*getElm();
       
     public:
       typedef _X_<NullType, BASE, 0> Accessor;
@@ -378,14 +407,14 @@ namespace typelist{
           static RET
           invoke (FUN f, TUP & arg)
             {
-              return f (arg.getAt<1>()); 
+              return f (arg.template getAt<1>()); 
             }
           
           template<class FUN, typename RET, class TUP>
           static RET
           bind (FUN f, TUP & arg)
             {
-              return std::tr1::bind (f, arg.getAt<1>()); 
+              return std::tr1::bind (f, arg.template getAt<1>()); 
             }
         };
       
@@ -396,8 +425,8 @@ namespace typelist{
           static RET
           invoke (FUN f, TUP & arg)
             {
-              return f ( arg.getAt<1>()
-                       , arg.getAt<2>()
+              return f ( arg.template getAt<1>()
+                       , arg.template getAt<2>()
                        ); 
             }
           
@@ -405,8 +434,8 @@ namespace typelist{
           static RET
           bind (FUN f, TUP & arg)
             {
-              return std::tr1::bind (f, arg.getAt<1>() 
-                                      , arg.getAt<2>()
+              return std::tr1::bind (f, arg.template getAt<1>() 
+                                      , arg.template getAt<2>()
                                      );
             }
         };
@@ -418,9 +447,8 @@ namespace typelist{
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
       
-      enum { ARG_CNT = count<Args::List>::value };
+      enum { ARG_CNT = count<typename Args::List>::value };
       
-      using tuple::Apply;
       
       /** storing a ref to the parameter tuple */
       Tuple<Args>& params_;
@@ -430,11 +458,11 @@ namespace typelist{
         : params_(args)
         { }
       
-      function<SIG>  bind (SIG& f)                 { return Apply<ARG_CNT>::bind (f, params_); }
-      function<SIG>  bind (function<SIG> const& f) { return Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (SIG& f)                 { return tuple::Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::bind (f, params_); }
       
-      Ret      operator() (SIG& f)                 { return Apply<ARG_CNT>::invoke (f, params_); }
-      Ret      operator() (function<SIG> const& f) { return Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (SIG& f)                 { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
     };
   
   
@@ -584,15 +612,25 @@ namespace test    {
     };
   
   
-  template<typename TY, class BASE, TY BASE::*getElm()>
+  template<typename TY, class BASE, uint idx>
   struct ParamAccessor
+    : BASE
     {
-      
+      template<class TUP>
+      ParamAccessor(TUP& tuple)
+        : BASE(tuple)
+        { 
+           cout << showSizeof(tuple.template getAt<idx>()) << endl;
+        }
     };
   template<class BASE>
   struct ParamAccessor<NullType, BASE, 0>
+    : BASE
     {
-      
+      template<class TUP>
+      ParamAccessor(TUP& tuple)
+        : BASE(tuple)
+        { }
     };
   
   template<typename SIG>
@@ -602,13 +640,14 @@ namespace test    {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
 //    typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
       
-      typedef Tuple<Arg> ArgTuple;
+      typedef Tuple<Args> ArgTuple;
       
       typedef BuildTupleAccessor<Args,ParamAccessor> BuildAccessor;
       typedef typename BuildAccessor::Accessor ParamStorageTuple;
       
       ParamStorageTuple params_;
       
+    public:
       Closure (ArgTuple& args)
         : params_(BuildAccessor(args))
         { }
@@ -663,6 +702,24 @@ namespace test    {
               return *this;
             }
           
+          template
+            < typename T1
+            , typename T2
+            >
+          UndoDefinition&    ///////TODO return here the completed Command
+          bind ( T1& p1
+               , T2& p2
+               )
+            {
+              typedef Types<T1,T2> ArgTypes;
+              Tuple<ArgTypes> params(p1,p2);
+              Closure<SIG> clo (params);
+              
+              cout << showSizeof(clo) << endl;
+              UNIMPLEMENTED ("complete Command definition by closing all functions");
+              return *this;
+            }
+          
         };
       
       /** type re-binding helper: create a suitable UndoDefinition type,
@@ -773,16 +830,21 @@ namespace test    {
       run (Arg) 
         {
           /////////////////////////////////TODO
+          defineCommands();
+          checkExecution();
         }
       
       void
       defineCommands ()
         {
+          P<Time> obj (new Time(5));
+          int randVal ((rand() % 10) - 5);
+          
           CommDef ("test.command1")
               .operation (command1::operate)
               .captureUndo (command1::capture)
               .undoOperation (command1::undoIt)
-//              .bind (obj, randVal)
+              .bind (obj, randVal)
               ;
         }
       

From ab4b4c71e61869ffb90e7443666962c525585af5 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 16 Jun 2009 11:39:36 +0200
Subject: [PATCH 106/368] WIP: start extacting new headers

---
 src/lib/meta/function.hpp                     | 534 ++++++++++++++++++
 .../proc/control/command-basic-test.cpp       | 476 +---------------
 2 files changed, 535 insertions(+), 475 deletions(-)
 create mode 100644 src/lib/meta/function.hpp

diff --git a/src/lib/meta/function.hpp b/src/lib/meta/function.hpp
new file mode 100644
index 000000000..9cdb8e89d
--- /dev/null
+++ b/src/lib/meta/function.hpp
@@ -0,0 +1,534 @@
+/*
+  FUNCTION.hpp  -  metaprogramming utilities for transforming function types
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file function.hpp
+ ** Metaprogramming tools for transforming functor types.
+ ** Sometimes it is necessary to build and remould a function signature, e.g. for
+ ** creating a functor or a closure based on an existing function of function pointer.
+ ** This is a core task of functional programming, but sadly C++ in its current shape
+ ** is still lacking in this area. (C++0X will significantly improve this situation).
+ ** As an \em pragmatic fix, we define here a collection of templates, specialising
+ ** them in a very repetitive way for up to 9 function arguments. Doing so enables
+ ** us to capture a function, access the return type and argument types as a typelist,
+ ** eventually to manipulate them and re-build a different signature, or to create
+ ** specifically tailored bindings.
+ ** 
+ ** If the following code makes you feel like vomiting, please look away,
+ ** and rest assured: you aren't alone. 
+ ** 
+ ** @see control::CommandDef usage example
+ ** @see typelist.hpp
+ ** @see tuple.hpp
+ ** 
+ */
+
+
+#ifndef LUMIERA_META_FUNCTION_H
+#define LUMIERA_META_FUNCTION_H
+
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/generator.hpp"
+#include "lib/meta/typelistutil.hpp"
+
+#include <tr1/functional>
+
+
+
+namespace lumiera {
+namespace typelist{
+
+  using std::tr1::bind;
+  //using std::tr1::placeholders::_1;
+  //using std::tr1::placeholders::_2;
+  using std::tr1::function;
+
+
+  template< typename SIG>
+  struct FunctionSignature;
+  
+  template< typename RET>
+  struct FunctionSignature< function<RET(void)> >
+  {
+    typedef RET Ret;
+    typedef Types<> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionSignature< function<RET(A1)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionSignature< function<RET(A1,A2)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5> Args;
+  };
+  
+  
+  template<typename RET, typename LI>
+  struct FunctionTypedef;
+  
+  template< typename RET>
+  struct FunctionTypedef<RET, Types<> >
+  {
+    typedef function<RET(void)> Func;
+    typedef          RET Sig();
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionTypedef<RET, Types<A1> >
+  {
+    typedef function<RET(A1)> Func;
+    typedef          RET Sig(A1);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionTypedef<RET, Types<A1,A2> >
+  {
+    typedef function<RET(A1,A2)> Func;
+    typedef          RET Sig(A1,A2);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3> >
+  {
+    typedef function<RET(A1,A2,A3)> Func;
+    typedef          RET Sig(A1,A2,A3);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
+  {
+    typedef function<RET(A1,A2,A3,A4)> Func;
+    typedef          RET Sig(A1,A2,A3,A4);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5);
+  };
+  
+  
+  
+  /////////////////////////very basic facility: Typed tuples
+  
+  template<class T, class TYPES>
+  struct Prepend;
+  
+  template< typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename IGN
+          >
+  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
+  {
+    typedef Types<A1,A2,A3,A4,A5> Tuple;
+  };
+
+  template<class TYPES>
+  struct Tuple;
+
+  template<>
+  struct Tuple<NullType>
+    {
+      typedef NullType HeadType;
+      typedef Types<>  TailType;
+      typedef Types<>  Type;
+      
+      typedef NullType ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<NullType> Tail;
+      enum { SIZE = 0 };
+      
+      NullType getHead() { return NullType(); }
+      Tail&    getTail() { return *this;      }
+      
+      Tuple (HeadType const&, Tail const&) { }
+      Tuple ()                             { }
+    };
+  
+  template<class TY, class TYPES>
+  struct Tuple<Node<TY,TYPES> >
+    : Tuple<TYPES>
+    {
+      typedef TY                                   HeadType;
+      typedef typename Tuple<TYPES>::Type          TailType;
+      typedef typename Prepend<TY,TailType>::Tuple Type;
+      
+      typedef Node<TY,TYPES> ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TYPES> Tail;
+      enum { SIZE = count<ArgList_>::value };
+      
+      Tuple ( TY a1 =TY()
+            , Tail tail =Tail()
+            )
+        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
+          val_(a1)
+        { }
+      
+      TY  & getHead() { return val_; }
+      Tail& getTail() { return static_cast<Tail&> (*this); }
+      
+    private:
+      TY val_;
+    };
+  
+  ////TODO move in sub-scope
+  template<class TUP,uint i>
+  struct Shifted
+    {
+      typedef typename TUP::Tail Tail;
+      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
+    };
+  template<class TUP>
+  struct Shifted<TUP,0>
+    { 
+      typedef Tuple<typename TUP::ArgList_> TupleType;
+    };
+      
+  
+  template< typename T1
+          , typename T2
+          , typename T3
+          , typename T4
+          , typename T5
+          >
+  struct Tuple<Types<T1,T2,T3,T4,T5> >
+    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
+    {
+      typedef T1                          HeadType;
+      typedef Types<T2,T3,T4,T5,NullType> TailType;
+      typedef Types<T1,T2,T3,T4,T5>       Type;
+      
+      typedef typename Type::List ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TailType> Tail;
+      enum { SIZE = count<ArgList_>::value };
+      
+      Tuple ( T1 a1 =T1()
+            , T2 a2 =T2()
+            , T3 a3 =T3()
+            , T4 a4 =T4()
+            , T5 a5 =T5()
+            )
+        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
+        { }
+      
+      using Tuple<ArgList_>::getHead;
+      using Tuple<ArgList_>::getTail;
+      
+      template<uint i>
+      typename Shifted<ThisTuple,i>::TupleType&
+      getShifted ()
+        {
+          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
+          return static_cast<Tail_I&> (*this);
+        }
+      
+      template<uint i>
+      typename Shifted<ThisTuple,i>::TupleType::HeadType&
+      getAt ()
+        {
+          return getShifted<i>().getHead();
+        }
+      
+      NullType&
+      getNull()
+        {
+          static NullType nix;
+          return nix; 
+        }
+    };
+  
+  
+  /**
+   * Decorating a tuple type with auxiliary data access operations.
+   * This helper template builds up a subclass of the given BASE type
+   * (which is assumed to be a Tuple or at least need to be copy constructible
+   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
+   * to add a layer of access functions, which in turn might rely on the exact
+   * type of the individual elements within the Tuple. To achieve this, for each
+   * type within the Tuple, the BASE type is decorated with an instance of the
+   * template passed in as template template parameter _X_. Each of these
+   * decorating instances is provided with a member pointer to access "his"
+   * specific element within the underlying tuple.
+   * 
+   * The decorating template _X_ need to take its own base class as template
+   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
+   * calling down into this templated base class. To support this, an instantiation
+   * of _X_ with the 0 member ptr is generated for detecting recursion end
+   * (built as innermost decorator, i.e. immediate subclass of BASE) 
+   */
+  template
+    < typename TYPES
+    , template<class,class,uint> class _X_
+    , class BASE =Tuple<TYPES>
+    , uint i = 0
+    >
+  class BuildTupleAccessor
+    {
+      typedef Tuple<TYPES> ArgTuple;
+      typedef typename ArgTuple::HeadType Head;
+      typedef typename ArgTuple::TailType Tail;
+//    typedef Head ArgTuple::*getElm();
+      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
+      typedef typename NextBuilder::Accessor NextAccessor;
+      
+      ArgTuple& argData_;
+      
+    public:
+      
+      /** type of the product created by this template.
+       *  Will be a subclass of BASE */
+      typedef _X_<Head, NextAccessor, i> Accessor;
+      
+      BuildTupleAccessor (ArgTuple& tup)
+        : argData_(tup)
+        { }
+      
+      operator Accessor() { return Accessor(argData_); }
+      
+    };
+
+  template
+    < class BASE
+    , template<class,class,uint> class _X_
+    , uint i
+    >
+  class BuildTupleAccessor<Types<>, _X_, BASE, i>
+    {
+      typedef Tuple<Types<> > ArgTuple;
+//    typedef NullType BASE::*getElm();
+      
+    public:
+      typedef _X_<NullType, BASE, 0> Accessor;
+    };
+  
+  
+  ///////////////////////// creating functional closures
+  
+  namespace tuple {
+      template<uint n>
+      struct Apply;
+      
+      template<>       
+      struct Apply<1>
+        {
+          template<class FUN, typename RET, class TUP>
+          static RET
+          invoke (FUN f, TUP & arg)
+            {
+              return f (arg.template getAt<1>()); 
+            }
+          
+          template<class FUN, typename RET, class TUP>
+          static RET
+          bind (FUN f, TUP & arg)
+            {
+              return std::tr1::bind (f, arg.template getAt<1>()); 
+            }
+        };
+      
+      template<>       
+      struct Apply<2>
+        {
+          template<class FUN, typename RET, class TUP>
+          static RET
+          invoke (FUN f, TUP & arg)
+            {
+              return f ( arg.template getAt<1>()
+                       , arg.template getAt<2>()
+                       ); 
+            }
+          
+          template<class FUN, typename RET, class TUP>
+          static RET
+          bind (FUN f, TUP & arg)
+            {
+              return std::tr1::bind (f, arg.template getAt<1>() 
+                                      , arg.template getAt<2>()
+                                     );
+            }
+        };
+  } // (END) sub-namespace 
+  
+  template<typename SIG>
+  class TupleApplicator
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      enum { ARG_CNT = count<typename Args::List>::value };
+      
+      
+      /** storing a ref to the parameter tuple */
+      Tuple<Args>& params_;
+      
+    public:
+      TupleApplicator (Tuple<Args>& args)
+        : params_(args)
+        { }
+      
+      function<SIG>  bind (SIG& f)                 { return tuple::Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::bind (f, params_); }
+      
+      Ret      operator() (SIG& f)                 { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
+    };
+  
+  
+  /**
+   * Closing a function over its arguments.
+   * This is a small usage example or spin-off,
+   * having almost the same effect than invoking tr1::bind.
+   * The notable difference is that the function arguments for
+   * creating the closure are passed in as one compound tuple.
+   */
+  template<typename SIG>
+  class FunctionClosure
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      function<Ret(void)> closure_;
+      
+    public:
+      FunctionClosure (SIG& f, Tuple<Args>& arg)
+        : closure_(TupleApplicator<SIG>(arg).bind(f))
+        { }
+      FunctionClosure (function<SIG> const& f, Tuple<Args>& arg)
+        : closure_(TupleApplicator<SIG>(arg).bind(f))
+        { }
+      
+      Ret operator() () { return closure_(); }
+    };
+  
+  
+/*
+  template<typename TYPES>
+  struct BuildClosure
+    : InstantiateWithIndex<TYPES, Accessor, I>
+    {
+      
+    };
+*/
+  
+  ///////////////////////// additional typelist manipulators
+  
+  template<class TYPES>
+  struct SplitLast;
+  
+  template<>
+  struct SplitLast<NullType>
+    {
+      typedef NullType Type;
+      typedef NullType Prefix;
+    };
+  
+  template<class TY>
+  struct SplitLast<Node<TY,NullType> >
+    {
+      typedef TY Type;
+      typedef NullType Prefix;
+    };
+  
+  template<class TY, class TYPES>
+  struct SplitLast<Node<TY,TYPES> >
+    {
+      typedef typename SplitLast<TYPES>::Type Type;
+      typedef typename Append<TY, typename SplitLast<TYPES>::Prefix>::List Prefix;
+    };
+
+  
+  
+}} // namespace lumiera::typelist
+#endif
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 15c551834..7d74708a6 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -39,6 +39,7 @@
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelistutil.hpp"
 #include "lib/meta/generator.hpp"
+#include "lib/meta/function.hpp"
 
 #include <tr1/functional>
 //#include <boost/format.hpp>
@@ -57,481 +58,6 @@ using std::cout;
 using std::endl;
 
 
-namespace lumiera {
-namespace typelist{
-
-
-  ////////////////////////////////////////////TODO braindump
-  
-  template< typename SIG>
-  struct FunctionSignature;
-  
-  template< typename RET>
-  struct FunctionSignature< function<RET(void)> >
-  {
-    typedef RET Ret;
-    typedef Types<> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          >
-  struct FunctionSignature< function<RET(A1)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          >
-  struct FunctionSignature< function<RET(A1,A2)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3,A4> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3,A4,A5> Args;
-  };
-  
-  
-  template<typename RET, typename LI>
-  struct FunctionTypedef;
-  
-  template< typename RET>
-  struct FunctionTypedef<RET, Types<> >
-  {
-    typedef function<RET(void)> Func;
-    typedef          RET Sig();
-  };
-  
-  template< typename RET
-          , typename A1
-          >
-  struct FunctionTypedef<RET, Types<A1> >
-  {
-    typedef function<RET(A1)> Func;
-    typedef          RET Sig(A1);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          >
-  struct FunctionTypedef<RET, Types<A1,A2> >
-  {
-    typedef function<RET(A1,A2)> Func;
-    typedef          RET Sig(A1,A2);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3> >
-  {
-    typedef function<RET(A1,A2,A3)> Func;
-    typedef          RET Sig(A1,A2,A3);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
-  {
-    typedef function<RET(A1,A2,A3,A4)> Func;
-    typedef          RET Sig(A1,A2,A3,A4);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
-  {
-    typedef function<RET(A1,A2,A3,A4,A5)> Func;
-    typedef          RET Sig(A1,A2,A3,A4,A5);
-  };
-  
-  
-  
-  /////////////////////////very basic facility: Typed tuples
-  
-  template<class T, class TYPES>
-  struct Prepend;
-  
-  template< typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          , typename IGN
-          >
-  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
-  {
-    typedef Types<A1,A2,A3,A4,A5> Tuple;
-  };
-
-  template<class TYPES>
-  struct Tuple;
-
-  template<>
-  struct Tuple<NullType>
-    {
-      typedef NullType HeadType;
-      typedef Types<>  TailType;
-      typedef Types<>  Type;
-      
-      typedef NullType ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<NullType> Tail;
-      enum { SIZE = 0 };
-      
-      NullType getHead() { return NullType(); }
-      Tail&    getTail() { return *this;      }
-      
-      Tuple (HeadType const&, Tail const&) { }
-      Tuple ()                             { }
-    };
-  
-  template<class TY, class TYPES>
-  struct Tuple<Node<TY,TYPES> >
-    : Tuple<TYPES>
-    {
-      typedef TY                                   HeadType;
-      typedef typename Tuple<TYPES>::Type          TailType;
-      typedef typename Prepend<TY,TailType>::Tuple Type;
-      
-      typedef Node<TY,TYPES> ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TYPES> Tail;
-      enum { SIZE = count<ArgList_>::value };
-      
-      Tuple ( TY a1 =TY()
-            , Tail tail =Tail()
-            )
-        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
-          val_(a1)
-        { }
-      
-      TY  & getHead() { return val_; }
-      Tail& getTail() { return static_cast<Tail&> (*this); }
-      
-    private:
-      TY val_;
-    };
-  
-  ////TODO move in sub-scope
-  template<class TUP,uint i>
-  struct Shifted
-    {
-      typedef typename TUP::Tail Tail;
-      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
-    };
-  template<class TUP>
-  struct Shifted<TUP,0>
-    { 
-      typedef Tuple<typename TUP::ArgList_> TupleType;
-    };
-      
-  
-  template< typename T1
-          , typename T2
-          , typename T3
-          , typename T4
-          , typename T5
-          >
-  struct Tuple<Types<T1,T2,T3,T4,T5> >
-    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
-    {
-      typedef T1                          HeadType;
-      typedef Types<T2,T3,T4,T5,NullType> TailType;
-      typedef Types<T1,T2,T3,T4,T5>       Type;
-      
-      typedef typename Type::List ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TailType> Tail;
-      enum { SIZE = count<ArgList_>::value };
-      
-      Tuple ( T1 a1 =T1()
-            , T2 a2 =T2()
-            , T3 a3 =T3()
-            , T4 a4 =T4()
-            , T5 a5 =T5()
-            )
-        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
-        { }
-      
-      using Tuple<ArgList_>::getHead;
-      using Tuple<ArgList_>::getTail;
-      
-      template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType&
-      getShifted ()
-        {
-          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
-          return static_cast<Tail_I&> (*this);
-        }
-      
-      template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType::HeadType&
-      getAt ()
-        {
-          return getShifted<i>().getHead();
-        }
-      
-      NullType&
-      getNull()
-        {
-          static NullType nix;
-          return nix; 
-        }
-    };
-  
-  
-  /**
-   * Decorating a tuple type with auxiliary data access operations.
-   * This helper template builds up a subclass of the given BASE type
-   * (which is assumed to be a Tuple or at least need to be copy constructible
-   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
-   * to add a layer of access functions, which in turn might rely on the exact
-   * type of the individual elements within the Tuple. To achieve this, for each
-   * type within the Tuple, the BASE type is decorated with an instance of the
-   * template passed in as template template parameter _X_. Each of these
-   * decorating instances is provided with a member pointer to access "his"
-   * specific element within the underlying tuple.
-   * 
-   * The decorating template _X_ need to take its own base class as template
-   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
-   * calling down into this templated base class. To support this, an instantiation
-   * of _X_ with the 0 member ptr is generated for detecting recursion end
-   * (built as innermost decorator, i.e. immediate subclass of BASE) 
-   */
-  template
-    < typename TYPES
-    , template<class,class,uint> class _X_
-    , class BASE =Tuple<TYPES>
-    , uint i = 0
-    >
-  class BuildTupleAccessor
-    {
-      typedef Tuple<TYPES> ArgTuple;
-      typedef typename ArgTuple::HeadType Head;
-      typedef typename ArgTuple::TailType Tail;
-//    typedef Head ArgTuple::*getElm();
-      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
-      typedef typename NextBuilder::Accessor NextAccessor;
-      
-      ArgTuple& argData_;
-      
-    public:
-      
-      /** type of the product created by this template.
-       *  Will be a subclass of BASE */
-      typedef _X_<Head, NextAccessor, i> Accessor;
-      
-      BuildTupleAccessor (ArgTuple& tup)
-        : argData_(tup)
-        { }
-      
-      operator Accessor() { return Accessor(argData_); }
-      
-    };
-
-  template
-    < class BASE
-    , template<class,class,uint> class _X_
-    , uint i
-    >
-  class BuildTupleAccessor<Types<>, _X_, BASE, i>
-    {
-      typedef Tuple<Types<> > ArgTuple;
-//    typedef NullType BASE::*getElm();
-      
-    public:
-      typedef _X_<NullType, BASE, 0> Accessor;
-    };
-  
-  
-  ///////////////////////// creating functional closures
-  
-  namespace tuple {
-      template<uint n>
-      struct Apply;
-      
-      template<>       
-      struct Apply<1>
-        {
-          template<class FUN, typename RET, class TUP>
-          static RET
-          invoke (FUN f, TUP & arg)
-            {
-              return f (arg.template getAt<1>()); 
-            }
-          
-          template<class FUN, typename RET, class TUP>
-          static RET
-          bind (FUN f, TUP & arg)
-            {
-              return std::tr1::bind (f, arg.template getAt<1>()); 
-            }
-        };
-      
-      template<>       
-      struct Apply<2>
-        {
-          template<class FUN, typename RET, class TUP>
-          static RET
-          invoke (FUN f, TUP & arg)
-            {
-              return f ( arg.template getAt<1>()
-                       , arg.template getAt<2>()
-                       ); 
-            }
-          
-          template<class FUN, typename RET, class TUP>
-          static RET
-          bind (FUN f, TUP & arg)
-            {
-              return std::tr1::bind (f, arg.template getAt<1>() 
-                                      , arg.template getAt<2>()
-                                     );
-            }
-        };
-  } // (END) sub-namespace 
-  
-  template<typename SIG>
-  class TupleApplicator
-    {
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-      
-      enum { ARG_CNT = count<typename Args::List>::value };
-      
-      
-      /** storing a ref to the parameter tuple */
-      Tuple<Args>& params_;
-      
-    public:
-      TupleApplicator (Tuple<Args>& args)
-        : params_(args)
-        { }
-      
-      function<SIG>  bind (SIG& f)                 { return tuple::Apply<ARG_CNT>::bind (f, params_); }
-      function<SIG>  bind (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::bind (f, params_); }
-      
-      Ret      operator() (SIG& f)                 { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
-      Ret      operator() (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
-    };
-  
-  
-  /**
-   * Closing a function over its arguments.
-   * This is a small usage example or spin-off,
-   * having almost the same effect than invoking tr1::bind.
-   * The notable difference is that the function arguments for
-   * creating the closure are passed in as one compound tuple.
-   */
-  template<typename SIG>
-  class FunctionClosure
-    {
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-      
-      function<Ret(void)> closure_;
-      
-    public:
-      FunctionClosure (SIG& f, Tuple<Args>& arg)
-        : closure_(TupleApplicator<SIG>(arg).bind(f))
-        { }
-      FunctionClosure (function<SIG> const& f, Tuple<Args>& arg)
-        : closure_(TupleApplicator<SIG>(arg).bind(f))
-        { }
-      
-      Ret operator() () { return closure_(); }
-    };
-  
-  
-/*
-  template<typename TYPES>
-  struct BuildClosure
-    : InstantiateWithIndex<TYPES, Accessor, I>
-    {
-      
-    };
-*/
-  
-  ///////////////////////// additional typelist manipulators
-  
-  template<class TYPES>
-  struct SplitLast;
-  
-  template<>
-  struct SplitLast<NullType>
-    {
-      typedef NullType Type;
-      typedef NullType Prefix;
-    };
-  
-  template<class TY>
-  struct SplitLast<Node<TY,NullType> >
-    {
-      typedef TY Type;
-      typedef NullType Prefix;
-    };
-  
-  template<class TY, class TYPES>
-  struct SplitLast<Node<TY,TYPES> >
-    {
-      typedef typename SplitLast<TYPES>::Type Type;
-      typedef typename Append<TY, typename SplitLast<TYPES>::Prefix>::List Prefix;
-    };
-
-  
-  
-}} // namespace lumiera::typelist
-  
 namespace control {
 namespace test    {
 

From 9d04f48c51b964ac4c1e35de7425d9d0348cb837 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 16 Jun 2009 12:07:49 +0200
Subject: [PATCH 107/368] WIP: further split the headers

---
 src/lib/meta/function-closure.hpp | 525 ++++++++++++++++++++++++++++++
 src/lib/meta/tuple.hpp            | 401 +++++++++++++++++++++++
 2 files changed, 926 insertions(+)
 create mode 100644 src/lib/meta/function-closure.hpp
 create mode 100644 src/lib/meta/tuple.hpp

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
new file mode 100644
index 000000000..f85d3953d
--- /dev/null
+++ b/src/lib/meta/function-closure.hpp
@@ -0,0 +1,525 @@
+/*
+  FUNCTION-CLOSURE.hpp  -  metaprogramming tools for closing a function over given arguments
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file function-closure.hpp
+ ** Partial function application and building a complete function closure.
+ ** This is a small addendum to (and thin wrapper for) tr1/functional, supporting
+ ** the case when a function should be closed over (all) arguments, where especially
+ ** the parameter values to close on are provided as a tuple. 
+ ** 
+ ** @see control::CommandDef usage example
+ ** @see function.hpp
+ ** @see tuple.hpp
+ ** 
+ */
+
+
+#ifndef LUMIERA_META_FUNCTION_CLOSURE_H
+#define LUMIERA_META_FUNCTION_CLOSURE_H
+
+#include "lib/meta/typelist.hpp"   /////////////TODO
+#include "lib/meta/generator.hpp"  /////////////TODO
+#include "lib/meta/function.hpp"
+
+#include <tr1/functional>
+
+
+
+namespace lumiera {
+namespace typelist{
+
+  using std::tr1::bind;
+  //using std::tr1::placeholders::_1;
+  //using std::tr1::placeholders::_2;
+  using std::tr1::function;
+
+
+  template< typename SIG>
+  struct FunctionSignature;
+  
+  template< typename RET>
+  struct FunctionSignature< function<RET(void)> >
+  {
+    typedef RET Ret;
+    typedef Types<> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionSignature< function<RET(A1)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionSignature< function<RET(A1,A2)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5> Args;
+  };
+  
+  
+  template<typename RET, typename LI>
+  struct FunctionTypedef;
+  
+  template< typename RET>
+  struct FunctionTypedef<RET, Types<> >
+  {
+    typedef function<RET(void)> Func;
+    typedef          RET Sig();
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionTypedef<RET, Types<A1> >
+  {
+    typedef function<RET(A1)> Func;
+    typedef          RET Sig(A1);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionTypedef<RET, Types<A1,A2> >
+  {
+    typedef function<RET(A1,A2)> Func;
+    typedef          RET Sig(A1,A2);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3> >
+  {
+    typedef function<RET(A1,A2,A3)> Func;
+    typedef          RET Sig(A1,A2,A3);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
+  {
+    typedef function<RET(A1,A2,A3,A4)> Func;
+    typedef          RET Sig(A1,A2,A3,A4);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5);
+  };
+  
+  
+  
+  /////////////////////////very basic facility: Typed tuples
+  
+  template<class T, class TYPES>
+  struct Prepend;
+  
+  template< typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename IGN
+          >
+  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
+  {
+    typedef Types<A1,A2,A3,A4,A5> Tuple;
+  };
+
+  template<class TYPES>
+  struct Tuple;
+
+  template<>
+  struct Tuple<NullType>
+    {
+      typedef NullType HeadType;
+      typedef Types<>  TailType;
+      typedef Types<>  Type;
+      
+      typedef NullType ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<NullType> Tail;
+      enum { SIZE = 0 };
+      
+      NullType getHead() { return NullType(); }
+      Tail&    getTail() { return *this;      }
+      
+      Tuple (HeadType const&, Tail const&) { }
+      Tuple ()                             { }
+    };
+  
+  template<class TY, class TYPES>
+  struct Tuple<Node<TY,TYPES> >
+    : Tuple<TYPES>
+    {
+      typedef TY                                   HeadType;
+      typedef typename Tuple<TYPES>::Type          TailType;
+      typedef typename Prepend<TY,TailType>::Tuple Type;
+      
+      typedef Node<TY,TYPES> ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TYPES> Tail;
+      enum { SIZE = count<ArgList_>::value };
+      
+      Tuple ( TY a1 =TY()
+            , Tail tail =Tail()
+            )
+        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
+          val_(a1)
+        { }
+      
+      TY  & getHead() { return val_; }
+      Tail& getTail() { return static_cast<Tail&> (*this); }
+      
+    private:
+      TY val_;
+    };
+  
+  ////TODO move in sub-scope
+  template<class TUP,uint i>
+  struct Shifted
+    {
+      typedef typename TUP::Tail Tail;
+      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
+    };
+  template<class TUP>
+  struct Shifted<TUP,0>
+    { 
+      typedef Tuple<typename TUP::ArgList_> TupleType;
+    };
+      
+  
+  template< typename T1
+          , typename T2
+          , typename T3
+          , typename T4
+          , typename T5
+          >
+  struct Tuple<Types<T1,T2,T3,T4,T5> >
+    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
+    {
+      typedef T1                          HeadType;
+      typedef Types<T2,T3,T4,T5,NullType> TailType;
+      typedef Types<T1,T2,T3,T4,T5>       Type;
+      
+      typedef typename Type::List ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TailType> Tail;
+      enum { SIZE = count<ArgList_>::value };
+      
+      Tuple ( T1 a1 =T1()
+            , T2 a2 =T2()
+            , T3 a3 =T3()
+            , T4 a4 =T4()
+            , T5 a5 =T5()
+            )
+        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
+        { }
+      
+      using Tuple<ArgList_>::getHead;
+      using Tuple<ArgList_>::getTail;
+      
+      template<uint i>
+      typename Shifted<ThisTuple,i>::TupleType&
+      getShifted ()
+        {
+          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
+          return static_cast<Tail_I&> (*this);
+        }
+      
+      template<uint i>
+      typename Shifted<ThisTuple,i>::TupleType::HeadType&
+      getAt ()
+        {
+          return getShifted<i>().getHead();
+        }
+      
+      NullType&
+      getNull()
+        {
+          static NullType nix;
+          return nix; 
+        }
+    };
+  
+  
+  /**
+   * Decorating a tuple type with auxiliary data access operations.
+   * This helper template builds up a subclass of the given BASE type
+   * (which is assumed to be a Tuple or at least need to be copy constructible
+   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
+   * to add a layer of access functions, which in turn might rely on the exact
+   * type of the individual elements within the Tuple. To achieve this, for each
+   * type within the Tuple, the BASE type is decorated with an instance of the
+   * template passed in as template template parameter _X_. Each of these
+   * decorating instances is provided with a member pointer to access "his"
+   * specific element within the underlying tuple.
+   * 
+   * The decorating template _X_ need to take its own base class as template
+   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
+   * calling down into this templated base class. To support this, an instantiation
+   * of _X_ with the 0 member ptr is generated for detecting recursion end
+   * (built as innermost decorator, i.e. immediate subclass of BASE) 
+   */
+  template
+    < typename TYPES
+    , template<class,class,uint> class _X_
+    , class BASE =Tuple<TYPES>
+    , uint i = 0
+    >
+  class BuildTupleAccessor
+    {
+      typedef Tuple<TYPES> ArgTuple;
+      typedef typename ArgTuple::HeadType Head;
+      typedef typename ArgTuple::TailType Tail;
+//    typedef Head ArgTuple::*getElm();
+      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
+      typedef typename NextBuilder::Accessor NextAccessor;
+      
+      ArgTuple& argData_;
+      
+    public:
+      
+      /** type of the product created by this template.
+       *  Will be a subclass of BASE */
+      typedef _X_<Head, NextAccessor, i> Accessor;
+      
+      BuildTupleAccessor (ArgTuple& tup)
+        : argData_(tup)
+        { }
+      
+      operator Accessor() { return Accessor(argData_); }
+      
+    };
+
+  template
+    < class BASE
+    , template<class,class,uint> class _X_
+    , uint i
+    >
+  class BuildTupleAccessor<Types<>, _X_, BASE, i>
+    {
+      typedef Tuple<Types<> > ArgTuple;
+//    typedef NullType BASE::*getElm();
+      
+    public:
+      typedef _X_<NullType, BASE, 0> Accessor;
+    };
+  
+  
+  ///////////////////////// creating functional closures
+  
+  namespace tuple {
+      template<uint n>
+      struct Apply;
+      
+      template<>       
+      struct Apply<1>
+        {
+          template<class FUN, typename RET, class TUP>
+          static RET
+          invoke (FUN f, TUP & arg)
+            {
+              return f (arg.template getAt<1>()); 
+            }
+          
+          template<class FUN, typename RET, class TUP>
+          static RET
+          bind (FUN f, TUP & arg)
+            {
+              return std::tr1::bind (f, arg.template getAt<1>()); 
+            }
+        };
+      
+      template<>       
+      struct Apply<2>
+        {
+          template<class FUN, typename RET, class TUP>
+          static RET
+          invoke (FUN f, TUP & arg)
+            {
+              return f ( arg.template getAt<1>()
+                       , arg.template getAt<2>()
+                       ); 
+            }
+          
+          template<class FUN, typename RET, class TUP>
+          static RET
+          bind (FUN f, TUP & arg)
+            {
+              return std::tr1::bind (f, arg.template getAt<1>() 
+                                      , arg.template getAt<2>()
+                                     );
+            }
+        };
+  } // (END) sub-namespace 
+  
+  template<typename SIG>
+  class TupleApplicator
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      enum { ARG_CNT = count<typename Args::List>::value };
+      
+      
+      /** storing a ref to the parameter tuple */
+      Tuple<Args>& params_;
+      
+    public:
+      TupleApplicator (Tuple<Args>& args)
+        : params_(args)
+        { }
+      
+      function<SIG>  bind (SIG& f)                 { return tuple::Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::bind (f, params_); }
+      
+      Ret      operator() (SIG& f)                 { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
+    };
+  
+  
+  /**
+   * Closing a function over its arguments.
+   * This is a small usage example or spin-off,
+   * having almost the same effect than invoking tr1::bind.
+   * The notable difference is that the function arguments for
+   * creating the closure are passed in as one compound tuple.
+   */
+  template<typename SIG>
+  class FunctionClosure
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      function<Ret(void)> closure_;
+      
+    public:
+      FunctionClosure (SIG& f, Tuple<Args>& arg)
+        : closure_(TupleApplicator<SIG>(arg).bind(f))
+        { }
+      FunctionClosure (function<SIG> const& f, Tuple<Args>& arg)
+        : closure_(TupleApplicator<SIG>(arg).bind(f))
+        { }
+      
+      Ret operator() () { return closure_(); }
+    };
+  
+  
+/*
+  template<typename TYPES>
+  struct BuildClosure
+    : InstantiateWithIndex<TYPES, Accessor, I>
+    {
+      
+    };
+*/
+  
+  ///////////////////////// additional typelist manipulators
+  
+  template<class TYPES>
+  struct SplitLast;
+  
+  template<>
+  struct SplitLast<NullType>
+    {
+      typedef NullType Type;
+      typedef NullType Prefix;
+    };
+  
+  template<class TY>
+  struct SplitLast<Node<TY,NullType> >
+    {
+      typedef TY Type;
+      typedef NullType Prefix;
+    };
+  
+  template<class TY, class TYPES>
+  struct SplitLast<Node<TY,TYPES> >
+    {
+      typedef typename SplitLast<TYPES>::Type Type;
+      typedef typename Append<TY, typename SplitLast<TYPES>::Prefix>::List Prefix;
+    };
+
+  
+  
+}} // namespace lumiera::typelist
+#endif
diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
new file mode 100644
index 000000000..2db8a6673
--- /dev/null
+++ b/src/lib/meta/tuple.hpp
@@ -0,0 +1,401 @@
+/*
+  TUPLE.hpp  -  metaprogramming utilities for type tuples and data tuples
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file tuple.hpp
+ ** Metaprogramming with tuples-of-types and a very simple Tuple datatype.
+ ** The metaprogramming part of this header complements typelist.hpp and allows
+ ** to re-build a new tuple-of-types from an existing typelist. Such a finite
+ ** tuple of types can at times be more handy than a typelist, especially when
+ ** capturing specific types to use as template parameter. 
+ ** 
+ ** Additionally, this header augments the Tuple template into a very simple Tuple
+ ** (run time) datatype. This isn't meant as competing with std::tr1::tuple, which is
+ ** much more capable, but also has the downside of pulling in a lot of other headers.
+ ** But when all we need is to define a generic typed record of N data elements and
+ ** later re-accessing them (but no further advanced processing), the Tuple template
+ ** might come in handy. 
+ ** 
+ ** @see control::CommandDef usage example
+ ** @see typelist.hpp
+ ** @see function.hpp
+ ** @see generator.hpp
+ ** 
+ */
+
+
+#ifndef LUMIERA_META_TUPLE_H
+#define LUMIERA_META_TUPLE_H
+
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/generator.hpp"
+#include "lib/meta/typelistutil.hpp"
+
+#include <tr1/functional>
+
+
+
+namespace lumiera {
+namespace typelist{
+
+  using std::tr1::bind;
+  //using std::tr1::placeholders::_1;
+  //using std::tr1::placeholders::_2;
+  using std::tr1::function;
+
+
+  template< typename SIG>
+  struct FunctionSignature;
+  
+  template< typename RET>
+  struct FunctionSignature< function<RET(void)> >
+  {
+    typedef RET Ret;
+    typedef Types<> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionSignature< function<RET(A1)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionSignature< function<RET(A1,A2)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4> Args;
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5> Args;
+  };
+  
+  
+  template<typename RET, typename LI>
+  struct FunctionTypedef;
+  
+  template< typename RET>
+  struct FunctionTypedef<RET, Types<> >
+  {
+    typedef function<RET(void)> Func;
+    typedef          RET Sig();
+  };
+  
+  template< typename RET
+          , typename A1
+          >
+  struct FunctionTypedef<RET, Types<A1> >
+  {
+    typedef function<RET(A1)> Func;
+    typedef          RET Sig(A1);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          >
+  struct FunctionTypedef<RET, Types<A1,A2> >
+  {
+    typedef function<RET(A1,A2)> Func;
+    typedef          RET Sig(A1,A2);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3> >
+  {
+    typedef function<RET(A1,A2,A3)> Func;
+    typedef          RET Sig(A1,A2,A3);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
+  {
+    typedef function<RET(A1,A2,A3,A4)> Func;
+    typedef          RET Sig(A1,A2,A3,A4);
+  };
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5);
+  };
+  
+  
+  
+  /////////////////////////very basic facility: Typed tuples
+  
+  template<class T, class TYPES>
+  struct Prepend;
+  
+  template< typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename IGN
+          >
+  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
+  {
+    typedef Types<A1,A2,A3,A4,A5> Tuple;
+  };
+
+  template<class TYPES>
+  struct Tuple;
+
+  template<>
+  struct Tuple<NullType>
+    {
+      typedef NullType HeadType;
+      typedef Types<>  TailType;
+      typedef Types<>  Type;
+      
+      typedef NullType ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<NullType> Tail;
+      enum { SIZE = 0 };
+      
+      NullType getHead() { return NullType(); }
+      Tail&    getTail() { return *this;      }
+      
+      Tuple (HeadType const&, Tail const&) { }
+      Tuple ()                             { }
+    };
+  
+  template<class TY, class TYPES>
+  struct Tuple<Node<TY,TYPES> >
+    : Tuple<TYPES>
+    {
+      typedef TY                                   HeadType;
+      typedef typename Tuple<TYPES>::Type          TailType;
+      typedef typename Prepend<TY,TailType>::Tuple Type;
+      
+      typedef Node<TY,TYPES> ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TYPES> Tail;
+      enum { SIZE = count<ArgList_>::value };
+      
+      Tuple ( TY a1 =TY()
+            , Tail tail =Tail()
+            )
+        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
+          val_(a1)
+        { }
+      
+      TY  & getHead() { return val_; }
+      Tail& getTail() { return static_cast<Tail&> (*this); }
+      
+    private:
+      TY val_;
+    };
+  
+  ////TODO move in sub-scope
+  template<class TUP,uint i>
+  struct Shifted
+    {
+      typedef typename TUP::Tail Tail;
+      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
+    };
+  template<class TUP>
+  struct Shifted<TUP,0>
+    { 
+      typedef Tuple<typename TUP::ArgList_> TupleType;
+    };
+      
+  
+  template< typename T1
+          , typename T2
+          , typename T3
+          , typename T4
+          , typename T5
+          >
+  struct Tuple<Types<T1,T2,T3,T4,T5> >
+    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
+    {
+      typedef T1                          HeadType;
+      typedef Types<T2,T3,T4,T5,NullType> TailType;
+      typedef Types<T1,T2,T3,T4,T5>       Type;
+      
+      typedef typename Type::List ArgList_;
+      typedef Tuple<Type> ThisTuple;
+      typedef Tuple<TailType> Tail;
+      enum { SIZE = count<ArgList_>::value };
+      
+      Tuple ( T1 a1 =T1()
+            , T2 a2 =T2()
+            , T3 a3 =T3()
+            , T4 a4 =T4()
+            , T5 a5 =T5()
+            )
+        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
+        { }
+      
+      using Tuple<ArgList_>::getHead;
+      using Tuple<ArgList_>::getTail;
+      
+      template<uint i>
+      typename Shifted<ThisTuple,i>::TupleType&
+      getShifted ()
+        {
+          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
+          return static_cast<Tail_I&> (*this);
+        }
+      
+      template<uint i>
+      typename Shifted<ThisTuple,i>::TupleType::HeadType&
+      getAt ()
+        {
+          return getShifted<i>().getHead();
+        }
+      
+      NullType&
+      getNull()
+        {
+          static NullType nix;
+          return nix; 
+        }
+    };
+  
+  
+  /**
+   * Decorating a tuple type with auxiliary data access operations.
+   * This helper template builds up a subclass of the given BASE type
+   * (which is assumed to be a Tuple or at least need to be copy constructible
+   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
+   * to add a layer of access functions, which in turn might rely on the exact
+   * type of the individual elements within the Tuple. To achieve this, for each
+   * type within the Tuple, the BASE type is decorated with an instance of the
+   * template passed in as template template parameter _X_. Each of these
+   * decorating instances is provided with a member pointer to access "his"
+   * specific element within the underlying tuple.
+   * 
+   * The decorating template _X_ need to take its own base class as template
+   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
+   * calling down into this templated base class. To support this, an instantiation
+   * of _X_ with the 0 member ptr is generated for detecting recursion end
+   * (built as innermost decorator, i.e. immediate subclass of BASE) 
+   */
+  template
+    < typename TYPES
+    , template<class,class,uint> class _X_
+    , class BASE =Tuple<TYPES>
+    , uint i = 0
+    >
+  class BuildTupleAccessor
+    {
+      typedef Tuple<TYPES> ArgTuple;
+      typedef typename ArgTuple::HeadType Head;
+      typedef typename ArgTuple::TailType Tail;
+//    typedef Head ArgTuple::*getElm();
+      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
+      typedef typename NextBuilder::Accessor NextAccessor;
+      
+      ArgTuple& argData_;
+      
+    public:
+      
+      /** type of the product created by this template.
+       *  Will be a subclass of BASE */
+      typedef _X_<Head, NextAccessor, i> Accessor;
+      
+      BuildTupleAccessor (ArgTuple& tup)
+        : argData_(tup)
+        { }
+      
+      operator Accessor() { return Accessor(argData_); }
+      
+    };
+
+  template
+    < class BASE
+    , template<class,class,uint> class _X_
+    , uint i
+    >
+  class BuildTupleAccessor<Types<>, _X_, BASE, i>
+    {
+      typedef Tuple<Types<> > ArgTuple;
+//    typedef NullType BASE::*getElm();
+      
+    public:
+      typedef _X_<NullType, BASE, 0> Accessor;
+    };
+  
+  
+
+  
+  
+}} // namespace lumiera::typelist
+#endif

From d1b425aba918f9bd05df2badc8a099a34d098d99 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 17 Jun 2009 06:55:18 +0200
Subject: [PATCH 108/368] finish and tidy the extracted headers

---
 src/lib/meta/function-closure.hpp             | 689 +++++++-----------
 src/lib/meta/function.hpp                     | 475 ++++--------
 src/lib/meta/tuple.hpp                        | 500 +++++++------
 src/lib/meta/typelistutil.hpp                 |  27 +-
 .../proc/control/command-basic-test.cpp       |  30 +-
 5 files changed, 766 insertions(+), 955 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index f85d3953d..499728d24 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -40,6 +40,7 @@
 #include "lib/meta/typelist.hpp"   /////////////TODO
 #include "lib/meta/generator.hpp"  /////////////TODO
 #include "lib/meta/function.hpp"
+#include "lib/meta/tuple.hpp"
 
 #include <tr1/functional>
 
@@ -52,386 +53,287 @@ namespace typelist{
   //using std::tr1::placeholders::_1;
   //using std::tr1::placeholders::_2;
   using std::tr1::function;
-
-
-  template< typename SIG>
-  struct FunctionSignature;
-  
-  template< typename RET>
-  struct FunctionSignature< function<RET(void)> >
-  {
-    typedef RET Ret;
-    typedef Types<> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          >
-  struct FunctionSignature< function<RET(A1)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          >
-  struct FunctionSignature< function<RET(A1,A2)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3,A4> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3,A4,A5> Args;
-  };
-  
-  
-  template<typename RET, typename LI>
-  struct FunctionTypedef;
-  
-  template< typename RET>
-  struct FunctionTypedef<RET, Types<> >
-  {
-    typedef function<RET(void)> Func;
-    typedef          RET Sig();
-  };
-  
-  template< typename RET
-          , typename A1
-          >
-  struct FunctionTypedef<RET, Types<A1> >
-  {
-    typedef function<RET(A1)> Func;
-    typedef          RET Sig(A1);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          >
-  struct FunctionTypedef<RET, Types<A1,A2> >
-  {
-    typedef function<RET(A1,A2)> Func;
-    typedef          RET Sig(A1,A2);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3> >
-  {
-    typedef function<RET(A1,A2,A3)> Func;
-    typedef          RET Sig(A1,A2,A3);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
-  {
-    typedef function<RET(A1,A2,A3,A4)> Func;
-    typedef          RET Sig(A1,A2,A3,A4);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
-  {
-    typedef function<RET(A1,A2,A3,A4,A5)> Func;
-    typedef          RET Sig(A1,A2,A3,A4,A5);
-  };
   
   
   
-  /////////////////////////very basic facility: Typed tuples
+  namespace func { // helpers for binding and applying a function to an argument tuple 
+    
+    using tuple::element;
+    
+    /** 
+     * this Helper with repetitive specialisations for up to nine arguments
+     * is used either to apply a function to arguments given as a tuple, or
+     * to create the actual closure (functor) over all function arguments. 
+     */
+    template<uint n>
+    struct Apply;
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<1>                                      ///< Apply function with 1 Argument
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f (element<1>(arg));
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg));
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<2>                                      ///< Apply function with 2 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<3>                                      ///< Apply function with 3 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<4>                                      ///< Apply function with 4 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     , element<4>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                    , element<4>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<5>                                      ///< Apply function with 5 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     , element<4>(arg)
+                     , element<5>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                    , element<4>(arg)
+                                    , element<5>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<6>                                      ///< Apply function with 6 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     , element<4>(arg)
+                     , element<5>(arg)
+                     , element<6>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                    , element<4>(arg)
+                                    , element<5>(arg)
+                                    , element<6>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<7>                                      ///< Apply function with 7 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     , element<4>(arg)
+                     , element<5>(arg)
+                     , element<6>(arg)
+                     , element<7>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                    , element<4>(arg)
+                                    , element<5>(arg)
+                                    , element<6>(arg)
+                                    , element<7>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<8>                                      ///< Apply function with 8 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     , element<4>(arg)
+                     , element<5>(arg)
+                     , element<6>(arg)
+                     , element<7>(arg)
+                     , element<8>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                    , element<4>(arg)
+                                    , element<5>(arg)
+                                    , element<6>(arg)
+                                    , element<7>(arg)
+                                    , element<8>(arg)
+                                   );
+          }
+      };
+    
+    
+    template<>                                            //_________________________________
+    struct Apply<9>                                      ///< Apply function with 9 Arguments
+      {
+        template<class FUN, typename RET, class TUP>
+        static RET
+        invoke (FUN f, TUP & arg)
+          {
+            return f ( element<1>(arg)
+                     , element<2>(arg)
+                     , element<3>(arg)
+                     , element<4>(arg)
+                     , element<5>(arg)
+                     , element<6>(arg)
+                     , element<7>(arg)
+                     , element<8>(arg)
+                     , element<9>(arg)
+                     ); 
+          }
+        
+        template<class FUN, typename RET, class TUP>
+        static RET
+        bind (FUN f, TUP & arg)
+          {
+            return std::tr1::bind (f, element<1>(arg)
+                                    , element<2>(arg)
+                                    , element<3>(arg)
+                                    , element<4>(arg)
+                                    , element<5>(arg)
+                                    , element<6>(arg)
+                                    , element<7>(arg)
+                                    , element<8>(arg)
+                                    , element<9>(arg)
+                                   );
+          }
+      };
+    
+  } // (END) impl-namespace (func)
   
-  template<class T, class TYPES>
-  struct Prepend;
-  
-  template< typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          , typename IGN
-          >
-  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
-  {
-    typedef Types<A1,A2,A3,A4,A5> Tuple;
-  };
-
-  template<class TYPES>
-  struct Tuple;
-
-  template<>
-  struct Tuple<NullType>
-    {
-      typedef NullType HeadType;
-      typedef Types<>  TailType;
-      typedef Types<>  Type;
-      
-      typedef NullType ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<NullType> Tail;
-      enum { SIZE = 0 };
-      
-      NullType getHead() { return NullType(); }
-      Tail&    getTail() { return *this;      }
-      
-      Tuple (HeadType const&, Tail const&) { }
-      Tuple ()                             { }
-    };
-  
-  template<class TY, class TYPES>
-  struct Tuple<Node<TY,TYPES> >
-    : Tuple<TYPES>
-    {
-      typedef TY                                   HeadType;
-      typedef typename Tuple<TYPES>::Type          TailType;
-      typedef typename Prepend<TY,TailType>::Tuple Type;
-      
-      typedef Node<TY,TYPES> ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TYPES> Tail;
-      enum { SIZE = count<ArgList_>::value };
-      
-      Tuple ( TY a1 =TY()
-            , Tail tail =Tail()
-            )
-        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
-          val_(a1)
-        { }
-      
-      TY  & getHead() { return val_; }
-      Tail& getTail() { return static_cast<Tail&> (*this); }
-      
-    private:
-      TY val_;
-    };
-  
-  ////TODO move in sub-scope
-  template<class TUP,uint i>
-  struct Shifted
-    {
-      typedef typename TUP::Tail Tail;
-      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
-    };
-  template<class TUP>
-  struct Shifted<TUP,0>
-    { 
-      typedef Tuple<typename TUP::ArgList_> TupleType;
-    };
-      
-  
-  template< typename T1
-          , typename T2
-          , typename T3
-          , typename T4
-          , typename T5
-          >
-  struct Tuple<Types<T1,T2,T3,T4,T5> >
-    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
-    {
-      typedef T1                          HeadType;
-      typedef Types<T2,T3,T4,T5,NullType> TailType;
-      typedef Types<T1,T2,T3,T4,T5>       Type;
-      
-      typedef typename Type::List ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TailType> Tail;
-      enum { SIZE = count<ArgList_>::value };
-      
-      Tuple ( T1 a1 =T1()
-            , T2 a2 =T2()
-            , T3 a3 =T3()
-            , T4 a4 =T4()
-            , T5 a5 =T5()
-            )
-        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
-        { }
-      
-      using Tuple<ArgList_>::getHead;
-      using Tuple<ArgList_>::getTail;
-      
-      template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType&
-      getShifted ()
-        {
-          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
-          return static_cast<Tail_I&> (*this);
-        }
-      
-      template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType::HeadType&
-      getAt ()
-        {
-          return getShifted<i>().getHead();
-        }
-      
-      NullType&
-      getNull()
-        {
-          static NullType nix;
-          return nix; 
-        }
-    };
   
   
   /**
-   * Decorating a tuple type with auxiliary data access operations.
-   * This helper template builds up a subclass of the given BASE type
-   * (which is assumed to be a Tuple or at least need to be copy constructible
-   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
-   * to add a layer of access functions, which in turn might rely on the exact
-   * type of the individual elements within the Tuple. To achieve this, for each
-   * type within the Tuple, the BASE type is decorated with an instance of the
-   * template passed in as template template parameter _X_. Each of these
-   * decorating instances is provided with a member pointer to access "his"
-   * specific element within the underlying tuple.
-   * 
-   * The decorating template _X_ need to take its own base class as template
-   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
-   * calling down into this templated base class. To support this, an instantiation
-   * of _X_ with the 0 member ptr is generated for detecting recursion end
-   * (built as innermost decorator, i.e. immediate subclass of BASE) 
+   * Closure-creating template.
    */
-  template
-    < typename TYPES
-    , template<class,class,uint> class _X_
-    , class BASE =Tuple<TYPES>
-    , uint i = 0
-    >
-  class BuildTupleAccessor
-    {
-      typedef Tuple<TYPES> ArgTuple;
-      typedef typename ArgTuple::HeadType Head;
-      typedef typename ArgTuple::TailType Tail;
-//    typedef Head ArgTuple::*getElm();
-      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
-      typedef typename NextBuilder::Accessor NextAccessor;
-      
-      ArgTuple& argData_;
-      
-    public:
-      
-      /** type of the product created by this template.
-       *  Will be a subclass of BASE */
-      typedef _X_<Head, NextAccessor, i> Accessor;
-      
-      BuildTupleAccessor (ArgTuple& tup)
-        : argData_(tup)
-        { }
-      
-      operator Accessor() { return Accessor(argData_); }
-      
-    };
-
-  template
-    < class BASE
-    , template<class,class,uint> class _X_
-    , uint i
-    >
-  class BuildTupleAccessor<Types<>, _X_, BASE, i>
-    {
-      typedef Tuple<Types<> > ArgTuple;
-//    typedef NullType BASE::*getElm();
-      
-    public:
-      typedef _X_<NullType, BASE, 0> Accessor;
-    };
-  
-  
-  ///////////////////////// creating functional closures
-  
-  namespace tuple {
-      template<uint n>
-      struct Apply;
-      
-      template<>       
-      struct Apply<1>
-        {
-          template<class FUN, typename RET, class TUP>
-          static RET
-          invoke (FUN f, TUP & arg)
-            {
-              return f (arg.template getAt<1>()); 
-            }
-          
-          template<class FUN, typename RET, class TUP>
-          static RET
-          bind (FUN f, TUP & arg)
-            {
-              return std::tr1::bind (f, arg.template getAt<1>()); 
-            }
-        };
-      
-      template<>       
-      struct Apply<2>
-        {
-          template<class FUN, typename RET, class TUP>
-          static RET
-          invoke (FUN f, TUP & arg)
-            {
-              return f ( arg.template getAt<1>()
-                       , arg.template getAt<2>()
-                       ); 
-            }
-          
-          template<class FUN, typename RET, class TUP>
-          static RET
-          bind (FUN f, TUP & arg)
-            {
-              return std::tr1::bind (f, arg.template getAt<1>() 
-                                      , arg.template getAt<2>()
-                                     );
-            }
-        };
-  } // (END) sub-namespace 
-  
   template<typename SIG>
   class TupleApplicator
     {
@@ -449,11 +351,11 @@ namespace typelist{
         : params_(args)
         { }
       
-      function<SIG>  bind (SIG& f)                 { return tuple::Apply<ARG_CNT>::bind (f, params_); }
-      function<SIG>  bind (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (SIG& f)                 { return func::Apply<ARG_CNT>::bind (f, params_); }
+      function<SIG>  bind (function<SIG> const& f) { return func::Apply<ARG_CNT>::bind (f, params_); }
       
-      Ret      operator() (SIG& f)                 { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
-      Ret      operator() (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (SIG& f)                 { return func::Apply<ARG_CNT>::invoke (f, params_); }
+      Ret      operator() (function<SIG> const& f) { return func::Apply<ARG_CNT>::invoke (f, params_); }
     };
   
   
@@ -484,41 +386,6 @@ namespace typelist{
     };
   
   
-/*
-  template<typename TYPES>
-  struct BuildClosure
-    : InstantiateWithIndex<TYPES, Accessor, I>
-    {
-      
-    };
-*/
-  
-  ///////////////////////// additional typelist manipulators
-  
-  template<class TYPES>
-  struct SplitLast;
-  
-  template<>
-  struct SplitLast<NullType>
-    {
-      typedef NullType Type;
-      typedef NullType Prefix;
-    };
-  
-  template<class TY>
-  struct SplitLast<Node<TY,NullType> >
-    {
-      typedef TY Type;
-      typedef NullType Prefix;
-    };
-  
-  template<class TY, class TYPES>
-  struct SplitLast<Node<TY,TYPES> >
-    {
-      typedef typename SplitLast<TYPES>::Type Type;
-      typedef typename Append<TY, typename SplitLast<TYPES>::Prefix>::List Prefix;
-    };
-
   
   
 }} // namespace lumiera::typelist
diff --git a/src/lib/meta/function.hpp b/src/lib/meta/function.hpp
index 9cdb8e89d..57faab310 100644
--- a/src/lib/meta/function.hpp
+++ b/src/lib/meta/function.hpp
@@ -37,6 +37,7 @@
  ** and rest assured: you aren't alone. 
  ** 
  ** @see control::CommandDef usage example
+ ** @see function-closure.hpp generic function application
  ** @see typelist.hpp
  ** @see tuple.hpp
  ** 
@@ -47,8 +48,6 @@
 #define LUMIERA_META_FUNCTION_H
 
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/generator.hpp"
-#include "lib/meta/typelistutil.hpp"
 
 #include <tr1/functional>
 
@@ -57,15 +56,23 @@
 namespace lumiera {
 namespace typelist{
 
-  using std::tr1::bind;
-  //using std::tr1::placeholders::_1;
-  //using std::tr1::placeholders::_2;
   using std::tr1::function;
-
-
+  
+  
+  
+  
+  /**
+   * Extract the type information contained in a
+   * function or functor type, so it can be manipulated
+   * by metaprogramming. Up to 9 function arguments are
+   * supported and can be extracted as a type sequence.
+   * The bare function signature serving as input can be
+   * obtained by capturing a function reference or pointer.
+   */
   template< typename SIG>
   struct FunctionSignature;
   
+  
   template< typename RET>
   struct FunctionSignature< function<RET(void)> >
   {
@@ -73,6 +80,7 @@ namespace typelist{
     typedef Types<> Args;
   };
   
+  
   template< typename RET
           , typename A1
           >
@@ -82,6 +90,7 @@ namespace typelist{
     typedef Types<A1> Args;
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -92,6 +101,7 @@ namespace typelist{
     typedef Types<A1,A2> Args;
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -103,6 +113,7 @@ namespace typelist{
     typedef Types<A1,A2,A3> Args;
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -115,6 +126,7 @@ namespace typelist{
     typedef Types<A1,A2,A3,A4> Args;
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -129,9 +141,85 @@ namespace typelist{
   };
   
   
-  template<typename RET, typename LI>
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5,A6)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5,A6> Args;
+  };
+  
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          , typename A7
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5,A6,A7)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5,A6,A7> Args;
+  };
+  
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          , typename A7
+          , typename A8
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5,A6,A7,A8)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5,A6,A7,A8> Args;
+  };
+  
+  
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          , typename A7
+          , typename A8
+          , typename A9
+          >
+  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5,A6,A7,A8,A9)> >
+  {
+    typedef RET Ret;
+    typedef Types<A1,A2,A3,A4,A5,A6,A7,A8,A9> Args;
+  };
+  
+  
+  
+  
+  /**
+   * Build function types from given Argument types.
+   * As embedded typedefs, you'll find a tr1 functor #Func
+   * and the bare function signature #Sig
+   * @param RET the function return type
+   * @param ARGS a type sequence describing the arguments
+   */
+  template<typename RET, typename ARGS>
   struct FunctionTypedef;
   
+  
   template< typename RET>
   struct FunctionTypedef<RET, Types<> >
   {
@@ -139,6 +227,7 @@ namespace typelist{
     typedef          RET Sig();
   };
   
+  
   template< typename RET
           , typename A1
           >
@@ -148,6 +237,7 @@ namespace typelist{
     typedef          RET Sig(A1);
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -158,6 +248,7 @@ namespace typelist{
     typedef          RET Sig(A1,A2);
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -169,6 +260,7 @@ namespace typelist{
     typedef          RET Sig(A1,A2,A3);
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -181,6 +273,7 @@ namespace typelist{
     typedef          RET Sig(A1,A2,A3,A4);
   };
   
+  
   template< typename RET
           , typename A1
           , typename A2
@@ -195,340 +288,74 @@ namespace typelist{
   };
   
   
-  
-  /////////////////////////very basic facility: Typed tuples
-  
-  template<class T, class TYPES>
-  struct Prepend;
-  
-  template< typename A1
+  template< typename RET
+          , typename A1
           , typename A2
           , typename A3
           , typename A4
           , typename A5
-          , typename IGN
+          , typename A6
           >
-  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5,A6> >
   {
-    typedef Types<A1,A2,A3,A4,A5> Tuple;
+    typedef function<RET(A1,A2,A3,A4,A5,A6)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5,A6);
   };
-
-  template<class TYPES>
-  struct Tuple;
-
-  template<>
-  struct Tuple<NullType>
-    {
-      typedef NullType HeadType;
-      typedef Types<>  TailType;
-      typedef Types<>  Type;
-      
-      typedef NullType ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<NullType> Tail;
-      enum { SIZE = 0 };
-      
-      NullType getHead() { return NullType(); }
-      Tail&    getTail() { return *this;      }
-      
-      Tuple (HeadType const&, Tail const&) { }
-      Tuple ()                             { }
-    };
   
-  template<class TY, class TYPES>
-  struct Tuple<Node<TY,TYPES> >
-    : Tuple<TYPES>
-    {
-      typedef TY                                   HeadType;
-      typedef typename Tuple<TYPES>::Type          TailType;
-      typedef typename Prepend<TY,TailType>::Tuple Type;
-      
-      typedef Node<TY,TYPES> ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TYPES> Tail;
-      enum { SIZE = count<ArgList_>::value };
-      
-      Tuple ( TY a1 =TY()
-            , Tail tail =Tail()
-            )
-        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
-          val_(a1)
-        { }
-      
-      TY  & getHead() { return val_; }
-      Tail& getTail() { return static_cast<Tail&> (*this); }
-      
-    private:
-      TY val_;
-    };
   
-  ////TODO move in sub-scope
-  template<class TUP,uint i>
-  struct Shifted
-    {
-      typedef typename TUP::Tail Tail;
-      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
-    };
-  template<class TUP>
-  struct Shifted<TUP,0>
-    { 
-      typedef Tuple<typename TUP::ArgList_> TupleType;
-    };
-      
-  
-  template< typename T1
-          , typename T2
-          , typename T3
-          , typename T4
-          , typename T5
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          , typename A7
           >
-  struct Tuple<Types<T1,T2,T3,T4,T5> >
-    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
-    {
-      typedef T1                          HeadType;
-      typedef Types<T2,T3,T4,T5,NullType> TailType;
-      typedef Types<T1,T2,T3,T4,T5>       Type;
-      
-      typedef typename Type::List ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TailType> Tail;
-      enum { SIZE = count<ArgList_>::value };
-      
-      Tuple ( T1 a1 =T1()
-            , T2 a2 =T2()
-            , T3 a3 =T3()
-            , T4 a4 =T4()
-            , T5 a5 =T5()
-            )
-        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
-        { }
-      
-      using Tuple<ArgList_>::getHead;
-      using Tuple<ArgList_>::getTail;
-      
-      template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType&
-      getShifted ()
-        {
-          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
-          return static_cast<Tail_I&> (*this);
-        }
-      
-      template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType::HeadType&
-      getAt ()
-        {
-          return getShifted<i>().getHead();
-        }
-      
-      NullType&
-      getNull()
-        {
-          static NullType nix;
-          return nix; 
-        }
-    };
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5,A6,A7> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5,A6,A7)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5,A6,A7);
+  };
   
   
-  /**
-   * Decorating a tuple type with auxiliary data access operations.
-   * This helper template builds up a subclass of the given BASE type
-   * (which is assumed to be a Tuple or at least need to be copy constructible
-   * from \c Tuple<TYPES> ). The purpose is to use the Tuple as storage, but
-   * to add a layer of access functions, which in turn might rely on the exact
-   * type of the individual elements within the Tuple. To achieve this, for each
-   * type within the Tuple, the BASE type is decorated with an instance of the
-   * template passed in as template template parameter _X_. Each of these
-   * decorating instances is provided with a member pointer to access "his"
-   * specific element within the underlying tuple.
-   * 
-   * The decorating template _X_ need to take its own base class as template
-   * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
-   * calling down into this templated base class. To support this, an instantiation
-   * of _X_ with the 0 member ptr is generated for detecting recursion end
-   * (built as innermost decorator, i.e. immediate subclass of BASE) 
-   */
-  template
-    < typename TYPES
-    , template<class,class,uint> class _X_
-    , class BASE =Tuple<TYPES>
-    , uint i = 0
-    >
-  class BuildTupleAccessor
-    {
-      typedef Tuple<TYPES> ArgTuple;
-      typedef typename ArgTuple::HeadType Head;
-      typedef typename ArgTuple::TailType Tail;
-//    typedef Head ArgTuple::*getElm();
-      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
-      typedef typename NextBuilder::Accessor NextAccessor;
-      
-      ArgTuple& argData_;
-      
-    public:
-      
-      /** type of the product created by this template.
-       *  Will be a subclass of BASE */
-      typedef _X_<Head, NextAccessor, i> Accessor;
-      
-      BuildTupleAccessor (ArgTuple& tup)
-        : argData_(tup)
-        { }
-      
-      operator Accessor() { return Accessor(argData_); }
-      
-    };
-
-  template
-    < class BASE
-    , template<class,class,uint> class _X_
-    , uint i
-    >
-  class BuildTupleAccessor<Types<>, _X_, BASE, i>
-    {
-      typedef Tuple<Types<> > ArgTuple;
-//    typedef NullType BASE::*getElm();
-      
-    public:
-      typedef _X_<NullType, BASE, 0> Accessor;
-    };
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          , typename A7
+          , typename A8
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5,A6,A7,A8> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5,A6,A7,A8)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5,A6,A7,A8);
+  };
   
   
-  ///////////////////////// creating functional closures
-  
-  namespace tuple {
-      template<uint n>
-      struct Apply;
-      
-      template<>       
-      struct Apply<1>
-        {
-          template<class FUN, typename RET, class TUP>
-          static RET
-          invoke (FUN f, TUP & arg)
-            {
-              return f (arg.template getAt<1>()); 
-            }
-          
-          template<class FUN, typename RET, class TUP>
-          static RET
-          bind (FUN f, TUP & arg)
-            {
-              return std::tr1::bind (f, arg.template getAt<1>()); 
-            }
-        };
-      
-      template<>       
-      struct Apply<2>
-        {
-          template<class FUN, typename RET, class TUP>
-          static RET
-          invoke (FUN f, TUP & arg)
-            {
-              return f ( arg.template getAt<1>()
-                       , arg.template getAt<2>()
-                       ); 
-            }
-          
-          template<class FUN, typename RET, class TUP>
-          static RET
-          bind (FUN f, TUP & arg)
-            {
-              return std::tr1::bind (f, arg.template getAt<1>() 
-                                      , arg.template getAt<2>()
-                                     );
-            }
-        };
-  } // (END) sub-namespace 
-  
-  template<typename SIG>
-  class TupleApplicator
-    {
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-      
-      enum { ARG_CNT = count<typename Args::List>::value };
-      
-      
-      /** storing a ref to the parameter tuple */
-      Tuple<Args>& params_;
-      
-    public:
-      TupleApplicator (Tuple<Args>& args)
-        : params_(args)
-        { }
-      
-      function<SIG>  bind (SIG& f)                 { return tuple::Apply<ARG_CNT>::bind (f, params_); }
-      function<SIG>  bind (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::bind (f, params_); }
-      
-      Ret      operator() (SIG& f)                 { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
-      Ret      operator() (function<SIG> const& f) { return tuple::Apply<ARG_CNT>::invoke (f, params_); }
-    };
+  template< typename RET
+          , typename A1
+          , typename A2
+          , typename A3
+          , typename A4
+          , typename A5
+          , typename A6
+          , typename A7
+          , typename A8
+          , typename A9
+          >
+  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5,A6,A7,A8,A9> >
+  {
+    typedef function<RET(A1,A2,A3,A4,A5,A6,A7,A8,A9)> Func;
+    typedef          RET Sig(A1,A2,A3,A4,A5,A6,A7,A8,A9);
+  };
   
   
-  /**
-   * Closing a function over its arguments.
-   * This is a small usage example or spin-off,
-   * having almost the same effect than invoking tr1::bind.
-   * The notable difference is that the function arguments for
-   * creating the closure are passed in as one compound tuple.
-   */
-  template<typename SIG>
-  class FunctionClosure
-    {
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-      
-      function<Ret(void)> closure_;
-      
-    public:
-      FunctionClosure (SIG& f, Tuple<Args>& arg)
-        : closure_(TupleApplicator<SIG>(arg).bind(f))
-        { }
-      FunctionClosure (function<SIG> const& f, Tuple<Args>& arg)
-        : closure_(TupleApplicator<SIG>(arg).bind(f))
-        { }
-      
-      Ret operator() () { return closure_(); }
-    };
   
   
-/*
-  template<typename TYPES>
-  struct BuildClosure
-    : InstantiateWithIndex<TYPES, Accessor, I>
-    {
-      
-    };
-*/
-  
-  ///////////////////////// additional typelist manipulators
-  
-  template<class TYPES>
-  struct SplitLast;
-  
-  template<>
-  struct SplitLast<NullType>
-    {
-      typedef NullType Type;
-      typedef NullType Prefix;
-    };
-  
-  template<class TY>
-  struct SplitLast<Node<TY,NullType> >
-    {
-      typedef TY Type;
-      typedef NullType Prefix;
-    };
-  
-  template<class TY, class TYPES>
-  struct SplitLast<Node<TY,TYPES> >
-    {
-      typedef typename SplitLast<TYPES>::Type Type;
-      typedef typename Append<TY, typename SplitLast<TYPES>::Prefix>::List Prefix;
-    };
-
-  
   
 }} // namespace lumiera::typelist
 #endif
diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 2db8a6673..19eb272fd 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -47,175 +47,140 @@
 #define LUMIERA_META_TUPLE_H
 
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/generator.hpp"
 #include "lib/meta/typelistutil.hpp"
 
-#include <tr1/functional>
-
 
 
 namespace lumiera {
 namespace typelist{
 
-  using std::tr1::bind;
-  //using std::tr1::placeholders::_1;
-  //using std::tr1::placeholders::_2;
-  using std::tr1::function;
 
-
-  template< typename SIG>
-  struct FunctionSignature;
-  
-  template< typename RET>
-  struct FunctionSignature< function<RET(void)> >
-  {
-    typedef RET Ret;
-    typedef Types<> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          >
-  struct FunctionSignature< function<RET(A1)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          >
-  struct FunctionSignature< function<RET(A1,A2)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3,A4)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3,A4> Args;
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          >
-  struct FunctionSignature< function<RET(A1,A2,A3,A4,A5)> >
-  {
-    typedef RET Ret;
-    typedef Types<A1,A2,A3,A4,A5> Args;
-  };
-  
-  
-  template<typename RET, typename LI>
-  struct FunctionTypedef;
-  
-  template< typename RET>
-  struct FunctionTypedef<RET, Types<> >
-  {
-    typedef function<RET(void)> Func;
-    typedef          RET Sig();
-  };
-  
-  template< typename RET
-          , typename A1
-          >
-  struct FunctionTypedef<RET, Types<A1> >
-  {
-    typedef function<RET(A1)> Func;
-    typedef          RET Sig(A1);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          >
-  struct FunctionTypedef<RET, Types<A1,A2> >
-  {
-    typedef function<RET(A1,A2)> Func;
-    typedef          RET Sig(A1,A2);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3> >
-  {
-    typedef function<RET(A1,A2,A3)> Func;
-    typedef          RET Sig(A1,A2,A3);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3,A4> >
-  {
-    typedef function<RET(A1,A2,A3,A4)> Func;
-    typedef          RET Sig(A1,A2,A3,A4);
-  };
-  
-  template< typename RET
-          , typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
-          >
-  struct FunctionTypedef<RET, Types<A1,A2,A3,A4,A5> >
-  {
-    typedef function<RET(A1,A2,A3,A4,A5)> Func;
-    typedef          RET Sig(A1,A2,A3,A4,A5);
-  };
-  
-  
-  
-  /////////////////////////very basic facility: Typed tuples
   
+  /** 
+   * Helper: prepend a type to an existing type sequence,
+   * thus shifting all elements within the sequence 
+   * to the right, eventually dropping the last element
+   */
   template<class T, class TYPES>
   struct Prepend;
   
-  template< typename A1
-          , typename A2
-          , typename A3
-          , typename A4
-          , typename A5
+  template< typename T01
+          , typename T02
+          , typename T03
+          , typename T04
+          , typename T05
+          , typename T06
+          , typename T07
+          , typename T08
+          , typename T09
+          , typename T10
+          , typename T11
+          , typename T12
+          , typename T13
+          , typename T14
+          , typename T15
+          , typename T16
+          , typename T17
+          , typename T18
+          , typename T19
+          , typename T20
           , typename IGN
           >
-  struct Prepend<A1, Types<A2,A3,A4,A5,IGN> >
+  struct Prepend<T01, Types<     T02,T03,T04,T05
+                           , T06,T07,T08,T09,T10
+                           , T11,T12,T13,T14,T15
+                           , T16,T17,T18,T19,T20
+                           , IGN
+                           > >
   {
-    typedef Types<A1,A2,A3,A4,A5> Tuple;
+    typedef Types< T01,T02,T03,T04,T05
+                 , T06,T07,T08,T09,T10
+                 , T11,T12,T13,T14,T15
+                 , T16,T17,T18,T19,T20 > Tuple;
   };
+  
+  
+  
+  
+  /** Helper: separate parts of a type sequence */
+  template<class TYPES>
+  struct Split;
+  
+  template< typename T01
+          , typename T02
+          , typename T03
+          , typename T04
+          , typename T05
+          , typename T06
+          , typename T07
+          , typename T08
+          , typename T09
+          , typename T10
+          , typename T11
+          , typename T12
+          , typename T13
+          , typename T14
+          , typename T15
+          , typename T16
+          , typename T17
+          , typename T18
+          , typename T19
+          , typename T20
+          >
+  struct Split<Types< T01,T02,T03,T04,T05
+                    , T06,T07,T08,T09,T10
+                    , T11,T12,T13,T14,T15
+                    , T16,T17,T18,T19,T20
+                    > >
+  {
+    typedef        T01                   Head;
+    typedef Types< T01                 > First;
+    typedef Types< T01,T02,T03,T04,T05
+                 , T06,T07,T08,T09,T10
+                 , T11,T12,T13,T14,T15
+                 , T16,T17,T18,T19     > Prefix;
+    typedef Types<     T02,T03,T04,T05
+                 , T06,T07,T08,T09,T10
+                 , T11,T12,T13,T14,T15
+                 , T16,T17,T18,T19,T20 > Tail;
+    typedef Types<                 T20 > Last;
+    typedef                        T20   End;
+  };
+  
+  
+  
+  
+  /**
+   * Helper: generate a type sequence left shifted 
+   * by i steps, filling in NullType at the end
+   */  
+  template<class TYPES, uint i=1>
+  class Shifted
+    {
+      typedef typename Split<TYPES>::Tail Tail;
+    public:
+      typedef typename Shifted<Tail,i-1>::Types Types;
+      typedef typename Split<Types>::Head       Head;
+    };
+  
+  template<class TYPES>
+  struct Shifted<TYPES,0>
+    { 
+      typedef TYPES Types;
+      typedef typename Types::List::Head Head;
+    };
 
+  
+  /** 
+   * simple generic Tuple datatype.
+   * Usable both for metaprogramming and as a generic record.
+   * The types within this tuple can either be specified
+   * as Type sequence or as typelist
+   */
   template<class TYPES>
   struct Tuple;
-
+  
+  
   template<>
   struct Tuple<NullType>
     {
@@ -223,10 +188,10 @@ namespace typelist{
       typedef Types<>  TailType;
       typedef Types<>  Type;
       
-      typedef NullType ArgList_;
-      typedef Tuple<Type> ThisTuple;
+      typedef NullType        ArgList;
+      typedef Tuple<Type>     ThisTuple;
       typedef Tuple<NullType> Tail;
-      enum { SIZE = 0 };
+      enum  { SIZE = 0 };
       
       NullType getHead() { return NullType(); }
       Tail&    getTail() { return *this;      }
@@ -235,6 +200,7 @@ namespace typelist{
       Tuple ()                             { }
     };
   
+  
   template<class TY, class TYPES>
   struct Tuple<Node<TY,TYPES> >
     : Tuple<TYPES>
@@ -243,12 +209,12 @@ namespace typelist{
       typedef typename Tuple<TYPES>::Type          TailType;
       typedef typename Prepend<TY,TailType>::Tuple Type;
       
-      typedef Node<TY,TYPES> ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TYPES> Tail;
-      enum { SIZE = count<ArgList_>::value };
+      typedef Node<TY,TYPES> ArgList;
+      typedef Tuple<Type>    ThisTuple;
+      typedef Tuple<TYPES>   Tail;
+      enum  { SIZE = count<ArgList>::value };
       
-      Tuple ( TY a1 =TY()
+      Tuple ( TY   a1   =TY()
             , Tail tail =Tail()
             )
         : Tuple<TYPES> (tail.getHead(), tail.getTail()),
@@ -262,74 +228,189 @@ namespace typelist{
       TY val_;
     };
   
-  ////TODO move in sub-scope
-  template<class TUP,uint i>
-  struct Shifted
-    {
-      typedef typename TUP::Tail Tail;
-      typedef typename Shifted<Tail,i-1>::TupleType TupleType;
-    };
-  template<class TUP>
-  struct Shifted<TUP,0>
-    { 
-      typedef Tuple<typename TUP::ArgList_> TupleType;
-    };
-      
   
   template< typename T1
           , typename T2
           , typename T3
           , typename T4
           , typename T5
+          , typename T6
+          , typename T7
+          , typename T8
+          , typename T9
           >
-  struct Tuple<Types<T1,T2,T3,T4,T5> >
-    : Tuple<typename Types<T1,T2,T3,T4,T5>::List>
+  struct Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >
+    : Tuple<typename Types<T1,T2,T3,T4,T5,T6,T7,T8,T9>::List>
     {
-      typedef T1                          HeadType;
-      typedef Types<T2,T3,T4,T5,NullType> TailType;
-      typedef Types<T1,T2,T3,T4,T5>       Type;
+      typedef       T1                                HeadType;
+      typedef Types<T2,T3,T4,T5,T6,T7,T8,T9,NullType> TailType;
+      typedef Types<T1,T2,T3,T4,T5,T6,T7,T8,T9>       Type;
       
-      typedef typename Type::List ArgList_;
-      typedef Tuple<Type> ThisTuple;
-      typedef Tuple<TailType> Tail;
-      enum { SIZE = count<ArgList_>::value };
+      typedef typename Type::List ArgList;
+      typedef Tuple<Type>         ThisTuple;
+      typedef Tuple<TailType>     Tail;
+      enum  { SIZE = count<ArgList>::value };
       
       Tuple ( T1 a1 =T1()
             , T2 a2 =T2()
             , T3 a3 =T3()
             , T4 a4 =T4()
             , T5 a5 =T5()
+            , T6 a6 =T6()
+            , T7 a7 =T7()
+            , T8 a8 =T8()
+            , T9 a9 =T9()
             )
-        : Tuple<ArgList_>(a1, Tuple<TailType>(a2,a3,a4,a5))
+        : Tuple<ArgList>(a1, Tuple<TailType>(a2,a3,a4,a5,a6,a7,a8,a9))
         { }
       
-      using Tuple<ArgList_>::getHead;
-      using Tuple<ArgList_>::getTail;
+      using Tuple<ArgList>::getHead;
+      using Tuple<ArgList>::getTail;
       
       template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType&
+      class ShiftedTuple
+        { 
+          typedef typename Tuple::Type                OurType_;
+          typedef typename Shifted<OurType_,i>::Types ShiftedTypes_;
+        public:
+          typedef Tuple<typename ShiftedTypes_::List> Type;
+        };
+      
+      template<uint i>
+      typename ShiftedTuple<i>::Type&
       getShifted ()
         {
-          typedef typename Shifted<ThisTuple,i>::TupleType Tail_I;
+          typedef typename ShiftedTuple<i>::Type Tail_I;
           return static_cast<Tail_I&> (*this);
         }
       
       template<uint i>
-      typename Shifted<ThisTuple,i>::TupleType::HeadType&
+      typename Shifted<Type,i>::Head&
       getAt ()
         {
           return getShifted<i>().getHead();
         }
-      
-      NullType&
-      getNull()
-        {
-          static NullType nix;
-          return nix; 
-        }
     };
   
   
+  
+  namespace tuple { // some convenience access functions
+  
+    template<uint n, class TUP> 
+    typename TUP::template ShiftedTuple<n>::Type::Head&
+    element (TUP& tup)
+    {
+      return tup.template getAt<n>();
+    }
+    
+    
+    
+    Tuple<Types<> >
+    makeNullTuple ()
+    {
+      return Tuple<Types<> > ();
+    }
+    
+    
+    template< typename T1
+            >
+    Tuple<Types<T1> >
+    make ( T1 a1 =T1()
+         )
+    {
+      return Tuple<Types<T1> > (a1);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            >
+    Tuple<Types<T1,T2> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         )
+    {
+      return Tuple<Types<T1,T2> > (a1,a2);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            >
+    Tuple<Types<T1,T2,T3> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         )
+    {
+      return Tuple<Types<T1,T2,T3> > (a1,a2,a3);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            >
+    Tuple<Types<T1,T2,T3,T4> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         , T4 a4 =T4()
+         )
+    {
+      return Tuple<Types<T1,T2,T3,T4> > (a1,a2,a3,a4);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            >
+    Tuple<Types<T1,T2,T3,T4,T5> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         , T4 a4 =T4()
+         , T5 a5 =T5()
+         )
+    {
+      return Tuple<Types<T1,T2,T3,T4,T5> > (a1,a2,a3,a4,a5);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            , typename T9
+            >
+    Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         , T4 a4 =T4()
+         , T5 a5 =T5()
+         , T6 a6 =T6()
+         , T7 a7 =T7()
+         , T8 a8 =T8()
+         , T9 a9 =T9()
+         )
+    {
+      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7,a8,a9);
+    }
+    
+  }
+      
+
+  
   /**
    * Decorating a tuple type with auxiliary data access operations.
    * This helper template builds up a subclass of the given BASE type
@@ -349,18 +430,17 @@ namespace typelist{
    * (built as innermost decorator, i.e. immediate subclass of BASE) 
    */
   template
-    < typename TYPES
-    , template<class,class,uint> class _X_
-    , class BASE =Tuple<TYPES>
-    , uint i = 0
+    < typename TYPES                                ///< Type sequence to use within the Accessor (usually the Tuple Types)
+    , template<class,class,class, uint> class _X_   ///< user provided template<Type, Base, TupleType, arg-No>
+    , class TUP =Tuple<TYPES>                       ///< the tuple type to build on
+    , uint i = 0                                    ///< tuple element index counter
     >
   class BuildTupleAccessor
     {
       typedef Tuple<TYPES> ArgTuple;
       typedef typename ArgTuple::HeadType Head;
       typedef typename ArgTuple::TailType Tail;
-//    typedef Head ArgTuple::*getElm();
-      typedef BuildTupleAccessor<Tail,_X_,BASE, i+1> NextBuilder;
+      typedef BuildTupleAccessor<Tail,_X_,TUP, i+1> NextBuilder;
       typedef typename NextBuilder::Accessor NextAccessor;
       
       ArgTuple& argData_;
@@ -368,29 +448,35 @@ namespace typelist{
     public:
       
       /** type of the product created by this template.
-       *  Will be a subclass of BASE */
-      typedef _X_<Head, NextAccessor, i> Accessor;
+       *  Will be a subclass of TUP */
+      typedef _X_< Head            // the type to use for this accessor
+                 , NextAccessor    // the base type to inherit from
+                 , TUP             // the tuple type we build upon
+                 , i               // current element index
+                 >    Accessor;
+      
       
       BuildTupleAccessor (ArgTuple& tup)
         : argData_(tup)
         { }
       
+      /** used to get the product of this builder template... */
       operator Accessor() { return Accessor(argData_); }
       
     };
-
+  
+  
   template
-    < class BASE
-    , template<class,class,uint> class _X_
+    < template<class,class,class, uint> class _X_
+    , class TUP
     , uint i
     >
-  class BuildTupleAccessor<Types<>, _X_, BASE, i>
+  class BuildTupleAccessor<Types<>, _X_, TUP, i>
     {
       typedef Tuple<Types<> > ArgTuple;
-//    typedef NullType BASE::*getElm();
       
     public:
-      typedef _X_<NullType, BASE, 0> Accessor;
+      typedef _X_<NullType, TUP, TUP, 0> Accessor;
     };
   
   
diff --git a/src/lib/meta/typelistutil.hpp b/src/lib/meta/typelistutil.hpp
index ebc39dc3f..1b89b26bc 100644
--- a/src/lib/meta/typelistutil.hpp
+++ b/src/lib/meta/typelistutil.hpp
@@ -29,7 +29,7 @@
 #include "lib/meta/typelist.hpp"
 
 namespace lumiera {
-  namespace typelist {
+namespace typelist {
     
     
     /**
@@ -131,6 +131,27 @@ namespace lumiera {
     
     
     
+    
+    /** access the last list element */
+    template<class TYPES>
+    struct SplitLast;
+    
+    template<>
+    struct SplitLast<NullType>             { typedef NullType Type;
+                                             typedef NullType List; };
+    template<class TY>
+    struct SplitLast<Node<TY,NullType> >   { typedef TY       Type;
+                                             typedef NullType List; };
+    
+    template<class TY, class TYPES>
+    struct SplitLast<Node<TY,TYPES> >      { typedef typename SplitLast<TYPES>::Type Type;
+                                             typedef typename Append< TY,
+                                                                      typename SplitLast<TYPES>::List
+                                                                    >::List 
+                                                                    List; };
+    
+    
+    
     /** 
      * prefix each of the elements,
      * yielding a list-of lists-of-types
@@ -207,7 +228,5 @@ namespace lumiera {
     
     
     
-  } // namespace typelist
-  
-} // namespace lumiera
+}} // namespace lumiera::typelist
 #endif
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 7d74708a6..915aa59ff 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -40,6 +40,9 @@
 #include "lib/meta/typelistutil.hpp"
 #include "lib/meta/generator.hpp"
 #include "lib/meta/function.hpp"
+#include "lib/meta/function-closure.hpp"
+#include "lib/meta/tuple.hpp"
+
 
 #include <tr1/functional>
 //#include <boost/format.hpp>
@@ -111,7 +114,7 @@ namespace test    {
           typedef typename ARG::List Args;
           
           typedef typename SplitLast<Args>::Type Memento;
-          typedef typename SplitLast<Args>::Prefix OperationArglist;
+          typedef typename SplitLast<Args>::List OperationArglist;
           typedef typename Tuple<OperationArglist>::Type OperationArgs;
           
           typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
@@ -138,33 +141,42 @@ namespace test    {
     };
   
   
-  template<typename TY, class BASE, uint idx>
+  template
+    < typename TY
+    , class BASE
+    , class TUP
+    , uint idx
+    >
   struct ParamAccessor
     : BASE
     {
-      template<class TUP>
       ParamAccessor(TUP& tuple)
         : BASE(tuple)
         { 
            cout << showSizeof(tuple.template getAt<idx>()) << endl;
         }
+      
+      ////////////////////TODO the real access operations (e.g. for serialising) go here
     };
-  template<class BASE>
-  struct ParamAccessor<NullType, BASE, 0>
-    : BASE
+    
+  template<class TUP>
+  struct ParamAccessor<NullType, TUP, TUP, 0>
+    : TUP
     {
-      template<class TUP>
       ParamAccessor(TUP& tuple)
-        : BASE(tuple)
+        : TUP(tuple)
         { }
+      
+      ////////////////////TODO the recursion-end of the access operations goes here
     };
   
+  
+  
   template<typename SIG>
   class Closure
     : public CmdClosure
     {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
-//    typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
       
       typedef Tuple<Args> ArgTuple;
       

From 3f9902f68298f0e316c48333552e1d69746c5948 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 00:40:31 +0200
Subject: [PATCH 109/368] fix possible race in dummy player: sync on tick
 thread termination

---
 src/gui/workspace/workspace-window.cpp |  1 +
 src/proc/play/tick-service.hpp         | 11 +++++++----
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/gui/workspace/workspace-window.cpp b/src/gui/workspace/workspace-window.cpp
index 12d6506bc..b9db9b5d5 100644
--- a/src/gui/workspace/workspace-window.cpp
+++ b/src/gui/workspace/workspace-window.cpp
@@ -56,6 +56,7 @@ WorkspaceWindow::WorkspaceWindow(Project &source_project,
 
 WorkspaceWindow::~WorkspaceWindow()
 {
+  INFO (gui_dbg, "closing workspace window...");
 }
 
 Project&
diff --git a/src/proc/play/tick-service.hpp b/src/proc/play/tick-service.hpp
index 876daadf9..c1df386c6 100644
--- a/src/proc/play/tick-service.hpp
+++ b/src/proc/play/tick-service.hpp
@@ -57,7 +57,8 @@ namespace proc {
      * with adjustable frequency. Quick'n dirty implementation!
      */
     class TickService
-      : backend::Thread
+      : backend::JoinHandle,
+        backend::Thread
       {
         typedef function<void(void)> Tick;
         volatile uint timespan_;
@@ -68,16 +69,18 @@ namespace proc {
       public:
         TickService (Tick callback)
           : Thread("Tick generator (dummy)",
-                   bind (&TickService::timerLoop, this, callback))
+                   bind (&TickService::timerLoop, this, callback),
+                   (backend::JoinHandle&)*this 
+                  )
           { 
             INFO (proc, "TickService started.");
           }
         
        ~TickService ()
           {
-            uint curr_tick = timespan_;
             timespan_ = 0;
-            usleep (2*curr_tick); ////TODO actually should wait for timer thread termination
+            this->join();
+            usleep (200000);    // additional delay allowing GTK to dispatch the last output
             
             INFO (proc, "TickService shutdown.");
           }

From 37c0175bd1127441a2662b96d0bbec5af2c6ae92 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 00:45:08 +0200
Subject: [PATCH 110/368] fix crash on closing lumiera, in case of starting
 multiple threads

---
 src/backend/threads.c | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/src/backend/threads.c b/src/backend/threads.c
index 46449156b..67f2d4aa4 100644
--- a/src/backend/threads.c
+++ b/src/backend/threads.c
@@ -56,13 +56,14 @@ static void* pthread_runner (void* thread)
   pthread_setcancelstate (PTHREAD_CANCEL_DISABLE, NULL);
 
   struct lumiera_thread_mockup* starter = (struct lumiera_thread_mockup*) thread;
+  LumieraReccondition thread_end_notification = starter->finished;
 
   starter->fn (starter->arg);
 
-  if (!starter->finished)
-    return NULL; // no condition var provided for signalling thread termination
-  
-  LUMIERA_RECCONDITION_SECTION(cond_sync, starter->finished)
+  if (!thread_end_notification)
+    return NULL; // no signalling of thread termination desired
+
+  LUMIERA_RECCONDITION_SECTION(cond_sync, thread_end_notification)
     LUMIERA_RECCONDITION_BROADCAST;
 
   return NULL;

From 42fd494443c57e011e21bfb975f169a7e446e9cf Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 02:18:40 +0200
Subject: [PATCH 111/368] fix regexps to make the new tests pass

---
 tests/40components.tests |  1 -
 tests/43session.tests    | 10 ++++------
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/tests/40components.tests b/tests/40components.tests
index fbe2af650..7a87ab1ad 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -370,7 +370,6 @@ out: Displaying types and sizes....
 out: sizeof..theUniverse.+ =  42
 out: sizeof..just a char.+ =   1
 out: sizeof.+lib.+test.+test.+Murpf.+ =   1
-out: sizeof.+lib.+test.+test.+Wrmrmpft.+Murpf.+ =   1
 out: sizeof.+lib.+test.+test.+Wrmrmpft.+ =   2
 out: sizeof.+lib.+test.+test.+Wrmrmpft.+ =   3
 out: sizeof.+lib.+test.+test.+Wrmrmpft.+Murpf.+ =   1
diff --git a/tests/43session.tests b/tests/43session.tests
index a06c7558b..d91e4b0a9 100644
--- a/tests/43session.tests
+++ b/tests/43session.tests
@@ -34,16 +34,14 @@ END
 
 
 TEST "hierarchical placement types" PlacementHierarchy_test <<END
-out: sizeof\( \w+ \) =  \d{2}
+out: sizeof\( .+ \) =  [0-9]{2}
 out: Placement.+mobject.+test.+TestSubMO1.+. use-cnt=1 .*
 out: Placement.+mobject.+test.+TestSubMO2.+. use-cnt=1 .*
 out: Placement.+mobject.+test.+TestSubMO21.+ use-cnt=2 .*
-out: Placement.+mobject.+test.+TestSubMO21.+ use-cnt=2 .*
 out: Placement.+mobject.+session.+Clip.+.... use-cnt=2 .*
-out: TestSubMO1\(ID= \d{3}\)
-out: TestSubMO2\(ID= \d{3}\)
-out: TestSubMO21\(ID= \d{3}\)
-out: specialAPI()
+out: TestSubMO1\(ID= [0-9]{3}\)
+out: TestSubMO2\(ID= [0-9]{3}\)
+out: TestSubMO21\(ID= [0-9]{3}\)
 out: specialAPI()
 out: pID\(\w{16}\)
 END

From 8dfc23472951f55f50aaa48ec2db49f26701bc2c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 03:21:43 +0200
Subject: [PATCH 112/368] small fix: wrong log formatting spec detected by
 valgrind

---
 src/gui/output/xvdisplayer.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/gui/output/xvdisplayer.cpp b/src/gui/output/xvdisplayer.cpp
index 17017ff30..fe0c37d2f 100644
--- a/src/gui/output/xvdisplayer.cpp
+++ b/src/gui/output/xvdisplayer.cpp
@@ -62,7 +62,7 @@ XvDisplayer::XvDisplayer( Gtk::Widget *drawing_area, int width, int height ) :
       for ( unsigned int n = 0; gotPort == false && n < count; ++n )
         {
           // Diagnostics
-          INFO(gui, "%s, %d, %d, %d", adaptorInfo[ n ].name,
+          INFO(gui, "%s, %d, %d", adaptorInfo[ n ].name,
             adaptorInfo[ n ].base_id, adaptorInfo[ n ].num_ports - 1);
 
           for ( unsigned int port = adaptorInfo[ n ].base_id;

From 52ac7bdc5e1160c6873ab93ad8dc06dd476b12e0 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Fri, 19 Jun 2009 04:21:51 +0200
Subject: [PATCH 113/368] FIX: bogus pointer dereference causing gcc to barf
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

gcc (GCC) 4.2.4 (Ubuntu 4.2.4-1ubuntu3) reported:

./src/lib/mpool.c: In function ‘bitmap_bit_get_nth’:
./src/lib/mpool.c:119: warning: dereferencing type-punned
 pointer will break strict-aliasing rules
---
 src/lib/mpool.c | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index 88a2a8be2..9d28266cf 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -116,7 +116,7 @@ bitmap_bit_get_nth (MPoolcluster cluster, unsigned index)
 
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
-  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)cluster->data;
 
   return bitmap[quot] & ((uintptr_t)1<<rem);
 }
@@ -166,7 +166,7 @@ mpool_cluster_alloc_ (MPool self)
     return NULL;
 
   /* clear the bitmap */
-  memset (&cluster->data, 0, MPOOL_BITMAP_SIZE (self->elements_per_cluster));
+  memset (cluster->data, 0, MPOOL_BITMAP_SIZE (self->elements_per_cluster));
 
   /* initialize freelist */
   for (unsigned i = 0; i < self->elements_per_cluster; ++i)
@@ -240,7 +240,7 @@ alloc_near (MPoolcluster cluster, MPool self, void* locality)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)cluster->data;
   unsigned r = ~0U;
 
   /* the bitmap word at locality */
@@ -276,7 +276,7 @@ bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)cluster->data;
   bitmap[quot] |= ((uintptr_t)1<<rem);
 
   TRACE (mpool_dbg, "set bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
@@ -295,7 +295,7 @@ bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)cluster->data;
   bitmap[quot] &= ~((uintptr_t)1<<rem);
 
   TRACE (mpool_dbg, "cleared bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
@@ -403,7 +403,7 @@ find_near (MPoolcluster cluster, MPool self, void* element)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)cluster->data;
   unsigned r = ~0U;
 
   /* the bitmap word at locality */

From 0ab5a926297dd0480ca1b73ea38e7ce44ecfdb52 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 05:57:06 +0200
Subject: [PATCH 114/368] WIP: test-driven brainstorming... how to capture
 state and params.

---
 src/proc/control/command-def.hpp              |   4 +-
 src/proc/control/mutation.hpp                 |  61 +++++
 tests/45controller.tests                      |   3 +-
 tests/components/Makefile.am                  |   1 +
 .../proc/control/command-basic-test.cpp       |  45 ++--
 .../proc/control/command-mutation-test.cpp    | 212 ++++++++++++++++++
 6 files changed, 297 insertions(+), 29 deletions(-)
 create mode 100644 tests/components/proc/control/command-mutation-test.cpp

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index a6b6c2c1d..0f02e9046 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -44,8 +44,8 @@
 
 
 
-#ifndef CONTROL_COMMAND_H
-#define CONTROL_COMMAND_H
+#ifndef CONTROL_COMMAND_DEF_H
+#define CONTROL_COMMAND_DEF_H
 
 //#include "pre.hpp"
 #include "include/symbol.hpp"
diff --git a/src/proc/control/mutation.hpp b/src/proc/control/mutation.hpp
index d0791ecd2..04f1daf54 100644
--- a/src/proc/control/mutation.hpp
+++ b/src/proc/control/mutation.hpp
@@ -36,6 +36,7 @@
 #define CONTROL_MUTATION_H
 
 //#include "pre.hpp"
+#include "lib/error.hpp"
 
 //#include <tr1/memory>
 
@@ -54,10 +55,53 @@ namespace control {
     {
       
     public:
+      template<typename SIG>
+      Mutation (function<SIG> const& func)
+        {
+          UNIMPLEMENTED ("build a Mutation functor object, thereby erasing the concrete function signature type");
+        }
       
+      virtual ~Mutation() {}
+      
+      virtual Mutation&
+      close (CmdClosure const& closure)
+        {
+          UNIMPLEMENTED ("accept and store a parameter closure");
+        }
+      
+      void
+      operator() ()
+        {
+          UNIMPLEMENTED ("invoke the Mutation functor");
+        }
+      
+      
+      /* == diagnostics == */
+      typedef pClo Mutation::*_unspecified_bool_type;
+      
+      /** implicit conversion to "bool" */ 
+      operator _unspecified_bool_type()  const { return  isValid()? &Mutation::clo_ : 0; }  // never throws
+      bool operator! ()                  const { return !isValid(); }                      //  ditto
+      
+      operator string()  const
+        { 
+          return isValid()? string (*clo) : "Mutation(state missing)";
+        }
+      
+    protected:
+      virtual bool
+      isValid () 
+        {
+          UNIMPLEMENTED ("mutation lifecycle");
+        }
     };
   
   
+  inline ostream& operator<< (ostream& os, const Mutation& muta) { return os << string(muta); }
+  
+  
+  
+  
   /**
    * @todo Type-comment
    */
@@ -66,6 +110,23 @@ namespace control {
     {
       
     public:
+      template<typename SIG>
+      UndoMutation (function<SIG> const& func)
+        {
+          UNIMPLEMENTED ("build a undo Mutation functor object");
+        }
+      
+      Mutation&
+      captureState ()
+        {
+          UNIMPLEMENTED ("invoke the state capturing Functor");
+        }
+      
+      CmdClosure&
+      getMemento()
+        {
+          UNIMPLEMENTED ("return the closure serving as memento");
+        }
       
     };
   ////////////////TODO currently just fleshing  out the API....
diff --git a/tests/45controller.tests b/tests/45controller.tests
index f1cca4d94..b49080ee9 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -7,4 +7,5 @@ PLANNED "CommandBasic_test" CommandBasic_test <<END
 END
 
 
-#
+PLANNED "CommandMutation_test" CommandMutation_test <<END
+END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index b8594f4f5..3861b01db 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -48,6 +48,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/asset/orderingofassetstest.cpp		\
 	$(testcomponents_srcdir)/proc/asset/testasset.cpp			\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
 	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 915aa59ff..a15e9d97f 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -80,6 +80,10 @@ namespace test    {
   
   using lumiera::typelist::BuildTupleAccessor;
   
+  
+  ////////////////////////////////////////////TODO braindump
+  
+  
   /** 
    * Type analysis helper template. 
    * Used for dissecting a given type signature to derive
@@ -313,17 +317,8 @@ namespace test    {
   
   //////////////////////////// start of the actual Test....
   
-
-/*  
-    bind: opFunc(a,b,c) -> op(void)
-    
-    curry(opFunc) (a) (b) (c)
-    
-    pAppl(func, x) ->  func2 (b, c)
-    
-    return bind( recursion(), param)
-     
-*/  
+  
+  
   namespace command1 {
     void
     operate (P<Time> dummyObj, int randVal)
@@ -345,7 +340,6 @@ namespace test    {
   
   }
   
-  ////////////////////////////////////////////TODO braindump
   
   
   /***************************************************************************
@@ -366,29 +360,28 @@ namespace test    {
       
       virtual void
       run (Arg) 
-        {
-          /////////////////////////////////TODO
-          defineCommands();
-          checkExecution();
-        }
-      
-      void
-      defineCommands ()
         {
           P<Time> obj (new Time(5));
           int randVal ((rand() % 10) - 5);
           
-          CommDef ("test.command1")
+          CommandDef ("test.command1")
               .operation (command1::operate)
               .captureUndo (command1::capture)
               .undoOperation (command1::undoIt)
               .bind (obj, randVal)
               ;
-        }
-      
-      void
-      checkExecution ()
-        {
+          
+          
+          Command ourCmd = Command::get("test.command1");
+          
+          // invoke the command
+          ASSERT (obj == Time(5));
+          ourCmd();
+          ASSERT (obj == Time(5) + Time(randVal));
+          
+          // undo the effect of the command
+          ourCmd.undo();
+          ASSERT (obj == Time(5));
         }
     };
   
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
new file mode 100644
index 000000000..f41f8bcc1
--- /dev/null
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -0,0 +1,212 @@
+/*
+  CommandMutation(Test)  -  checking the functor and undo-functor used within Proc-commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/mutation.hpp"
+#include "lib/meta/tuple.hpp"
+//#include "lib/lumitime.hpp"
+//#include "lib/util.hpp"
+
+//#include <tr1/functional>
+//#include <boost/format.hpp>
+#include <iostream>
+#include <string>
+
+//using std::tr1::bind;
+//using std::tr1::placeholders::_1;
+//using std::tr1::placeholders::_2;
+//using std::tr1::function;
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+using std::cout;
+using std::endl;
+
+
+namespace control {
+namespace test    {
+
+  using lib::test::showSizeof;
+
+//  using session::test::TestClip;
+//  using lumiera::P;
+  using lumiera::typelist::Tuple;
+  using control::CommandClosure;
+  
+  
+  
+  
+  
+  
+  namespace {
+    void
+    operate (P<Time> dummyObj, int randVal)
+    {
+      *dummyObj += Time(randVal);
+    }
+    
+    Time
+    capture (P<Time> dummyObj, int)
+    {
+      return *dummyObj;
+    }
+    
+    void
+    undoIt (P<Time> dummyObj, int, Time oldVal)
+    {
+      *dummyObj = oldVal;
+    }
+  
+  }
+  
+  
+  
+  /***************************************************************************
+   * Verify the behaviour of the type erased closure, which is used
+   * by Proc-Layer commands to implement the capturing and later
+   * re-invocation of a function.
+   *       
+   * @see  control::Command
+   * @see  control::CommandDef
+   * @see  control::Mutation
+   * @see  control::UndoMutation
+   * @see  command-basic-test.hpp
+   */
+  class CommandMutation_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          checkMutation();
+          checkUndoMutation();
+        }
+      
+      
+      /** @test check the Mutation functor which is bound to our \c testFunc(int) .
+       *        Then close this Mutation by providing a parameter tuple.
+       *        Verify finally that by invoking the Mutation functor
+       *        actually \c testFunc(param) is executed.
+       */
+      void
+      checkMutation ()
+        {
+          function<void(int)> funky (bind (&testFunc));
+          
+          Mutation functor (funky);
+          ASSERT (!functor);
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, functor() );
+          
+          Tuple<int> param = tuple::make(23);
+          Closure close_over (param);
+          
+          CmdClosure& clo (close_over);
+          functor.close(clo);
+          ASSERT (functor);
+          
+          testVal = 0;
+          functor();
+          ASSERT (testVal == 23);
+          functor();
+          ASSERT (testVal == 2*23);
+        }
+      
+      
+      /** @test check the special Mutation which is used to \em undo a command.
+       *        This time, we use our \c testFunc(int) as implementation of the
+       *        "undo" function; thus its parameter has now the meaning of an
+       *        captured state value. Consequently this time the \em operation
+       *        which is to be undone would have the signature \c void(void) .
+       *        To carry out the test, we first have to trigger the state
+       *        capturing mechanism; after that, invoking the UndoMutation
+       *        will call the testFunc with the previously captured state.
+       *  @note Mutation and UndoMutation are value objects.
+       */
+      void
+      checkUndoMutation ()
+        {
+          function<void(int)> undo_func (bind (&testFunc));
+          function<int(void)> cap_func  (bind (&capture));
+          
+          UndoMutation undoFunctor (undo_func,cap_func);
+          ASSERT (!undoFunctor);
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor() );
+          
+          Tuple<> param;
+          Closure clo (param);
+          
+          undoFunctor.close(clo);
+          ASSERT (!undoFunctor);
+          VERIFY_ERROR (MISSING_MEMENTO, undoFunctor() );
+          VERIFY_ERROR (MISSING_MEMENTO, undoFunctor.getMemento() );
+          
+          testVal = 11;
+          undoFunctor.captureState();
+          ASSERT (undoFunctor);
+          ASSERT (testVal == 11);
+          
+          CmdClosure& mem = undoFunctor.getMemento();
+          cout << showSizeof(mem) << endl;
+          cout << "saved state: " << mem << endl;
+          
+          undoFunctor();
+          ASSERT (testVal == 11 + 11);
+          undoFunctor();
+          ASSERT (testVal == 11 + 11 + 11);
+          undoFunctor.captureState();
+          undoFunctor();
+          ASSERT (testVal == 33 + 33);
+          testVal = 9;
+          undoFunctor();
+          ASSERT (testVal == 42);
+          
+          UndoMutation clonedFunc (undoFunctor);
+          ASSERT (&undoFunctor.getMemento() != &clonedFunc.getMemento());
+          
+          clonedFunc.captureState();
+          testVal = 0;
+          undoFunctor();
+          ASSERT (testVal == 33);
+          testVal = 0;
+          clonedFunc();
+          ASSERT (testVal == 42);
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandMutation_test, "unit controller");
+      
+      
+}} // namespace control::test

From e951c468a732b9eeace7f3633dd4e7acfc23de7e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 14:47:37 +0200
Subject: [PATCH 115/368] WIP: header rename

---
 src/proc/control/command-def.hpp                        | 2 +-
 src/proc/control/{mutation.hpp => command-mutation.hpp} | 6 +++---
 src/proc/control/command.hpp                            | 2 +-
 tests/components/proc/control/command-mutation-test.cpp | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)
 rename src/proc/control/{mutation.hpp => command-mutation.hpp} (94%)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 0f02e9046..acbf8bb5b 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -50,7 +50,7 @@
 //#include "pre.hpp"
 #include "include/symbol.hpp"
 #include "proc/control/command.hpp"
-#include "proc/control/mutation.hpp"
+#include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
 
 //#include <tr1/memory>
diff --git a/src/proc/control/mutation.hpp b/src/proc/control/command-mutation.hpp
similarity index 94%
rename from src/proc/control/mutation.hpp
rename to src/proc/control/command-mutation.hpp
index 04f1daf54..eeb26c51d 100644
--- a/src/proc/control/mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -1,5 +1,5 @@
 /*
-  MUTATION.hpp  -  a functor encapsulating the actual operation of a proc-Command
+  COMMAND-MUTATION.hpp  -  functor encapsulating the actual operation of proc-Command
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,8 +21,8 @@
 */
 
 
-/** @file mutation.hpp
- ** The core of a proc-Layer command: functor containing the actual operation to be executed.
+/** @file command-mutation.hpp
+ ** The core of a Proc-Layer command: functor containing the actual operation to be executed.
  ** //TODO
  **  
  ** @see Command
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 3939ae3d7..4d24e961e 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -36,7 +36,7 @@
 
 //#include "pre.hpp"
 #include "include/symbol.hpp"
-#include "proc/control/mutation.hpp"
+#include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
 
 //#include <tr1/memory>
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index f41f8bcc1..38a124e2b 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -32,7 +32,7 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
-#include "proc/control/mutation.hpp"
+#include "proc/control/command-mutation.hpp"
 #include "lib/meta/tuple.hpp"
 //#include "lib/lumitime.hpp"
 //#include "lib/util.hpp"

From f358f548d1eea47973e33af2778d238bc92cedbe Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 19 Jun 2009 19:11:33 +0200
Subject: [PATCH 116/368] draft version of CmdClosure and Mutation interface
 now passing compiler

---
 src/lib/meta/tuple.hpp                        |  37 ++-
 src/proc/control/command-closure.hpp          | 127 ++++++++-
 src/proc/control/command-def.hpp              | 173 +++++++++++-
 src/proc/control/command-mutation.hpp         |  46 +++-
 src/proc/control/command.cpp                  |  12 +-
 src/proc/control/command.hpp                  |   6 +
 src/proc/control/proc-dispatcher.hpp          |   2 +-
 .../proc/control/command-basic-test.cpp       | 246 +-----------------
 .../proc/control/command-mutation-test.cpp    |  44 ++--
 9 files changed, 403 insertions(+), 290 deletions(-)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 19eb272fd..f95816824 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -305,16 +305,17 @@ namespace typelist{
     
     
     
-    Tuple<Types<> >
+    inline
+    Tuple< Types<> >
     makeNullTuple ()
     {
       return Tuple<Types<> > ();
     }
     
     
-    template< typename T1
-            >
-    Tuple<Types<T1> >
+    template<typename T1>
+    inline
+    Tuple< Types<T1> >
     make ( T1 a1 =T1()
          )
     {
@@ -325,7 +326,8 @@ namespace typelist{
     template< typename T1
             , typename T2
             >
-    Tuple<Types<T1,T2> >
+    inline
+    Tuple< Types<T1,T2> >
     make ( T1 a1 =T1()
          , T2 a2 =T2()
          )
@@ -338,7 +340,8 @@ namespace typelist{
             , typename T2
             , typename T3
             >
-    Tuple<Types<T1,T2,T3> >
+    inline
+    Tuple< Types<T1,T2,T3> >
     make ( T1 a1 =T1()
          , T2 a2 =T2()
          , T3 a3 =T3()
@@ -353,7 +356,8 @@ namespace typelist{
             , typename T3
             , typename T4
             >
-    Tuple<Types<T1,T2,T3,T4> >
+    inline
+    Tuple< Types<T1,T2,T3,T4> >
     make ( T1 a1 =T1()
          , T2 a2 =T2()
          , T3 a3 =T3()
@@ -370,7 +374,8 @@ namespace typelist{
             , typename T4
             , typename T5
             >
-    Tuple<Types<T1,T2,T3,T4,T5> >
+    inline
+    Tuple< Types<T1,T2,T3,T4,T5> >
     make ( T1 a1 =T1()
          , T2 a2 =T2()
          , T3 a3 =T3()
@@ -392,7 +397,8 @@ namespace typelist{
             , typename T8
             , typename T9
             >
-    Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >
+    inline
+    Tuple< Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >
     make ( T1 a1 =T1()
          , T2 a2 =T2()
          , T3 a3 =T3()
@@ -443,7 +449,7 @@ namespace typelist{
       typedef BuildTupleAccessor<Tail,_X_,TUP, i+1> NextBuilder;
       typedef typename NextBuilder::Accessor NextAccessor;
       
-      ArgTuple& argData_;
+      ArgTuple const& argData_;
       
     public:
       
@@ -456,7 +462,7 @@ namespace typelist{
                  >    Accessor;
       
       
-      BuildTupleAccessor (ArgTuple& tup)
+      BuildTupleAccessor (ArgTuple const& tup)
         : argData_(tup)
         { }
       
@@ -474,9 +480,18 @@ namespace typelist{
   class BuildTupleAccessor<Types<>, _X_, TUP, i>
     {
       typedef Tuple<Types<> > ArgTuple;
+      ArgTuple const& argData_;
       
     public:
       typedef _X_<NullType, TUP, TUP, 0> Accessor;
+      
+      BuildTupleAccessor (ArgTuple const& tup)
+        : argData_(tup)
+        { }
+      
+      /** used to get the product of this builder template... */
+      operator Accessor() { return Accessor(argData_); }
+      
     };
   
   
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 8b38eacab..5c5923f09 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -36,25 +36,142 @@
 #define CONTROL_COMMAND_CLOSURE_H
 
 //#include "pre.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/function.hpp"
+#include "lib/meta/function-closure.hpp"
+#include "lib/meta/tuple.hpp"
 
-//#include <tr1/memory>
+#include <tr1/memory>
+#include <tr1/functional>
+#include <iostream> 
+#include <string>
 
 
+#include "lib/test/test-helper.hpp"  /////////////////TODO remove this
+using lib::test::showSizeof;
+
+using std::cout;    //////////////////////////////////TODO remove this
+using std::endl;
+
 
 namespace control {
   
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
+  using std::string;
+  using std::ostream;
+  using std::tr1::function;
+  using lumiera::typelist::FunctionSignature;
+  using lumiera::typelist::Tuple;
+  using lumiera::typelist::BuildTupleAccessor;
+  
+  using lumiera::typelist::NullType;
+  
+  class CmdClosure;
+  typedef std::tr1::shared_ptr<CmdClosure> PClo;  ///< smart-ptr type used for handling concrete closures
   
   
-  /**
-   * @todo Type-comment
-   */
-  class CommandClosure
+  /** Interface */
+  class CmdClosure
     {
+    public:
+      virtual ~CmdClosure() {}
+      
+      virtual PClo clone()  const =0;
+      
+      virtual operator string()  const =0;
+      
+    };
+
+  
+  
+  inline ostream& operator<< (ostream& os, const CmdClosure& clo) { return os << string(clo); }
+  
+  
+  template
+    < typename TY
+    , class BASE
+    , class TUP
+    , uint idx
+    >
+  class ParamAccessor
+    : public BASE
+    {
+      TY& element() { return BASE::template getAt<idx>(); }
       
     public:
+        
+      ParamAccessor(TUP const& tuple)
+        : BASE(tuple)
+        { 
+          cout << showSizeof(element()) << endl;   //////////TODO remove this test code
+        }
       
+      string
+      dump (string const& prefix = "(")  const
+        {
+          return BASE::dump (prefix+element());
+        }
+      
+      
+      ////////////////////TODO the real access operations (e.g. for serialising) go here
+    };
+    
+  template<class TUP>
+  class ParamAccessor<NullType, TUP, TUP, 0>
+    : public TUP
+    {
+    public:
+      ParamAccessor(TUP const& tuple)
+        : TUP(tuple)
+        { }
+      
+      ////////////////////TODO the recursion-end of the access operations goes here
+      
+    protected:
+      string
+      dump (string const& prefix)  const
+        { 
+          return prefix+")";
+        }
+      
+    };
+  
+  
+  
+  template<typename SIG>
+  class Closure
+    : public CmdClosure
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      
+      typedef Tuple<Args> ArgTuple;
+      
+      typedef BuildTupleAccessor<Args,ParamAccessor> BuildAccessor;
+      typedef typename BuildAccessor::Accessor ParamStorageTuple;
+      
+      ParamStorageTuple params_;
+      
+    public:
+      Closure (ArgTuple const& args)
+        : params_(BuildAccessor(args))
+        { }
+      
+      
+      /** create a clone copy of this concrete closure,
+       *  hidden behind the generic CmdClosure interface
+       *  and owned by a shared_ptr PClo.
+       */
+      PClo
+      clone()  const
+        {
+          return PClo (new Closure (this->params_));
+        }
+      
+      operator string()  const
+        {
+          UNIMPLEMENTED ("how to do a string conversion on the variable argument tuple??");
+        }
     };
   ////////////////TODO currently just fleshing  out the API....
   
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index acbf8bb5b..5002e9452 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -52,8 +52,13 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
+#include "lib/meta/function.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/tuple.hpp"
 
 //#include <tr1/memory>
+#include <tr1/functional>
 
 
 
@@ -62,21 +67,187 @@ namespace control {
   
   using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
+  using std::tr1::function;
+  
+  using lumiera::typelist::FunctionSignature;
+  using lumiera::typelist::FunctionTypedef;
+  using lumiera::typelist::Types;
+//using lumiera::typelist::NullType;
+  using lumiera::typelist::Tuple;
+  using lumiera::typelist::Append;
+  using lumiera::typelist::SplitLast;
+  
+  
+  
+  
+  /** 
+   * Type analysis helper template. 
+   * Used for dissecting a given type signature to derive
+   * the related basic operation signature, the signature of a possible Undo-function
+   * and the signature necessary for capturing undo information. The implementation
+   * relies on re-binding an embedded type defining template, based on the actual
+   * case, as identified by the structure of the given parameter signature.
+   */
+  template<typename SIG>
+  struct UndoSignature
+    {
+    private:
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      /** Case1: defining the Undo-Capture function */
+      template<typename RET, typename ARG>
+      struct Case
+        {
+          typedef RET Memento;
+          typedef typename Append<ARG, Memento>::List ExtendedArglist;
+          typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
+          
+          typedef typename FunctionTypedef<void, ARG>::Sig           OperateSig;
+          typedef typename FunctionTypedef<Ret,ARG>::Sig             CaptureSig;
+          typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
+        };
+      /** Case2: defining the actual Undo function */
+      template<typename ARG>
+      struct Case<void,ARG>
+        {
+          typedef typename ARG::List Args;
+          
+          typedef typename SplitLast<Args>::Type Memento;
+          typedef typename SplitLast<Args>::List OperationArglist;
+          typedef typename Tuple<OperationArglist>::Type OperationArgs;
+          
+          typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
+          typedef typename FunctionTypedef<Ret,OperationArgs>::Sig   CaptureSig;
+          typedef typename FunctionTypedef<void, ARG>::Sig           UndoOp_Sig;
+        };
+      
+    public:
+      typedef typename Case<Ret,Args>::CaptureSig CaptureSig;
+      typedef typename Case<Ret,Args>::UndoOp_Sig UndoOp_Sig;
+      typedef typename Case<Ret,Args>::OperateSig OperateSig;
+      typedef typename Case<Ret,Args>::Memento    Memento;
+    };
+  
+  
+  
+  
+  
+  
+  
   
   
   /**
-   * @todo Type-comment
+   * Helper class used solely for \em defining a Command-Object.
+   * This technique is known as "fluent API", see http://en.wikipedia.org/wiki/Fluent_interface
+   * The basic idea is for the user to create a disposable instance of this definition helper,
+   * only for calling a chain of definition functions, which internally build the actual Command object.
+   * Finally, the created Command object will be stored into a registry or handed over to the
+   * ProcDispatcher. To give an example:
+   * \code
+   *    CommandDefinition ("test.command1")
+   *           .operation (command1::operate)          // provide the function to be executed as command
+   *           .captureUndo (command1::capture)        // provide the function capturing Undo state
+   *           .undoOperation (command1::undoIt)       // provide the function which might undo the command
+   *           .bind (obj, randVal)                    // bind to the actual command parameters
+   *           .executeSync();                         // convenience call, forwarding the Command to dispatch.
+   * \endcode
+   * 
+   * @todo of course, this needs to be extracted into command-definition.hpp 
    */
   class CommandDef
     {
       Symbol id_;
       
+      template<typename SIG, typename MEM>
+      struct UndoDefinition
+        {
+          typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
+          typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
+          
+          UndoDefinition (function<UndoCaptureSig>& undoCapOperation)
+            {
+              cout << showSizeof(undoCapOperation) << endl;
+              UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
+            }
+          
+          template<typename SIG2>
+          UndoDefinition&
+          undoOperation (SIG2& how_to_Undo)
+            {
+              typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
+              
+              function<UndoSig> opera3 (how_to_Undo);
+              
+              UNIMPLEMENTED ("store actual Undo-Functor into the command definition held by the enclosing UndoDefinition instance");
+              return *this;
+            }
+          
+          template
+            < typename T1
+            , typename T2
+            >
+          UndoDefinition&    ///////TODO return here the completed Command
+          bind ( T1& p1
+               , T2& p2
+               )
+            {
+              typedef Types<T1,T2> ArgTypes;
+              Tuple<ArgTypes> params(p1,p2);
+              Closure<SIG> clo (params);
+              
+              cout << showSizeof(clo) << endl;
+              UNIMPLEMENTED ("complete Command definition by closing all functions");
+              return *this;
+            }
+          
+        };
+      
+      /** type re-binding helper: create a suitable UndoDefinition type,
+       *  based on the UndoSignature template instance given as parameter */
+      template<typename U_SIG>
+      struct BuildUndoDefType
+        {
+          typedef UndoDefinition<typename U_SIG::OperateSig, typename U_SIG::Memento> Type;
+        };
+      
+      template<typename SIG>
+      struct BasicDefinition
+        {
+          BasicDefinition(function<SIG>& operation)
+            {
+              cout << showSizeof(operation) << endl;
+              UNIMPLEMENTED ("create new command object an store the operation functor");
+            }
+          
+          
+          template<typename SIG2>
+          typename BuildUndoDefType<UndoSignature<SIG2> >::Type
+          captureUndo (SIG2& how_to_capture_UndoState)
+            {
+              typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
+              typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
+              
+              function<UndoCapSig> opera2 (how_to_capture_UndoState);
+              return SpecificUndoDefinition (opera2);
+            }
+          
+        };
+      
     public:
       CommandDef (Symbol cmdID)
         : id_(cmdID)
         { }
       
+      template<typename SIG>
+      BasicDefinition<SIG>
+      operation (SIG& operation_to_define)
+        {
+          function<SIG> opera1 (operation_to_define);
+          return BasicDefinition<SIG>(opera1);
+        }
     };
+  
   ////////////////TODO currently just fleshing  out the API....
   
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index eeb26c51d..02a68794f 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -32,13 +32,18 @@
 
 
 
-#ifndef CONTROL_MUTATION_H
-#define CONTROL_MUTATION_H
+#ifndef CONTROL_COMMAND_MUTATION_H
+#define CONTROL_COMMAND_MUTATION_H
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
+#include "proc/control/command-closure.hpp"
 
 //#include <tr1/memory>
+#include <boost/scoped_ptr.hpp>
+#include <tr1/functional>
+#include <iostream>
+#include <string>
 
 
 
@@ -46,6 +51,10 @@ namespace control {
   
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
+  using boost::scoped_ptr;
+  using std::tr1::function;
+  using std::ostream;
+  using std::string;
   
   
   /**
@@ -53,6 +62,7 @@ namespace control {
    */
   class Mutation
     {
+      PClo clo_;
       
     public:
       template<typename SIG>
@@ -63,12 +73,15 @@ namespace control {
       
       virtual ~Mutation() {}
       
+      
       virtual Mutation&
       close (CmdClosure const& closure)
         {
           UNIMPLEMENTED ("accept and store a parameter closure");
+          return *this;
         }
       
+      
       void
       operator() ()
         {
@@ -77,7 +90,7 @@ namespace control {
       
       
       /* == diagnostics == */
-      typedef pClo Mutation::*_unspecified_bool_type;
+      typedef PClo Mutation::*_unspecified_bool_type;
       
       /** implicit conversion to "bool" */ 
       operator _unspecified_bool_type()  const { return  isValid()? &Mutation::clo_ : 0; }  // never throws
@@ -85,12 +98,12 @@ namespace control {
       
       operator string()  const
         { 
-          return isValid()? string (*clo) : "Mutation(state missing)";
+          return isValid()? string (*clo_) : "Mutation(state missing)";
         }
       
     protected:
       virtual bool
-      isValid () 
+      isValid ()   const
         {
           UNIMPLEMENTED ("mutation lifecycle");
         }
@@ -108,14 +121,30 @@ namespace control {
   class UndoMutation
     : public Mutation
     {
+      scoped_ptr<CmdClosure> memento_;
       
     public:
-      template<typename SIG>
-      UndoMutation (function<SIG> const& func)
+      template<typename SIG_undo, typename SIG_cap>
+      UndoMutation (function<SIG_undo> const& undoFunc, function<SIG_cap> const& captureFunc)
+        : Mutation(undoFunc)
         {
           UNIMPLEMENTED ("build a undo Mutation functor object");
         }
       
+      UndoMutation (UndoMutation const& o)
+        : Mutation(*this),
+          memento_(o.memento_->clone().get())
+        { }
+      
+      UndoMutation&
+      operator= (UndoMutation const& o)
+        {
+          Mutation::operator= (o);
+          memento_.reset(o.memento_->clone().get());
+          return *this;
+        }
+      
+      
       Mutation&
       captureState ()
         {
@@ -132,6 +161,9 @@ namespace control {
   ////////////////TODO currently just fleshing  out the API....
   
   
+  LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Mutation functor not yet usable, because arguments aren't bound
+  LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);   ///<  Undo functor not yet usable, because no undo state has been captured
+    
   
   
 } // namespace control
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index e0d82fdf7..54e4b0888 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -39,8 +39,18 @@
 
 namespace control {
   
-  /** */
+  LUMIERA_ERROR_DEFINE (UNBOUND_ARGUMENTS, "Mutation functor not yet usable, because arguments aren't bound");
+  LUMIERA_ERROR_DEFINE (MISSING_MEMENTO, "Undo functor not yet usable, because no undo state has been captured");
   
+
+
+  /** */
+  Command& 
+  Command::get (Symbol cmdID)
+  {
+    UNIMPLEMENTED ("fetch an existing command from the internal cmd registry");
+  }
+
   
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 4d24e961e..d48dba207 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -58,6 +58,12 @@ namespace control {
     {
       
     public:
+      static Command& get (Symbol cmdID);
+      
+      virtual ~Command() {};
+      
+      virtual void operator() ()   =0;
+      virtual void undo ()         =0;         
       
     };
   ////////////////TODO currently just fleshing  out the API....
diff --git a/src/proc/control/proc-dispatcher.hpp b/src/proc/control/proc-dispatcher.hpp
index d6e221838..b0783a940 100644
--- a/src/proc/control/proc-dispatcher.hpp
+++ b/src/proc/control/proc-dispatcher.hpp
@@ -45,7 +45,7 @@
 
 namespace control {
   
-  using lumiera::Symbol;
+//  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
   
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index a15e9d97f..a47209ad7 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -39,9 +39,6 @@
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelistutil.hpp"
 #include "lib/meta/generator.hpp"
-#include "lib/meta/function.hpp"
-#include "lib/meta/function-closure.hpp"
-#include "lib/meta/tuple.hpp"
 
 
 #include <tr1/functional>
@@ -69,245 +66,10 @@ namespace test    {
 //  using session::test::TestClip;
   using lumiera::P;
   
-  using lumiera::typelist::FunctionSignature;
-  using lumiera::typelist::FunctionTypedef;
-  
-  using lumiera::typelist::Types;
-  using lumiera::typelist::NullType;
-  using lumiera::typelist::Tuple;
-  using lumiera::typelist::Append;
-  using lumiera::typelist::SplitLast;
   
   using lumiera::typelist::BuildTupleAccessor;
   
   
-  ////////////////////////////////////////////TODO braindump
-  
-  
-  /** 
-   * Type analysis helper template. 
-   * Used for dissecting a given type signature to derive
-   * the related basic operation signature, the signature of a possible Undo-function
-   * and the signature necessary for capturing undo information. The implementation
-   * relies on re-binding an embedded type defining template, based on the actual
-   * case, as identified by the structure of the given parameter signature.
-   */
-  template<typename SIG>
-  struct UndoSignature
-    {
-    private:
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-      
-      /** Case1: defining the Undo-Capture function */
-      template<typename RET, typename ARG>
-      struct Case
-        {
-          typedef RET Memento;
-          typedef typename Append<ARG, Memento>::List ExtendedArglist;
-          typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
-          
-          typedef typename FunctionTypedef<void, ARG>::Sig           OperateSig;
-          typedef typename FunctionTypedef<Ret,ARG>::Sig             CaptureSig;
-          typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
-        };
-      /** Case2: defining the actual Undo function */
-      template<typename ARG>
-      struct Case<void,ARG>
-        {
-          typedef typename ARG::List Args;
-          
-          typedef typename SplitLast<Args>::Type Memento;
-          typedef typename SplitLast<Args>::List OperationArglist;
-          typedef typename Tuple<OperationArglist>::Type OperationArgs;
-          
-          typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
-          typedef typename FunctionTypedef<Ret,OperationArgs>::Sig   CaptureSig;
-          typedef typename FunctionTypedef<void, ARG>::Sig           UndoOp_Sig;
-        };
-      
-    public:
-      typedef typename Case<Ret,Args>::CaptureSig CaptureSig;
-      typedef typename Case<Ret,Args>::UndoOp_Sig UndoOp_Sig;
-      typedef typename Case<Ret,Args>::OperateSig OperateSig;
-      typedef typename Case<Ret,Args>::Memento    Memento;
-    };
-  
-  
-  
-  
-  
-  /** Interface */
-  class CmdClosure
-    {
-    public:
-      virtual ~CmdClosure() {}
-    };
-  
-  
-  template
-    < typename TY
-    , class BASE
-    , class TUP
-    , uint idx
-    >
-  struct ParamAccessor
-    : BASE
-    {
-      ParamAccessor(TUP& tuple)
-        : BASE(tuple)
-        { 
-           cout << showSizeof(tuple.template getAt<idx>()) << endl;
-        }
-      
-      ////////////////////TODO the real access operations (e.g. for serialising) go here
-    };
-    
-  template<class TUP>
-  struct ParamAccessor<NullType, TUP, TUP, 0>
-    : TUP
-    {
-      ParamAccessor(TUP& tuple)
-        : TUP(tuple)
-        { }
-      
-      ////////////////////TODO the recursion-end of the access operations goes here
-    };
-  
-  
-  
-  template<typename SIG>
-  class Closure
-    : public CmdClosure
-    {
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      
-      typedef Tuple<Args> ArgTuple;
-      
-      typedef BuildTupleAccessor<Args,ParamAccessor> BuildAccessor;
-      typedef typename BuildAccessor::Accessor ParamStorageTuple;
-      
-      ParamStorageTuple params_;
-      
-    public:
-      Closure (ArgTuple& args)
-        : params_(BuildAccessor(args))
-        { }
-    };
-  
-  
-  
-  
-  /**
-   * Helper class used solely for \em defining a Command-Object.
-   * This technique is known as "fluent API", see http://en.wikipedia.org/wiki/Fluent_interface
-   * The basic idea is for the user to create a disposable instance of this definition helper,
-   * only for calling a chain of definition functions, which internally build the actual Command object.
-   * Finally, the created Command object will be stored into a registry or handed over to the
-   * ProcDispatcher. To give an example:
-   * \code
-   *    CommandDefinition ("test.command1")
-   *           .operation (command1::operate)          // provide the function to be executed as command
-   *           .captureUndo (command1::capture)        // provide the function capturing Undo state
-   *           .undoOperation (command1::undoIt)       // provide the function which might undo the command
-   *           .bind (obj, randVal)                    // bind to the actual command parameters
-   *           .executeSync();                         // convenience call, forwarding the Command to dispatch.
-   * \endcode
-   * 
-   * @todo of course, this needs to be extracted into command-definition.hpp 
-   */
-  class CommDef
-    {
-      Symbol id_;
-      
-      template<typename SIG, typename MEM>
-      struct UndoDefinition
-        {
-          typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
-          typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
-          
-          UndoDefinition (function<UndoCaptureSig>& undoCapOperation)
-            {
-              cout << showSizeof(undoCapOperation) << endl;
-              UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
-            }
-          
-          template<typename SIG2>
-          UndoDefinition&
-          undoOperation (SIG2& how_to_Undo)
-            {
-              typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
-              
-              function<UndoSig> opera3 (how_to_Undo);
-              
-              UNIMPLEMENTED ("store actual Undo-Functor into the command definition held by the enclosing UndoDefinition instance");
-              return *this;
-            }
-          
-          template
-            < typename T1
-            , typename T2
-            >
-          UndoDefinition&    ///////TODO return here the completed Command
-          bind ( T1& p1
-               , T2& p2
-               )
-            {
-              typedef Types<T1,T2> ArgTypes;
-              Tuple<ArgTypes> params(p1,p2);
-              Closure<SIG> clo (params);
-              
-              cout << showSizeof(clo) << endl;
-              UNIMPLEMENTED ("complete Command definition by closing all functions");
-              return *this;
-            }
-          
-        };
-      
-      /** type re-binding helper: create a suitable UndoDefinition type,
-       *  based on the UndoSignature template instance given as parameter */
-      template<typename U_SIG>
-      struct BuildUndoDefType
-        {
-          typedef UndoDefinition<typename U_SIG::OperateSig, typename U_SIG::Memento> Type;
-        };
-      
-      template<typename SIG>
-      struct BasicDefinition
-        {
-          BasicDefinition(function<SIG>& operation)
-            {
-              cout << showSizeof(operation) << endl;
-              UNIMPLEMENTED ("create new command object an store the operation functor");
-            }
-          
-          
-          template<typename SIG2>
-          typename BuildUndoDefType<UndoSignature<SIG2> >::Type
-          captureUndo (SIG2& how_to_capture_UndoState)
-            {
-              typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
-              typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
-              
-              function<UndoCapSig> opera2 (how_to_capture_UndoState);
-              return SpecificUndoDefinition (opera2);
-            }
-          
-        };
-      
-    public:
-      CommDef (Symbol cmdID)
-        : id_(cmdID)
-        { }
-      
-      template<typename SIG>
-      BasicDefinition<SIG>
-      operation (SIG& operation_to_define)
-        {
-          function<SIG> opera1 (operation_to_define);
-          return BasicDefinition<SIG>(opera1);
-        }
-    };
   
   
   
@@ -372,16 +134,16 @@ namespace test    {
               ;
           
           
-          Command ourCmd = Command::get("test.command1");
+          Command& ourCmd = Command::get("test.command1");
           
           // invoke the command
-          ASSERT (obj == Time(5));
+          ASSERT (*obj == Time(5));
           ourCmd();
-          ASSERT (obj == Time(5) + Time(randVal));
+          ASSERT (*obj == Time(5) + Time(randVal));
           
           // undo the effect of the command
           ourCmd.undo();
-          ASSERT (obj == Time(5));
+          ASSERT (*obj == Time(5));
         }
     };
   
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index 38a124e2b..5d9547a32 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -33,19 +33,20 @@
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-mutation.hpp"
+#include "lib/meta/typelist.hpp"
 #include "lib/meta/tuple.hpp"
 //#include "lib/lumitime.hpp"
 //#include "lib/util.hpp"
 
-//#include <tr1/functional>
+#include <tr1/functional>
 //#include <boost/format.hpp>
 #include <iostream>
 #include <string>
 
-//using std::tr1::bind;
+using std::tr1::bind;
 //using std::tr1::placeholders::_1;
 //using std::tr1::placeholders::_2;
-//using std::tr1::function;
+using std::tr1::function;
 //using boost::format;
 //using lumiera::Time;
 //using util::contains;
@@ -61,8 +62,10 @@ namespace test    {
 
 //  using session::test::TestClip;
 //  using lumiera::P;
+  using namespace lumiera::typelist;
   using lumiera::typelist::Tuple;
-  using control::CommandClosure;
+  
+  using control::CmdClosure;
   
   
   
@@ -70,22 +73,19 @@ namespace test    {
   
   
   namespace {
+  
+    int testVal;  ///< used to verify the effect of testFunc
+  
     void
-    operate (P<Time> dummyObj, int randVal)
+    testFunc (int val)
     {
-      *dummyObj += Time(randVal);
+      testVal += val;
     }
     
-    Time
-    capture (P<Time> dummyObj, int)
+    int
+    capture ()
     {
-      return *dummyObj;
-    }
-    
-    void
-    undoIt (P<Time> dummyObj, int, Time oldVal)
-    {
-      *dummyObj = oldVal;
+      return testVal;
     }
   
   }
@@ -122,14 +122,14 @@ namespace test    {
       void
       checkMutation ()
         {
-          function<void(int)> funky (bind (&testFunc));
+          function<void(int)> funky  = bind (testFunc, _1);
           
           Mutation functor (funky);
           ASSERT (!functor);
           VERIFY_ERROR (UNBOUND_ARGUMENTS, functor() );
           
-          Tuple<int> param = tuple::make(23);
-          Closure close_over (param);
+          Tuple<Types<int> > param = tuple::make(23);
+          Closure<void(int)> close_over (param);
           
           CmdClosure& clo (close_over);
           functor.close(clo);
@@ -156,15 +156,15 @@ namespace test    {
       void
       checkUndoMutation ()
         {
-          function<void(int)> undo_func (bind (&testFunc));
-          function<int(void)> cap_func  (bind (&capture));
+          function<void(int)> undo_func  = bind (&testFunc,_1);
+          function<int(void)> cap_func   = bind (&capture    );
           
           UndoMutation undoFunctor (undo_func,cap_func);
           ASSERT (!undoFunctor);
           VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor() );
           
-          Tuple<> param;
-          Closure clo (param);
+          Tuple<Types<> > param;
+          Closure<void()> clo (param);
           
           undoFunctor.close(clo);
           ASSERT (!undoFunctor);

From 006c29c625413967ff0a9fb500126100022cbdf3 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 00:00:29 +0200
Subject: [PATCH 117/368] Idea how to store an unspecified functor to be used
 later as Command implementation

---
 src/lib/meta/function-closure.hpp | 156 ++++++++++++++++++++++++++++++
 1 file changed, 156 insertions(+)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 499728d24..ce81a89dd 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -44,6 +44,8 @@
 
 #include <tr1/functional>
 
+#include "lib/util.hpp" ////////////////////////TODO
+#include "lib/error.hpp"
 
 
 namespace lumiera {
@@ -383,6 +385,160 @@ namespace typelist{
         { }
       
       Ret operator() () { return closure_(); }
+      
+      typedef Ret  result_type;  ///< for STL use
+      typedef void argument_type;
+    };
+  
+  
+  
+  /**
+   * Generic wrapper carrying a function object
+   * while hiding the actual function signature
+   * @note not statically typesafe. Depending on
+   *       the actual embedded container type,
+   *       it \em might be run-time typesafe.
+   */
+  template<class FH>
+  struct FunErasure
+    : FH
+    {
+      template<typename FUN>
+      FunErasure (FUN const& functor)
+        : FH(functor)
+        { }
+    };
+    
+  /** 
+   * Policy for FunErasure: store an embedded tr1::function
+   * Using this policy allows to store arbitrary complex functor objects
+   * embedded within a neutral container and retrieving them later type-safe.
+   * The price to pay is vtable access and heap storage of function arguments. 
+   */
+  class StoreFunction
+    {
+      /** Helper: type erasure */
+      struct Holder
+        {
+          enum { SIZE = sizeof(function<void(void)>) };
+          char storage_[SIZE];
+          virtual ~Holder() {}
+        };
+      
+      /** embedding the concrete functor object */
+      template<typename SIG>
+      struct FunctionHolder : Holder
+        {
+          typedef function<SIG> Functor;
+          FunctionHolder (SIG& fun)
+            {
+              REQUIRE (SIZE >= sizeof(Functor));
+              new(&storage_) Functor (fun);
+            }
+          ~FunctionHolder()
+            {
+              get()->~Functor();
+            }
+          Functor&
+          get()
+            {
+              return static_cast<Functor*> (&storage_);
+            }
+        };
+      
+      /** embedded buffer actually holding
+       *  the concrete Functor object */
+      Holder holder_;
+      
+    public:
+      template<typename SIG>
+      StoreFunction (SIG& fun)
+        {
+          new(&holder_) FunctionHolder<SIG> (fun);
+        }
+      
+      template<typename SIG>
+      function<SIG>&
+      getFun ()
+        {
+          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
+          return static_cast<FunctionHolder<SIG>&> (holder_).get();
+        }
+    };
+  
+  
+  /** 
+   * Policy for FunErasure: store a bare function pointer.
+   * Using this policy allows to store a conventional function ptr,
+   * while still being able to re-access it later with run-time typecheck.
+   * The price to pay is vtable access. 
+   */
+  class StoreFunPtr
+    {
+      /** Helper: type erasure */
+      struct Holder
+        {
+          void *fun_;
+          virtual ~Holder() {}
+        };
+      
+      /** storing and retrieving concrete function ptr */
+      template<typename SIG>
+      struct FunctionHolder : Holder
+        {
+          FunctionHolder (SIG& fun)
+            {
+              fun_ = &fun;
+            }
+          SIG&
+          get()
+            {
+              return reinterpret_cast<SIG*> (&fun_);
+            }
+        };
+      
+      /** embedded container holding the pointer */
+      Holder holder_;
+      
+    public:
+      template<typename SIG>
+      StoreFunPtr (SIG& fun)
+        {
+          new(&holder_) FunctionHolder<SIG> (fun);
+        }
+      
+      template<typename SIG>
+      function<SIG>&
+      getFun ()
+        {
+          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
+          return static_cast<FunctionHolder<SIG>&> (holder_).get();
+        }
+    };
+  
+  
+  /** 
+   * Policy for FunErasure: store an unchecked bare function pointer.
+   * Using this policy allows to store a conventional function ptr,
+   * and to retrieve it without overhead, but also without safety.
+   */
+  class StoreUncheckedFunPtr
+    {
+      void *fun_;
+      
+    public:
+      template<typename SIG>
+      StoreUncheckedFunPtr (SIG& fun)
+        {
+          fun_ = &fun;
+        }
+      
+      template<typename SIG>
+      SIG&
+      getFun ()
+        {
+          return reinterpret_cast<SIG*> (&fun_);
+        }
     };
   
   

From a565bfef732a635d7a178a318531328a7cfaa64e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 01:28:47 +0200
Subject: [PATCH 118/368] some header-renaming

---
 src/lib/meta/function-erasure.hpp             | 214 ++++++++++++++++++
 tests/lib/Makefile.am                         |  10 +-
 ...figflagstest.cpp => config-flags-test.cpp} |  14 +-
 tests/lib/meta/function-closure-test.cpp      |  90 ++++++++
 tests/lib/meta/function-erasure-test.cpp      |  90 ++++++++
 .../{generatortest.cpp => generator-test.cpp} |  21 +-
 tests/lib/meta/typelist-diagnostics.hpp       | 162 +++++++++++++
 ...tmaniptest.cpp => typelist-manip-test.cpp} |  24 +-
 .../{typelisttest.cpp => typelist-test.cpp}   |  17 +-
 tests/lib/meta/typelistdiagnostics.hpp        | 170 --------------
 10 files changed, 589 insertions(+), 223 deletions(-)
 create mode 100644 src/lib/meta/function-erasure.hpp
 rename tests/lib/meta/{configflagstest.cpp => config-flags-test.cpp} (98%)
 create mode 100644 tests/lib/meta/function-closure-test.cpp
 create mode 100644 tests/lib/meta/function-erasure-test.cpp
 rename tests/lib/meta/{generatortest.cpp => generator-test.cpp} (94%)
 create mode 100644 tests/lib/meta/typelist-diagnostics.hpp
 rename tests/lib/meta/{typelistmaniptest.cpp => typelist-manip-test.cpp} (96%)
 rename tests/lib/meta/{typelisttest.cpp => typelist-test.cpp} (94%)
 delete mode 100644 tests/lib/meta/typelistdiagnostics.hpp

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
new file mode 100644
index 000000000..5f29c783b
--- /dev/null
+++ b/src/lib/meta/function-erasure.hpp
@@ -0,0 +1,214 @@
+/*
+  FUNCTION-ERASURE.hpp  -  wrapping a functor object for inline storage while hiding the signature
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file function-erasure.hpp
+ ** Partial function application and building a complete function closure.
+ ** This is a small addendum to (and thin wrapper for) tr1/functional, supporting
+ ** the case when a function should be closed over (all) arguments, where especially
+ ** the parameter values to close on are provided as a tuple. 
+ ** 
+ ** @see control::CommandDef usage example
+ ** @see function.hpp
+ ** @see tuple.hpp
+ ** 
+ */
+
+
+#ifndef LUMIERA_META_FUNCTION_ERASURE_H
+#define LUMIERA_META_FUNCTION_ERASURE_H
+
+#include "lib/meta/typelist.hpp"   /////////////TODO
+#include "lib/meta/generator.hpp"  /////////////TODO
+#include "lib/meta/function.hpp"
+#include "lib/meta/tuple.hpp"
+
+#include <tr1/functional>
+
+#include "lib/util.hpp" ////////////////////////TODO
+#include "lib/error.hpp"
+
+
+namespace lumiera {
+namespace typelist{
+
+  using std::tr1::bind;
+  //using std::tr1::placeholders::_1;
+  //using std::tr1::placeholders::_2;
+  using std::tr1::function;
+  
+  
+  
+  /**
+   * Generic wrapper carrying a function object
+   * while hiding the actual function signature
+   * @note not statically typesafe. Depending on
+   *       the actual embedded container type,
+   *       it \em might be run-time typesafe.
+   */
+  template<class FH>
+  struct FunErasure
+    : FH
+    {
+      template<typename FUN>
+      FunErasure (FUN const& functor)
+        : FH(functor)
+        { }
+    };
+    
+  /** 
+   * Policy for FunErasure: store an embedded tr1::function
+   * Using this policy allows to store arbitrary complex functor objects
+   * embedded within a neutral container and retrieving them later type-safe.
+   * The price to pay is vtable access and heap storage of function arguments. 
+   */
+  class StoreFunction
+    {
+      /** Helper: type erasure */
+      struct Holder
+        {
+          enum { SIZE = sizeof(function<void(void)>) };
+          char storage_[SIZE];
+          virtual ~Holder() {}
+        };
+      
+      /** embedding the concrete functor object */
+      template<typename SIG>
+      struct FunctionHolder : Holder
+        {
+          typedef function<SIG> Functor;
+          FunctionHolder (SIG& fun)
+            {
+              REQUIRE (SIZE >= sizeof(Functor));
+              new(&storage_) Functor (fun);
+            }
+          ~FunctionHolder()
+            {
+              get()->~Functor();
+            }
+          Functor&
+          get()
+            {
+              return static_cast<Functor*> (&storage_);
+            }
+        };
+      
+      /** embedded buffer actually holding
+       *  the concrete Functor object */
+      Holder holder_;
+      
+    public:
+      template<typename SIG>
+      StoreFunction (SIG& fun)
+        {
+          new(&holder_) FunctionHolder<SIG> (fun);
+        }
+      
+      template<typename SIG>
+      function<SIG>&
+      getFun ()
+        {
+          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
+          return static_cast<FunctionHolder<SIG>&> (holder_).get();
+        }
+    };
+  
+  
+  /** 
+   * Policy for FunErasure: store a bare function pointer.
+   * Using this policy allows to store a conventional function ptr,
+   * while still being able to re-access it later with run-time typecheck.
+   * The price to pay is vtable access. 
+   */
+  class StoreFunPtr
+    {
+      /** Helper: type erasure */
+      struct Holder
+        {
+          void *fun_;
+          virtual ~Holder() {}
+        };
+      
+      /** storing and retrieving concrete function ptr */
+      template<typename SIG>
+      struct FunctionHolder : Holder
+        {
+          FunctionHolder (SIG& fun)
+            {
+              fun_ = &fun;
+            }
+          SIG&
+          get()
+            {
+              return reinterpret_cast<SIG*> (&fun_);
+            }
+        };
+      
+      /** embedded container holding the pointer */
+      Holder holder_;
+      
+    public:
+      template<typename SIG>
+      StoreFunPtr (SIG& fun)
+        {
+          new(&holder_) FunctionHolder<SIG> (fun);
+        }
+      
+      template<typename SIG>
+      function<SIG>&
+      getFun ()
+        {
+          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
+          return static_cast<FunctionHolder<SIG>&> (holder_).get();
+        }
+    };
+  
+  
+  /** 
+   * Policy for FunErasure: store an unchecked bare function pointer.
+   * Using this policy allows to store a conventional function ptr,
+   * and to retrieve it without overhead, but also without safety.
+   */
+  class StoreUncheckedFunPtr
+    {
+      void *fun_;
+      
+    public:
+      template<typename SIG>
+      StoreUncheckedFunPtr (SIG& fun)
+        {
+          fun_ = &fun;
+        }
+      
+      template<typename SIG>
+      SIG&
+      getFun ()
+        {
+          return reinterpret_cast<SIG*> (&fun_);
+        }
+    };
+  
+  
+  
+  
+}} // namespace lumiera::typelist
+#endif
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 323750462..0c8f60501 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -46,10 +46,12 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
 	$(testlib_srcdir)/mainsuite.cpp				\
-	$(testlib_srcdir)/meta/typelisttest.cpp         	\
-	$(testlib_srcdir)/meta/typelistmaniptest.cpp    	\
-	$(testlib_srcdir)/meta/generatortest.cpp        	\
-	$(testlib_srcdir)/meta/configflagstest.cpp      	\
+	$(testlib_srcdir)/meta/typelist-test.cpp         	\
+	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
+	$(testlib_srcdir)/meta/function-closure-test.cpp   	\
+	$(testlib_srcdir)/meta/function-erasure-test.cpp   	\
+	$(testlib_srcdir)/meta/generator-test.cpp        	\
+	$(testlib_srcdir)/meta/config-flags-test.cpp      	\
 	$(testlib_srcdir)/query/queryutilstest.cpp		\
 	$(testlib_srcdir)/removefromsettest.cpp			\
 	$(testlib_srcdir)/sanitizedidentifiertest.cpp		\
diff --git a/tests/lib/meta/configflagstest.cpp b/tests/lib/meta/config-flags-test.cpp
similarity index 98%
rename from tests/lib/meta/configflagstest.cpp
rename to tests/lib/meta/config-flags-test.cpp
index 1098b0385..995ddef56 100644
--- a/tests/lib/meta/configflagstest.cpp
+++ b/tests/lib/meta/config-flags-test.cpp
@@ -21,7 +21,7 @@
 * *****************************************************/
 
 
-/** @file configflagstest.cpp
+/** @file config-flags-test.cpp
  ** \par build a type representing a single configuration defined by a set of flags
  **
  ** The semi-automatic assembly of processing node invocation code utilises some
@@ -42,7 +42,7 @@
 #include "lib/meta/generator.hpp"
 #include "lib/meta/typelistutil.hpp"
 #include "lib/meta/configflags.hpp"
-#include "meta/typelistdiagnostics.hpp"
+#include "meta/typelist-diagnostics.hpp"
 #include "proc/engine/nodewiringconfig.hpp"
 #include "lib/util.hpp"
 
@@ -55,8 +55,8 @@ using std::cout;
 
 
 namespace lumiera {
-  namespace typelist {
-    namespace test {
+namespace typelist{
+namespace test {
       
       
       namespace { // internal definitions
@@ -332,8 +332,4 @@ namespace lumiera {
       
       
       
-    } // namespace test
-    
-  } // namespace typelist
-
-} // namespace lumiera
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
new file mode 100644
index 000000000..78b205925
--- /dev/null
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -0,0 +1,90 @@
+/*
+  FunctionClosure(Test)  -  appending, mixing and filtering typelists
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file function-closure-test.cpp
+ ** bla
+ **
+ ** @see function-closure.hpp
+ ** @see control::CmdClosure real world usage example
+ **
+ */
+
+
+#include "lib/test/run.hpp"
+#include "lib/meta/function-closure.hpp"
+#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+#include <iostream>
+
+using ::test::Test;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test {
+  
+  
+  namespace { // test data
+    
+  } // (End) test data
+  
+  
+  
+  
+  
+  
+  /*************************************************************************
+   * @test //////////////////////////////////////////
+   *       - building combinations and permutations
+   */
+  class FunctionClosure_test : public Test
+    {
+      virtual void run(Arg arg) 
+        {
+          check_distribute();
+          check_combine();
+        }
+      
+      
+      void check_distribute()
+        {
+        }
+      
+      
+      void check_combine()
+        {
+        }
+
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (FunctionClosure_test, "unit common");
+  
+  
+  
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
new file mode 100644
index 000000000..c615edbc7
--- /dev/null
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -0,0 +1,90 @@
+/*
+  FunctionErasure(Test)  -  verify the wrapping of functor object with type erasure
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file function-erasure-test.cpp
+ ** bla
+ **
+ ** @see control::FunErasure
+ ** @see command-mutation.hpp real world usage example
+ **
+ */
+
+
+#include "lib/test/run.hpp"
+#include "lib/meta/function-erasure.hpp"
+#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+#include <iostream>
+
+using ::test::Test;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test {
+  
+  
+  namespace { // test data
+    
+  } // (End) test data
+  
+  
+  
+  
+  
+  
+  /*************************************************************************
+   * @test //////////////////////////////////////////
+   *       - building combinations and permutations
+   */
+  class FunctionErasure_test : public Test
+    {
+      virtual void run(Arg arg) 
+        {
+          check_distribute();
+          check_combine();
+        }
+      
+      
+      void check_distribute()
+        {
+        }
+      
+      
+      void check_combine()
+        {
+        }
+
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (FunctionErasure_test, "unit common");
+  
+  
+  
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/generatortest.cpp b/tests/lib/meta/generator-test.cpp
similarity index 94%
rename from tests/lib/meta/generatortest.cpp
rename to tests/lib/meta/generator-test.cpp
index c4224b4fa..dc7abbcbe 100644
--- a/tests/lib/meta/generatortest.cpp
+++ b/tests/lib/meta/generator-test.cpp
@@ -21,7 +21,7 @@
 * *****************************************************/
 
 
-/** @file generatortest.cpp
+/** @file generator-test.cpp
  ** \par what are we doing here??
  **
  ** the following test composes both an interface and the corresponding implementation
@@ -30,7 +30,7 @@
  ** in the list. (remember: normally the number and signature of all virtual functions
  ** need to be absolutely fixed in the class definition)
  **
- ** @see typelisttest.cpp
+ ** @see typelist-test.cpp
  ** @see generator.hpp
  ** @see lumiera::query::ConfigRules  a real world usage example
  **
@@ -47,12 +47,9 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera
-  {
-  namespace typelist
-    {
-    namespace test
-      {
+namespace lumiera {
+namespace typelist{
+namespace test {
       
       /** template for generating lots of different test types */
       template<int I>
@@ -89,7 +86,7 @@ namespace lumiera
           virtual ~DoIt() { cout << "dtor DoIt<"<< X::name << " >\n";}
         public:
           void eat (X& x) { cout << x.talk() << "\n";}
-          using BASE::eat; // prevent shaddowing
+          using BASE::eat; // prevent shadowing
         };
       
       typedef Types< Block<1>
@@ -148,8 +145,4 @@ namespace lumiera
       
       
       
-    } // namespace test
-    
-  } // namespace typelist
-
-} // namespace lumiera
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
new file mode 100644
index 000000000..800af1a39
--- /dev/null
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -0,0 +1,162 @@
+/*
+  TYPELIST-DIAGNOSTICS  -  helper for testing the typelist based utilities
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file typelist-diagnostics.hpp
+ ** a Printer template usable for debugging the structure of a typelist built
+ ** upon some simple debugging-style types. Examples being a Num<int> template,
+ ** or the Flag type. A Printer type generated from this template provides
+ ** a static \c print() function returning a string visualising the structure
+ ** of the typelist provided as parameter to the Printer template.
+ **
+ ** @see typelist-manip-test.cpp
+ ** @see config-flags-test.cpp
+ **
+ */
+#ifndef META_TYPELIST_DIAGNOSTICS_H
+#define META_TYPELIST_DIAGNOSTICS_H
+
+
+#include "lib/meta/generator.hpp"
+
+#include <boost/format.hpp>
+
+using std::string;
+using boost::format;
+
+
+namespace lumiera {
+namespace typelist{
+  
+  /** constant-wrapper type for debugging purposes,
+   *  usable for generating lists of distinguishable types
+   */
+  template<int I>
+  struct Num
+    {
+      enum{ VAL=I };
+    };
+  
+  
+  /* some forwards used by config-flags-test.cpp */
+  template<char bit> struct Flag;
+  template< char f1
+          , char f2
+          , char f3
+          , char f4
+          , char f5
+          >
+  struct Config;
+  
+  
+  
+  namespace test {
+    namespace { // hidden internals
+      
+      using boost::format;
+      
+      format fmt ("-<%u>%s");
+      
+      struct NullP
+        {
+          static string print () { return "-"; }
+        };
+      
+      /** debugging template, 
+       *  printing the "number" used for instantiation on ctor call
+       */
+      template<class NUM=NullType, class BASE=NullP>
+      struct Printer;
+      
+      template<class BASE>
+      struct Printer<NullType, BASE>
+        : BASE
+        {
+          static string print () { return str( fmt % "·" % BASE::print()); }
+        };
+      
+      template<class BASE, int I>
+      struct Printer<Num<I>, BASE>    ///< display the presence of a Num instance in the typelist
+        : BASE
+        {
+          static string print () { return str( fmt % uint(Num<I>::VAL) % BASE::print()); }
+        };
+      
+      template<class BASE, char Fl>
+      struct Printer<Flag<Fl>, BASE>  ///< display the presence of a Flag in the typelist
+        : BASE
+        {
+          static string print () { return str( fmt % uint(Fl) % BASE::print()); }
+        };
+      
+      
+      
+      /** call the debug-print for a typelist
+       *  utilising the Printer template */
+      template<class L>
+      string
+      printSublist ()
+      {
+        typedef InstantiateChained<L, Printer, NullP> SubList;
+        return SubList::print();
+      }
+      
+      /** Specialisation for debug-printing of a nested sublist */
+      template<class TY, class TYPES, class BASE>
+      struct Printer<Node<TY,TYPES>, BASE>
+        : BASE
+        {
+          static string print () 
+            {
+              typedef Node<TY,TYPES> List;
+              return string("\n\t+--") + printSublist<List>()+"+"
+                   + BASE::print(); 
+            }
+        };
+      
+      template<char f1, char f2, char f3, char f4, char f5, class BASE>
+      struct Printer<Config<f1,f2,f3,f4,f5>, BASE>
+        : BASE
+        {
+          static string print () 
+            {
+              typedef typename Config<f1,f2,f3,f4,f5>::Flags FlagList;
+              return string("\n\t+-Conf-[") + printSublist<FlagList>()+"]"
+                   + BASE::print(); 
+            }
+        };
+      
+      
+#define DIAGNOSE(LIST) \
+        typedef InstantiateChained<LIST::List, Printer, NullP>  Contents_##LIST;
+                     
+#define DISPLAY(NAME)  \
+        DIAGNOSE(NAME); cout << STRINGIFY(NAME) << "\t:" << Contents_##NAME::print() << "\n";
+      
+      
+      
+    } // (End) internal defs
+    
+    
+    
+}}} // namespace lumiera::typelist::test
+#endif
diff --git a/tests/lib/meta/typelistmaniptest.cpp b/tests/lib/meta/typelist-manip-test.cpp
similarity index 96%
rename from tests/lib/meta/typelistmaniptest.cpp
rename to tests/lib/meta/typelist-manip-test.cpp
index 5eb3e0f0e..a9f2ac06a 100644
--- a/tests/lib/meta/typelistmaniptest.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -21,17 +21,17 @@
 * *****************************************************/
 
 
-/** @file typelistmaniptest.cpp
+/** @file typelist-manip-test.cpp
  ** \par checking the correct working of simple list manipulation metafunctions
  **
- ** The semi-automatic assembly of processing node invocation code utilizes some
+ ** The semi-automatic assembly of processing node invocation code utilises some
  ** metaprogramming magic built upon simple list manipulation. As template metaprogramming
  ** is kind-of functional programming, most of this is done by recursion.
  ** To check the correct working, this test uses some constant-wrapper types and a debugging
  ** template which will print these constant numbers, thus allowing to verify in the output
  ** if various lists of such constant-wrapper types were manipulated as expected.
  **
- ** @see typelisttest.cpp
+ ** @see typelist-test.cpp
  ** @see typelistutil.hpp
  ** @see nodewiringconfig.hpp real world usage example
  **
@@ -41,7 +41,7 @@
 #include "lib/test/run.hpp"
 #include "lib/meta/generator.hpp"
 #include "lib/meta/typelistutil.hpp"
-#include "meta/typelistdiagnostics.hpp"
+#include "meta/typelist-diagnostics.hpp"
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
@@ -53,8 +53,8 @@ using std::cout;
 
 
 namespace lumiera {
-  namespace typelist {
-    namespace test {
+namespace typelist{
+namespace test {
       
       
       namespace { // test data
@@ -69,7 +69,7 @@ namespace lumiera {
                      , Num<6>
                      , Num<7>
                      >::List List2;
-         
+        
         
         template<class X> struct CountDown          { typedef NullType List; };
         template<>        struct CountDown<Num<0> > { typedef Node<Num<0>, NullType> List; };
@@ -91,7 +91,7 @@ namespace lumiera {
        *       - append lists, single elements and NullType
        *         in various combinations
        *       - filtering out some types from a typelist by
-       *         using a "predicate template" (metafuction)
+       *         using a "predicate template" (metafunction)
        *       - building combinations and permutations
        */
       class TypeListManipl_test : public Test
@@ -224,7 +224,7 @@ namespace lumiera {
               typedef CombineFlags<List1::List> OnOff;
               DISPLAY (OnOff);
             }
-
+          
           
         };
       
@@ -234,8 +234,4 @@ namespace lumiera {
       
       
       
-    } // namespace test
-    
-  } // namespace typelist
-
-} // namespace lumiera
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/typelisttest.cpp b/tests/lib/meta/typelist-test.cpp
similarity index 94%
rename from tests/lib/meta/typelisttest.cpp
rename to tests/lib/meta/typelist-test.cpp
index 20a70cbfb..c31c4a70d 100644
--- a/tests/lib/meta/typelisttest.cpp
+++ b/tests/lib/meta/typelist-test.cpp
@@ -30,12 +30,9 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera
-  {
-  namespace typelist
-    {
-    namespace test
-      {
+namespace lumiera {
+namespace typelist{
+namespace test {
       
       template<int I>
       struct Block    
@@ -46,7 +43,7 @@ namespace lumiera
         { 
           Zero()  { cout << "- The End -"; }
         };
-
+      
       
       typedef Types< Block<1>
                    , Block<2>
@@ -94,8 +91,4 @@ namespace lumiera
       
       
       
-    } // namespace test
-    
-  } // namespace typelist
-
-} // namespace lumiera
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/typelistdiagnostics.hpp b/tests/lib/meta/typelistdiagnostics.hpp
deleted file mode 100644
index 7be9cef31..000000000
--- a/tests/lib/meta/typelistdiagnostics.hpp
+++ /dev/null
@@ -1,170 +0,0 @@
-/*
-  TYPELISTDIAGNOSTICS  -  helper for testing the typelist based utilities
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-/** @file typelistdiagnostics.hpp
- ** a Printer template usable for debugging the structure of a typelist built
- ** upon some simple debugging-style types. Examples being a Num<int> template,
- ** or the Flag type. A Printer type generated from this template provides
- ** a static \c print() function returing a string visualizing the structure
- ** of the typelist provided as parameter to the Printer template.
- **
- ** @see typelistmaniptest.cpp
- ** @see configflagstest.cpp
- **
- */
-#ifndef META_TYPELISTDIAGNOSTICS_H
-#define META_TYPELISTDIAGNOSTICS_H
-
-
-#include "lib/meta/generator.hpp"
-
-//#include "lib/meta/typelistutil.hpp"
-//#include "lib/meta/util.hpp"
-//#include "lib/util.hpp"
-
-#include <boost/format.hpp>
-
-using std::string;
-using boost::format;
-
-
-namespace lumiera {
-  namespace typelist {
-      
-    /** constant-wrapper type for debugging purposes,
-     *  usable for generating lists of distinguishable types
-     */
-    template<int I>
-    struct Num
-      {
-        enum{ VAL=I };
-      };
-    
-    
-    /* some forwards used by configflagstest.cpp */
-    template<char bit> struct Flag;
-    template< char f1
-            , char f2
-            , char f3
-            , char f4
-            , char f5
-            >
-    struct Config;
-    
-    
-    
-    namespace test {
-      namespace { // internal definitions
-      
-        using boost::format;
-        
-        format fmt ("-<%u>%s");
-        
-        struct NullP
-          {
-            static string print () { return "-"; }
-          };
-        
-        /** debugging template, 
-         *  printing the "number" used for intantiation on ctor call
-         */
-        template<class NUM=NullType, class BASE=NullP>
-        struct Printer;
-        
-        template<class BASE>
-        struct Printer<NullType, BASE>
-          : BASE
-          {
-            static string print () { return str( fmt % "·" % BASE::print()); }
-          };
-        
-        template<class BASE, int I>
-        struct Printer<Num<I>, BASE>    ///< display the presence of a Num instance in the typelist
-          : BASE
-          {
-            static string print () { return str( fmt % uint(Num<I>::VAL) % BASE::print()); }
-          };
-        
-        template<class BASE, char Fl>
-        struct Printer<Flag<Fl>, BASE>  ///< display the presence of a Flag in the typelist
-          : BASE
-          {
-            static string print () { return str( fmt % uint(Fl) % BASE::print()); }
-          };
-        
-        
-        
-        /** call the debug-print for a typelist
-         *  utilizing the Printer template */ 
-        template<class L>
-        string
-        printSublist ()
-        {
-          typedef InstantiateChained<L, Printer, NullP> SubList;
-          return SubList::print();
-        }
-        
-        /** Spezialisation for debug-printing of a nested sublist */
-        template<class TY, class TYPES, class BASE>
-        struct Printer<Node<TY,TYPES>, BASE>
-          : BASE
-          {
-            static string print () 
-              {
-                typedef Node<TY,TYPES> List;
-                return string("\n\t+--") + printSublist<List>()+"+"
-                     + BASE::print(); 
-              }
-          };
-        
-        template<char f1, char f2, char f3, char f4, char f5, class BASE>
-        struct Printer<Config<f1,f2,f3,f4,f5>, BASE>
-          : BASE
-          {
-            static string print () 
-              {
-                typedef typename Config<f1,f2,f3,f4,f5>::Flags FlagList;
-                return string("\n\t+-Conf-[") + printSublist<FlagList>()+"]"
-                     + BASE::print(); 
-              }
-          };
-        
-        
-#define DIAGNOSE(LIST) \
-        typedef InstantiateChained<LIST::List, Printer, NullP>  Contents_##LIST;
-                     
-#define DISPLAY(NAME)  \
-        DIAGNOSE(NAME); cout << STRINGIFY(NAME) << "\t:" << Contents_##NAME::print() << "\n";
-        
-        
-        
-      } // (End) internal defs
-      
-      
-      
-    } // namespace test
-    
-  } // namespace typelist
-
-} // namespace lumiera
-#endif

From 079030818dcfadd77efd9cef5f688a06947adcee Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 04:43:52 +0200
Subject: [PATCH 119/368] draft a test to sharpen the idea of the function
 holder (erasure)

---
 src/lib/meta/function-closure.hpp        | 162 +-------------------
 src/lib/meta/function-erasure.hpp        |  80 ++++++----
 tests/40components.tests                 |  10 ++
 tests/lib/meta/dummy-functions.hpp       |  60 ++++++++
 tests/lib/meta/function-closure-test.cpp |  31 +---
 tests/lib/meta/function-erasure-test.cpp | 185 +++++++++++++++++++----
 6 files changed, 283 insertions(+), 245 deletions(-)
 create mode 100644 tests/lib/meta/dummy-functions.hpp

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index ce81a89dd..85a9c7ef7 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -37,28 +37,22 @@
 #ifndef LUMIERA_META_FUNCTION_CLOSURE_H
 #define LUMIERA_META_FUNCTION_CLOSURE_H
 
-#include "lib/meta/typelist.hpp"   /////////////TODO
-#include "lib/meta/generator.hpp"  /////////////TODO
 #include "lib/meta/function.hpp"
 #include "lib/meta/tuple.hpp"
 
 #include <tr1/functional>
 
-#include "lib/util.hpp" ////////////////////////TODO
-#include "lib/error.hpp"
 
 
 namespace lumiera {
 namespace typelist{
 
-  using std::tr1::bind;
-  //using std::tr1::placeholders::_1;
-  //using std::tr1::placeholders::_2;
   using std::tr1::function;
+  using std::tr1::bind;
   
   
   
-  namespace func { // helpers for binding and applying a function to an argument tuple 
+  namespace func { ///< helpers for binding and applying a function to an argument tuple 
     
     using tuple::element;
     
@@ -392,157 +386,5 @@ namespace typelist{
   
   
   
-  /**
-   * Generic wrapper carrying a function object
-   * while hiding the actual function signature
-   * @note not statically typesafe. Depending on
-   *       the actual embedded container type,
-   *       it \em might be run-time typesafe.
-   */
-  template<class FH>
-  struct FunErasure
-    : FH
-    {
-      template<typename FUN>
-      FunErasure (FUN const& functor)
-        : FH(functor)
-        { }
-    };
-    
-  /** 
-   * Policy for FunErasure: store an embedded tr1::function
-   * Using this policy allows to store arbitrary complex functor objects
-   * embedded within a neutral container and retrieving them later type-safe.
-   * The price to pay is vtable access and heap storage of function arguments. 
-   */
-  class StoreFunction
-    {
-      /** Helper: type erasure */
-      struct Holder
-        {
-          enum { SIZE = sizeof(function<void(void)>) };
-          char storage_[SIZE];
-          virtual ~Holder() {}
-        };
-      
-      /** embedding the concrete functor object */
-      template<typename SIG>
-      struct FunctionHolder : Holder
-        {
-          typedef function<SIG> Functor;
-          FunctionHolder (SIG& fun)
-            {
-              REQUIRE (SIZE >= sizeof(Functor));
-              new(&storage_) Functor (fun);
-            }
-          ~FunctionHolder()
-            {
-              get()->~Functor();
-            }
-          Functor&
-          get()
-            {
-              return static_cast<Functor*> (&storage_);
-            }
-        };
-      
-      /** embedded buffer actually holding
-       *  the concrete Functor object */
-      Holder holder_;
-      
-    public:
-      template<typename SIG>
-      StoreFunction (SIG& fun)
-        {
-          new(&holder_) FunctionHolder<SIG> (fun);
-        }
-      
-      template<typename SIG>
-      function<SIG>&
-      getFun ()
-        {
-          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
-          return static_cast<FunctionHolder<SIG>&> (holder_).get();
-        }
-    };
-  
-  
-  /** 
-   * Policy for FunErasure: store a bare function pointer.
-   * Using this policy allows to store a conventional function ptr,
-   * while still being able to re-access it later with run-time typecheck.
-   * The price to pay is vtable access. 
-   */
-  class StoreFunPtr
-    {
-      /** Helper: type erasure */
-      struct Holder
-        {
-          void *fun_;
-          virtual ~Holder() {}
-        };
-      
-      /** storing and retrieving concrete function ptr */
-      template<typename SIG>
-      struct FunctionHolder : Holder
-        {
-          FunctionHolder (SIG& fun)
-            {
-              fun_ = &fun;
-            }
-          SIG&
-          get()
-            {
-              return reinterpret_cast<SIG*> (&fun_);
-            }
-        };
-      
-      /** embedded container holding the pointer */
-      Holder holder_;
-      
-    public:
-      template<typename SIG>
-      StoreFunPtr (SIG& fun)
-        {
-          new(&holder_) FunctionHolder<SIG> (fun);
-        }
-      
-      template<typename SIG>
-      function<SIG>&
-      getFun ()
-        {
-          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
-          return static_cast<FunctionHolder<SIG>&> (holder_).get();
-        }
-    };
-  
-  
-  /** 
-   * Policy for FunErasure: store an unchecked bare function pointer.
-   * Using this policy allows to store a conventional function ptr,
-   * and to retrieve it without overhead, but also without safety.
-   */
-  class StoreUncheckedFunPtr
-    {
-      void *fun_;
-      
-    public:
-      template<typename SIG>
-      StoreUncheckedFunPtr (SIG& fun)
-        {
-          fun_ = &fun;
-        }
-      
-      template<typename SIG>
-      SIG&
-      getFun ()
-        {
-          return reinterpret_cast<SIG*> (&fun_);
-        }
-    };
-  
-  
-  
-  
 }} // namespace lumiera::typelist
 #endif
diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 5f29c783b..7e18ba090 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -22,14 +22,30 @@
 
 
 /** @file function-erasure.hpp
- ** Partial function application and building a complete function closure.
- ** This is a small addendum to (and thin wrapper for) tr1/functional, supporting
- ** the case when a function should be closed over (all) arguments, where especially
- ** the parameter values to close on are provided as a tuple. 
+ ** When working with generic function objects and function pointers typed to
+ ** arbitrary signatures, often there is the necessity to hold onto such a functor
+ ** while hiding the actual signature behind an common interface ("type erasure").
+ ** The usual solution based on subclassing has the downside of requiring separate
+ ** storage for the concrete functor object, which might become problematic when
+ ** dealing with lots of functor objects. 
  ** 
- ** @see control::CommandDef usage example
- ** @see function.hpp
- ** @see tuple.hpp
+ ** Especially when dealing with tr1::function objects, all of the type differences
+ ** are actually encoded into 3 internal pointers, thus yielding the same size for
+ ** all various types of functors. Building on this observation, we can create an
+ ** common container object to store the varying functors inline, while hiding the
+ ** actual signature.
+ ** 
+ ** There remains the problem of re-accessing the concrete functor later on. As
+ ** C++ has only rudimental introspection capabilities, we can only rely on the
+ ** usage context to provide the correct function signature; only when using a
+ ** virtual function for the re-access, we can perform at least a runtime-check.
+ ** 
+ ** Thus there are various flavours for actually implementing this idea, and the
+ ** picking a suitable implementation depends largely on the context. Thus we
+ ** provide a common and expect the client code to pick an implementation policy.
+ ** 
+ ** @see control::Mutation usage example
+ ** @see function-erasure-test.cpp
  ** 
  */
 
@@ -37,23 +53,15 @@
 #ifndef LUMIERA_META_FUNCTION_ERASURE_H
 #define LUMIERA_META_FUNCTION_ERASURE_H
 
-#include "lib/meta/typelist.hpp"   /////////////TODO
-#include "lib/meta/generator.hpp"  /////////////TODO
-#include "lib/meta/function.hpp"
-#include "lib/meta/tuple.hpp"
+#include "lib/util.hpp"
+#include "lib/error.hpp"
 
 #include <tr1/functional>
 
-#include "lib/util.hpp" ////////////////////////TODO
-#include "lib/error.hpp"
-
 
 namespace lumiera {
 namespace typelist{
 
-  using std::tr1::bind;
-  //using std::tr1::placeholders::_1;
-  //using std::tr1::placeholders::_2;
   using std::tr1::function;
   
   
@@ -96,19 +104,19 @@ namespace typelist{
       struct FunctionHolder : Holder
         {
           typedef function<SIG> Functor;
-          FunctionHolder (SIG& fun)
+          FunctionHolder (Functor const& fun)
             {
               REQUIRE (SIZE >= sizeof(Functor));
               new(&storage_) Functor (fun);
             }
           ~FunctionHolder()
             {
-              get()->~Functor();
+              get().~Functor();
             }
           Functor&
           get()
             {
-              return static_cast<Functor*> (&storage_);
+              return *reinterpret_cast<Functor*> (&storage_);
             }
         };
       
@@ -119,6 +127,11 @@ namespace typelist{
     public:
       template<typename SIG>
       StoreFunction (SIG& fun)
+        {
+          new(&holder_) FunctionHolder<SIG> (function<SIG>(fun));
+        }
+      template<typename SIG>
+      StoreFunction (function<SIG> const& fun)
         {
           new(&holder_) FunctionHolder<SIG> (fun);
         }
@@ -144,7 +157,7 @@ namespace typelist{
       /** Helper: type erasure */
       struct Holder
         {
-          void *fun_;
+          void *fP_;
           virtual ~Holder() {}
         };
       
@@ -152,14 +165,15 @@ namespace typelist{
       template<typename SIG>
       struct FunctionHolder : Holder
         {
-          FunctionHolder (SIG& fun)
+          FunctionHolder (SIG *fun)
             {
-              fun_ = &fun;
+              REQUIRE (fun);
+              fP_ = reinterpret_cast<void*> (fun);
             }
           SIG&
           get()
             {
-              return reinterpret_cast<SIG*> (&fun_);
+              return *reinterpret_cast<SIG*> (&fP_);
             }
         };
       
@@ -169,12 +183,17 @@ namespace typelist{
     public:
       template<typename SIG>
       StoreFunPtr (SIG& fun)
+        {
+          new(&holder_) FunctionHolder<SIG> (&fun);
+        }
+      template<typename SIG>
+      StoreFunPtr (SIG *fun)
         {
           new(&holder_) FunctionHolder<SIG> (fun);
         }
       
       template<typename SIG>
-      function<SIG>&
+      SIG&
       getFun ()
         {
           REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
@@ -190,20 +209,25 @@ namespace typelist{
    */
   class StoreUncheckedFunPtr
     {
-      void *fun_;
+      void *funP_;
       
     public:
       template<typename SIG>
       StoreUncheckedFunPtr (SIG& fun)
         {
-          fun_ = &fun;
+          funP_ = reinterpret_cast<void*> (&fun);
+        }
+      template<typename SIG>
+      StoreUncheckedFunPtr (SIG *fun)
+        {
+          funP_ = reinterpret_cast<void*> (fun);
         }
       
       template<typename SIG>
       SIG&
       getFun ()
         {
-          return reinterpret_cast<SIG*> (&fun_);
+          return *reinterpret_cast<SIG*> (&funP_);
         }
     };
   
diff --git a/tests/40components.tests b/tests/40components.tests
index 7a87ab1ad..e261ba5d0 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -213,6 +213,16 @@ out: dtor ~TargetObj\(12\) successful
 END
 
 
+PLANNED "FunctionClosure_test" FunctionClosure_test <<END
+return: 0
+END
+
+
+PLANNED "FunctionErasure_test" FunctionErasure_test <<END
+return: 0
+END
+
+
 TEST "HashIndexed_test" HashIndexed_test <<END
 return: 0
 END
diff --git a/tests/lib/meta/dummy-functions.hpp b/tests/lib/meta/dummy-functions.hpp
new file mode 100644
index 000000000..0957cbada
--- /dev/null
+++ b/tests/lib/meta/dummy-functions.hpp
@@ -0,0 +1,60 @@
+/*
+  DUMMY-FUNCTIONS  -  mock functions for checking functor utils
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#ifndef LIB_META_DUMMY_FUNCTIONS_H
+#define LIB_META_DUMMY_FUNCTIONS_H
+
+
+//#include <boost/format.hpp>
+//#include <string>
+
+//using std::string;
+//using boost::format;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test {
+  
+  
+  namespace { // test helpers
+  
+    int _sum_ =0;  ///< used to verify the effect of testFunc
+  
+    void
+    testFunc (int i, char c)
+    {
+      _sum_ += i + c;
+    }
+    
+    int
+    returnIt ()
+    {
+      return _sum_;
+    }
+  }
+  
+  
+  
+}}} // namespace lumiera::typelist::test
+#endif
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 78b205925..6218061a6 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -22,7 +22,8 @@
 
 
 /** @file function-closure-test.cpp
- ** bla
+ ** 
+ ** @todo define function-closure-test
  **
  ** @see function-closure.hpp
  ** @see control::CmdClosure real world usage example
@@ -32,7 +33,8 @@
 
 #include "lib/test/run.hpp"
 #include "lib/meta/function-closure.hpp"
-#include "lib/util.hpp"
+#include "meta/dummy-functions.hpp"
+//#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
 #include <iostream>
@@ -47,13 +49,6 @@ namespace typelist{
 namespace test {
   
   
-  namespace { // test data
-    
-  } // (End) test data
-  
-  
-  
-  
   
   
   /*************************************************************************
@@ -62,23 +57,11 @@ namespace test {
    */
   class FunctionClosure_test : public Test
     {
-      virtual void run(Arg arg) 
+      virtual void
+      run (Arg) 
         {
-          check_distribute();
-          check_combine();
+          UNIMPLEMENTED ("verify function closure utils");
         }
-      
-      
-      void check_distribute()
-        {
-        }
-      
-      
-      void check_combine()
-        {
-        }
-
-      
     };
   
   
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index c615edbc7..46c611f52 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -21,20 +21,13 @@
 * *****************************************************/
 
 
-/** @file function-erasure-test.cpp
- ** bla
- **
- ** @see control::FunErasure
- ** @see command-mutation.hpp real world usage example
- **
- */
-
-
 #include "lib/test/run.hpp"
 #include "lib/meta/function-erasure.hpp"
-#include "lib/util.hpp"
+#include "meta/dummy-functions.hpp"
+//#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
+#include <tr1/functional>
 #include <iostream>
 
 using ::test::Test;
@@ -46,38 +39,164 @@ namespace lumiera {
 namespace typelist{
 namespace test {
   
+  using std::tr1::function;
+  using std::tr1::bind;
+
   
-  namespace { // test data
-    
-  } // (End) test data
-  
-  
-  
-  
-  
+  typedef FunErasure<StoreFunction> Efun;
+  typedef FunErasure<StoreFunPtr>   Efp;
+  typedef FunErasure<StoreUncheckedFunPtr> Evoid;
   
   /*************************************************************************
-   * @test //////////////////////////////////////////
-   *       - building combinations and permutations
+   * @test Create specifically typed functor objects and then wrap them
+   *       into common holder objects, thereby discarding the specific
+   *       signature type information. Later on, the concrete functor
+   *       can be re-accessed, given the exact and specific type.
+   *
+   * @see control::FunErasure
+   * @see command-mutation.hpp real world usage example
    */
   class FunctionErasure_test : public Test
     {
-      virtual void run(Arg arg) 
-        {
-          check_distribute();
-          check_combine();
-        }
-      
-      
-      void check_distribute()
-        {
-        }
-      
-      
-      void check_combine()
+      virtual void
+      run (Arg) 
         {
+          function<void(int,char)> bindFunc = bind (testFunc,_1,_2);
+          function<void(int,char)> pAplFunc = bind (testFunc,_1,'x');
+          function<void(int,char)> memFunc  = bind (&FunctionErasure_test::testMemberFunction,this, _1);
+          
+          function<int(void)> getterFunc  = &returnIt;
+          
+          check_FunctorContainer( Efun (testFunc)
+                                , Efun (bindFunc)
+                                , Efun (pAplFunc)
+                                , Efun (memFunc)
+                                , Efun (getterFunc)
+                                );
+          
+          check_FunctPtrHolder(Efp(testFunc)
+                               ,Efp(&testFunc)
+                               , Efp(returnIt));
+          
+          check_VoidPtrHolder(Evoid(testFunc)
+                              ,Evoid(&testFunc)
+                              , Evoid(returnIt));
         }
 
+      void
+      testMemberFunction (char c)
+        {
+          return testFunc('a'-'A', c);
+        }
+      
+      
+      void
+      check_FunctorContainer (Efun f1, Efun f2, Efun f3, Efun f4, Efun f5)
+        {
+          typedef void (Sig1) (int,char);
+          typedef void (Sig2) (int);
+          typedef void (Sig3) (char);
+          typedef int  (Sig4) ();
+          
+          _sum_ = 0;
+          f1.getFun<Sig1>() (-11,'M');
+          ASSERT (_sum_ == 'M'-11);
+          
+          _sum_ = 0;
+          f2.getFun<Sig1>() (-22,'M');
+          ASSERT (_sum_ == 'M'-22);
+          
+          _sum_ = 0;
+          f3.getFun<Sig2>() (-33);
+          ASSERT (_sum_ == 'x'-22);
+          
+          _sum_ = 0;
+          f4.getFun<Sig3>() ('U');
+          ASSERT (_sum_ == 'u');
+          
+          ASSERT ( 'u' == f5.getFun<Sig4>() () );
+          
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          VERIFY_ERROR (ASSERTION, f1.getFun<Sig2>() );
+          VERIFY_ERROR (ASSERTION, f1.getFun<Sig3>() );
+          VERIFY_ERROR (ASSERTION, f1.getFun<Sig4>() );
+
+          VERIFY_ERROR (ASSERTION, f2.getFun<Sig2>() );
+          VERIFY_ERROR (ASSERTION, f3.getFun<Sig3>() );
+          VERIFY_ERROR (ASSERTION, f2.getFun<Sig4>() );
+
+          VERIFY_ERROR (ASSERTION, f3.getFun<Sig1>() );
+          VERIFY_ERROR (ASSERTION, f3.getFun<Sig3>() );
+          VERIFY_ERROR (ASSERTION, f3.getFun<Sig4>() );
+
+          VERIFY_ERROR (ASSERTION, f4.getFun<Sig1>() );
+          VERIFY_ERROR (ASSERTION, f4.getFun<Sig2>() );
+          VERIFY_ERROR (ASSERTION, f4.getFun<Sig4>() );
+
+          VERIFY_ERROR (ASSERTION, f5.getFun<Sig1>() );
+          VERIFY_ERROR (ASSERTION, f5.getFun<Sig2>() );
+          VERIFY_ERROR (ASSERTION, f5.getFun<Sig3>() );
+#endif        
+        }
+      
+      
+      void
+      check_FunctPtrHolder (Efp f1, Efp f2, Efp f3)
+        {
+          typedef void (*FP)(int,char);
+          typedef void (&FR)(int,char);
+          
+          FP fun1 = &f1.getFun<void(int,char)>();
+          FP fun2 = &f2.getFun<void(int,char)>();
+          FR fun2r = f2.getFun<void(int,char)>();
+          
+          _sum_ = 0;
+          (*fun1) (10, 'a');
+          ASSERT (_sum_ == 10+'a');
+          
+          (*fun2) (20, 'b');
+          ASSERT (_sum_ == 10+'a'+20+'b');
+          
+          fun2r (30, 'c');
+          ASSERT (_sum_ == 10+'a'+20+'b'+30+'c');
+          
+          ASSERT (_sum_ == (f3.getFun<int(void)>()) () );
+          
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          VERIFY_ERROR (ASSERTION, f1.getFun<int(int)>() );
+#endif        
+
+        }
+      
+      
+      void
+      check_VoidPtrHolder (Evoid f1, Evoid f2, Evoid f3)
+        {
+          typedef void (*FP)(int,char);
+          typedef void (&FR)(int,char);
+          
+          FP fun1 = &f1.getFun<void(int,char)>();
+          FP fun2 = &f2.getFun<void(int,char)>();
+          FR fun2r = f2.getFun<void(int,char)>();
+          
+          _sum_ = 0;
+          (*fun1) (10, 'a');
+          ASSERT (_sum_ == 10+'a');
+          
+          (*fun2) (20, 'b');
+          ASSERT (_sum_ == 10+'a'+20+'b');
+          
+          fun2r (30, 'c');
+          ASSERT (_sum_ == 10+'a'+20+'b'+30+'c');
+          
+          ASSERT (_sum_ == (f3.getFun<int(void)>()) () );
+          
+          FP bad_fun = &f3.getFun<void(int,char)>();
+          ASSERT ((void*)bad_fun == &returnIt);
+          
+          (*bad_fun) (11, 'x'); // SEGV
+        }
+      
       
     };
   

From a28c05877f6a259da19bdb1435a51f0a6ccfb148 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 06:11:09 +0200
Subject: [PATCH 120/368] test pass (resolves Ticket #174)

---
 src/lib/meta/function-erasure.hpp        | 30 +++++++----
 tests/40components.tests                 |  2 +-
 tests/lib/meta/function-erasure-test.cpp | 67 +++++++++++-------------
 3 files changed, 53 insertions(+), 46 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 7e18ba090..0696b6a42 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -61,17 +61,25 @@
 
 namespace lumiera {
 namespace typelist{
-
+  
   using std::tr1::function;
   
   
   
-  /**
+  /******************************************************
    * Generic wrapper carrying a function object
    * while hiding the actual function signature
+   * - create it using a function ref or pointer
+   * - the StoreFunction-policy also allows 
+   *   creation based on an existing function object
+   * - re-access the functor or function ref
+   *   using the templated \c getFun()
+   *   
+   * @param FH policy to control the implementation.
+   *        In most cases, you should use "StoreFunction"  
    * @note not statically typesafe. Depending on
-   *       the actual embedded container type,
-   *       it \em might be run-time typesafe.
+   *       the specified policy, it \em might be
+   *       run-time typesafe.
    */
   template<class FH>
   struct FunErasure
@@ -82,7 +90,10 @@ namespace typelist{
         : FH(functor)
         { }
     };
+  
     
+  /* ====== Policy classes ====== */
+  
   /** 
    * Policy for FunErasure: store an embedded tr1::function
    * Using this policy allows to store arbitrary complex functor objects
@@ -104,6 +115,7 @@ namespace typelist{
       struct FunctionHolder : Holder
         {
           typedef function<SIG> Functor;
+          
           FunctionHolder (Functor const& fun)
             {
               REQUIRE (SIZE >= sizeof(Functor));
@@ -146,10 +158,10 @@ namespace typelist{
     };
   
   
-  /** 
+  /**
    * Policy for FunErasure: store a bare function pointer.
    * Using this policy allows to store a conventional function ptr,
-   * while still being able to re-access it later with run-time typecheck.
+   * while still being able to re-access it later with run-time type check.
    * The price to pay is vtable access. 
    */
   class StoreFunPtr
@@ -173,7 +185,7 @@ namespace typelist{
           SIG&
           get()
             {
-              return *reinterpret_cast<SIG*> (&fP_);
+              return *reinterpret_cast<SIG*> (fP_);
             }
         };
       
@@ -202,7 +214,7 @@ namespace typelist{
     };
   
   
-  /** 
+  /**
    * Policy for FunErasure: store an unchecked bare function pointer.
    * Using this policy allows to store a conventional function ptr,
    * and to retrieve it without overhead, but also without safety.
@@ -227,7 +239,7 @@ namespace typelist{
       SIG&
       getFun ()
         {
-          return *reinterpret_cast<SIG*> (&funP_);
+          return *reinterpret_cast<SIG*> (funP_);
         }
     };
   
diff --git a/tests/40components.tests b/tests/40components.tests
index e261ba5d0..e28e5445f 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -218,7 +218,7 @@ return: 0
 END
 
 
-PLANNED "FunctionErasure_test" FunctionErasure_test <<END
+TEST "FunctionErasure_test" FunctionErasure_test <<END
 return: 0
 END
 
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 46c611f52..be7d6a8ae 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -2,7 +2,7 @@
   FunctionErasure(Test)  -  verify the wrapping of functor object with type erasure
  
   Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
  
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
@@ -22,17 +22,16 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 #include "lib/meta/function-erasure.hpp"
+#include "lib/error.hpp"
 #include "meta/dummy-functions.hpp"
-//#include "lib/util.hpp"
 
-//#include <boost/format.hpp>
 #include <tr1/functional>
-#include <iostream>
 
 using ::test::Test;
-using std::string;
-using std::cout;
+using lumiera::error::LUMIERA_ERROR_ASSERTION;
+
 
 
 namespace lumiera {
@@ -41,18 +40,19 @@ namespace test {
   
   using std::tr1::function;
   using std::tr1::bind;
-
+  
   
   typedef FunErasure<StoreFunction> Efun;
   typedef FunErasure<StoreFunPtr>   Efp;
   typedef FunErasure<StoreUncheckedFunPtr> Evoid;
   
-  /*************************************************************************
+  
+  /***********************************************************************
    * @test Create specifically typed functor objects and then wrap them
    *       into common holder objects, thereby discarding the specific
    *       signature type information. Later on, the concrete functor
    *       can be re-accessed, given the exact and specific type.
-   *
+   * 
    * @see control::FunErasure
    * @see command-mutation.hpp real world usage example
    */
@@ -62,29 +62,24 @@ namespace test {
       run (Arg) 
         {
           function<void(int,char)> bindFunc = bind (testFunc,_1,_2);
-          function<void(int,char)> pAplFunc = bind (testFunc,_1,'x');
-          function<void(int,char)> memFunc  = bind (&FunctionErasure_test::testMemberFunction,this, _1);
+          function<void(int     )> pAplFunc = bind (testFunc,_1,'x');
+          function<void(    char)> membFunc = bind (&FunctionErasure_test::testMemberFunction,this, _1);
           
           function<int(void)> getterFunc  = &returnIt;
           
           check_FunctorContainer( Efun (testFunc)
                                 , Efun (bindFunc)
                                 , Efun (pAplFunc)
-                                , Efun (memFunc)
+                                , Efun (membFunc)
                                 , Efun (getterFunc)
                                 );
           
-          check_FunctPtrHolder(Efp(testFunc)
-                               ,Efp(&testFunc)
-                               , Efp(returnIt));
-          
-          check_VoidPtrHolder(Evoid(testFunc)
-                              ,Evoid(&testFunc)
-                              , Evoid(returnIt));
+          check_FunctPtrHolder(Efp(testFunc),Efp(&testFunc), Efp(returnIt));
+          check_VoidPtrHolder(Evoid(testFunc),Evoid(&testFunc),Evoid(returnIt));
         }
-
+      
       void
-      testMemberFunction (char c)
+      testMemberFunction (char c) ///< for checking bind-to member function
         {
           return testFunc('a'-'A', c);
         }
@@ -99,7 +94,7 @@ namespace test {
           typedef int  (Sig4) ();
           
           _sum_ = 0;
-          f1.getFun<Sig1>() (-11,'M');
+          f1.getFun<Sig1>() (-11,'M');                // invoke stored tr1::function...
           ASSERT (_sum_ == 'M'-11);
           
           _sum_ = 0;
@@ -108,35 +103,37 @@ namespace test {
           
           _sum_ = 0;
           f3.getFun<Sig2>() (-33);
-          ASSERT (_sum_ == 'x'-22);
+          ASSERT (_sum_ == 'x'-33);
           
           _sum_ = 0;
           f4.getFun<Sig3>() ('U');
           ASSERT (_sum_ == 'u');
           
           ASSERT ( 'u' == f5.getFun<Sig4>() () );
+          ASSERT (INSTANCEOF (function<Sig4>, &f5.getFun<Sig4>()));
+          
           
 #if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
           VERIFY_ERROR (ASSERTION, f1.getFun<Sig2>() );
           VERIFY_ERROR (ASSERTION, f1.getFun<Sig3>() );
           VERIFY_ERROR (ASSERTION, f1.getFun<Sig4>() );
-
+          
           VERIFY_ERROR (ASSERTION, f2.getFun<Sig2>() );
           VERIFY_ERROR (ASSERTION, f3.getFun<Sig3>() );
           VERIFY_ERROR (ASSERTION, f2.getFun<Sig4>() );
-
+          
           VERIFY_ERROR (ASSERTION, f3.getFun<Sig1>() );
           VERIFY_ERROR (ASSERTION, f3.getFun<Sig3>() );
           VERIFY_ERROR (ASSERTION, f3.getFun<Sig4>() );
-
+          
           VERIFY_ERROR (ASSERTION, f4.getFun<Sig1>() );
           VERIFY_ERROR (ASSERTION, f4.getFun<Sig2>() );
           VERIFY_ERROR (ASSERTION, f4.getFun<Sig4>() );
-
+          
           VERIFY_ERROR (ASSERTION, f5.getFun<Sig1>() );
           VERIFY_ERROR (ASSERTION, f5.getFun<Sig2>() );
           VERIFY_ERROR (ASSERTION, f5.getFun<Sig3>() );
-#endif        
+#endif    ////////////////////////////////////////////////////////
         }
       
       
@@ -151,7 +148,7 @@ namespace test {
           FR fun2r = f2.getFun<void(int,char)>();
           
           _sum_ = 0;
-          (*fun1) (10, 'a');
+          (*fun1) (10, 'a');                          // invoke retrieved function pointer
           ASSERT (_sum_ == 10+'a');
           
           (*fun2) (20, 'b');
@@ -164,8 +161,8 @@ namespace test {
           
 #if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
           VERIFY_ERROR (ASSERTION, f1.getFun<int(int)>() );
-#endif        
-
+#endif////////////////////////////////////////////////////////////
+          
         }
       
       
@@ -192,12 +189,10 @@ namespace test {
           ASSERT (_sum_ == (f3.getFun<int(void)>()) () );
           
           FP bad_fun = &f3.getFun<void(int,char)>();
-          ASSERT ((void*)bad_fun == &returnIt);
+          ASSERT ((void*)bad_fun == &returnIt);   // got wrong function!
           
-          (*bad_fun) (11, 'x'); // SEGV
-        }
-      
-      
+        //(*bad_fun) (11, 'x');  // The compiler would accept this line!
+        }                       //  likely to result in heap corruption or SEGV
     };
   
   

From 12bcc127a64ddeb54f5faccba5016711c47277b4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 06:46:21 +0200
Subject: [PATCH 121/368] another test-helper unittest

---
 tests/lib/test/test-helper-test.cpp | 32 ++++++++++++++++++++++++++---
 1 file changed, 29 insertions(+), 3 deletions(-)

diff --git a/tests/lib/test/test-helper-test.cpp b/tests/lib/test/test-helper-test.cpp
index 032eb3e9b..f4d44a0a5 100644
--- a/tests/lib/test/test-helper-test.cpp
+++ b/tests/lib/test/test-helper-test.cpp
@@ -23,11 +23,15 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
+#include "lib/error.hpp"
 
 #include <iostream>
 
 using std::cout;
 using std::endl;
+using lumiera::Error;
+using lumiera::LUMIERA_ERROR_EXCEPTION;
+using lumiera::error::LUMIERA_ERROR_ASSERTION;
 
 
 namespace lib {
@@ -43,6 +47,10 @@ namespace test{
   struct Murpf { };
   
   
+  void doThrow() { throw Error("because I feel like it"); }
+  int dontThrow() { return 2+2; }
+  
+  
   /*************************************************
    * verifies the proper working of helper functions
    * frequently used within the Lumiera testsuite.
@@ -54,6 +62,7 @@ namespace test{
       run (Arg)
         {
           checkTypeDisplay();
+          checkThrowChecker();
         }
       
       
@@ -88,10 +97,27 @@ namespace test{
           cout << showSizeof(p1)  << endl;
           cout << showSizeof(p2)  << endl;
         }
+      
+      
+      /** @test check the VERIFY_ERROR macro, 
+       *        which ensures a given error is raised.
+       */
+      void
+      checkThrowChecker()
+        {
+          // verify the exception is indeed raised
+          VERIFY_ERROR (EXCEPTION, doThrow() );
+          
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          // and when actually no exception is raised, this is an ASSERTION failure
+          VERIFY_ERROR (ASSERTION, VERIFY_ERROR (EXCEPTION, dontThrow() ));
+#endif    ////////////////////////////////////////////////////////
+        }
+      
     };
   
-    LAUNCHER (TestHelper_test, "unit common");    
-    
-    
+  LAUNCHER (TestHelper_test, "unit common");
+  
+  
 }}} // namespace lib::test::test
 

From bc94f299e28a4f012b95409f89327fc3224ed55f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 07:13:20 +0200
Subject: [PATCH 122/368] hey... now storing the operation is almost
 effortless!

---
 src/proc/control/command-closure.hpp          |  2 +-
 src/proc/control/command-mutation.hpp         | 33 +++++++++++++------
 .../proc/control/command-mutation-test.cpp    |  2 +-
 tests/lib/meta/function-closure-test.cpp      |  2 +-
 tests/lib/test/test-helper-test.cpp           |  2 +-
 5 files changed, 27 insertions(+), 14 deletions(-)

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 5c5923f09..80ef6f095 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -82,12 +82,12 @@ namespace control {
       virtual operator string()  const =0;
       
     };
-
   
   
   inline ostream& operator<< (ostream& os, const CmdClosure& clo) { return os << string(clo); }
   
   
+  
   template
     < typename TY
     , class BASE
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 02a68794f..d7711079a 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -38,6 +38,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "proc/control/command-closure.hpp"
+#include "lib/meta/function-erasure.hpp"
 
 //#include <tr1/memory>
 #include <boost/scoped_ptr.hpp>
@@ -49,6 +50,8 @@
 
 namespace control {
   
+  using lumiera::typelist::FunErasure;
+  using lumiera::typelist::StoreFunction;
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   using boost::scoped_ptr;
@@ -57,19 +60,26 @@ namespace control {
   using std::string;
   
   
+  /** 
+   * A neutral container internally holding 
+   * the functor used to implement the Command
+   */
+  typedef FunErasure<StoreFunction> CmdFunctor;
+  
+  
   /**
    * @todo Type-comment
    */
   class Mutation
     {
+      CmdFunctor func_;
       PClo clo_;
       
     public:
       template<typename SIG>
       Mutation (function<SIG> const& func)
-        {
-          UNIMPLEMENTED ("build a Mutation functor object, thereby erasing the concrete function signature type");
-        }
+        : func_(func)
+        { }
       
       virtual ~Mutation() {}
       
@@ -121,25 +131,28 @@ namespace control {
   class UndoMutation
     : public Mutation
     {
+      CmdFunctor         captureFunc_;
       scoped_ptr<CmdClosure> memento_;
       
     public:
       template<typename SIG_undo, typename SIG_cap>
-      UndoMutation (function<SIG_undo> const& undoFunc, function<SIG_cap> const& captureFunc)
-        : Mutation(undoFunc)
-        {
-          UNIMPLEMENTED ("build a undo Mutation functor object");
-        }
+      UndoMutation (function<SIG_undo> const& undoFunc,
+                    function<SIG_cap> const& captureFunc)
+        : Mutation (undoFunc)
+        , captureFunc_(captureFunc)
+        { }
       
       UndoMutation (UndoMutation const& o)
-        : Mutation(*this),
-          memento_(o.memento_->clone().get())
+        : Mutation (*this)
+        , captureFunc_(o.captureFunc_)
+        , memento_(o.memento_->clone().get())
         { }
       
       UndoMutation&
       operator= (UndoMutation const& o)
         {
           Mutation::operator= (o);
+          captureFunc_ = o.captureFunc_;
           memento_.reset(o.memento_->clone().get());
           return *this;
         }
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index 5d9547a32..79b54d723 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -74,7 +74,7 @@ namespace test    {
   
   namespace {
   
-    int testVal;  ///< used to verify the effect of testFunc
+    int testVal=0;  ///< used to verify the effect of testFunc
   
     void
     testFunc (int val)
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 6218061a6..b0be3edb5 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -2,7 +2,7 @@
   FunctionClosure(Test)  -  appending, mixing and filtering typelists
  
   Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
  
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
diff --git a/tests/lib/test/test-helper-test.cpp b/tests/lib/test/test-helper-test.cpp
index f4d44a0a5..40258c44a 100644
--- a/tests/lib/test/test-helper-test.cpp
+++ b/tests/lib/test/test-helper-test.cpp
@@ -2,7 +2,7 @@
   TestHelper(Test)  -  validate the unittest support functions
  
   Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
  
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as

From b26de14dcf472ed70e689152220bf1eb06d01190 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 09:22:33 +0200
Subject: [PATCH 123/368] WIP how to apply the param tuple?

---
 src/proc/control/command-closure.hpp  | 39 +++++++++++++++++++++++++++
 src/proc/control/command-mutation.hpp | 10 -------
 2 files changed, 39 insertions(+), 10 deletions(-)

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 80ef6f095..a01079ee8 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -39,6 +39,7 @@
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/function-closure.hpp"
+#include "lib/meta/function-erasure.hpp"
 #include "lib/meta/tuple.hpp"
 
 #include <tr1/memory>
@@ -64,8 +65,19 @@ namespace control {
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::Tuple;
   using lumiera::typelist::BuildTupleAccessor;
+  using lumiera::typelist::TupleApplicator;
+  using lumiera::typelist::FunErasure;
+  using lumiera::typelist::StoreFunction;
   
   using lumiera::typelist::NullType;
+    
+  
+  /** 
+   * A neutral container internally holding 
+   * the functor used to implement the Command
+   */
+  typedef FunErasure<StoreFunction> CmdFunctor;
+  
   
   class CmdClosure;
   typedef std::tr1::shared_ptr<CmdClosure> PClo;  ///< smart-ptr type used for handling concrete closures
@@ -81,6 +93,7 @@ namespace control {
       
       virtual operator string()  const =0;
       
+      virtual CmdFunctor bindArguments (CmdFunctor&) =0;
     };
   
   
@@ -158,6 +171,32 @@ namespace control {
         { }
       
       
+      /** Core operation: use the embedded argument tuple
+       *  to close a given functor over its arguments.
+       *  @param unboundFunctor an function object, whose
+       *         function arguments are required to match 
+       *         the types of the embedded ParamStorageTuple
+       *  @return new functor object containing the function<void()>,
+       *         which is created by binding all arguments of the
+       *         input functor.
+       *  @note  ASSERTION failure if the function signature 
+       *         doesn't match the argument types tuple.
+       *  @note  when finally invoked, the functor, which is
+       *         bound here to the argument tuple, might actually
+       *         \em modify the param values. Thus this function
+       *         can't be const.
+       */
+      CmdFunctor
+      bindArguments (CmdFunctor& unboundFunctor)
+        {
+          function<SIG> unboundF (unboundFunctor.getFun<SIG>());
+          TupleApplicator<SIG> appli (params_);
+                
+          function<void()> boundFunctor = appli.bind (unboundF);
+          return CmdFunctor (boundFunctor);
+        }
+      
+      
       /** create a clone copy of this concrete closure,
        *  hidden behind the generic CmdClosure interface
        *  and owned by a shared_ptr PClo.
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index d7711079a..a17f7973e 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -38,7 +38,6 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "proc/control/command-closure.hpp"
-#include "lib/meta/function-erasure.hpp"
 
 //#include <tr1/memory>
 #include <boost/scoped_ptr.hpp>
@@ -50,8 +49,6 @@
 
 namespace control {
   
-  using lumiera::typelist::FunErasure;
-  using lumiera::typelist::StoreFunction;
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   using boost::scoped_ptr;
@@ -60,13 +57,6 @@ namespace control {
   using std::string;
   
   
-  /** 
-   * A neutral container internally holding 
-   * the functor used to implement the Command
-   */
-  typedef FunErasure<StoreFunction> CmdFunctor;
-  
-  
   /**
    * @todo Type-comment
    */

From 1620b8dcefe7eb098fccc88b24bdcccba20bfe34 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 09:32:22 +0200
Subject: [PATCH 124/368] WIP fixes to Apply<N>, but yet doesn't work...

---
 src/lib/meta/function-closure.hpp | 101 ++++++++++++++++++------------
 1 file changed, 61 insertions(+), 40 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 85a9c7ef7..c86958ba7 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -65,19 +65,38 @@ namespace typelist{
     struct Apply;
     
     
+    template<>                                            //__________________________________
+    struct Apply<0>                                      ///< Apply function without Arguments
+      {
+        template<typename RET, class FUN, class TUP>
+        static RET
+        invoke (FUN& f, TUP&)
+          {
+            return f ();
+          }
+        
+        template<typename RET, class FUN, class TUP>
+        static RET
+        bind (FUN& f, TUP&)
+          {
+            return std::tr1::bind (f);
+          }
+      };
+    
+    
     template<>                                            //_________________________________
     struct Apply<1>                                      ///< Apply function with 1 Argument
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f (element<1>(arg));
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg));
           }
@@ -87,18 +106,18 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<2>                                      ///< Apply function with 2 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -110,9 +129,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<3>                                      ///< Apply function with 3 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -120,9 +139,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -135,9 +154,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<4>                                      ///< Apply function with 4 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -146,9 +165,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -162,9 +181,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<5>                                      ///< Apply function with 5 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -174,9 +193,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -191,9 +210,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<6>                                      ///< Apply function with 6 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -204,9 +223,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -222,9 +241,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<7>                                      ///< Apply function with 7 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -236,9 +255,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -255,9 +274,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<8>                                      ///< Apply function with 8 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -270,9 +289,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -290,9 +309,9 @@ namespace typelist{
     template<>                                            //_________________________________
     struct Apply<9>                                      ///< Apply function with 9 Arguments
       {
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        invoke (FUN f, TUP & arg)
+        invoke (FUN& f, TUP & arg)
           {
             return f ( element<1>(arg)
                      , element<2>(arg)
@@ -306,9 +325,9 @@ namespace typelist{
                      ); 
           }
         
-        template<class FUN, typename RET, class TUP>
+        template<typename RET, class FUN, class TUP>
         static RET
-        bind (FUN f, TUP & arg)
+        bind (FUN& f, TUP & arg)
           {
             return std::tr1::bind (f, element<1>(arg)
                                     , element<2>(arg)
@@ -336,6 +355,8 @@ namespace typelist{
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
       
+      typedef function<Ret()> BoundFunc;
+      
       enum { ARG_CNT = count<typename Args::List>::value };
       
       
@@ -347,11 +368,11 @@ namespace typelist{
         : params_(args)
         { }
       
-      function<SIG>  bind (SIG& f)                 { return func::Apply<ARG_CNT>::bind (f, params_); }
-      function<SIG>  bind (function<SIG> const& f) { return func::Apply<ARG_CNT>::bind (f, params_); }
+      BoundFunc bind (SIG& f)           { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
+      BoundFunc bind (function<SIG>& f) { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
       
-      Ret      operator() (SIG& f)                 { return func::Apply<ARG_CNT>::invoke (f, params_); }
-      Ret      operator() (function<SIG> const& f) { return func::Apply<ARG_CNT>::invoke (f, params_); }
+      Ret operator() (SIG& f)           { return func::Apply<ARG_CNT>::template invoke<BoundFunc> (f, params_); }
+      Ret operator() (function<SIG>& f) { return func::Apply<ARG_CNT>::template invoke<BoundFunc> (f, params_); }
     };
   
   

From 95f0b26e3846225afce232f9eaed2324c9f0baa1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 18:06:07 +0200
Subject: [PATCH 125/368] start a type tuple unit test...

---
 src/lib/meta/tuple.hpp                  |   1 +
 tests/40components.tests                |   5 ++
 tests/lib/Makefile.am                   |   1 +
 tests/lib/meta/type-tuple-test.cpp      | 102 ++++++++++++++++++++++++
 tests/lib/meta/typelist-diagnostics.hpp |  12 ++-
 tests/lib/meta/typelist-manip-test.cpp  |  32 ++++----
 6 files changed, 137 insertions(+), 16 deletions(-)
 create mode 100644 tests/lib/meta/type-tuple-test.cpp

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index f95816824..ec8f5dd72 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -36,6 +36,7 @@
  ** might come in handy. 
  ** 
  ** @see control::CommandDef usage example
+ ** @see tuple-test.cpp
  ** @see typelist.hpp
  ** @see function.hpp
  ** @see generator.hpp
diff --git a/tests/40components.tests b/tests/40components.tests
index e28e5445f..85bfb6c2d 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -550,6 +550,11 @@ return: 0
 END
 
 
+PLANNED "TypeTuple_test" TypeTuple_test <<END
+return: 0
+END
+
+
 TEST "VectorTransfer_test" VectorTransfer_test <<END
 return: 0
 END
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 0c8f60501..19f4023b6 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -48,6 +48,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/mainsuite.cpp				\
 	$(testlib_srcdir)/meta/typelist-test.cpp         	\
 	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
+	$(testlib_srcdir)/meta/type-tuple-test.cpp    		\
 	$(testlib_srcdir)/meta/function-closure-test.cpp   	\
 	$(testlib_srcdir)/meta/function-erasure-test.cpp   	\
 	$(testlib_srcdir)/meta/generator-test.cpp        	\
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
new file mode 100644
index 000000000..a8f6b13dc
--- /dev/null
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -0,0 +1,102 @@
+/*
+  TypeTuple(Test)  -  checking type tuples and records based on them
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file type-tuple-test.cpp
+ ** Interconnection of typelists, type tuples and simple record
+ ** data types build on top of them.  
+ ** @todo define function-closure-test
+ **
+ ** @see lumiera::typelist::Tuple
+ ** @see tuple.hpp
+ ** @see function-closure.hpp
+ ** @see control::CmdClosure real world usage example
+ **
+ */
+
+
+#include "lib/test/run.hpp"
+#include "lib/meta/typelist.hpp"   ////////////TODO really?
+#include "lib/meta/tuple.hpp"
+#include "meta/typelist-diagnostics.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+#include <iostream>
+
+using ::test::Test;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test {
+      
+      
+      namespace { // test data
+        
+        
+        
+        typedef Types< Num<1>
+                     , Num<2>
+                     , Num<3>
+                     >::List List1;
+        typedef Types< Num<5>
+                     , Num<6>
+                     , Num<7>
+                     >::List List2;
+        
+        
+        template<class X> struct CountDown          { typedef NullType List; };
+        template<>        struct CountDown<Num<0> > { typedef Node<Num<0>, NullType> List; };
+        template<int I>   struct CountDown<Num<I> > { typedef Node<Num<I>, typename CountDown<Num<I-1> >::List> List; };
+        
+        
+        
+      } // (End) test data
+      
+      
+      
+      
+      
+      
+  /*************************************************************************
+   * @test //////////////////////////////////////////
+   *       - building combinations and permutations
+   */
+  class TypeTuple_test : public Test
+    {
+      virtual void
+      run (Arg) 
+        {
+          UNIMPLEMENTED ("verify type tuples");
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (TypeTuple_test, "unit common");
+  
+  
+  
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
index 800af1a39..63ccda325 100644
--- a/tests/lib/meta/typelist-diagnostics.hpp
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -36,6 +36,7 @@
 #define META_TYPELIST_DIAGNOSTICS_H
 
 
+#include "lib/meta/typelist.hpp"
 #include "lib/meta/generator.hpp"
 
 #include <boost/format.hpp>
@@ -68,9 +69,16 @@ namespace typelist{
   struct Config;
   
   
+        
+  /** helper for generating test lists */      
+  template<class X> struct CountDown          { typedef NullType List; };
+  template<>        struct CountDown<Num<0> > { typedef Node<Num<0>, NullType> List; };
+  template<int I>   struct CountDown<Num<I> > { typedef Node<Num<I>, typename CountDown<Num<I-1> >::List> List; };
   
-  namespace test {
-    namespace { // hidden internals
+  
+  
+  namespace test { //< unit tests covering typelist manipulating templates
+    namespace {   // hidden internals for diagnostics....
       
       using boost::format;
       
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index a9f2ac06a..3f742ba6c 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -42,7 +42,7 @@
 #include "lib/meta/generator.hpp"
 #include "lib/meta/typelistutil.hpp"
 #include "meta/typelist-diagnostics.hpp"
-#include "lib/util.hpp"
+//#include "lib/util.hpp"
 
 #include <boost/format.hpp>
 #include <iostream>
@@ -71,11 +71,7 @@ namespace test {
                      >::List List2;
         
         
-        template<class X> struct CountDown          { typedef NullType List; };
-        template<>        struct CountDown<Num<0> > { typedef Node<Num<0>, NullType> List; };
-        template<int I>   struct CountDown<Num<I> > { typedef Node<Num<I>, typename CountDown<Num<I-1> >::List> List; };
-        
-        
+        // see also the CountDown template in typelist-diagnostics.hpp...
         
       } // (End) test data
       
@@ -96,7 +92,8 @@ namespace test {
        */
       class TypeListManipl_test : public Test
         {
-          virtual void run(Arg arg) 
+          virtual void
+          run (Arg) 
             {
               check_diagnostics ();
               check_apply  ();
@@ -108,7 +105,8 @@ namespace test {
             }
           
           
-          void check_diagnostics ()
+          void
+          check_diagnostics ()
             {
               // Explanation: the DISPLAY macro expands as follows....
               typedef InstantiateChained<List1::List, Printer, NullP >  Contents_List1;
@@ -123,7 +121,8 @@ namespace test {
             }
           
           
-          void check_append ()
+          void
+          check_append ()
             {
               typedef Append<NullType, NullType> Append1;
               DISPLAY (Append1);
@@ -156,7 +155,8 @@ namespace test {
           template<class X> struct AddConst2          { typedef X        Type; };
           template<int I>   struct AddConst2<Num<I> > { typedef Num<I+2> Type; };
           
-          void check_apply ()
+          void
+          check_apply ()
             {
               typedef Apply<List1, AddConst2> Added2;
               DISPLAY (Added2);
@@ -166,14 +166,16 @@ namespace test {
           template<class X> struct IsEven          { enum {value = false };        };
           template<int I>   struct IsEven<Num<I> > { enum {value = (0 == I % 2) }; };
           
-          void check_filter ()
+          void
+          check_filter ()
             {
               typedef Filter<Append<List1,List2>::List, IsEven > FilterEven; 
               DISPLAY (FilterEven);
             }
           
           
-          void check_prefix ()
+          void
+          check_prefix ()
             {
               typedef PrefixAll<Num<11>,Num<22> > Prefix1;
               DISPLAY (Prefix1);
@@ -196,7 +198,8 @@ namespace test {
             }
           
           
-          void check_distribute()
+          void
+          check_distribute()
             {
               typedef Distribute<Num<11>, List1> Dist1;
               DISPLAY (Dist1);
@@ -213,7 +216,8 @@ namespace test {
             }
           
           
-          void check_combine()
+          void
+          check_combine()
             {
               typedef CountDown<Num<11> > Down;
               DISPLAY (Down);

From 0117e4bce5f009a17d74b0b0a8c7094cb9d6eb24 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 18:41:18 +0200
Subject: [PATCH 126/368] start a function-closure unit test...

---
 src/proc/control/command-closure.hpp     |  5 +-
 tests/lib/meta/function-closure-test.cpp | 71 ++++++++++++++++++++++--
 tests/lib/meta/typelist-diagnostics.hpp  | 13 ++++-
 3 files changed, 80 insertions(+), 9 deletions(-)

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index a01079ee8..56085e74d 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -192,8 +192,9 @@ namespace control {
           function<SIG> unboundF (unboundFunctor.getFun<SIG>());
           TupleApplicator<SIG> appli (params_);
                 
-          function<void()> boundFunctor = appli.bind (unboundF);
-          return CmdFunctor (boundFunctor);
+//          function<void()> boundFunctor = appli.bind (unboundF); ///////TODO: deactivated temporarily 
+          function<void()> boundFun;
+          return CmdFunctor (boundFun);
         }
       
       
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index b0be3edb5..1eeb7b634 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -32,8 +32,10 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/meta/typelist.hpp"   ////////////TODO really?
 #include "lib/meta/function-closure.hpp"
 #include "meta/dummy-functions.hpp"
+#include "meta/typelist-diagnostics.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
@@ -47,21 +49,78 @@ using std::cout;
 namespace lumiera {
 namespace typelist{
 namespace test {
-  
-  
-  
-  
+      
+      
+      namespace { // test data
+        
+        
+        
+        typedef Types< Num<1>
+                     , Num<2>
+                     , Num<3>
+                     >::List List1;
+        typedef Types< Num<5>
+                     , Num<6>
+                     , Num<7>
+                     >::List List2;
+        
+        
+        /** special test fun 
+         *  accepting the terrific Num types */
+        template<char i,char ii, char iii>
+        int
+        getNumberz (Num<i> one, Num<ii> two, Num<iii> three)
+          {
+            return one.o_ + two.o_ + three.o_;
+          }
+        
+      } // (End) test data
+      
+      
+      
+      
+      
+      
   /*************************************************************************
-   * @test //////////////////////////////////////////
-   *       - building combinations and permutations
+   * @test building a function closure for a given functor
+   *       and arguments passed in as tuple
+   *       //////////////////////////////////////////TODO
+   *       - building
    */
   class FunctionClosure_test : public Test
     {
       virtual void
       run (Arg) 
         {
+          check_diagnostics ();
+          check_append ();
+          
           UNIMPLEMENTED ("verify function closure utils");
         }
+      
+      
+      /** verify the test input data
+       *  @see TypeListManipl_test#check_diagnostics()
+       *       for an explanation of the DISPLAY macro
+       */
+      void
+      check_diagnostics ()
+        {
+          DISPLAY (List1);
+          DISPLAY (List2);
+          ;
+          ASSERT (6 == (getNumberz<1,2,3> (Num<1>(), Num<2>(), Num<3>())));
+          ASSERT (6 == (getNumberz<1,1,1> (Num<1>(), Num<1>(2), Num<1>(3))));
+        }
+      
+      
+      void
+      check_append ()
+        {
+          /////////////////////////////////////////////TODO      
+          typedef Append<Num<111>,List2>     Append7;
+          DISPLAY (Append7);
+        }
     };
   
   
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
index 63ccda325..c5bdd94a2 100644
--- a/tests/lib/meta/typelist-diagnostics.hpp
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -48,16 +48,27 @@ using boost::format;
 namespace lumiera {
 namespace typelist{
   
+  /** dummy interface / baseclass for diagnostics */
+  struct Numz
+    {
+      char o_;
+      Numz (char x =0) : o_(x) { }
+    };
+
+
   /** constant-wrapper type for debugging purposes,
    *  usable for generating lists of distinguishable types
    */
   template<int I>
-  struct Num
+  struct Num : Numz
     {
       enum{ VAL=I };
+      
+      Num (char x = char(I)) : Numz(x) { }
     };
   
   
+  
   /* some forwards used by config-flags-test.cpp */
   template<char bit> struct Flag;
   template< char f1

From 294c254f29317e9ddffbb904ea273a72b29432ac Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 23:17:22 +0200
Subject: [PATCH 127/368] Fix instantiation of Tuple datastructs

---
 src/lib/meta/tuple.hpp               | 27 +++++++++++++++++++++++++++
 src/lib/util.hpp                     | 10 ++++++++++
 src/proc/control/command-closure.hpp | 13 ++++++++++---
 3 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index ec8f5dd72..4cb0a49d8 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -294,6 +294,33 @@ namespace typelist{
     };
   
   
+  template<>
+  struct Tuple<Types<> >
+    : Tuple<NullType>
+    {
+      enum  { SIZE = 0 };
+      typedef Tuple<NullType> TupleNull;
+      
+      Tuple ( NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            , NullType =NullType()
+            )
+        { } ///< end recursion of chained ctor calls
+      
+      
+      template<uint> struct ShiftedTuple       { typedef TupleNull Type; };
+      
+      template<uint> TupleNull&  getShifted () { return static_cast<TupleNull&> (*this); }
+      template<uint> NullType&        getAt () { return getHead(); }
+    };
+  
+  
   
   namespace tuple { // some convenience access functions
   
diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index a835fc443..40845283f 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -190,6 +190,16 @@ namespace util {
   }
   
   
+  /** shortcut to save some typing when having to define
+   *  const and non-const variants of member functions
+   */
+  template<class OBJ>
+  OBJ*
+  unConst (const OBJ* o)
+  {
+    return const_cast<OBJ*> (o);
+  }
+  
   
   
   /** produce an identifier based on the given string.
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 56085e74d..56efd3302 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -41,6 +41,7 @@
 #include "lib/meta/function-closure.hpp"
 #include "lib/meta/function-erasure.hpp"
 #include "lib/meta/tuple.hpp"
+#include "lib/util.hpp"
 
 #include <tr1/memory>
 #include <tr1/functional>
@@ -59,6 +60,7 @@ namespace control {
   
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
+  using util::unConst;
   using std::string;
   using std::ostream;
   using std::tr1::function;
@@ -110,7 +112,8 @@ namespace control {
   class ParamAccessor
     : public BASE
     {
-      TY& element() { return BASE::template getAt<idx>(); }
+      TY      & element()        { return          BASE::template getAt<idx>(); }
+      TY const& element()  const { return unConst(this)->template getAt<idx>(); }
       
     public:
         
@@ -123,7 +126,7 @@ namespace control {
       string
       dump (string const& prefix = "(")  const
         {
-          return BASE::dump (prefix+element());
+          return BASE::dump (prefix+element()+",");
         }
       
       
@@ -145,7 +148,11 @@ namespace control {
       string
       dump (string const& prefix)  const
         { 
-          return prefix+")";
+          if (1 < prefix.length())
+            // remove trailing comma...
+            return prefix.substr (0, prefix.length()-1) +")";
+          else
+            return prefix+")";
         }
       
     };

From ad7c326c9c3bfc3ba86653c7e47a319172ba0276 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 23:18:02 +0200
Subject: [PATCH 128/368] got basic diagnostics for type tuples working

---
 src/lib/meta/tuple.hpp                  |  12 ++
 src/lib/meta/util.hpp                   |  18 +++
 tests/lib/meta/type-tuple-test.cpp      | 164 +++++++++++++++++++++---
 tests/lib/meta/typelist-diagnostics.hpp |  44 +++++--
 tests/lib/meta/typelist-manip-test.cpp  |   2 +-
 5 files changed, 210 insertions(+), 30 deletions(-)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 4cb0a49d8..e10d86abe 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -49,6 +49,7 @@
 
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelistutil.hpp"
+#include "lib/meta/util.hpp"
 
 
 
@@ -443,6 +444,17 @@ namespace typelist{
     
   }
       
+    
+  /** Trait template for detecting a type tuple */
+  template<typename TUP>
+  class is_Tuple
+    {
+      template<class X>  struct Check             { typedef No_t It;  };
+      template<class TY> struct Check<Tuple<TY> > { typedef Yes_t It; };
+      
+    public: 
+      static const bool value = (sizeof(Yes_t)==sizeof(typename Check<TUP>::It));
+    };
 
   
   /**
diff --git a/src/lib/meta/util.hpp b/src/lib/meta/util.hpp
index b01a412fa..f824ee6b6 100644
--- a/src/lib/meta/util.hpp
+++ b/src/lib/meta/util.hpp
@@ -70,6 +70,24 @@ namespace lumiera {
       };
     
     
+    /** Trait template for detecting a typelist type.
+     *  For example, this allows to write specialisations with the help of
+     *  boost::enable_if
+     */
+    template<typename TY>
+    class is_Typelist
+      {
+        template<class X>
+        static Yes_t check(typename X::List *);
+        template<class>
+        static No_t  check(...);
+        
+      public: 
+        static const bool value = (sizeof(Yes_t)==sizeof(check<TY>(0)));
+      };
+    
+    
+    
   } // namespace typelist
   
 } // namespace lumiera
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index a8f6b13dc..b0e045582 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -38,48 +38,152 @@
 #include "lib/meta/typelist.hpp"   ////////////TODO really?
 #include "lib/meta/tuple.hpp"
 #include "meta/typelist-diagnostics.hpp"
-//#include "lib/util.hpp"
+#include "lib/util.hpp"
 
-//#include <boost/format.hpp>
+#include <boost/utility/enable_if.hpp>
+#include <boost/format.hpp>
 #include <iostream>
 
 using ::test::Test;
+  
+using boost::enable_if;
+using boost::format;
+using boost::str;
+using util::unConst;
 using std::string;
 using std::cout;
+using std::endl;
 
 
 namespace lumiera {
 namespace typelist{
 namespace test {
       
+  
       
       namespace { // test data
         
         
         
         typedef Types< Num<1>
-                     , Num<2>
                      , Num<3>
-                     >::List List1;
-        typedef Types< Num<5>
-                     , Num<6>
-                     , Num<7>
-                     >::List List2;
-        
-        
-        template<class X> struct CountDown          { typedef NullType List; };
-        template<>        struct CountDown<Num<0> > { typedef Node<Num<0>, NullType> List; };
-        template<int I>   struct CountDown<Num<I> > { typedef Node<Num<I>, typename CountDown<Num<I-1> >::List> List; };
+                     , Num<5>
+                     >          Types1;
+        typedef Types< Num<2>
+                     , Num<4>
+                     >          Types2;
+        typedef Types< Num<7> > Types3;
         
         
         
       } // (End) test data
+  
+  
+  namespace { // Diagnostics
+    
+    
+    
+    template<int i>
+    string
+    showTupElement(Num<i> o) 
+    {
+      static format   constElm("(%i)");
+      static format changedElm("{%i}");
       
-      
-      
-      
-      
-      
+      return str ( (o.o_==i? constElm:changedElm) % int(o.o_));
+    }
+    
+    template<typename T>
+    string
+    showTupElement(T x)
+    {
+      return string(x);
+    }
+    
+    
+    /**
+     * Helper template which acts as an "accessor".
+     * Using the BuildTupleAccessor, we create a linear chain
+     * of such TupleElementDisplayers as subclass of a given tuple type.
+     * Here this technique is just used for dumping the tuples data fields,
+     * but e.g. the control::Closure uses the same principle for manipulating
+     * the individual datafields of an function argument tuple.  
+     */
+    template
+      < typename TY
+      , class BASE
+      , class TUP
+      , uint idx
+      >
+    class TupleElementDisplayer
+      : public BASE
+      {
+        TY      & element()        { return BASE::template getAt<idx>(); }
+        TY const& element()  const { return unConst(this)->template getAt<idx>(); }
+        
+      public:
+        TupleElementDisplayer(TUP const& tuple) : BASE(tuple) {}
+        
+        string
+        dump (string const& prefix = "(")  const
+          {
+            return BASE::dump (prefix+showTupElement(element())+",");
+          }
+      };
+    
+    template<class TUP>
+    class TupleElementDisplayer<NullType, TUP, TUP, 0>
+      : public TUP
+      {
+      public:
+        TupleElementDisplayer(TUP const& tuple) : TUP(tuple) {}
+        
+        
+      protected:
+        
+        string
+        dump (string const& prefix)  const
+          { 
+            if (1 < prefix.length())
+              // removing the trailing comma
+              return prefix.substr (0, prefix.length()-1) +")";
+            else
+              return prefix+")";
+          }
+      };
+    
+  } // (END) Diagnostics Helper
+  
+  
+  
+  /* ===== printing Tuple types and contents ===== */ 
+    
+  template<typename TYPES>
+  string
+  showDump (Tuple<TYPES> const& tuple)
+  {
+    typedef BuildTupleAccessor<TYPES,TupleElementDisplayer> BuildAccessor;
+    typedef typename BuildAccessor::Accessor Displayer;
+    
+    return " Tup" + Displayer(tuple).dump();
+  }
+  
+  template<typename TUP>
+  typename enable_if< is_Tuple<TUP>,
+    string          >::type
+  showType ()
+  {
+    typedef InstantiateChained<typename TUP::ArgList, Printer, NullP>  DumpPrinter;
+    return "TYPES-<>"
+         + DumpPrinter::print();
+  }
+  
+  // see the macros DISPLAY and DUMPVAL defined in typelist-diagnostics.hpp
+  
+  
+  
+  
+  
   /*************************************************************************
    * @test //////////////////////////////////////////
    *       - building combinations and permutations
@@ -89,8 +193,32 @@ namespace test {
       virtual void
       run (Arg) 
         {
+          check_diagnostics();
+          
           UNIMPLEMENTED ("verify type tuples");
         }
+      
+      
+      /** verify the test input data
+       *  @see TypeListManipl_test#check_diagnostics()
+       *       for an explanation of the DISPLAY macro
+       */
+      void
+      check_diagnostics ()
+        {
+          typedef Types1::List L1;
+          typedef Types2::List L2;
+          typedef Types3::List L3;
+          
+          DISPLAY (L1);
+          DISPLAY (L2);
+          DISPLAY (L3);
+          
+          typedef Tuple<Types3> Tup3;
+          
+          DISPLAY (Tup3);
+          DUMPVAL (Tup3());
+        }
     };
   
   
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
index c5bdd94a2..201c1f4fd 100644
--- a/tests/lib/meta/typelist-diagnostics.hpp
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -38,11 +38,16 @@
 
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/generator.hpp"
+#include "lib/meta/util.hpp"
 
 #include <boost/format.hpp>
+#include <boost/utility/enable_if.hpp>
+
+
 
 using std::string;
 using boost::format;
+using boost::enable_if;
 
 
 namespace lumiera {
@@ -54,8 +59,8 @@ namespace typelist{
       char o_;
       Numz (char x =0) : o_(x) { }
     };
-
-
+  
+  
   /** constant-wrapper type for debugging purposes,
    *  usable for generating lists of distinguishable types
    */
@@ -80,7 +85,7 @@ namespace typelist{
   struct Config;
   
   
-        
+  
   /** helper for generating test lists */      
   template<class X> struct CountDown          { typedef NullType List; };
   template<>        struct CountDown<Num<0> > { typedef Node<Num<0>, NullType> List; };
@@ -88,6 +93,7 @@ namespace typelist{
   
   
   
+  
   namespace test { //< unit tests covering typelist manipulating templates
     namespace {   // hidden internals for diagnostics....
       
@@ -165,17 +171,33 @@ namespace typelist{
         };
       
       
-#define DIAGNOSE(LIST) \
-        typedef InstantiateChained<LIST::List, Printer, NullP>  Contents_##LIST;
-                     
-#define DISPLAY(NAME)  \
-        DIAGNOSE(NAME); cout << STRINGIFY(NAME) << "\t:" << Contents_##NAME::print() << "\n";
-      
-      
-      
     } // (End) internal defs
     
     
     
+    /* ===== printing types and contents ===== */ 
+    
+    template<typename TYPES>
+    typename enable_if< is_Typelist<TYPES>,
+      string          >::type
+    showType ()
+    {
+      typedef InstantiateChained<typename TYPES::List, Printer, NullP>  DumpPrinter;
+      return DumpPrinter::print();
+    }
+    
+    //  Note: we define overloads of this function for other types, especially Tuples
+    
+    
+#define DISPLAY(NAME)  \
+        cout << STRINGIFY(NAME) << "\t:" << showType<NAME>() << "\n";
+    
+#define DUMPVAL(NAME)  \
+        cout << STRINGIFY(NAME) << "\t:" << showDump (NAME) << "\n";
+    
+    
+    
+    
+    
 }}} // namespace lumiera::typelist::test
 #endif
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index 3f742ba6c..f3096430e 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -108,7 +108,7 @@ namespace test {
           void
           check_diagnostics ()
             {
-              // Explanation: the DISPLAY macro expands as follows....
+              // Explanation: the DISPLAY macro results in the following definition....
               typedef InstantiateChained<List1::List, Printer, NullP >  Contents_List1;
               cout << "List1" << "\t:" << Contents_List1::print() << "\n";
               

From 30ac23fb2832bada9890473a359365970761af5d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Jun 2009 23:39:45 +0200
Subject: [PATCH 129/368] factor out the tuple diagnostics functions

---
 tests/lib/meta/function-closure-test.cpp |   1 +
 tests/lib/meta/tuple-diagnostics.hpp     | 163 +++++++++++++++++++++++
 tests/lib/meta/type-tuple-test.cpp       | 120 +----------------
 tests/lib/meta/typelist-diagnostics.hpp  |   2 +-
 4 files changed, 172 insertions(+), 114 deletions(-)
 create mode 100644 tests/lib/meta/tuple-diagnostics.hpp

diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 1eeb7b634..02629b76a 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -36,6 +36,7 @@
 #include "lib/meta/function-closure.hpp"
 #include "meta/dummy-functions.hpp"
 #include "meta/typelist-diagnostics.hpp"
+#include "meta/tuple-diagnostics.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/lib/meta/tuple-diagnostics.hpp b/tests/lib/meta/tuple-diagnostics.hpp
new file mode 100644
index 000000000..283187044
--- /dev/null
+++ b/tests/lib/meta/tuple-diagnostics.hpp
@@ -0,0 +1,163 @@
+/*
+  TUPLE-DIAGNOSTICS  -  helper for diagnostics of type tuples
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file tuple-diagnostics.hpp
+ ** an extension to typelist-diagnostics.hpp, allowing to dump the \em contents
+ ** of a Tuple datatype. Any type defining an operator string() may be printed
+ ** when used as Tuple member type; special formatting is provided for the
+ ** Num<int> test types, which makes typelist and tuples of these types 
+ ** a good candidate for unit tests.
+ **
+ ** @see type-tuple-test.cpp
+ ** @see typelist-manip-test.cpp
+ **
+ */
+#ifndef META_TUPLE_DIAGNOSTICS_H
+#define META_TUPLE_DIAGNOSTICS_H
+
+
+#include "meta/typelist-diagnostics.hpp"
+#include "lib/meta/tuple.hpp"
+
+#include <boost/utility/enable_if.hpp>
+#include <boost/format.hpp>
+#include <string>
+
+using std::string;
+using boost::str;
+using boost::format;
+using boost::enable_if;
+using util::unConst;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test    {
+  
+  
+  namespace { // Diagnostics
+    
+    
+    
+    template<int i>
+    string
+    showTupElement(Num<i> o) 
+    {
+      static format   constElm("(%i)");
+      static format changedElm("{%i}");
+      
+      return str ( (o.o_==i? constElm:changedElm) % int(o.o_));
+    }
+    
+    template<typename T>
+    string
+    showTupElement(T x)
+    {
+      return string(x);
+    }
+    
+    
+    /**
+     * Helper template which acts as an "accessor".
+     * Using the BuildTupleAccessor, we create a linear chain
+     * of such TupleElementDisplayers as subclass of a given tuple type.
+     * Here this technique is just used for dumping the tuples data fields,
+     * but e.g. the control::Closure uses the same principle for manipulating
+     * the individual datafields of an function argument tuple.  
+     */
+    template
+      < typename TY
+      , class BASE
+      , class TUP
+      , uint idx
+      >
+    class TupleElementDisplayer
+      : public BASE
+      {
+        TY      & element()        { return BASE::template getAt<idx>(); }
+        TY const& element()  const { return unConst(this)->template getAt<idx>(); }
+        
+      public:
+        TupleElementDisplayer(TUP const& tuple) : BASE(tuple) {}
+        
+        string
+        dump (string const& prefix = "(")  const
+          {
+            return BASE::dump (prefix+showTupElement(element())+",");
+          }
+      };
+    
+    template<class TUP>
+    class TupleElementDisplayer<NullType, TUP, TUP, 0>
+      : public TUP
+      {
+      public:
+        TupleElementDisplayer(TUP const& tuple) : TUP(tuple) {}
+        
+        
+      protected:
+        
+        string
+        dump (string const& prefix)  const
+          { 
+            if (1 < prefix.length())
+              // removing the trailing comma
+              return prefix.substr (0, prefix.length()-1) +")";
+            else
+              return prefix+")";
+          }
+      };
+    
+  } // (END) Diagnostics Helper
+  
+  
+  
+  /* ===== printing Tuple types and contents ===== */ 
+    
+  template<typename TYPES>
+  string
+  showDump (Tuple<TYPES> const& tuple)
+  {
+    typedef BuildTupleAccessor<TYPES,TupleElementDisplayer> BuildAccessor;
+    typedef typename BuildAccessor::Accessor Displayer;
+    
+    return "...Tuple" + Displayer(tuple).dump();
+  }
+  
+  template<typename TUP>
+  typename enable_if< is_Tuple<TUP>,
+    string          >::type
+  showType ()
+  {
+    typedef InstantiateChained<typename TUP::ArgList, Printer, NullP>  DumpPrinter;
+    return "TYPES-<>"
+         + DumpPrinter::print();
+  }
+  
+  // see the macros DISPLAY and DUMPVAL defined in typelist-diagnostics.hpp
+  
+  
+  
+  
+}}} // namespace lumiera::typelist::test
+#endif
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index b0e045582..c3c97a6fb 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -38,7 +38,7 @@
 #include "lib/meta/typelist.hpp"   ////////////TODO really?
 #include "lib/meta/tuple.hpp"
 #include "meta/typelist-diagnostics.hpp"
-#include "lib/util.hpp"
+#include "meta/tuple-diagnostics.hpp"
 
 #include <boost/utility/enable_if.hpp>
 #include <boost/format.hpp>
@@ -46,10 +46,6 @@
 
 using ::test::Test;
   
-using boost::enable_if;
-using boost::format;
-using boost::str;
-using util::unConst;
 using std::string;
 using std::cout;
 using std::endl;
@@ -59,12 +55,11 @@ namespace lumiera {
 namespace typelist{
 namespace test {
       
-  
+      
       
       namespace { // test data
         
         
-        
         typedef Types< Num<1>
                      , Num<3>
                      , Num<5>
@@ -79,109 +74,6 @@ namespace test {
       } // (End) test data
   
   
-  namespace { // Diagnostics
-    
-    
-    
-    template<int i>
-    string
-    showTupElement(Num<i> o) 
-    {
-      static format   constElm("(%i)");
-      static format changedElm("{%i}");
-      
-      return str ( (o.o_==i? constElm:changedElm) % int(o.o_));
-    }
-    
-    template<typename T>
-    string
-    showTupElement(T x)
-    {
-      return string(x);
-    }
-    
-    
-    /**
-     * Helper template which acts as an "accessor".
-     * Using the BuildTupleAccessor, we create a linear chain
-     * of such TupleElementDisplayers as subclass of a given tuple type.
-     * Here this technique is just used for dumping the tuples data fields,
-     * but e.g. the control::Closure uses the same principle for manipulating
-     * the individual datafields of an function argument tuple.  
-     */
-    template
-      < typename TY
-      , class BASE
-      , class TUP
-      , uint idx
-      >
-    class TupleElementDisplayer
-      : public BASE
-      {
-        TY      & element()        { return BASE::template getAt<idx>(); }
-        TY const& element()  const { return unConst(this)->template getAt<idx>(); }
-        
-      public:
-        TupleElementDisplayer(TUP const& tuple) : BASE(tuple) {}
-        
-        string
-        dump (string const& prefix = "(")  const
-          {
-            return BASE::dump (prefix+showTupElement(element())+",");
-          }
-      };
-    
-    template<class TUP>
-    class TupleElementDisplayer<NullType, TUP, TUP, 0>
-      : public TUP
-      {
-      public:
-        TupleElementDisplayer(TUP const& tuple) : TUP(tuple) {}
-        
-        
-      protected:
-        
-        string
-        dump (string const& prefix)  const
-          { 
-            if (1 < prefix.length())
-              // removing the trailing comma
-              return prefix.substr (0, prefix.length()-1) +")";
-            else
-              return prefix+")";
-          }
-      };
-    
-  } // (END) Diagnostics Helper
-  
-  
-  
-  /* ===== printing Tuple types and contents ===== */ 
-    
-  template<typename TYPES>
-  string
-  showDump (Tuple<TYPES> const& tuple)
-  {
-    typedef BuildTupleAccessor<TYPES,TupleElementDisplayer> BuildAccessor;
-    typedef typename BuildAccessor::Accessor Displayer;
-    
-    return " Tup" + Displayer(tuple).dump();
-  }
-  
-  template<typename TUP>
-  typename enable_if< is_Tuple<TUP>,
-    string          >::type
-  showType ()
-  {
-    typedef InstantiateChained<typename TUP::ArgList, Printer, NullP>  DumpPrinter;
-    return "TYPES-<>"
-         + DumpPrinter::print();
-  }
-  
-  // see the macros DISPLAY and DUMPVAL defined in typelist-diagnostics.hpp
-  
-  
-  
   
   
   /*************************************************************************
@@ -214,10 +106,12 @@ namespace test {
           DISPLAY (L2);
           DISPLAY (L3);
           
-          typedef Tuple<Types3> Tup3;
+          typedef Tuple<Types1> Tup1;
+          Tup1 tup1x (Num<1>(11));
           
-          DISPLAY (Tup3);
-          DUMPVAL (Tup3());
+          DISPLAY (Tup1);     // prints the type
+          DUMPVAL (Tup1());   // prints the contents
+          DUMPVAL (tup1x);
         }
     };
   
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
index 201c1f4fd..e2a806776 100644
--- a/tests/lib/meta/typelist-diagnostics.hpp
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -40,8 +40,8 @@
 #include "lib/meta/generator.hpp"
 #include "lib/meta/util.hpp"
 
-#include <boost/format.hpp>
 #include <boost/utility/enable_if.hpp>
+#include <boost/format.hpp>
 
 
 

From 231834d2e96c89c3fe6be43cc9b5736187fe1d91 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 21 Jun 2009 02:03:22 +0200
Subject: [PATCH 130/368] basic tuple creation and outline of the remainder of
 the test

---
 src/lib/meta/tuple.hpp                  | 65 +++++++++++++++++++
 tests/lib/meta/tuple-diagnostics.hpp    | 37 ++++++++++-
 tests/lib/meta/type-tuple-test.cpp      | 86 +++++++++++++++++++++++--
 tests/lib/meta/typelist-diagnostics.hpp |  7 ++
 4 files changed, 189 insertions(+), 6 deletions(-)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index e10d86abe..0f534b8c1 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -253,6 +253,7 @@ namespace typelist{
       typedef Tuple<TailType>     Tail;
       enum  { SIZE = count<ArgList>::value };
       
+      /** standard ctor: create from values */
       Tuple ( T1 a1 =T1()
             , T2 a2 =T2()
             , T3 a3 =T3()
@@ -266,6 +267,12 @@ namespace typelist{
         : Tuple<ArgList>(a1, Tuple<TailType>(a2,a3,a4,a5,a6,a7,a8,a9))
         { }
       
+      /** shortcut: allow copy construction from a tuple
+       *  which is rather defined by a list type */
+      Tuple (Tuple<ArgList> const& listTuple)
+        : Tuple<ArgList> (listTuple)
+        { }
+      
       using Tuple<ArgList>::getHead;
       using Tuple<ArgList>::getTail;
       
@@ -455,6 +462,64 @@ namespace typelist{
     public: 
       static const bool value = (sizeof(Yes_t)==sizeof(typename Check<TUP>::It));
     };
+  
+  /** Trait template detecting especially tuples
+   *  built directly on top of a Typelist */
+  template<typename TUP>
+  class is_TupleListType
+    {
+      template<class X>          
+      struct Check
+        {
+          enum{ result = sizeof(No_t)};
+        };
+      
+      template<class N>
+      struct Check<Tuple<N> >
+      {
+        template<class H, class T>
+        Yes_t static check(Node<H,T>*);
+        Yes_t static check(NullType*);
+        No_t  static check(...);
+        
+        enum{ result = sizeof(check( (N*)0)) };
+      };
+      
+    public: 
+      static const bool value = (sizeof(Yes_t)== Check<TUP>::result);
+    };
+  
+  /** Trait template to discern plain tuples and list-type tuples */
+  template<typename TUP>
+  struct is_TuplePlain
+    {
+      static const bool value =     is_Tuple<TUP>::value
+                                && !is_TupleListType<TUP>::value;
+    };
+  
+  /** Trait template detecting an empty tuple type */
+  template<typename TUP>
+  class is_NullTuple
+    {
+      template<class X>          
+      struct Check
+        {
+          enum{ result = sizeof(No_t)};
+        };
+      
+      template<class TY>
+      struct Check<Tuple<TY> >
+      {
+        Yes_t check(Types<>*);
+        Yes_t check(NullType*);
+        No_t  check(...);
+        
+        enum{ result = sizeof(check( (TY*)0)) };
+      };
+      
+    public: 
+      static const bool value = (sizeof(Yes_t)== Check<TUP>::result);
+    };
 
   
   /**
diff --git a/tests/lib/meta/tuple-diagnostics.hpp b/tests/lib/meta/tuple-diagnostics.hpp
index 283187044..63c176503 100644
--- a/tests/lib/meta/tuple-diagnostics.hpp
+++ b/tests/lib/meta/tuple-diagnostics.hpp
@@ -40,6 +40,7 @@
 #include "lib/meta/tuple.hpp"
 
 #include <boost/utility/enable_if.hpp>
+#include <boost/lexical_cast.hpp>
 #include <boost/format.hpp>
 #include <string>
 
@@ -47,6 +48,7 @@ using std::string;
 using boost::str;
 using boost::format;
 using boost::enable_if;
+using boost::lexical_cast;
 using util::unConst;
 
 
@@ -69,6 +71,12 @@ namespace test    {
       return str ( (o.o_==i? constElm:changedElm) % int(o.o_));
     }
     
+    string
+    showTupElement(int i)
+    {
+      return lexical_cast<string>(i);
+    }
+    
     template<typename T>
     string
     showTupElement(T x)
@@ -135,7 +143,8 @@ namespace test    {
   /* ===== printing Tuple types and contents ===== */ 
     
   template<typename TYPES>
-  string
+  typename enable_if< is_TuplePlain<Tuple<TYPES> >,
+    string          >::type
   showDump (Tuple<TYPES> const& tuple)
   {
     typedef BuildTupleAccessor<TYPES,TupleElementDisplayer> BuildAccessor;
@@ -144,8 +153,22 @@ namespace test    {
     return "...Tuple" + Displayer(tuple).dump();
   }
   
+  template<typename TYPES>
+  typename enable_if< is_TupleListType<Tuple<TYPES> >,
+    string          >::type
+  showDump (Tuple<TYPES> const& tuple)
+  {
+    typedef typename Tuple<TYPES>::Type TypeSeq;
+    Tuple<TypeSeq> plainTuple (tuple);
+    
+    typedef BuildTupleAccessor<TypeSeq, TupleElementDisplayer> BuildAccessor;
+    typedef typename BuildAccessor::Accessor Displayer;
+    
+    return "...Tuple" + Displayer(plainTuple).dump();
+  }
+  
   template<typename TUP>
-  typename enable_if< is_Tuple<TUP>,
+  typename enable_if< is_TuplePlain<TUP>,
     string          >::type
   showType ()
   {
@@ -154,6 +177,16 @@ namespace test    {
          + DumpPrinter::print();
   }
   
+  template<typename TUP>
+  typename enable_if< is_TupleListType<TUP>,
+    string          >::type
+  showType ()
+  {
+    typedef InstantiateChained<typename TUP::ArgList, Printer, NullP>  DumpPrinter;
+    return "TYPES-[]"
+         + DumpPrinter::print();
+  }
+  
   // see the macros DISPLAY and DUMPVAL defined in typelist-diagnostics.hpp
   
   
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index c3c97a6fb..44e79aab3 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -77,8 +77,17 @@ namespace test {
   
   
   /*************************************************************************
-   * @test //////////////////////////////////////////
-   *       - building combinations and permutations
+   * @test Cover various aspects of the type tuple. 
+   *       Check the metaprogramming behaviour... 
+   *       - build a tuple type from an existing typelist
+   *       - create sub tuple types and types with shifted parameters
+   *       Additionally, check the behaviour when creating tuple instances
+   *       at runtime. Effectively, these are simple record types, which are
+   *       synthesised by recursion over the related typelist.
+   *       - create tuples from a list of values
+   *       - copy and copy construct
+   *       - access the "head" and access values by numeric index
+   *       - create a tuple with shifted values 
    */
   class TypeTuple_test : public Test
     {
@@ -86,8 +95,12 @@ namespace test {
       run (Arg) 
         {
           check_diagnostics();
-          
-          UNIMPLEMENTED ("verify type tuples");
+          check_tuple_from_Typelist();
+          check_sub_tuple_types();
+          check_shiftedTuple();
+          check_tuple_creation();
+          check_tuple_copy();
+          check_value_access();
         }
       
       
@@ -113,6 +126,71 @@ namespace test {
           DUMPVAL (Tup1());   // prints the contents
           DUMPVAL (tup1x);
         }
+      
+      
+      void
+      check_tuple_from_Typelist()
+        {
+          typedef Types1::List L1;  // starting from an existing Typelist...
+          
+          typedef Tuple<L1> T_L1;           // ListType based tuple type
+          typedef Tuple<L1>::ThisTuple T1;  // corresponding plain tuple type
+          typedef Tuple<L1>::Type Type1;    // extract the underlying type sequence
+          
+          DISPLAY (Type1);
+          DISPLAY (T_L1);
+          DISPLAY (T1);
+          
+          T_L1 tup1 (Num<1>(8));            // both flavours can be created at runtime
+          T1   tup2 (Num<1>(9));            // (and we provide an explicit value for the 1st element)
+          DUMPVAL (tup1);
+          DUMPVAL (tup2);
+          
+          typedef Tuple<Node<int, L1> > Prepend;
+          DISPLAY (Prepend);                // another ListType based tuple created by prepending
+          
+          Prepend prepend (22, tup2);       // but note: the ListType based tuple has an "(head,tail)" style ctor
+          DUMPVAL (prepend);                // ... and in construction, tup2 has been copied and coerced to ListType style
+        }
+      
+      
+      void
+      check_sub_tuple_types()
+        {
+          UNIMPLEMENTED ("verify head and tail type");
+        }
+      
+      
+      void
+      check_shiftedTuple()
+        {
+          UNIMPLEMENTED ("verify shifted type tuple");
+        }
+      
+      
+      void
+      check_tuple_creation()
+        {
+          UNIMPLEMENTED ("verify tuple creation");
+          
+        }
+      
+      
+      void
+      check_tuple_copy()
+        {
+          UNIMPLEMENTED ("verify tuple copying and assignment");
+          
+        }
+      
+      
+      void
+      check_value_access()
+        {
+          UNIMPLEMENTED ("verify tuple value access");
+          
+        }
+
     };
   
   
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
index e2a806776..a5b77ac71 100644
--- a/tests/lib/meta/typelist-diagnostics.hpp
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -133,6 +133,13 @@ namespace typelist{
           static string print () { return str( fmt % uint(Fl) % BASE::print()); }
         };
       
+      template<class BASE>
+      struct Printer<int, BASE>  ///< display the presence of a plain int in the typelist
+        : BASE
+        {
+          static string print () { return str( fmt % 'i' % BASE::print()); }
+        };
+      
       
       
       /** call the debug-print for a typelist

From 2a182a20164b335738ba729ca2e3a718136fd17f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 21 Jun 2009 02:51:37 +0200
Subject: [PATCH 131/368] outline of the function-closure-test

---
 tests/lib/meta/function-closure-test.cpp | 79 +++++++++++++++++++++---
 1 file changed, 69 insertions(+), 10 deletions(-)

diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 02629b76a..9576a2dcf 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -32,7 +32,10 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/meta/typelist.hpp"   ////////////TODO really?
+#include "lib/test/test-helper.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/function.hpp"
 #include "lib/meta/function-closure.hpp"
 #include "meta/dummy-functions.hpp"
 #include "meta/typelist-diagnostics.hpp"
@@ -42,9 +45,13 @@
 //#include <boost/format.hpp>
 #include <iostream>
 
+using lib::test::showSizeof;
+using lib::test::showType;
+
 using ::test::Test;
 using std::string;
 using std::cout;
+using std::endl;
 
 
 namespace lumiera {
@@ -85,8 +92,12 @@ namespace test {
   /*************************************************************************
    * @test building a function closure for a given functor
    *       and arguments passed in as tuple
-   *       //////////////////////////////////////////TODO
-   *       - building
+   *       - accessing signatures as typelists
+   *       - apply free function to tuple
+   *       - apply functor to tuple 
+   *       - bind free function to tuple
+   *       - bind functor to tuple
+   *       - build a simple "tuple closure"
    */
   class FunctionClosure_test : public Test
     {
@@ -94,9 +105,12 @@ namespace test {
       run (Arg) 
         {
           check_diagnostics ();
-          check_append ();
-          
-          UNIMPLEMENTED ("verify function closure utils");
+          check_signatureTypeManip ();
+          check_applyFree ();
+          check_applyFunc ();
+          check_bindFree  ();
+          check_bindFunc  ();
+          build_closure ();
         }
       
       
@@ -116,11 +130,56 @@ namespace test {
       
       
       void
-      check_append ()
+      check_signatureTypeManip ()
         {
-          /////////////////////////////////////////////TODO      
-          typedef Append<Num<111>,List2>     Append7;
-          DISPLAY (Append7);
+          typedef int someFunc(Num<5>,Num<9>);
+          typedef FunctionSignature<function<someFunc> >::Ret RetType;  // should be int
+          typedef FunctionSignature<function<someFunc> >::Args Args;
+          DISPLAY (Args);
+          
+          typedef Prepend<Num<1>, Args>::Tuple NewArgs;             // manipulate the argument type(s)
+          DISPLAY (NewArgs);
+          
+          typedef FunctionTypedef<RetType,NewArgs>::Sig NewSig;  // re-build a new function signature
+          
+          NewSig& fun =  getNumberz<1,5,9>;                    //...which is compatible to an existing real function signature!
+          
+          ASSERT (1+5+9 == fun(Num<1>(), Num<5>(), Num<9>()));
+        }
+      
+      
+      void
+      check_applyFree ()
+        {
+          UNIMPLEMENTED ("verify apply free function to tuple");
+        }
+      
+      
+      void
+      check_applyFunc ()
+        {
+          UNIMPLEMENTED ("verify apply functor to tuple");
+        }
+      
+      
+      void
+      check_bindFree ()
+        {
+          UNIMPLEMENTED ("verify bind free function to tuple");
+        }
+      
+      
+      void
+      check_bindFunc ()
+        {
+          UNIMPLEMENTED ("verify bind functor to tuple");
+        }
+      
+      
+      void
+      build_closure ()
+        {
+          UNIMPLEMENTED ("build a simple tuple closure");
         }
     };
   

From c3768b93a1b84122df670b2ae342bcd9fbd5d2cc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 21 Jun 2009 08:38:24 +0200
Subject: [PATCH 132/368] function closure utils finished and pass test

---
 src/lib/meta/function-closure.hpp        | 178 +++++++++++++++------
 src/lib/meta/tuple.hpp                   |  34 ++++-
 src/proc/control/command-closure.hpp     |   3 +-
 tests/40components.tests                 |  14 +-
 tests/43session.tests                    |   2 +-
 tests/lib/meta/function-closure-test.cpp | 187 +++++++++++++++++++++--
 tests/lib/meta/tuple-diagnostics.hpp     |   7 +-
 tests/lib/meta/type-tuple-test.cpp       |  43 +++++-
 8 files changed, 388 insertions(+), 80 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index c86958ba7..59348fd8e 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -56,7 +56,27 @@ namespace typelist{
     
     using tuple::element;
     
-    /** 
+    template<typename SIG>
+    struct _Fun
+      {
+        typedef typename FunctionSignature<function<SIG> >::Ret Ret;
+        typedef typename FunctionSignature<function<SIG> >::Args Args;
+      };
+    template<typename SIG>
+    struct _Fun<function<SIG> >
+      {
+        typedef typename FunctionSignature<function<SIG> >::Ret Ret;
+        typedef typename FunctionSignature<function<SIG> >::Args Args;
+      };
+    
+    template<typename FUN>
+    struct is_Functor                 { static const bool value = false; };
+    template<typename SIG>
+    struct is_Functor<function<SIG> > { static const bool value = true;  };
+    
+    
+    
+    /**
      * this Helper with repetitive specialisations for up to nine arguments
      * is used either to apply a function to arguments given as a tuple, or
      * to create the actual closure (functor) over all function arguments. 
@@ -91,14 +111,14 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f (element<1>(arg));
+            return f (element<0>(arg));
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg));
+            return std::tr1::bind (f, element<0>(arg));
           }
       };
     
@@ -110,17 +130,17 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
-                     , element<2>(arg)
-                     ); 
+            return f ( element<0>(arg)
+                     , element<1>(arg)
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
-                                    , element<2>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                    );
           }
       };
@@ -133,19 +153,19 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
-                     , element<3>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
-                                    , element<3>(arg)
                                    );
           }
       };
@@ -158,21 +178,21 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
                      , element<3>(arg)
-                     , element<4>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
                                     , element<3>(arg)
-                                    , element<4>(arg)
                                    );
           }
       };
@@ -185,23 +205,23 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
                      , element<3>(arg)
                      , element<4>(arg)
-                     , element<5>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
                                     , element<3>(arg)
                                     , element<4>(arg)
-                                    , element<5>(arg)
                                    );
           }
       };
@@ -214,25 +234,25 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
                      , element<3>(arg)
                      , element<4>(arg)
                      , element<5>(arg)
-                     , element<6>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
                                     , element<3>(arg)
                                     , element<4>(arg)
                                     , element<5>(arg)
-                                    , element<6>(arg)
                                    );
           }
       };
@@ -245,27 +265,27 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
                      , element<3>(arg)
                      , element<4>(arg)
                      , element<5>(arg)
                      , element<6>(arg)
-                     , element<7>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
                                     , element<3>(arg)
                                     , element<4>(arg)
                                     , element<5>(arg)
                                     , element<6>(arg)
-                                    , element<7>(arg)
                                    );
           }
       };
@@ -278,29 +298,29 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
                      , element<3>(arg)
                      , element<4>(arg)
                      , element<5>(arg)
                      , element<6>(arg)
                      , element<7>(arg)
-                     , element<8>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
                                     , element<3>(arg)
                                     , element<4>(arg)
                                     , element<5>(arg)
                                     , element<6>(arg)
                                     , element<7>(arg)
-                                    , element<8>(arg)
                                    );
           }
       };
@@ -313,7 +333,8 @@ namespace typelist{
         static RET
         invoke (FUN& f, TUP & arg)
           {
-            return f ( element<1>(arg)
+            return f ( element<0>(arg)
+                     , element<1>(arg)
                      , element<2>(arg)
                      , element<3>(arg)
                      , element<4>(arg)
@@ -321,15 +342,15 @@ namespace typelist{
                      , element<6>(arg)
                      , element<7>(arg)
                      , element<8>(arg)
-                     , element<9>(arg)
-                     ); 
+                     );
           }
         
         template<typename RET, class FUN, class TUP>
         static RET
         bind (FUN& f, TUP & arg)
           {
-            return std::tr1::bind (f, element<1>(arg)
+            return std::tr1::bind (f, element<0>(arg)
+                                    , element<1>(arg)
                                     , element<2>(arg)
                                     , element<3>(arg)
                                     , element<4>(arg)
@@ -337,7 +358,6 @@ namespace typelist{
                                     , element<6>(arg)
                                     , element<7>(arg)
                                     , element<8>(arg)
-                                    , element<9>(arg)
                                    );
           }
       };
@@ -348,6 +368,7 @@ namespace typelist{
   
   /**
    * Closure-creating template.
+   * @note taking functor objects \em and parameters per reference
    */
   template<typename SIG>
   class TupleApplicator
@@ -368,11 +389,11 @@ namespace typelist{
         : params_(args)
         { }
       
-      BoundFunc bind (SIG& f)           { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
-      BoundFunc bind (function<SIG>& f) { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
+      BoundFunc bind (SIG& f)                 { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
+      BoundFunc bind (function<SIG> const& f) { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
       
-      Ret operator() (SIG& f)           { return func::Apply<ARG_CNT>::template invoke<BoundFunc> (f, params_); }
-      Ret operator() (function<SIG>& f) { return func::Apply<ARG_CNT>::template invoke<BoundFunc> (f, params_); }
+      Ret operator() (SIG& f)                 { return func::Apply<ARG_CNT>::template invoke<Ret> (f, params_); }
+      Ret operator() (function<SIG>& f)       { return func::Apply<ARG_CNT>::template invoke<Ret> (f, params_); }
     };
   
   
@@ -386,8 +407,8 @@ namespace typelist{
   template<typename SIG>
   class FunctionClosure
     {
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      typedef typename func::_Fun<SIG>::Args Args;
+      typedef typename func::_Fun<SIG>::Ret  Ret;
       
       function<Ret(void)> closure_;
       
@@ -407,5 +428,64 @@ namespace typelist{
   
   
   
+  namespace func { // ...some convenience shortcuts
+    
+    template<typename RET, typename ARG>
+    struct _Sig
+      {
+        typedef typename FunctionTypedef<RET, ARG>::Sig Type;
+        typedef TupleApplicator<Type> Applicator;
+      };
+    
+    template<typename SIG, typename ARG>
+    struct _Clo
+      {
+        typedef typename _Fun<SIG>::Ret Ret;
+        typedef typename _Sig<Ret,ARG>::Type Signature;
+        typedef FunctionClosure<Signature> Type;
+      };
+    
+    
+    /** build a TupleApplicator, which embodies the given
+     *  argument tuple and can be used to apply various
+     *  functions to them.
+     */
+    template<typename ARG>
+    typename _Sig<void, ARG>::Applicator
+    tupleApplicator (Tuple<ARG>& args)
+    {
+      typedef typename _Sig<void,ARG>::Type Signature;
+      return TupleApplicator<Signature> (args);
+    }
+    
+    
+    /** apply the given function to the argument tuple */
+    template<typename SIG, typename ARG>
+    typename _Fun<SIG>::Ret
+    apply (SIG& f, Tuple<ARG>& args)
+    {
+      typedef typename _Fun<SIG>::Ret Ret;                //
+      typedef typename _Sig<Ret,ARG>::Type Signature;    // Note: deliberately re-building the Signature Type
+      return TupleApplicator<Signature> (args) (f);     //        in order to get better error messages here
+    }
+    
+    /** close the given function over all arguments,
+     *  using the values from the argument tuple.
+     *  @return a closure object, which can be 
+     *          invoked later to yield the
+     *          function result. */
+    template<typename SIG, typename ARG>
+    typename _Clo<SIG,ARG>::Type
+    closure (SIG& f, Tuple<ARG>& args)
+    {
+      typedef typename _Fun<SIG>::Ret Ret;
+      typedef typename _Sig<Ret,ARG>::Type Signature;
+      typedef typename _Clo<SIG,ARG>::Type Closure;
+      return Closure (f,args);
+    }
+  }
+  
+  
+  
 }} // namespace lumiera::typelist
 #endif
diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 0f534b8c1..6b031adb5 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -161,15 +161,15 @@ namespace typelist{
     {
       typedef typename Split<TYPES>::Tail Tail;
     public:
-      typedef typename Shifted<Tail,i-1>::Types Types;
-      typedef typename Split<Types>::Head       Head;
+      typedef typename Shifted<Tail,i-1>::Type Type;
+      typedef typename Split<Type>::Head       Head;
     };
   
   template<class TYPES>
   struct Shifted<TYPES,0>
     { 
-      typedef TYPES Types;
-      typedef typename Types::List::Head Head;
+      typedef TYPES                      Type;
+      typedef typename Split<Type>::Head Head;
     };
 
   
@@ -280,7 +280,7 @@ namespace typelist{
       class ShiftedTuple
         { 
           typedef typename Tuple::Type                OurType_;
-          typedef typename Shifted<OurType_,i>::Types ShiftedTypes_;
+          typedef typename Shifted<OurType_,i>::Type  ShiftedTypes_;
         public:
           typedef Tuple<typename ShiftedTypes_::List> Type;
         };
@@ -321,6 +321,11 @@ namespace typelist{
             )
         { } ///< end recursion of chained ctor calls
       
+      /** shortcut: allow copy construction from a tuple
+       *  which is rather defined by a list type */
+      Tuple (Tuple<NullType> const&)
+        { }
+      
       
       template<uint> struct ShiftedTuple       { typedef TupleNull Type; };
       
@@ -330,10 +335,27 @@ namespace typelist{
   
   
   
+  
+  /** specialisation to shift plain tuple types */
+  template<class TYPES, uint i>
+  struct Shifted<Tuple<TYPES>,i>
+    { 
+      typedef typename Shifted<TYPES,i>::Type Type;
+      typedef typename Shifted<TYPES,i>::Head Head;
+    };
+  template<class TYPES>
+  struct Shifted<Tuple<TYPES>, 0>
+    { 
+      typedef typename Tuple<TYPES>::Type     Type;
+      typedef typename Tuple<TYPES>::HeadType Head;
+    };
+  
+  
+  
   namespace tuple { // some convenience access functions
   
     template<uint n, class TUP> 
-    typename TUP::template ShiftedTuple<n>::Type::Head&
+    typename Shifted<TUP,n>::Head&
     element (TUP& tup)
     {
       return tup.template getAt<n>();
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 56efd3302..8b626b6b2 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -144,9 +144,8 @@ namespace control {
       
       ////////////////////TODO the recursion-end of the access operations goes here
       
-    protected:
       string
-      dump (string const& prefix)  const
+      dump (string const& prefix ="(")  const
         { 
           if (1 < prefix.length())
             // remove trailing comma...
diff --git a/tests/40components.tests b/tests/40components.tests
index 85bfb6c2d..7e48db913 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -213,7 +213,19 @@ out: dtor ~TargetObj\(12\) successful
 END
 
 
-PLANNED "FunctionClosure_test" FunctionClosure_test <<END
+TEST "FunctionClosure_test" FunctionClosure_test <<END
+out: List1	:-<1>-<2>-<3>-
+out: List2	:-<5>-<6>-<7>-
+out: Args	:-<5>-<9>-
+out: NewArgs	:-<1>-<5>-<9>-
+out: 	:$
+out: 	: ---Apply---
+out: tup0	:...Tuple\(\)
+out: tup1	:...Tuple\(11\)
+out: tup2	:...Tuple\(11,12\)
+out: tup3	:...Tuple\(11,12,13\)
+out: 	:$
+out: 	: ---Bind----
 return: 0
 END
 
diff --git a/tests/43session.tests b/tests/43session.tests
index d91e4b0a9..083df1c4e 100644
--- a/tests/43session.tests
+++ b/tests/43session.tests
@@ -43,7 +43,7 @@ out: TestSubMO1\(ID= [0-9]{3}\)
 out: TestSubMO2\(ID= [0-9]{3}\)
 out: TestSubMO21\(ID= [0-9]{3}\)
 out: specialAPI()
-out: pID\(\w{16}\)
+out: pID\(\w{8,16}\)
 END
 
 
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 9576a2dcf..72b458cf8 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -22,9 +22,13 @@
 
 
 /** @file function-closure-test.cpp
+ ** Testing a combination of tr1::function objects and metaprogramming.
+ ** Argument types will be extracted and represented as typelist, so they
+ ** can be manipulated at compile time. This test uses some functions with
+ ** and systematically applies or binds them to corresponding data tuples.
+ ** Moreover, closure objects will be constructed in various flavours,
+ ** combining a function object and a set of parameters.
  ** 
- ** @todo define function-closure-test
- **
  ** @see function-closure.hpp
  ** @see control::CmdClosure real world usage example
  **
@@ -40,14 +44,9 @@
 #include "meta/dummy-functions.hpp"
 #include "meta/typelist-diagnostics.hpp"
 #include "meta/tuple-diagnostics.hpp"
-//#include "lib/util.hpp"
 
-//#include <boost/format.hpp>
 #include <iostream>
 
-using lib::test::showSizeof;
-using lib::test::showType;
-
 using ::test::Test;
 using std::string;
 using std::cout;
@@ -82,6 +81,12 @@ namespace test {
             return one.o_ + two.o_ + three.o_;
           }
         
+        
+        int fun0 ()                       { return -1;       }
+        int fun1 (int i1)                 { return i1;       }
+        int fun2 (int i1, int i2)         { return i1+i2;    }
+        int fun3 (int i1, int i2, int i3) { return i1+i2+i3; }
+        
       } // (End) test data
       
       
@@ -90,8 +95,8 @@ namespace test {
       
       
   /*************************************************************************
-   * @test building a function closure for a given functor
-   *       and arguments passed in as tuple
+   * @test building a function closure for a given function or functor,
+   *       while arguments are passed in as tuple
    *       - accessing signatures as typelists
    *       - apply free function to tuple
    *       - apply functor to tuple 
@@ -151,35 +156,189 @@ namespace test {
       void
       check_applyFree ()
         {
-          UNIMPLEMENTED ("verify apply free function to tuple");
+          cout << "\t:\n\t: ---Apply---\n";
+          
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          DUMPVAL (tup0);
+          DUMPVAL (tup1);
+          DUMPVAL (tup2);
+          DUMPVAL (tup3);
+          
+          ASSERT (-1       == func::Apply<0>::invoke<int> (fun0, tup0) );
+          ASSERT (11       == func::Apply<1>::invoke<int> (fun1, tup1) );
+          ASSERT (11+12    == func::Apply<2>::invoke<int> (fun2, tup2) );
+          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (fun3, tup3) );
+          
+          ASSERT (-1       == TupleApplicator<int()>            (tup0) (fun0) );
+          ASSERT (11       == TupleApplicator<int(int)>         (tup1) (fun1) );
+          ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (fun2) );
+          ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (fun3) );
+          
+          ASSERT (-1       == func::apply(fun0, tup0) );
+          ASSERT (11       == func::apply(fun1, tup1) );
+          ASSERT (11+12    == func::apply(fun2, tup2) );
+          ASSERT (11+12+13 == func::apply(fun3, tup3) );
+        
         }
       
       
       void
       check_applyFunc ()
         {
-          UNIMPLEMENTED ("verify apply functor to tuple");
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          function<int()>            functor0 (fun0);
+          function<int(int)>         functor1 (fun1);
+          function<int(int,int)>     functor2 (fun2);
+          function<int(int,int,int)> functor3 (fun3);
+          
+          ASSERT (-1       == func::Apply<0>::invoke<int> (functor0, tup0) );
+          ASSERT (11       == func::Apply<1>::invoke<int> (functor1, tup1) );
+          ASSERT (11+12    == func::Apply<2>::invoke<int> (functor2, tup2) );
+          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (functor3, tup3) );
+          
+          ASSERT (-1       == TupleApplicator<int()>            (tup0) (functor0) );
+          ASSERT (11       == TupleApplicator<int(int)>         (tup1) (functor1) );
+          ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (functor2) );
+          ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (functor3) );
+          
+          ASSERT (-1       == func::apply(functor0, tup0) );
+          ASSERT (11       == func::apply(functor1, tup1) );
+          ASSERT (11+12    == func::apply(functor2, tup2) );
+          ASSERT (11+12+13 == func::apply(functor3, tup3) );
+          
         }
       
       
       void
       check_bindFree ()
         {
-          UNIMPLEMENTED ("verify bind free function to tuple");
+          cout << "\t:\n\t: ---Bind----\n";
+          
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          
+          typedef function<int()> BoundFun;
+          
+          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (fun0, tup0);
+          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (fun1, tup1);
+          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (fun2, tup3);
+          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (fun3, tup3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
+          functor0 = TupleApplicator<int()>            (tup0).bind (fun0);
+          functor1 = TupleApplicator<int(int)>         (tup1).bind (fun1);
+          functor2 = TupleApplicator<int(int,int)>     (tup2).bind (fun2);
+          functor3 = TupleApplicator<int(int,int,int)> (tup3).bind (fun3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
         }
       
       
       void
       check_bindFunc ()
         {
-          UNIMPLEMENTED ("verify bind functor to tuple");
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          function<int()>            unbound_functor0 (fun0);
+          function<int(int)>         unbound_functor1 (fun1);
+          function<int(int,int)>     unbound_functor2 (fun2);
+          function<int(int,int,int)> unbound_functor3 (fun3);
+          
+          typedef function<int()> BoundFun;
+          
+          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (unbound_functor0, tup0);
+          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (unbound_functor1, tup1);
+          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (unbound_functor2, tup3);
+          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (unbound_functor3, tup3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
+          functor0 = TupleApplicator<int()>            (tup0).bind (unbound_functor0);
+          functor1 = TupleApplicator<int(int)>         (tup1).bind (unbound_functor1);
+          functor2 = TupleApplicator<int(int,int)>     (tup2).bind (unbound_functor2);
+          functor3 = TupleApplicator<int(int,int,int)> (tup3).bind (unbound_functor3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
         }
       
       
       void
       build_closure ()
         {
-          UNIMPLEMENTED ("build a simple tuple closure");
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          
+          FunctionClosure<int()>            clo0 (fun0,tup0);
+          FunctionClosure<int(int)>         clo1 (fun1,tup1);
+          FunctionClosure<int(int,int)>     clo2 (fun2,tup2);
+          FunctionClosure<int(int,int,int)> clo3 (fun3,tup3);
+          
+          ASSERT (-1       == clo0() );
+          ASSERT (11       == clo1() );
+          ASSERT (11+12    == clo2() );
+          ASSERT (11+12+13 == clo3() );
+          
+          function<int()>            unbound_functor0 (fun0);
+          function<int(int)>         unbound_functor1 (fun1);
+          function<int(int,int)>     unbound_functor2 (fun2);
+          function<int(int,int,int)> unbound_functor3 (fun3);
+          
+          clo0 = FunctionClosure<int()>            (unbound_functor0,tup0);
+          clo1 = FunctionClosure<int(int)>         (unbound_functor1,tup1);
+          clo2 = FunctionClosure<int(int,int)>     (unbound_functor2,tup2);
+          clo3 = FunctionClosure<int(int,int,int)> (unbound_functor3,tup3);
+          
+          ASSERT (-1       == clo0() );
+          ASSERT (11       == clo1() );
+          ASSERT (11+12    == clo2() );
+          ASSERT (11+12+13 == clo3() );
+          
+          ASSERT (-1       == func::closure(fun0,tup0) () );
+          ASSERT (11       == func::closure(fun1,tup1) () );
+          ASSERT (11+12    == func::closure(fun2,tup2) () );
+          ASSERT (11+12+13 == func::closure(fun3,tup3) () );
+          
+          ASSERT (-1       == func::closure(unbound_functor0,tup0) () );
+          ASSERT (11       == func::closure(unbound_functor1,tup1) () );
+          ASSERT (11+12    == func::closure(unbound_functor2,tup2) () );
+          ASSERT (11+12+13 == func::closure(unbound_functor3,tup3) () );
+          
+          
+          // finally combine all techniques....
+          typedef Tuple<List2>::Type NumberzArg;
+          typedef FunctionTypedef<int,NumberzArg>::Sig NumberzSig;
+          Tuple<NumberzArg> numberzTup (Num<5>(22), Num<6>(33), Num<7>(44));
+          
+          FunctionClosure<NumberzSig> numClo (getNumberz<5,6,7>, numberzTup );
+          
+          ASSERT (22+33+44 == numClo() );
         }
     };
   
diff --git a/tests/lib/meta/tuple-diagnostics.hpp b/tests/lib/meta/tuple-diagnostics.hpp
index 63c176503..127b845e1 100644
--- a/tests/lib/meta/tuple-diagnostics.hpp
+++ b/tests/lib/meta/tuple-diagnostics.hpp
@@ -109,7 +109,7 @@ namespace test    {
         TupleElementDisplayer(TUP const& tuple) : BASE(tuple) {}
         
         string
-        dump (string const& prefix = "(")  const
+        dump (string const& prefix ="(")  const
           {
             return BASE::dump (prefix+showTupElement(element())+",");
           }
@@ -122,11 +122,8 @@ namespace test    {
       public:
         TupleElementDisplayer(TUP const& tuple) : TUP(tuple) {}
         
-        
-      protected:
-        
         string
-        dump (string const& prefix)  const
+        dump (string const& prefix ="(")  const
           { 
             if (1 < prefix.length())
               // removing the trailing comma
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index 44e79aab3..a11358344 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -157,14 +157,53 @@ namespace test {
       void
       check_sub_tuple_types()
         {
-          UNIMPLEMENTED ("verify head and tail type");
+          cout << "\t:\n\t: ---Head-and-Tail---\n";
+          
+          typedef Append<Types2::List, Types1::List>::List L2;
+          
+          typedef Tuple<L2> T_L2;
+          typedef Types<T_L2::HeadType> Head;
+          typedef T_L2::TailType Tail;
+          DISPLAY (T_L2);
+          DISPLAY (Head);
+          DISPLAY (Tail);
+          
+          typedef T_L2::ThisTuple T2;
+          typedef Types<T2::HeadType> Head2;
+          typedef T2::TailType Tail2;
+          DISPLAY (T2);
+          DISPLAY (Head2);
+          DISPLAY (Tail2);
         }
       
       
       void
       check_shiftedTuple()
         {
-          UNIMPLEMENTED ("verify shifted type tuple");
+          cout << "\t:\n\t: ---Shifted-Tuple---\n";
+          
+          typedef Append<Types2::List, Types3::List>::List L3;
+          typedef Tuple<L3>::Type Ty3;
+          typedef Tuple<Ty3>      T3;
+          
+          typedef Shifted<Ty3,0>::Type Ty_0;  DISPLAY (Ty_0);
+          typedef Shifted<Ty3,1>::Type Ty_1;  DISPLAY (Ty_1);
+          typedef Shifted<Ty3,2>::Type Ty_2;  DISPLAY (Ty_2);
+          typedef Shifted<Ty3,3>::Type Ty_3;  DISPLAY (Ty_3);
+          typedef Shifted<Ty3,4>::Type Ty_4;  DISPLAY (Ty_4);
+          
+          typedef T3::ShiftedTuple<0>::Type T_0; DISPLAY (T_0);
+          typedef T3::ShiftedTuple<1>::Type T_1; DISPLAY (T_1);
+          typedef T3::ShiftedTuple<2>::Type T_2; DISPLAY (T_2);
+          typedef T3::ShiftedTuple<3>::Type T_3; DISPLAY (T_3);
+          typedef T3::ShiftedTuple<4>::Type T_4; DISPLAY (T_4);
+          
+          T3 tu3;                                DUMPVAL (tu3);
+          T_0 tu3_0 = tu3.getShifted<0>();       DUMPVAL (tu3_0);
+          T_1 tu3_1 = tu3.getShifted<1>();       DUMPVAL (tu3_1);
+          T_2 tu3_2 = tu3.getShifted<2>();       DUMPVAL (tu3_2);
+          T_3 tu3_3 = tu3.getShifted<3>();       DUMPVAL (tu3_3);
+          T_4 tu3_4 = tu3.getShifted<4>();       DUMPVAL (tu3_4);
         }
       
       

From a92f63327697dd01617b0d53153e2bb015783a6f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 21 Jun 2009 09:37:26 +0200
Subject: [PATCH 133/368] draft the remainder of type-tuple-test

---
 tests/lib/meta/type-tuple-test.cpp | 62 ++++++++++++++++++++++++++++--
 1 file changed, 58 insertions(+), 4 deletions(-)

diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index a11358344..24faee34d 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -24,7 +24,6 @@
 /** @file type-tuple-test.cpp
  ** Interconnection of typelists, type tuples and simple record
  ** data types build on top of them.  
- ** @todo define function-closure-test
  **
  ** @see lumiera::typelist::Tuple
  ** @see tuple.hpp
@@ -210,23 +209,78 @@ namespace test {
       void
       check_tuple_creation()
         {
-          UNIMPLEMENTED ("verify tuple creation");
+          Tuple<Types1> tup11 (Num<1>() );                      
+          Tuple<Types1> tup12 (Num<1>(11), Num<3>() );
+          Tuple<Types1> tup13 (Num<1>(11), Num<3>(33), Num<5>() );
+          DUMPVAL (tup11);
+          DUMPVAL (tup12);
+          DUMPVAL (tup13);
           
+          Tuple<Types<int,int,Num<11> > > tup2 = tuple::make(41,42, Num<11>(43));
+          DISPLAY (tup2::ThisType);
+          DUMPVAL (tup2);
+          
+          tup2::TailType tup22 = tup2.getTail();
+          DISPLAY (tup22);
+          DUMPVAL (tup22);
+          
+          tup22::TailType tup222 = tup22.getTail();
+          DISPLAY (tup222);
+          DUMPVAL (tup222);
+          
+          Tuple<NullType> nullT = tuple::makeNullTuple();
         }
       
       
       void
       check_tuple_copy()
         {
-          UNIMPLEMENTED ("verify tuple copying and assignment");
+          Tuple<Types1> tup1 (Num<1>(11), Num<3>(33), Num<5>() );
           
+          Tuple<Types1> tup11 (tup1);
+          tup11.getAt<2>().o_ = 44;
+          DUMPVAL (tup1);
+          DUMPVAL (tup11);
+          
+          tup1 = tup11;
+          DUMPVAL (tup1);
+          
+          Tuple<Types1::List> tupL = tup11.getShifted<0>();
+          Tuple<Types1> tup1L (tupL);
+          DUMPVAL (tupL);
+          DUMPVAL (tup1L);
         }
       
       
       void
       check_value_access()
         {
-          UNIMPLEMENTED ("verify tuple value access");
+          typedef Append<Types2::List, Types2::List>::List T2424;
+          Tuple<T2424> tupX;
+          DISPLAY (tupX);
+          DUMPVAL (tupX);
+          
+          Tuple<Types2> tu2;
+          DUMPVAL (tu2);
+          tuple::element<1>(tu2).o_ = 55;
+          tu2.getHead() = Num<2>(55);
+          DUMPVAL (tu2);
+
+          tupX.getShifted<2>() = tu2;
+          DUMPVAL (tupX);
+          
+          typedef Shifted<tupX::ThisTuple,2> T4;
+          T4 t4 (tupX.getShifted<2>());
+          DUMPVAL (t4);
+          
+          DISPLAY (tupX::Type)
+          DISPLAY (tupX::TailType)
+          DISPLAY (tupX::ThisTuple)
+          
+          typedef tupX::ThisTuple T2424T;
+          DISPLAY (T2424T::Type)
+          DISPLAY (T2424T::TailType)
+          DISPLAY (T2424T::ThisTuple)
           
         }
 

From db9ef808a5fd271ad99898c544fbed13d09a2ea8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 21 Jun 2009 19:52:33 +0200
Subject: [PATCH 134/368] refactoring to solve consistency problems uncovered
 by the tests

---
 src/lib/meta/tuple.hpp             |  91 ++++++++++++++---------
 src/lib/meta/typelist.hpp          |   2 +-
 tests/lib/meta/type-tuple-test.cpp | 112 ++++++++++++++++++++++-------
 3 files changed, 146 insertions(+), 59 deletions(-)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 6b031adb5..3876c7a88 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -191,7 +191,8 @@ namespace typelist{
       typedef Types<>  Type;
       
       typedef NullType        ArgList;
-      typedef Tuple<Type>     ThisTuple;
+      typedef Tuple<Type>     TupleType;
+      typedef Tuple<NullType> ThisType;
       typedef Tuple<NullType> Tail;
       enum  { SIZE = 0 };
       
@@ -200,6 +201,16 @@ namespace typelist{
       
       Tuple (HeadType const&, Tail const&) { }
       Tuple ()                             { }
+      
+      template<uint> struct ShiftedTuple { typedef Tail Type;};
+      template<uint> Tail& getShifted () { return *this;     }
+      template<uint> NullType&  getAt () { return getHead(); }
+      
+      TupleType& 
+      tupleCast ()
+        {
+          return reinterpret_cast<TupleType&> (*this);
+        }
     };
   
   
@@ -212,20 +223,52 @@ namespace typelist{
       typedef typename Prepend<TY,TailType>::Tuple Type;
       
       typedef Node<TY,TYPES> ArgList;
-      typedef Tuple<Type>    ThisTuple;
+      typedef Tuple<Type>    TupleType;
+      typedef Tuple<ArgList> ThisType;
       typedef Tuple<TYPES>   Tail;
       enum  { SIZE = count<ArgList>::value };
       
       Tuple ( TY   a1   =TY()
             , Tail tail =Tail()
             )
-        : Tuple<TYPES> (tail.getHead(), tail.getTail()),
+        : Tail (tail.getHead(), tail.getTail()),
           val_(a1)
         { }
       
       TY  & getHead() { return val_; }
       Tail& getTail() { return static_cast<Tail&> (*this); }
       
+      
+      template<uint i>
+      class ShiftedTuple
+        { 
+          typedef typename Tuple::Type                OurType_;
+          typedef typename Shifted<OurType_,i>::Type  ShiftedTypes_;
+        public:
+          typedef Tuple<typename ShiftedTypes_::List> Type;
+        };
+      
+      template<uint i>
+      typename ShiftedTuple<i>::Type&
+      getShifted ()
+        {
+          typedef typename ShiftedTuple<i>::Type Tail_I;
+          return static_cast<Tail_I&> (*this);
+        }
+      
+      TupleType& 
+      tupleCast () ///< note makes this List-style Tuple appear as plain-flat Tuple
+        {
+          return reinterpret_cast<TupleType&> (*this);
+        }
+      
+      template<uint i>
+      typename Shifted<Type,i>::Head&
+      getAt ()
+        {
+          return getShifted<i>().getHead();
+        }
+      
     private:
       TY val_;
     };
@@ -249,7 +292,8 @@ namespace typelist{
       typedef Types<T1,T2,T3,T4,T5,T6,T7,T8,T9>       Type;
       
       typedef typename Type::List ArgList;
-      typedef Tuple<Type>         ThisTuple;
+      typedef Tuple<Type>         TupleType;
+      typedef Tuple<Type>         ThisType;
       typedef Tuple<TailType>     Tail;
       enum  { SIZE = count<ArgList>::value };
       
@@ -274,30 +318,10 @@ namespace typelist{
         { }
       
       using Tuple<ArgList>::getHead;
-      using Tuple<ArgList>::getTail;
       
-      template<uint i>
-      class ShiftedTuple
-        { 
-          typedef typename Tuple::Type                OurType_;
-          typedef typename Shifted<OurType_,i>::Type  ShiftedTypes_;
-        public:
-          typedef Tuple<typename ShiftedTypes_::List> Type;
-        };
-      
-      template<uint i>
-      typename ShiftedTuple<i>::Type&
-      getShifted ()
+      Tail& getTail() ///< note makes the Tail appear as plain-flat shifted tuple
         {
-          typedef typename ShiftedTuple<i>::Type Tail_I;
-          return static_cast<Tail_I&> (*this);
-        }
-      
-      template<uint i>
-      typename Shifted<Type,i>::Head&
-      getAt ()
-        {
-          return getShifted<i>().getHead();
+          return Tuple<ArgList>::getTail().tupleCast();
         }
     };
   
@@ -307,7 +331,10 @@ namespace typelist{
     : Tuple<NullType>
     {
       enum  { SIZE = 0 };
-      typedef Tuple<NullType> TupleNull;
+      typedef Tuple<NullType> TupNilList;
+      typedef Tuple<Types<> > ThisType;
+      typedef ThisType        Tail;
+      
       
       Tuple ( NullType =NullType()
             , NullType =NullType()
@@ -323,14 +350,8 @@ namespace typelist{
       
       /** shortcut: allow copy construction from a tuple
        *  which is rather defined by a list type */
-      Tuple (Tuple<NullType> const&)
+      Tuple (TupNilList const&)
         { }
-      
-      
-      template<uint> struct ShiftedTuple       { typedef TupleNull Type; };
-      
-      template<uint> TupleNull&  getShifted () { return static_cast<TupleNull&> (*this); }
-      template<uint> NullType&        getAt () { return getHead(); }
     };
   
   
@@ -342,12 +363,14 @@ namespace typelist{
     { 
       typedef typename Shifted<TYPES,i>::Type Type;
       typedef typename Shifted<TYPES,i>::Head Head;
+      typedef Tuple<Type>                     TupleType;
     };
   template<class TYPES>
   struct Shifted<Tuple<TYPES>, 0>
     { 
       typedef typename Tuple<TYPES>::Type     Type;
       typedef typename Tuple<TYPES>::HeadType Head;
+      typedef Tuple<Type>                     TupleType;
     };
   
   
diff --git a/src/lib/meta/typelist.hpp b/src/lib/meta/typelist.hpp
index 726381bf5..96c70c480 100644
--- a/src/lib/meta/typelist.hpp
+++ b/src/lib/meta/typelist.hpp
@@ -62,7 +62,7 @@ This code is heavily inspired by
 namespace lumiera {
 namespace typelist{
     
-    class NullType 
+    struct NullType 
       { 
         typedef NullType List;
       };
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index 24faee34d..d8de75bd3 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -133,7 +133,7 @@ namespace test {
           typedef Types1::List L1;  // starting from an existing Typelist...
           
           typedef Tuple<L1> T_L1;           // ListType based tuple type
-          typedef Tuple<L1>::ThisTuple T1;  // corresponding plain tuple type
+          typedef Tuple<L1>::TupleType T1;  // corresponding plain tuple type
           typedef Tuple<L1>::Type Type1;    // extract the underlying type sequence
           
           DISPLAY (Type1);
@@ -156,7 +156,7 @@ namespace test {
       void
       check_sub_tuple_types()
         {
-          cout << "\t:\n\t: ---Head-and-Tail---\n";
+          cout << "\t:\n\t: ---Sub-Tuple-Types----\n";
           
           typedef Append<Types2::List, Types1::List>::List L2;
           
@@ -167,12 +167,44 @@ namespace test {
           DISPLAY (Head);
           DISPLAY (Tail);
           
-          typedef T_L2::ThisTuple T2;
+          typedef T_L2::TupleType T2;
           typedef Types<T2::HeadType> Head2;
           typedef T2::TailType Tail2;
           DISPLAY (T2);
           DISPLAY (Head2);
           DISPLAY (Tail2);
+          
+          typedef Tuple<Types<> > NulT;
+          typedef Tuple<NullType> NulL;
+          
+          DISPLAY (T2::Type);
+          DISPLAY (T2::TailType);
+          DISPLAY (T2::TupleType);
+          DISPLAY (T2::ThisType);
+          DISPLAY (T2::Tail);
+          DISPLAY (T2::ArgList);
+          
+          DISPLAY (T_L2::Type);
+          DISPLAY (T_L2::TailType);
+          DISPLAY (T_L2::TupleType);
+          DISPLAY (T_L2::ThisType);
+          DISPLAY (T_L2::Tail);
+          DISPLAY (T_L2::ArgList);
+          
+          DISPLAY (NulT::Type);
+          DISPLAY (NulT::TailType);
+          DISPLAY (NulT::TupleType);
+          DISPLAY (NulT::ThisType);
+          DISPLAY (NulT::Tail);
+          DISPLAY (NulT::ArgList);
+          
+          DISPLAY (NulL::Type);
+          DISPLAY (NulL::TailType);
+          DISPLAY (NulL::TupleType);
+          DISPLAY (NulL::ThisType);
+          DISPLAY (NulL::Tail);
+          DISPLAY (NulL::ArgList);
+          
         }
       
       
@@ -209,32 +241,52 @@ namespace test {
       void
       check_tuple_creation()
         {
-          Tuple<Types1> tup11 (Num<1>() );                      
-          Tuple<Types1> tup12 (Num<1>(11), Num<3>() );
+          cout << "\t:\n\t: ---creating-Tuples---\n";
+          
+          Tuple<Types1> tup1  ;                      
+          Tuple<Types1> tup11 (Num<1>(11) );                      
+          Tuple<Types1> tup12 (Num<1>(),   Num<3>(33) );
           Tuple<Types1> tup13 (Num<1>(11), Num<3>(33), Num<5>() );
+          DUMPVAL (tup1);
           DUMPVAL (tup11);
           DUMPVAL (tup12);
           DUMPVAL (tup13);
           
-          Tuple<Types<int,int,Num<11> > > tup2 = tuple::make(41,42, Num<11>(43));
-          DISPLAY (tup2::ThisType);
+          typedef Tuple<Types<int,int,Num<11> > > Tup2;
+          Tup2 tup2 = tuple::make(41,42, Num<11>(43));
+          DISPLAY (Tup2);
           DUMPVAL (tup2);
           
-          tup2::TailType tup22 = tup2.getTail();
-          DISPLAY (tup22);
+          typedef Tup2::Tail Tup22;
+          Tup22 tup22 = tup2.getTail();
+          DISPLAY (Tup22);
           DUMPVAL (tup22);
           
-          tup22::TailType tup222 = tup22.getTail();
-          DISPLAY (tup222);
+          typedef Tup2::Tail::Tail Tup222;
+          Tup222 tup222 = tup22.getTail();
+          DISPLAY (Tup222);
           DUMPVAL (tup222);
           
-          Tuple<NullType> nullT = tuple::makeNullTuple();
+          typedef Tuple<Types<> > T0T;
+          typedef Tuple<NullType> T0L;
+          T0T nullT = tuple::makeNullTuple();
+          T0L nullL = tuple::makeNullTuple();
+          T0T nulTcpy (nullL);
+          T0T& nulTref (nullL.tupleCast());
+          DISPLAY (T0T);
+          DISPLAY (T0L);
+          DUMPVAL (nullT);
+          DUMPVAL (nullL);
+          DUMPVAL (nulTcpy);
+          DUMPVAL (nulTref);
         }
       
       
       void
       check_tuple_copy()
         {
+          cout << "\t:\n\t: ---copy-operations---\n";
+          
           Tuple<Types1> tup1 (Num<1>(11), Num<3>(33), Num<5>() );
           
           Tuple<Types1> tup11 (tup1);
@@ -255,33 +307,45 @@ namespace test {
       void
       check_value_access()
         {
+          cout << "\t:\n\t: ---value-access---\n";
+          
           typedef Append<Types2::List, Types2::List>::List T2424;
-          Tuple<T2424> tupX;
-          DISPLAY (tupX);
+          typedef Tuple<T2424> TupX;
+          TupX tupX;
+          DISPLAY (TupX);
           DUMPVAL (tupX);
           
           Tuple<Types2> tu2;
           DUMPVAL (tu2);
-          tuple::element<1>(tu2).o_ = 55;
-          tu2.getHead() = Num<2>(55);
+          tuple::element<1>(tu2).o_ = 5;
+          tu2.getHead() = Num<2> (tu2.getAt<1>().o_);
           DUMPVAL (tu2);
 
+
           tupX.getShifted<2>() = tu2;
           DUMPVAL (tupX);
           
-          typedef Shifted<tupX::ThisTuple,2> T4;
+          typedef Shifted<TupX::TupleType,2>::TupleType T4;
           T4 t4 (tupX.getShifted<2>());
+          DISPLAY (T4);
           DUMPVAL (t4);
           
-          DISPLAY (tupX::Type)
-          DISPLAY (tupX::TailType)
-          DISPLAY (tupX::ThisTuple)
+          DISPLAY (TupX::Type)
+          DISPLAY (TupX::TailType)
+          DISPLAY (TupX::ThisType)
+          DISPLAY (TupX::TupleType)
           
-          typedef tupX::ThisTuple T2424T;
-          DISPLAY (T2424T::Type)
-          DISPLAY (T2424T::TailType)
-          DISPLAY (T2424T::ThisTuple)
+          typedef TupX::TupleType TupT;
+          DISPLAY (TupT::Type)
+          DISPLAY (TupT::TailType)
+          DISPLAY (TupT::ThisType)
+          DISPLAY (TupT::TupleType)
           
+          TupT tupXcopy (tupX);
+          DUMPVAL (tupXcopy);
+          
+          TupT& tupXcast (tupX.tupleCast());
+          DUMPVAL (tupXcast);
         }
 
     };

From 61f8c1814dab1d1848859a4e5fb29b232033fb57 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 22 Jun 2009 06:05:32 +0200
Subject: [PATCH 135/368] tuple test pass

---
 src/lib/meta/tuple.hpp             |  58 +++++++++------
 tests/40components.tests           | 109 ++++++++++++++++++++++++++++-
 tests/lib/meta/type-tuple-test.cpp |  94 ++++++++++++++++---------
 3 files changed, 207 insertions(+), 54 deletions(-)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 3876c7a88..d8e4c8d39 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -22,13 +22,13 @@
 
 
 /** @file tuple.hpp
- ** Metaprogramming with tuples-of-types and a very simple Tuple datatype.
+ ** Metaprogramming with tuples-of-types and a simple Tuple (record) datatype.
  ** The metaprogramming part of this header complements typelist.hpp and allows
  ** to re-build a new tuple-of-types from an existing typelist. Such a finite
- ** tuple of types can at times be more handy than a typelist, especially when
- ** capturing specific types to use as template parameter. 
+ ** sequence or tuple of types can at times be more handy than a typelist,
+ ** especially when capturing specific types to use as template parameter.
  ** 
- ** Additionally, this header augments the Tuple template into a very simple Tuple
+ ** Additionally, this header augments the Tuple template into a simple Tuple
  ** (run time) datatype. This isn't meant as competing with std::tr1::tuple, which is
  ** much more capable, but also has the downside of pulling in a lot of other headers.
  ** But when all we need is to define a generic typed record of N data elements and
@@ -55,8 +55,8 @@
 
 namespace lumiera {
 namespace typelist{
-
-
+  
+  
   
   /** 
    * Helper: prepend a type to an existing type sequence,
@@ -99,6 +99,8 @@ namespace typelist{
                  , T06,T07,T08,T09,T10
                  , T11,T12,T13,T14,T15
                  , T16,T17,T18,T19,T20 > Tuple;
+    
+    typedef typename Tuple::List         List;
   };
   
   
@@ -171,13 +173,23 @@ namespace typelist{
       typedef TYPES                      Type;
       typedef typename Split<Type>::Head Head;
     };
-
+  
   
   /** 
    * simple generic Tuple datatype.
    * Usable both for metaprogramming and as a generic record.
    * The types within this tuple can either be specified
-   * as Type sequence or as typelist
+   * as Type sequence or as typelist. Default and canonical
+   * is the type-sequence based tuple form \c Tuple<Types<T1,T2,...>>
+   * The secondary from of specifying a tuple is based on a typelist
+   * (and this form is used actually to implement the storage, while
+   * the plain-flat (type sequence based) form acts as interface.
+   * 
+   * Irrespective of the flavour actually used, you can always
+   * - get the canonical TupleType (sequence based)
+   * - get the types of head and tail, and a list version of the types
+   * - access the head element and the tail tuple
+   * - access the Nth element and a shifted-b-N sub (tail) tuple
    */
   template<class TYPES>
   struct Tuple;
@@ -248,6 +260,7 @@ namespace typelist{
           typedef Tuple<typename ShiftedTypes_::List> Type;
         };
       
+      
       template<uint i>
       typename ShiftedTuple<i>::Type&
       getShifted ()
@@ -375,6 +388,8 @@ namespace typelist{
   
   
   
+  /* ====== Helpers for working with Tuples ========= */
+  
   namespace tuple { // some convenience access functions
   
     template<uint n, class TUP> 
@@ -494,9 +509,10 @@ namespace typelist{
       return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7,a8,a9);
     }
     
-  }
-      
-    
+  } // (END) access / tuple building helper functions (namespace tuple)
+  
+  
+  
   /** Trait template for detecting a type tuple */
   template<typename TUP>
   class is_Tuple
@@ -504,7 +520,7 @@ namespace typelist{
       template<class X>  struct Check             { typedef No_t It;  };
       template<class TY> struct Check<Tuple<TY> > { typedef Yes_t It; };
       
-    public: 
+    public:
       static const bool value = (sizeof(Yes_t)==sizeof(typename Check<TUP>::It));
     };
   
@@ -513,7 +529,7 @@ namespace typelist{
   template<typename TUP>
   class is_TupleListType
     {
-      template<class X>          
+      template<class X>
       struct Check
         {
           enum{ result = sizeof(No_t)};
@@ -546,7 +562,7 @@ namespace typelist{
   template<typename TUP>
   class is_NullTuple
     {
-      template<class X>          
+      template<class X>
       struct Check
         {
           enum{ result = sizeof(No_t)};
@@ -555,9 +571,9 @@ namespace typelist{
       template<class TY>
       struct Check<Tuple<TY> >
       {
-        Yes_t check(Types<>*);
-        Yes_t check(NullType*);
-        No_t  check(...);
+        Yes_t static check(Types<>*);
+        Yes_t static check(NullType*);
+        No_t  static check(...);
         
         enum{ result = sizeof(check( (TY*)0)) };
       };
@@ -565,7 +581,7 @@ namespace typelist{
     public: 
       static const bool value = (sizeof(Yes_t)== Check<TUP>::result);
     };
-
+  
   
   /**
    * Decorating a tuple type with auxiliary data access operations.
@@ -576,13 +592,13 @@ namespace typelist{
    * type of the individual elements within the Tuple. To achieve this, for each
    * type within the Tuple, the BASE type is decorated with an instance of the
    * template passed in as template template parameter _X_. Each of these
-   * decorating instances is provided with a member pointer to access "his"
+   * decorating instances is provided with a index allowing to access "his"
    * specific element within the underlying tuple.
    * 
    * The decorating template _X_ need to take its own base class as template
    * parameter. Typically, operations on _X_ will be defined in a recursive fashion,
    * calling down into this templated base class. To support this, an instantiation
-   * of _X_ with the 0 member ptr is generated for detecting recursion end
+   * of _X_ with the empty type sequence is generated for detecting recursion end
    * (built as innermost decorator, i.e. immediate subclass of BASE) 
    */
   template
@@ -645,7 +661,7 @@ namespace typelist{
     };
   
   
-
+  
   
   
 }} // namespace lumiera::typelist
diff --git a/tests/40components.tests b/tests/40components.tests
index 7e48db913..ba3050091 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -562,7 +562,114 @@ return: 0
 END
 
 
-PLANNED "TypeTuple_test" TypeTuple_test <<END
+TEST "TypeTuple_test" TypeTuple_test <<END
+out: L1	:-<1>-<3>-<5>-
+out: L2	:-<2>-<4>-
+out: L3	:-<7>-
+out: Tup1	:TYPES-<>-<1>-<3>-<5>-
+out: Tup1\(\)	:...Tuple\(\(1\),\(3\),\(5\)\)
+out: tup1x	:...Tuple\(\{11\},\(3\),\(5\)\)
+out: Type1	:-<1>-<3>-<5>-
+out: T_L1	:TYPES-\[\]-<1>-<3>-<5>-
+out: T1	:TYPES-<>-<1>-<3>-<5>-
+out: tup1	:...Tuple\(\{8\},\(3\),\(5\)\)
+out: tup2	:...Tuple\(\{9\},\(3\),\(5\)\)
+out: Prepend	:TYPES-\[\]-<i>-<1>-<3>-<5>-
+out: prepend	:...Tuple\(22,\{9\},\(3\),\(5\)\)
+out: 	:$
+out: 	: ---Sub-Tuple-Types----
+out: T_L2	:TYPES-\[\]-<2>-<4>-<1>-<3>-<5>-
+out: Head	:-<2>-
+out: Tail	:-<4>-<1>-<3>-<5>-
+out: T2	:TYPES-<>-<2>-<4>-<1>-<3>-<5>-
+out: Head2	:-<2>-
+out: Tail2	:-<4>-<1>-<3>-<5>-
+out: T2::Type	:-<2>-<4>-<1>-<3>-<5>-
+out: T2::TailType	:-<4>-<1>-<3>-<5>-
+out: T2::TupleType	:TYPES-<>-<2>-<4>-<1>-<3>-<5>-
+out: T2::ThisType	:TYPES-<>-<2>-<4>-<1>-<3>-<5>-
+out: T2::Tail	:TYPES-<>-<4>-<1>-<3>-<5>-
+out: T2::ArgList	:-<2>-<4>-<1>-<3>-<5>-
+out: T_L2::Type	:-<2>-<4>-<1>-<3>-<5>-
+out: T_L2::TailType	:-<4>-<1>-<3>-<5>-
+out: T_L2::TupleType	:TYPES-<>-<2>-<4>-<1>-<3>-<5>-
+out: T_L2::ThisType	:TYPES-\[\]-<2>-<4>-<1>-<3>-<5>-
+out: T_L2::Tail	:TYPES-\[\]-<4>-<1>-<3>-<5>-
+out: T_L2::ArgList	:-<2>-<4>-<1>-<3>-<5>-
+out: NulT::Type	:-
+out: NulT::TailType	:-
+out: NulT::TupleType	:TYPES-<>-
+out: NulT::ThisType	:TYPES-<>-
+out: NulT::Tail	:TYPES-<>-
+out: NulT::ArgList	:-
+out: NulL::Type	:-
+out: NulL::TailType	:-
+out: NulL::TupleType	:TYPES-<>-
+out: NulL::ThisType	:TYPES-\[\]-
+out: NulL::Tail	:TYPES-\[\]-
+out: NulL::ArgList	:-
+out: 	:$
+out: 	: ---Shifted-Tuple---
+out: Ty_0	:-<2>-<4>-<7>-
+out: Ty_1	:-<4>-<7>-
+out: Ty_2	:-<7>-
+out: Ty_3	:-
+out: Ty_4	:-
+out: T_0	:TYPES-\[\]-<2>-<4>-<7>-
+out: T_1	:TYPES-\[\]-<4>-<7>-
+out: T_2	:TYPES-\[\]-<7>-
+out: T_3	:TYPES-\[\]-
+out: T_4	:TYPES-\[\]-
+out: tu3	:...Tuple\(\(2\),\(4\),\(7\)\)
+out: tu3_0	:...Tuple\(\(2\),\(4\),\(7\)\)
+out: tu3_1	:...Tuple\(\(4\),\(7\)\)
+out: tu3_2	:...Tuple\(\(7\)\)
+out: tu3_3	:...Tuple\(\)
+out: tu3_4	:...Tuple\(\)
+out: 	:$
+out: 	: ---creating-Tuples---
+out: tup1	:...Tuple\(\(1\),\(3\),\(5\)\)
+out: tup11	:...Tuple\(\{11\},\(3\),\(5\)\)
+out: tup12	:...Tuple\(\(1\),\{33\},\(5\)\)
+out: tup13	:...Tuple\(\{11\},\{33\},\(5\)\)
+out: Tup2	:TYPES-<>-<i>-<i>-<11>-
+out: tup2	:...Tuple\(41,42,\{43\}\)
+out: Tup22	:TYPES-<>-<i>-<11>-
+out: tup22	:...Tuple\(42,\{43\}\)
+out: Tup222	:TYPES-<>-<11>-
+out: tup222	:...Tuple\(\{43\}\)
+out: T0T	:TYPES-<>-
+out: T0L	:TYPES-\[\]-
+out: nullT	:...Tuple\(\)
+out: nullL	:...Tuple\(\)
+out: nulTcpy	:...Tuple\(\)
+out: nulTref	:...Tuple\(\)
+out: 	:$
+out: 	: ---copy-operations---
+out: tup1	:...Tuple\(\{11\},\{33\},\(5\)\)
+out: tup11	:...Tuple\(\{11\},\{33\},\{44\}\)
+out: tup1	:...Tuple\(\{11\},\{33\},\{44\}\)
+out: tupL	:...Tuple\(\{11\},\{33\},\{44\}\)
+out: tup1L	:...Tuple\(\{11\},\{33\},\{44\}\)
+out: 	:$
+out: 	: ---value-access---
+out: TupX	:TYPES-\[\]-<2>-<4>-<2>-<4>-
+out: tupX	:...Tuple\(\(2\),\(4\),\(2\),\(4\)\)
+out: tu2	:...Tuple\(\(2\),\(4\)\)
+out: tu2	:...Tuple\(\{5\},\{5\}\)
+out: tupX	:...Tuple\(\(2\),\(4\),\{5\},\{5\}\)
+out: T4	:TYPES-<>-<2>-<4>-
+out: t4	:...Tuple\(\{5\},\{5\}\)
+out: TupX::Type	:-<2>-<4>-<2>-<4>-
+out: TupX::TailType	:-<4>-<2>-<4>-
+out: TupX::ThisType	:TYPES-\[\]-<2>-<4>-<2>-<4>-
+out: TupX::TupleType	:TYPES-<>-<2>-<4>-<2>-<4>-
+out: TupT::Type	:-<2>-<4>-<2>-<4>-
+out: TupT::TailType	:-<4>-<2>-<4>-
+out: TupT::ThisType	:TYPES-<>-<2>-<4>-<2>-<4>-
+out: TupT::TupleType	:TYPES-<>-<2>-<4>-<2>-<4>-
+out: tupXcopy	:...Tuple\(\(2\),\(4\),\{5\},\{5\}\)
+out: tupXcast	:...Tuple\(\(2\),\(4\),\{5\},\{5\}\)
 return: 0
 END
 
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index d8de75bd3..80f15929a 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -22,8 +22,8 @@
 
 
 /** @file type-tuple-test.cpp
- ** Interconnection of typelists, type tuples and simple record
- ** data types build on top of them.  
+ ** Interplay of typelists, type tuples and simple record
+ ** data types build on top of them.
  **
  ** @see lumiera::typelist::Tuple
  ** @see tuple.hpp
@@ -34,18 +34,13 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/meta/typelist.hpp"   ////////////TODO really?
 #include "lib/meta/tuple.hpp"
 #include "meta/typelist-diagnostics.hpp"
 #include "meta/tuple-diagnostics.hpp"
 
-#include <boost/utility/enable_if.hpp>
-#include <boost/format.hpp>
 #include <iostream>
 
 using ::test::Test;
-  
-using std::string;
 using std::cout;
 using std::endl;
 
@@ -81,9 +76,10 @@ namespace test {
    *       - build a tuple type from an existing typelist
    *       - create sub tuple types and types with shifted parameters
    *       Additionally, check the behaviour when creating tuple instances
-   *       at runtime. Effectively, these are simple record types, which are
-   *       synthesised by recursion over the related typelist.
-   *       - create tuples from a list of values
+   *       at runtime. Effectively, these are simple record types, which
+   *       are synthesised by recursion over the related typelist.
+   *       - diagnostics through TupleAccessor retrieving stored values
+   *       - creating tuples by direct function call, providing values
    *       - copy and copy construct
    *       - access the "head" and access values by numeric index
    *       - create a tuple with shifted values 
@@ -130,7 +126,7 @@ namespace test {
       void
       check_tuple_from_Typelist()
         {
-          typedef Types1::List L1;  // starting from an existing Typelist...
+          typedef Types1::List L1; // starting from an existing Typelist...
           
           typedef Tuple<L1> T_L1;           // ListType based tuple type
           typedef Tuple<L1>::TupleType T1;  // corresponding plain tuple type
@@ -150,6 +146,40 @@ namespace test {
           
           Prepend prepend (22, tup2);       // but note: the ListType based tuple has an "(head,tail)" style ctor
           DUMPVAL (prepend);                // ... and in construction, tup2 has been copied and coerced to ListType style
+          
+          typedef Tuple<Types<> > NulT;     // plain-flat empty Tuple
+          typedef Tuple<NullType> NulL;     // list-style empty Tuple
+          
+          ASSERT (            is_Tuple<T1>::value);
+          ASSERT (       is_TuplePlain<T1>::value);
+          ASSERT (!   is_TupleListType<T1>::value);
+          ASSERT (!       is_NullTuple<T1>::value);
+          
+          ASSERT (          is_Tuple<T_L1>::value);
+          ASSERT (!    is_TuplePlain<T_L1>::value);
+          ASSERT (  is_TupleListType<T_L1>::value);
+          ASSERT (!     is_NullTuple<T_L1>::value);
+          
+          ASSERT (          is_Tuple<NulT>::value);
+          ASSERT (     is_TuplePlain<NulT>::value);
+          ASSERT (! is_TupleListType<NulT>::value);
+          ASSERT (      is_NullTuple<NulT>::value);
+          
+          ASSERT (          is_Tuple<NulL>::value);
+          ASSERT (!    is_TuplePlain<NulL>::value);
+          ASSERT (  is_TupleListType<NulL>::value);
+          ASSERT (      is_NullTuple<NulL>::value);
+          
+          ASSERT (!        is_Tuple<Type1>::value);
+          ASSERT (!   is_TuplePlain<Type1>::value);
+          ASSERT (!is_TupleListType<Type1>::value);
+          ASSERT (!    is_NullTuple<Type1>::value);
+          
+          ASSERT (!        is_Tuple<Types1::List>::value);
+          ASSERT (!   is_TuplePlain<Types1::List>::value);
+          ASSERT (!is_TupleListType<Types1::List>::value);
+          ASSERT (!    is_NullTuple<Types1::List>::value);
+          
         }
       
       
@@ -160,36 +190,36 @@ namespace test {
           
           typedef Append<Types2::List, Types1::List>::List L2;
           
-          typedef Tuple<L2> T_L2;
+          typedef Tuple<L2> T_L2;              // list-style Tuple
           typedef Types<T_L2::HeadType> Head;
           typedef T_L2::TailType Tail;
           DISPLAY (T_L2);
           DISPLAY (Head);
           DISPLAY (Tail);
           
-          typedef T_L2::TupleType T2;
+          typedef T_L2::TupleType T2;          // plain-flat Tuple
           typedef Types<T2::HeadType> Head2;
           typedef T2::TailType Tail2;
           DISPLAY (T2);
           DISPLAY (Head2);
           DISPLAY (Tail2);
           
-          typedef Tuple<Types<> > NulT;
-          typedef Tuple<NullType> NulL;
+          typedef Tuple<Types<> > NulT;        // plain-flat empty Tuple
+          typedef Tuple<NullType> NulL;        // list-style empty Tuple
           
-          DISPLAY (T2::Type);
-          DISPLAY (T2::TailType);
-          DISPLAY (T2::TupleType);
+          DISPLAY (T2::Type);                  // irrespective of the flavour,
+          DISPLAY (T2::TailType);              // a basic set of typedefs is 
+          DISPLAY (T2::TupleType);             // always available
           DISPLAY (T2::ThisType);
           DISPLAY (T2::Tail);
           DISPLAY (T2::ArgList);
           
-          DISPLAY (T_L2::Type);
-          DISPLAY (T_L2::TailType);
-          DISPLAY (T_L2::TupleType);
-          DISPLAY (T_L2::ThisType);
-          DISPLAY (T_L2::Tail);
-          DISPLAY (T_L2::ArgList);
+          DISPLAY (T_L2::Type);                // the element types as type sequence
+          DISPLAY (T_L2::TailType);            // the element types of the "tail" tuple
+          DISPLAY (T_L2::TupleType);           // corresponding plain-flat tuple type
+          DISPLAY (T_L2::ThisType);            // "type_of(this)"
+          DISPLAY (T_L2::Tail);                // tail tuple
+          DISPLAY (T_L2::ArgList);             // typelist comprised of the element types
           
           DISPLAY (NulT::Type);
           DISPLAY (NulT::TailType);
@@ -243,8 +273,8 @@ namespace test {
         {
           cout << "\t:\n\t: ---creating-Tuples---\n";
           
-          Tuple<Types1> tup1  ;                      
-          Tuple<Types1> tup11 (Num<1>(11) );                      
+          Tuple<Types1> tup1  ;
+          Tuple<Types1> tup11 (Num<1>(11) );
           Tuple<Types1> tup12 (Num<1>(),   Num<3>(33) );
           Tuple<Types1> tup13 (Num<1>(11), Num<3>(33), Num<5>() );
           DUMPVAL (tup1);
@@ -253,7 +283,7 @@ namespace test {
           DUMPVAL (tup13);
           
           typedef Tuple<Types<int,int,Num<11> > > Tup2;
-          Tup2 tup2 = tuple::make(41,42, Num<11>(43));
+          Tup2 tup2 = tuple::make(41,42, Num<11>(43));   // build tuple from given values
           DISPLAY (Tup2);
           DUMPVAL (tup2);
           
@@ -298,7 +328,7 @@ namespace test {
           DUMPVAL (tup1);
           
           Tuple<Types1::List> tupL = tup11.getShifted<0>();
-          Tuple<Types1> tup1L (tupL);
+          Tuple<Types1> tup1L (tupL);      // create plain tuple from list-style tuple
           DUMPVAL (tupL);
           DUMPVAL (tup1L);
         }
@@ -320,8 +350,8 @@ namespace test {
           tuple::element<1>(tu2).o_ = 5;
           tu2.getHead() = Num<2> (tu2.getAt<1>().o_);
           DUMPVAL (tu2);
-
-
+          
+          
           tupX.getShifted<2>() = tu2;
           DUMPVAL (tupX);
           
@@ -344,10 +374,10 @@ namespace test {
           TupT tupXcopy (tupX);
           DUMPVAL (tupXcopy);
           
-          TupT& tupXcast (tupX.tupleCast());
+          TupT& tupXcast (tupX.tupleCast());   // (down)cast list-style to plain tuple
           DUMPVAL (tupXcast);
         }
-
+      
     };
   
   

From 909c7a1715c0ee1fd56d4821b58a9440e90446df Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 22 Jun 2009 06:18:13 +0200
Subject: [PATCH 136/368] now core operation of CmdClosure passes compler!

---
 src/proc/control/command-closure.hpp | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 8b626b6b2..4c75feca4 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -195,12 +195,8 @@ namespace control {
       CmdFunctor
       bindArguments (CmdFunctor& unboundFunctor)
         {
-          function<SIG> unboundF (unboundFunctor.getFun<SIG>());
-          TupleApplicator<SIG> appli (params_);
-                
-//          function<void()> boundFunctor = appli.bind (unboundF); ///////TODO: deactivated temporarily 
-          function<void()> boundFun;
-          return CmdFunctor (boundFun);
+          return CmdFunctor (TupleApplicator<SIG> (params_)
+                               .bind ( unboundFunctor.getFun<SIG>()) );
         }
       
       

From 2aee99f2f336f3ceddbe3d1e3980282dd3eb7e2e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 23 Jun 2009 05:54:54 +0200
Subject: [PATCH 137/368] WIP working out the details of Mutation and
 UndoMutation

---
 src/proc/control/command-closure.hpp  | 25 ++++++++++--
 src/proc/control/command-mutation.hpp | 56 ++++++++++++++++++++++-----
 2 files changed, 68 insertions(+), 13 deletions(-)

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 4c75feca4..91052aeae 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -82,7 +82,7 @@ namespace control {
   
   
   class CmdClosure;
-  typedef std::tr1::shared_ptr<CmdClosure> PClo;  ///< smart-ptr type used for handling concrete closures
+  typedef std::tr1::shared_ptr<CmdClosure> PClosure;  ///< smart-ptr type used for handling concrete closures
   
   
   /** Interface */
@@ -91,7 +91,7 @@ namespace control {
     public:
       virtual ~CmdClosure() {}
       
-      virtual PClo clone()  const =0;
+      virtual PClosure clone()  const =0;
       
       virtual operator string()  const =0;
       
@@ -204,10 +204,10 @@ namespace control {
        *  hidden behind the generic CmdClosure interface
        *  and owned by a shared_ptr PClo.
        */
-      PClo
+      PClosure
       clone()  const
         {
-          return PClo (new Closure (this->params_));
+          return PClosure (new Closure (this->params_));
         }
       
       operator string()  const
@@ -215,6 +215,23 @@ namespace control {
           UNIMPLEMENTED ("how to do a string conversion on the variable argument tuple??");
         }
     };
+    
+    
+  /**
+   *  Special kind of Closure, which \em decorates an existing Closure
+   *  and provides a captured state memento as additional parameter on invocation.
+   *  
+   *  @todo concept isn't clear yet. Multiple MementoClosurese are to decorate a single Closure;
+   *        they have to match and extract the concrete type of the Closure and the provided Memento,
+   *        but the latter needs to be erased immediately. Basically, MementoClosure must be able
+   *        to stand-in for an simple parameter closure. 
+   */
+  class MementoClosure
+    : public CmdClosure
+    {
+      
+    };
+    
   ////////////////TODO currently just fleshing  out the API....
   
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index a17f7973e..63a5019ec 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -63,21 +63,25 @@ namespace control {
   class Mutation
     {
       CmdFunctor func_;
-      PClo clo_;
+      Closure* clo_;
       
     public:
       template<typename SIG>
       Mutation (function<SIG> const& func)
-        : func_(func)
+        : func_(func),
+          clo_(0)
         { }
       
       virtual ~Mutation() {}
       
       
       virtual Mutation&
-      close (CmdClosure const& closure)
+      close (Closure& cmdClosure)
         {
-          UNIMPLEMENTED ("accept and store a parameter closure");
+          REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
+          REQUIRE (func_, "Param error: not bound to a valid function");
+          func_ = cmdClosure->bindArguments(func_);
+          clo_ = &cmdClosure;
           return *this;
         }
       
@@ -85,12 +89,15 @@ namespace control {
       void
       operator() ()
         {
-          UNIMPLEMENTED ("invoke the Mutation functor");
+          if (!clo_)
+            throw lumiera::error::State ("Lifecycle error: function arguments not yet provided",
+                                         LUMIERA_ERROR_UNBOUND_ARGUMENTS);
+          invoke (func_);
         }
       
       
       /* == diagnostics == */
-      typedef PClo Mutation::*_unspecified_bool_type;
+      typedef PClosure Mutation::*_unspecified_bool_type;
       
       /** implicit conversion to "bool" */ 
       operator _unspecified_bool_type()  const { return  isValid()? &Mutation::clo_ : 0; }  // never throws
@@ -105,7 +112,20 @@ namespace control {
       virtual bool
       isValid ()   const
         {
-          UNIMPLEMENTED ("mutation lifecycle");
+          return func_ && clo_;
+        }
+      
+      void
+      invoke (CmdFunctor & closedFunction)
+        {
+          closedFunction.getFun<void()>() ();
+        }
+      
+      CmdClosure&
+      getClosure() ///< Interface for subclasses to access the bound parameters
+        {
+          REQUIRE (clo_, "Lifecycle error: function arguments not yet bound");
+          return *clo_;
         }
     };
   
@@ -151,15 +171,33 @@ namespace control {
       Mutation&
       captureState ()
         {
-          UNIMPLEMENTED ("invoke the state capturing Functor");
+          if (!Mutation::isValid())
+            throw lumiera::error::State ("need to bind function arguments prior to capturing undo state",
+                                         LUMIERA_ERROR_UNBOUND_ARGUMENTS);
+          
+          if (!memento_)   // on first invocation we have to close the capture function
+            captureFunc_ = Mutation::getClosure().bindArguments(func_);
+
+          memento_.reset (new MementoClosure (Mutation::getClosure(), invoke(captureFunc_) ))   //////TODO verify exception safety!
+          
+          UNIMPLEMENTED ("how to make the inherited operator() use the extended Parameters (including the memento)???");
+          return *this;
         }
       
       CmdClosure&
       getMemento()
         {
-          UNIMPLEMENTED ("return the closure serving as memento");
+          return *memento_;
         }
       
+    private:
+      virtual bool
+      isValid ()   const
+        {
+          return Mutation::isValid() && captureFunc_ && memento_;
+        }
+      
+      
     };
   ////////////////TODO currently just fleshing  out the API....
   

From 69d6bad1f454e5510d6027e96ab3fa1fdd30efef Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 24 Jun 2009 05:51:02 +0200
Subject: [PATCH 138/368] WIP brainstorming about a way how the extended
 memento capturing closure might work

---
 src/proc/control/command-mutation.hpp         | 26 +++++++---
 .../proc/control/command-mutation-test.cpp    | 48 +++++++++++++++++++
 2 files changed, 68 insertions(+), 6 deletions(-)

diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 63a5019ec..6afe61137 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -168,6 +168,24 @@ namespace control {
         }
       
       
+      virtual Mutation&
+      close (Closure& cmdClosure)
+        {
+          REQUIRE (!memento_,    "Lifecycle error: already closed over the arguments");
+          REQUIRE (captureFunc_, "Param error: not bound to a valid function");
+          
+          // create a special state closure, which can later on store the captured undo state (memento)
+          scoped_ptr<CmdClosure> stateClosure (new MementoClosure (captureFunc_));
+          CmdFunctor closedCaptureFunc = stateClosure->bindArguments(captureFunc_);
+          
+          // the undoFunc (within parent class) will retrieve an argument tuple extended by the memento
+          Mutation::close (stateClosure->decorate (cmdClosure));
+          
+          captureFunc_ = closedCaptureFunc;
+          memento_.swap(stateClosure);
+          return *this;
+        }
+      
       Mutation&
       captureState ()
         {
@@ -175,18 +193,14 @@ namespace control {
             throw lumiera::error::State ("need to bind function arguments prior to capturing undo state",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          if (!memento_)   // on first invocation we have to close the capture function
-            captureFunc_ = Mutation::getClosure().bindArguments(func_);
-
-          memento_.reset (new MementoClosure (Mutation::getClosure(), invoke(captureFunc_) ))   //////TODO verify exception safety!
-          
-          UNIMPLEMENTED ("how to make the inherited operator() use the extended Parameters (including the memento)???");
+          invoke(captureFunc_);
           return *this;
         }
       
       CmdClosure&
       getMemento()
         {
+          ASSERT (memento_, "Lifecycle error: need to close first");
           return *memento_;
         }
       
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index 79b54d723..ddfd59047 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -41,6 +41,7 @@
 #include <tr1/functional>
 //#include <boost/format.hpp>
 #include <iostream>
+#include <cstdlib>
 #include <string>
 
 using std::tr1::bind;
@@ -51,6 +52,7 @@ using std::tr1::function;
 //using lumiera::Time;
 //using util::contains;
 using std::string;
+using std::rand;
 using std::cout;
 using std::endl;
 
@@ -135,6 +137,8 @@ namespace test    {
           functor.close(clo);
           ASSERT (functor);
           
+          cout << "param values: " << clo << endl;
+          
           testVal = 0;
           functor();
           ASSERT (testVal == 23);
@@ -202,6 +206,50 @@ namespace test    {
           clonedFunc();
           ASSERT (testVal == 42);
         }
+      
+      
+      void
+      checkStateCapturingClosure ()
+        {
+          function<void(int)> undo_func  = bind (&testFunc,_1);
+          function<int(void)> cap_func   = bind (&capture    );
+          
+          MementoClosure memClo (cap_func);
+          CmdFunctor closed_cap_func = memClo.bindArguments (cap_func);
+          Tuple<Types<> > param;
+          Closure<void()> clo (param);
+          cout << "plain param values: " << clo << endl;
+          
+          Closure<void(int)> extendedClo = memClo.decorate (clo);
+          cout << "params including memento storage: " << extendedClo << endl;
+          
+          CmdFunctor closed_undo_func = extendedClo.bindArguments (undo_func);
+          
+          VERIFY_ERROR (MISSING_MEMENTO, closed_undo_func() );     // invalid, because no state was captured
+          
+          int rr (rand() %100);
+          
+          testVal = rr;
+          closed_cap_func();      // invoke state capturing 
+          
+          cout << "params including memento: " << memClo << endl;
+          cout << "captured memento state  : " << extendedClo << endl;
+          
+          testVal = -10;          // meanwhile "somehow" mutate the state
+          
+          closed_undo_func();     // invoking the undo() feeds back the memento
+          ASSERT (rr == testVal); // which is then restored into the state
+          
+          // this cycle can be repeated with different state values
+          rr = (rand() %100);
+          testVal = rr;
+          closed_cap_func();      // capture new state
+          cout << "params including memento: " << memClo << endl;
+                                //   ....note the changed memento!
+          testVal = -20;
+          closed_undo_func();
+          ASSERT (rr == testVal);
+        }
     };
   
   

From 53e882ca3e095ef399ccb410804d57b5ad66e804 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 24 Jun 2009 06:01:14 +0200
Subject: [PATCH 139/368] WIP should also cover the detection of empty functors

---
 .../proc/control/command-basic-test.cpp       |  2 ++
 tests/lib/meta/function-erasure-test.cpp      | 19 +++++++++++++++++++
 2 files changed, 21 insertions(+)

diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index a47209ad7..76ccc20a1 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -44,6 +44,7 @@
 #include <tr1/functional>
 //#include <boost/format.hpp>
 #include <iostream>
+#include <cstdlib>
 #include <string>
 
 using std::tr1::bind;
@@ -54,6 +55,7 @@ using std::tr1::function;
 using lumiera::Time;
 //using util::contains;
 using std::string;
+using std::rand;
 using std::cout;
 using std::endl;
 
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index be7d6a8ae..16024e5c6 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -76,6 +76,10 @@ namespace test {
           
           check_FunctPtrHolder(Efp(testFunc),Efp(&testFunc), Efp(returnIt));
           check_VoidPtrHolder(Evoid(testFunc),Evoid(&testFunc),Evoid(returnIt));
+          
+          detect_unboundFunctor(Efun(testFunc), Efun(getterFunc), Efun(membFunc));
+          detect_unboundFunctor(Efp(testFunc),Efp(&testFunc), Efp(returnIt));
+          detect_unboundFunctor(Evoid(testFunc),Evoid(&testFunc),Evoid(returnIt));
         }
       
       void
@@ -193,6 +197,21 @@ namespace test {
           
         //(*bad_fun) (11, 'x');  // The compiler would accept this line!
         }                       //  likely to result in heap corruption or SEGV
+      
+      
+      template<class HOL>
+      void
+      detect_unboundFunctor(HOL h1, HOL h2, HOL h3)
+        {
+          // fabricate an unbound functor...
+          function<long(int,char)> emptyFunc;
+          HOL emptyHolder (emptyFunc);
+          ASSERT (!emptyHolder);
+          ASSERT ( h1 );
+          ASSERT ( h2 );
+          ASSERT ( h3 );
+        }
+
     };
   
   

From 5ab8c126e0a8c54da0e13ed441b1cf3729626bdd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 24 Jun 2009 06:38:33 +0200
Subject: [PATCH 140/368] WIP compilation fixes and stubs; split off
 MementoClosure (incl. separate unit test)

---
 src/proc/control/command-closure.hpp          |  15 --
 src/proc/control/command-mutation.hpp         |  18 +-
 src/proc/control/memento-closure.hpp          | 114 ++++++++++++
 tests/45controller.tests                      |   4 +
 tests/components/Makefile.am                  |   1 +
 .../proc/control/memento-closure-test.cpp     | 173 ++++++++++++++++++
 6 files changed, 302 insertions(+), 23 deletions(-)
 create mode 100644 src/proc/control/memento-closure.hpp
 create mode 100644 tests/components/proc/control/memento-closure-test.cpp

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 91052aeae..f309d0aef 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -217,21 +217,6 @@ namespace control {
     };
     
     
-  /**
-   *  Special kind of Closure, which \em decorates an existing Closure
-   *  and provides a captured state memento as additional parameter on invocation.
-   *  
-   *  @todo concept isn't clear yet. Multiple MementoClosurese are to decorate a single Closure;
-   *        they have to match and extract the concrete type of the Closure and the provided Memento,
-   *        but the latter needs to be erased immediately. Basically, MementoClosure must be able
-   *        to stand-in for an simple parameter closure. 
-   */
-  class MementoClosure
-    : public CmdClosure
-    {
-      
-    };
-    
   ////////////////TODO currently just fleshing  out the API....
   
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 6afe61137..4bbede998 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -38,6 +38,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "proc/control/command-closure.hpp"
+#include "proc/control/memento-closure.hpp"
 
 //#include <tr1/memory>
 #include <boost/scoped_ptr.hpp>
@@ -57,13 +58,17 @@ namespace control {
   using std::string;
   
   
+  LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Mutation functor not yet usable, because arguments aren't bound
+  LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);   ///<  Undo functor not yet usable, because no undo state has been captured
+  
+  
   /**
    * @todo Type-comment
    */
   class Mutation
     {
       CmdFunctor func_;
-      Closure* clo_;
+      CmdClosure* clo_;
       
     public:
       template<typename SIG>
@@ -76,11 +81,11 @@ namespace control {
       
       
       virtual Mutation&
-      close (Closure& cmdClosure)
+      close (CmdClosure& cmdClosure)
         {
           REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
           REQUIRE (func_, "Param error: not bound to a valid function");
-          func_ = cmdClosure->bindArguments(func_);
+          func_ = cmdClosure.bindArguments(func_);
           clo_ = &cmdClosure;
           return *this;
         }
@@ -97,7 +102,7 @@ namespace control {
       
       
       /* == diagnostics == */
-      typedef PClosure Mutation::*_unspecified_bool_type;
+      typedef CmdClosure* Mutation::*_unspecified_bool_type;
       
       /** implicit conversion to "bool" */ 
       operator _unspecified_bool_type()  const { return  isValid()? &Mutation::clo_ : 0; }  // never throws
@@ -169,7 +174,7 @@ namespace control {
       
       
       virtual Mutation&
-      close (Closure& cmdClosure)
+      close (CmdClosure& cmdClosure)
         {
           REQUIRE (!memento_,    "Lifecycle error: already closed over the arguments");
           REQUIRE (captureFunc_, "Param error: not bound to a valid function");
@@ -215,9 +220,6 @@ namespace control {
     };
   ////////////////TODO currently just fleshing  out the API....
   
-  
-  LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Mutation functor not yet usable, because arguments aren't bound
-  LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);   ///<  Undo functor not yet usable, because no undo state has been captured
     
   
   
diff --git a/src/proc/control/memento-closure.hpp b/src/proc/control/memento-closure.hpp
new file mode 100644
index 000000000..f97b1337e
--- /dev/null
+++ b/src/proc/control/memento-closure.hpp
@@ -0,0 +1,114 @@
+/*
+  MEMENTO-CLOSURE.hpp  -  capturing and providing state for undoing commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file memento-closure.hpp
+ ** Extension to the CmdClosure for storing and retrieving a state memento.
+ ** //TODO
+ **  
+ ** @see CmdClosure
+ ** @see UndoMutation
+ ** @see memento-closure-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_MEMENTO_CLOSURE_H
+#define CONTROL_MEMENTO_CLOSURE_H
+
+//#include "pre.hpp"
+//#include "lib/meta/typelist.hpp"  ////////////////TODO include these??
+//#include "lib/meta/function.hpp"
+//#include "lib/meta/function-closure.hpp"
+//#include "lib/meta/function-erasure.hpp"
+//#include "lib/meta/tuple.hpp"
+#include "proc/control/command-closure.hpp"
+#include "lib/util.hpp"
+
+//#include <tr1/memory>
+//#include <tr1/functional>
+//#include <iostream> 
+//#include <string>
+
+
+#include "lib/test/test-helper.hpp"  /////////////////TODO remove this
+using lib::test::showSizeof;
+
+using std::cout;    //////////////////////////////////TODO remove this
+using std::endl;
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+//  using util::unConst;
+  using std::string;
+//  using std::ostream;
+//  using std::tr1::function;
+//  using lumiera::typelist::FunctionSignature;
+//  using lumiera::typelist::Tuple;
+//  using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::typelist::TupleApplicator;
+//  using lumiera::typelist::FunErasure;
+//  using lumiera::typelist::StoreFunction;
+  
+//  using lumiera::typelist::NullType;
+    
+  
+  
+  /**
+   *  Special kind of Closure, which \em decorates an existing Closure
+   *  and provides a captured state memento as additional parameter on invocation.
+   *  
+   *  @todo concept isn't clear yet. Multiple MementoClosurese are to decorate a single Closure;
+   *        they have to match and extract the concrete type of the Closure and the provided Memento,
+   *        but the latter needs to be erased immediately. Basically, MementoClosure must be able
+   *        to stand-in for an simple parameter closure. 
+   */
+  class MementoClosure
+    : public CmdClosure   ///////////TODO hierarachy?
+    {
+    public:
+      
+      virtual PClosure clone()  const =0;
+      
+      virtual operator string()  const =0;
+      
+      virtual CmdFunctor bindArguments (CmdFunctor&) =0;
+      
+      
+      ////////////TODO how to give access to the following dedicated API?
+      CmdClosure& decorate (CmdClosure& core) 
+        {
+          return *this; // TODO would be nice, but probably won't be thus simple ;-) 
+        }
+    };
+    
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/tests/45controller.tests b/tests/45controller.tests
index b49080ee9..761354de1 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -9,3 +9,7 @@ END
 
 PLANNED "CommandMutation_test" CommandMutation_test <<END
 END
+
+
+PLANNED "MementoClosure_test" MementoClosure_test <<END
+END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 3861b01db..783d21ce4 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -49,6 +49,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/asset/testasset.cpp			\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/memento-closure-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
 	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
diff --git a/tests/components/proc/control/memento-closure-test.cpp b/tests/components/proc/control/memento-closure-test.cpp
new file mode 100644
index 000000000..d27d06de7
--- /dev/null
+++ b/tests/components/proc/control/memento-closure-test.cpp
@@ -0,0 +1,173 @@
+/*
+  MementoClosure(Test)  -  check the mechanism for capturing and providing undo-state
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/memento-closure.hpp"
+//#include "lib/meta/typelist.hpp"
+#include "lib/meta/tuple.hpp"
+//#include "lib/lumitime.hpp"
+//#include "lib/util.hpp"
+
+#include <tr1/functional>
+//#include <boost/format.hpp>
+#include <iostream>
+#include <cstdlib>
+#include <string>
+
+using std::tr1::bind;
+//using std::tr1::placeholders::_1;
+//using std::tr1::placeholders::_2;
+using std::tr1::function;
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+using std::rand;
+using std::cout;
+using std::endl;
+
+
+namespace control {
+namespace test    {
+
+  using lib::test::showSizeof;
+
+//  using session::test::TestClip;
+//  using lumiera::P;
+  using namespace lumiera::typelist;
+  using lumiera::typelist::Tuple;
+  
+  using control::CmdClosure;
+  
+  
+  
+  
+  
+  
+  namespace {                                                     /////////////////TODO: use a more interesting function here.....
+  
+    int testVal=0;  ///< used to verify the effect of testFunc
+  
+    void
+    testFunc (int val)
+    {
+      testVal += val;
+    }
+    
+    int
+    capture ()
+    {
+      return testVal;
+    }
+  
+  }
+  
+  
+  
+  /***************************************************************************
+   * Verify the state capturing mechanism (memento), which is used
+   * to implement the Undo() functionality for Proc-Layer commands
+   *       
+   * @see  control::Command
+   * @see  control::CmdClosure
+   * @see  control::UndoMutation
+   * @see  command-mutation-test.hpp
+   */
+  class MementoClosure_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          checkStateCapturingClosure();
+        }
+      
+      
+      /** @test check the functionality used to implement UndoMutation:
+       *        bind an undo function and a state capturing function
+       *        and use the latter to define the special CmdClosure
+       *        with the ability hold the memento and bind it into
+       *        the relevant parameter of the undo function.
+       *        Verify that, after closing the functions, actually
+       *        state is captured by each invocation.
+       */
+      void
+      checkStateCapturingClosure ()
+        {
+          function<void(int)> undo_func  = bind (&testFunc,_1);
+          function<int(void)> cap_func   = bind (&capture    );
+          
+          MementoClosure memClo (cap_func);
+          CmdFunctor closed_cap_func = memClo.bindArguments (cap_func);
+          Tuple<Types<> > param;
+          Closure<void()> clo (param);
+          cout << "plain param values: " << clo << endl;
+          
+          Closure<void(int)> extendedClo = memClo.decorate (clo);
+          cout << "params including memento storage: " << extendedClo << endl;
+          
+          CmdFunctor closed_undo_func = extendedClo.bindArguments (undo_func);
+          
+          VERIFY_ERROR (MISSING_MEMENTO, closed_undo_func() );     // invalid, because no state was captured
+          
+          int rr (rand() %100);
+          
+          testVal = rr;
+          closed_cap_func();      // invoke state capturing 
+          
+          cout << "params including memento: " << memClo << endl;
+          cout << "captured memento state  : " << extendedClo << endl;
+          
+          testVal = -10;          // meanwhile "somehow" mutate the state
+          
+          closed_undo_func();     // invoking the undo() feeds back the memento
+          ASSERT (rr == testVal); // which is then restored into the state
+          
+          // this cycle can be repeated with different state values
+          rr = (rand() %100);
+          testVal = rr;
+          closed_cap_func();      // capture new state
+          cout << "params including memento: " << memClo << endl;
+                                //   ....note the changed memento!
+          testVal = -20;
+          closed_undo_func();
+          ASSERT (rr == testVal);
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (MementoClosure_test, "unit controller");
+      
+      
+}} // namespace control::test

From e91cdd39e9f5503cf055595f14df2c4a6592f849 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 26 Jun 2009 05:27:24 +0200
Subject: [PATCH 141/368] stubbed and commented out to get it to compile

---
 src/proc/control/command-mutation.hpp         | 10 ++++-----
 src/proc/control/command.cpp                  |  7 ++++++
 src/proc/control/memento-closure.hpp          | 22 ++++++++++++++-----
 .../proc/control/command-mutation-test.cpp    |  4 +++-
 .../proc/control/memento-closure-test.cpp     |  2 ++
 tests/lib/meta/function-erasure-test.cpp      | 19 +++++++++++-----
 6 files changed, 47 insertions(+), 17 deletions(-)

diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 4bbede998..df32cfe22 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -84,7 +84,7 @@ namespace control {
       close (CmdClosure& cmdClosure)
         {
           REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
-          REQUIRE (func_, "Param error: not bound to a valid function");
+//          REQUIRE (func_, "Param error: not bound to a valid function");
           func_ = cmdClosure.bindArguments(func_);
           clo_ = &cmdClosure;
           return *this;
@@ -117,7 +117,7 @@ namespace control {
       virtual bool
       isValid ()   const
         {
-          return func_ && clo_;
+//          return func_ && clo_;
         }
       
       void
@@ -177,14 +177,14 @@ namespace control {
       close (CmdClosure& cmdClosure)
         {
           REQUIRE (!memento_,    "Lifecycle error: already closed over the arguments");
-          REQUIRE (captureFunc_, "Param error: not bound to a valid function");
+//          REQUIRE (captureFunc_, "Param error: not bound to a valid function");
           
           // create a special state closure, which can later on store the captured undo state (memento)
           scoped_ptr<CmdClosure> stateClosure (new MementoClosure (captureFunc_));
           CmdFunctor closedCaptureFunc = stateClosure->bindArguments(captureFunc_);
           
           // the undoFunc (within parent class) will retrieve an argument tuple extended by the memento
-          Mutation::close (stateClosure->decorate (cmdClosure));
+//          Mutation::close (stateClosure->decorate (cmdClosure));
           
           captureFunc_ = closedCaptureFunc;
           memento_.swap(stateClosure);
@@ -213,7 +213,7 @@ namespace control {
       virtual bool
       isValid ()   const
         {
-          return Mutation::isValid() && captureFunc_ && memento_;
+//          return Mutation::isValid() && captureFunc_ && memento_;
         }
       
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 54e4b0888..fca9a6a8e 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -50,6 +50,13 @@ namespace control {
   {
     UNIMPLEMENTED ("fetch an existing command from the internal cmd registry");
   }
+  
+  
+  MementoClosure::MementoClosure (CmdFunctor&)
+  {
+    
+  }
+  
 
   
   
diff --git a/src/proc/control/memento-closure.hpp b/src/proc/control/memento-closure.hpp
index f97b1337e..14741bca8 100644
--- a/src/proc/control/memento-closure.hpp
+++ b/src/proc/control/memento-closure.hpp
@@ -87,18 +87,30 @@ namespace control {
    *        to stand-in for an simple parameter closure. 
    */
   class MementoClosure
-    : public CmdClosure   ///////////TODO hierarachy?
+    : public CmdClosure   ///////////TODO hierararchy?
     {
     public:
       
-      virtual PClosure clone()  const =0;
+      virtual PClosure clone()  const
+        {
+          return PClosure (new MementoClosure (*this));
+        }
+
+      virtual operator string()  const
+        {
+          return "TODO";
+        }
       
-      virtual operator string()  const =0;
-      
-      virtual CmdFunctor bindArguments (CmdFunctor&) =0;
+      virtual CmdFunctor bindArguments (CmdFunctor&)
+        {
+          UNIMPLEMENTED ("binding operation");
+        }
       
       
       ////////////TODO how to give access to the following dedicated API?
+      MementoClosure (CmdFunctor&);
+      
+      
       CmdClosure& decorate (CmdClosure& core) 
         {
           return *this; // TODO would be nice, but probably won't be thus simple ;-) 
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index ddfd59047..424a66445 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -213,7 +213,8 @@ namespace test    {
         {
           function<void(int)> undo_func  = bind (&testFunc,_1);
           function<int(void)> cap_func   = bind (&capture    );
-          
+
+#if false ////////////////////////////////////////////////////////////////////TODO: doesn't compile, lots of undefined stuff          
           MementoClosure memClo (cap_func);
           CmdFunctor closed_cap_func = memClo.bindArguments (cap_func);
           Tuple<Types<> > param;
@@ -249,6 +250,7 @@ namespace test    {
           testVal = -20;
           closed_undo_func();
           ASSERT (rr == testVal);
+#endif          
         }
     };
   
diff --git a/tests/components/proc/control/memento-closure-test.cpp b/tests/components/proc/control/memento-closure-test.cpp
index d27d06de7..62598dc85 100644
--- a/tests/components/proc/control/memento-closure-test.cpp
+++ b/tests/components/proc/control/memento-closure-test.cpp
@@ -127,6 +127,7 @@ namespace test    {
           function<void(int)> undo_func  = bind (&testFunc,_1);
           function<int(void)> cap_func   = bind (&capture    );
           
+#if false ////////////////////////////////////////////////////////////////////////TODO doesn't compile yet, lots of missing stuff          
           MementoClosure memClo (cap_func);
           CmdFunctor closed_cap_func = memClo.bindArguments (cap_func);
           Tuple<Types<> > param;
@@ -162,6 +163,7 @@ namespace test    {
           testVal = -20;
           closed_undo_func();
           ASSERT (rr == testVal);
+#endif          
         }
     };
   
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 16024e5c6..6d98582f1 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -46,6 +46,11 @@ namespace test {
   typedef FunErasure<StoreFunPtr>   Efp;
   typedef FunErasure<StoreUncheckedFunPtr> Evoid;
   
+  template<class HOL>
+  struct BuildEmptyHolder       { typedef long (*Type)(int,char); };
+  template<>
+  struct BuildEmptyHolder<Efun> { typedef function<long(int,char)> Type; };
+  
   
   /***********************************************************************
    * @test Create specifically typed functor objects and then wrap them
@@ -204,13 +209,15 @@ namespace test {
       detect_unboundFunctor(HOL h1, HOL h2, HOL h3)
         {
           // fabricate an unbound functor...
-          function<long(int,char)> emptyFunc;
-          HOL emptyHolder (emptyFunc);
-          ASSERT (!emptyHolder);
-          ASSERT ( h1 );
-          ASSERT ( h2 );
-          ASSERT ( h3 );
+          
+          typedef typename BuildEmptyHolder<HOL>::Type EmptyHolder;
+          EmptyHolder emptyHolder;
+//          ASSERT (!emptyHolder);
+//          ASSERT ( h1 );
+//          ASSERT ( h2 );
+//          ASSERT ( h3 );
         }
+      
 
     };
   

From daeff6f5fdb7ac1c916bcde876aa2a65444ca676 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 26 Jun 2009 05:27:54 +0200
Subject: [PATCH 142/368] WIP: how to define the bool conversion / validity
 check for the function holders?

---
 src/lib/meta/function-erasure.hpp | 26 +++++++++++++++++++++-
 src/tool/try.cpp                  | 36 +++++++++++++++++++++++++------
 2 files changed, 55 insertions(+), 7 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 0696b6a42..664e49e20 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -93,7 +93,24 @@ namespace typelist{
   
     
   /* ====== Policy classes ====== */
-  
+
+  template<class T>
+  struct BoolCheckable
+    {
+      typedef bool (T::*ValidityCheck)()  const;
+      typedef ValidityCheck _unspecified_bool_type;
+      ValidityCheck isValid;
+      
+      BoolCheckable() : isValid (&T::isValid) {}
+      
+      /** implicit conversion to "bool" */ 
+      operator _unspecified_bool_type()  const { T const& obj = *this;
+                                                 return  (obj.*isValid)()? isValid : 0; }  // never throws
+      bool operator! ()                  const { T const& obj = *this;
+                                                 return !(obj.*isValid)(); }                       //  ditto
+      
+    };
+    
   /** 
    * Policy for FunErasure: store an embedded tr1::function
    * Using this policy allows to store arbitrary complex functor objects
@@ -101,6 +118,7 @@ namespace typelist{
    * The price to pay is vtable access and heap storage of function arguments. 
    */
   class StoreFunction
+//    : public BoolCheckable<StoreFunction>
     {
       /** Helper: type erasure */
       struct Holder
@@ -155,6 +173,12 @@ namespace typelist{
           REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
           return static_cast<FunctionHolder<SIG>&> (holder_).get();
         }
+      
+      bool
+      isValid()  const
+        {
+          return reinterpret_cast<void*> (holder_.storage_[0]);
+        }
     };
   
   
diff --git a/src/tool/try.cpp b/src/tool/try.cpp
index d6b3a95b9..78ba1d0aa 100644
--- a/src/tool/try.cpp
+++ b/src/tool/try.cpp
@@ -12,16 +12,20 @@
 // 5/08  - how to guard a downcasting access, so it is compiled in only if the involved types are convertible
 // 7/08  - combining partial specialisation and subclasses 
 // 10/8  - abusing the STL containers to hold noncopyable values
+// 6/09  - investigating how to build a mixin template providing an operator bool()
 
 
 #include <nobug.h>
 //#include "include/nobugcfg.h"
+#include "lib/meta/function-erasure.hpp"
 
 #include <iostream>
 //#include <typeinfo>
 #include <boost/format.hpp>
-//#include <boost/noncopyable.hpp>
+#include <cstdlib>
 
+
+using std::rand;
 using std::string;
 using std::cout;
 using boost::format;
@@ -32,6 +36,24 @@ using boost::format;
       long checksum = 0;
   }
   
+  struct TestIt1
+    : lumiera::typelist::BoolCheckable<TestIt1>
+    {
+      
+      int val_;
+      
+      TestIt1 (int v = (rand() % 10))
+        : val_(v)
+        { }
+      
+      bool
+      isValid()  const
+        {
+          return true;
+        }
+      
+    };
+    
   
   
 int 
@@ -39,13 +61,15 @@ main (int argc, char* argv[])
   {
     
     NOBUG_INIT;
+   
+    TestIt1 testrosteron (22);
+    
+    bool boo = true; //testrosteron;
+    if (!boo)
+      return -1;
     
     cout <<  "\n.gulp.\n";
-   
-   int * p = 0;
-
-   int oh = *p;
-
+    
     
     return 0;
   }

From b8182f4341ee08c094466f5e4a0da290f8d47736 Mon Sep 17 00:00:00 2001
From: Joel Holdsworth <joel@airwebreathe.org.uk>
Date: Fri, 26 Jun 2009 11:14:01 +0100
Subject: [PATCH 143/368] Removed the toolbar

---
 src/gui/workspace/workspace-window.cpp | 9 +--------
 1 file changed, 1 insertion(+), 8 deletions(-)

diff --git a/src/gui/workspace/workspace-window.cpp b/src/gui/workspace/workspace-window.cpp
index b9db9b5d5..5a74c526f 100644
--- a/src/gui/workspace/workspace-window.cpp
+++ b/src/gui/workspace/workspace-window.cpp
@@ -99,14 +99,7 @@ WorkspaceWindow::create_ui()
   Gtk::Widget* menu_bar = uiManager->get_widget("/MenuBar");
   REQUIRE(menu_bar != NULL);
   baseContainer.pack_start(*menu_bar, Gtk::PACK_SHRINK);
-  
-  //----- Set up the Tool Bar -----//
-  Gtk::Toolbar* toolbar = dynamic_cast<Gtk::Toolbar*>(
-    uiManager->get_widget("/ToolBar"));
-  REQUIRE(toolbar != NULL);
-  toolbar->set_toolbar_style(TOOLBAR_ICONS);
-  baseContainer.pack_start(*toolbar, Gtk::PACK_SHRINK);
-  
+
   //----- Create the Docks -----//
   panelManager.setup_dock();
   

From a30461780b82a32c54e42c8327fecc2514c78494 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 26 Jun 2009 16:38:37 +0200
Subject: [PATCH 144/368] this way it works, but would cost additional
 storage....

---
 src/lib/meta/function-erasure.hpp | 15 +++++++++++----
 src/tool/try.cpp                  |  9 +++++----
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 664e49e20..b5299d186 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -104,10 +104,17 @@ namespace typelist{
       BoolCheckable() : isValid (&T::isValid) {}
       
       /** implicit conversion to "bool" */ 
-      operator _unspecified_bool_type()  const { T const& obj = *this;
-                                                 return  (obj.*isValid)()? isValid : 0; }  // never throws
-      bool operator! ()                  const { T const& obj = *this;
-                                                 return !(obj.*isValid)(); }                       //  ditto
+      operator _unspecified_bool_type()  const   ///< never throws
+        {
+          T const& obj = static_cast<T const&> (*this);
+          return  (obj.*isValid)()? isValid : 0;
+        }
+      
+      bool operator! ()  const ///< never throws
+        {
+          T const& obj = static_cast<T const&> (*this);
+          return !(obj.*isValid)();
+        }
       
     };
     
diff --git a/src/tool/try.cpp b/src/tool/try.cpp
index 78ba1d0aa..f4e6e1a4f 100644
--- a/src/tool/try.cpp
+++ b/src/tool/try.cpp
@@ -57,19 +57,20 @@ using boost::format;
   
   
 int 
-main (int argc, char* argv[])
+main (int, char**) //(int argc, char* argv[])
   {
     
     NOBUG_INIT;
    
     TestIt1 testrosteron (22);
     
-    bool boo = true; //testrosteron;
-    if (!boo)
-      return -1;
+    bool boo = testrosteron;
     
     cout <<  "\n.gulp.\n";
     
+    if (boo)
+      cout << "size=" << sizeof(TestIt1) <<"\n";
+    
     
     return 0;
   }

From 5291f6e41a1ffe75193b7e7a2c7af08044a50ceb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 26 Jun 2009 17:13:36 +0200
Subject: [PATCH 145/368] move the member pointer to the current stack frame...
 hopefully the optimiser will remove it completely ;-)

---
 src/lib/meta/function-erasure.hpp |  5 ++---
 src/tool/try.cpp                  | 20 ++++++++++++--------
 2 files changed, 14 insertions(+), 11 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index b5299d186..460143baf 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -99,19 +99,18 @@ namespace typelist{
     {
       typedef bool (T::*ValidityCheck)()  const;
       typedef ValidityCheck _unspecified_bool_type;
-      ValidityCheck isValid;
-      
-      BoolCheckable() : isValid (&T::isValid) {}
       
       /** implicit conversion to "bool" */ 
       operator _unspecified_bool_type()  const   ///< never throws
         {
+          ValidityCheck isValid (&T::isValid);
           T const& obj = static_cast<T const&> (*this);
           return  (obj.*isValid)()? isValid : 0;
         }
       
       bool operator! ()  const ///< never throws
         {
+          ValidityCheck isValid (&T::isValid);
           T const& obj = static_cast<T const&> (*this);
           return !(obj.*isValid)();
         }
diff --git a/src/tool/try.cpp b/src/tool/try.cpp
index f4e6e1a4f..f2496df9c 100644
--- a/src/tool/try.cpp
+++ b/src/tool/try.cpp
@@ -49,7 +49,7 @@ using boost::format;
       bool
       isValid()  const
         {
-          return true;
+          return val_ % 2;
         }
       
     };
@@ -61,16 +61,20 @@ main (int, char**) //(int argc, char* argv[])
   {
     
     NOBUG_INIT;
-   
-    TestIt1 testrosteron (22);
     
-    bool boo = testrosteron;
+    for (int i=0; i<10; ++i)
+      {
+        TestIt1 testrosteron (i);
+        
+        if (testrosteron)
+          cout << "doIt \n";
+        if (!testrosteron)
+          cout << i << "\n";
+      }
+    cout << "size=" << sizeof(TestIt1) <<"\n";
+    
     
     cout <<  "\n.gulp.\n";
     
-    if (boo)
-      cout << "size=" << sizeof(TestIt1) <<"\n";
-    
-    
     return 0;
   }

From b45cd49c8b24c1646612cb5ba2266689102c07d6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 26 Jun 2009 18:50:30 +0200
Subject: [PATCH 146/368] separate header + unit test for this bool check mixin

---
 .../{accesscasted.hpp => access-casted.hpp}   |  30 ++---
 src/lib/bool-checkable.hpp                    | 121 ++++++++++++++++++
 src/lib/frameid.hpp                           |   4 +-
 src/lib/wrapperptr.hpp                        |   2 +-
 src/proc/engine/nodeinvocation.hpp            |   4 +-
 src/proc/state.hpp                            |   6 +-
 src/tool/try.cpp                              |   4 +-
 tests/40components.tests                      |  27 +++-
 tests/lib/Makefile.am                         |   1 +
 tests/lib/bool-checkable-test.cpp             | 105 +++++++++++++++
 10 files changed, 276 insertions(+), 28 deletions(-)
 rename src/lib/{accesscasted.hpp => access-casted.hpp} (88%)
 create mode 100644 src/lib/bool-checkable.hpp
 create mode 100644 tests/lib/bool-checkable-test.cpp

diff --git a/src/lib/accesscasted.hpp b/src/lib/access-casted.hpp
similarity index 88%
rename from src/lib/accesscasted.hpp
rename to src/lib/access-casted.hpp
index b6832f37f..1a5d69f72 100644
--- a/src/lib/accesscasted.hpp
+++ b/src/lib/access-casted.hpp
@@ -1,5 +1,5 @@
 /*
-  ACCESSCASTED.hpp  -  util template to access a value using conversion or cast as appropriate
+  ACCESS-CASTED.hpp  -  util template to access a value using conversion or cast as appropriate
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,13 +21,13 @@
 */
 
 
-/** @file accesscasted.hpp
- ** Helper for accessing a value employing either conversion or downcast
+/** @file access-casted.hpp
+ ** Helper for accessing a value, employing either conversion or downcast,
  ** depending on the relation of the source type (type of the original value)
  ** and the target type (type we need within the usage context). 
  ** When instantiating AcessCasted<TAR>, we get a template static function
  ** \c AcessCasted<TAR>::access<SRC>(SRC& elm), but the actual implementation
- ** is chosen using boost::type_traits. If no viable implementation can be
+ ** is chosen using boost::type_traits. If no sensible implementation can be
  ** selected, \c EmptyVal<TAR>::create() is invoked instead, which by default
  ** creates a NULL value or similar by using the no-argument ctor of the
  ** type TAR. Alternatively, you may define an specialisation of EmptyVal,
@@ -38,8 +38,8 @@
  */
 
 
-#ifndef UTIL_ACCESSCASTED_H
-#define UTIL_ACCESSCASTED_H
+#ifndef UTIL_ACCESS_CASTED_H
+#define UTIL_ACCESS_CASTED_H
 
 #include <boost/utility/enable_if.hpp>
 #include <boost/type_traits/remove_pointer.hpp>
@@ -143,23 +143,23 @@ namespace util {
       
       template<typename ELM>
       static  typename enable_if< use_dynamic_downcast<ELM&,TAR>, TAR>::type
-      access (ELM& elem) 
-        { 
-          return dynamic_cast<TAR> (elem); 
+      access (ELM& elem)
+        {
+          return dynamic_cast<TAR> (elem);
         }
       
       template<typename ELM>
       static  typename enable_if< use_static_downcast<ELM&,TAR>, TAR>::type
-      access (ELM& elem) 
-        { 
-          return static_cast<TAR> (elem); 
+      access (ELM& elem)
+        {
+          return static_cast<TAR> (elem);
         }
       
       template<typename ELM>
       static  typename enable_if< use_conversion<ELM&,TAR>, TAR>::type
-      access (ELM& elem) 
-        { 
-          return elem; 
+      access (ELM& elem)
+        {
+          return elem;
         }
     };
   
diff --git a/src/lib/bool-checkable.hpp b/src/lib/bool-checkable.hpp
new file mode 100644
index 000000000..d10a1a150
--- /dev/null
+++ b/src/lib/bool-checkable.hpp
@@ -0,0 +1,121 @@
+/*
+  BOOL-CHECKABLE.hpp  -  mixin template for defining a safe conversion to bool
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file bool-checkable.hpp
+ ** When working with generic function objects and function pointers typed to
+ ** arbitrary signatures, often there is the necessity to hold onto such a functor
+ ** while hiding the actual signature behind an common interface ("type erasure").
+ ** The usual solution based on subclassing has the downside of requiring separate
+ ** storage for the concrete functor object, which might become problematic when
+ ** dealing with lots of functor objects. 
+ ** 
+ ** Especially when dealing with tr1::function objects, all of the type differences
+ ** are actually encoded into 3 internal pointers, thus yielding the same size for
+ ** all various types of functors. Building on this observation, we can create an
+ ** common container object to store the varying functors inline, while hiding the
+ ** actual signature.
+ ** 
+ ** There remains the problem of re-accessing the concrete functor later on. As
+ ** C++ has only rudimental introspection capabilities, we can only rely on the
+ ** usage context to provide the correct function signature; only when using a
+ ** virtual function for the re-access, we can perform at least a runtime-check.
+ ** 
+ ** Thus there are various flavours for actually implementing this idea, and the
+ ** picking a suitable implementation depends largely on the context. Thus we
+ ** provide a common and expect the client code to pick an implementation policy.
+ ** 
+ ** @see control::Mutation usage example
+ ** @see function-erasure-test.cpp
+ ** 
+ */
+
+
+#ifndef LIB_BOOL_CHECKABLE_H
+#define LIB_BOOL_CHECKABLE_H
+
+
+
+namespace lib {
+  
+  
+  
+  
+  /*
+   * Provide an implicit conversion to "bool".
+   * Inherit (mix-in) from this template by providing the
+   * concrete subclass type ("CRTP"). Additionally, to implement
+   * the specific logic of this bool check, the subclass using this
+   * template must provide a public function \c isValid() 
+   * 
+   * \par safe bool conversion
+   * Generally speaking, a direct automatic conversion to bool would be 
+   * a dangerous feature, because bool is considered an "integral type" in C.
+   * Thus, you'd not only get the ability to write very expressive checks
+   * like \c if(object) -- you would also get automatic conversions to int
+   * where you'd never expect them. In C++ there is a well-known idiom to
+   * circumvent this problem. Unfortunately, this idiom isn't easy to 
+   * grasp, involving the convoluted syntax of member pointers.
+   * So we try to hide away these details into a mixin.
+   * 
+   * The idea this implementation is based on is the fact that a 
+   * pointer-to-member is "somewhat a pointer" but not \em really a pointer.
+   * Similar to a pointer, a member pointer can be \em unbound, and this
+   * is the property we exploit here. But implementation-wise, a member pointer
+   * is a type information plus an offset into this type, and thus can't be
+   * converted to an integral type. Thus, depending on the result of the
+   * \c isValid() function, the conversion operator returns either a
+   * bound or unbound member pointer. 
+   * 
+   * @todo list some usage examples here
+   * @see bool-checkable-test.cpp 
+   */
+  template<class T>
+  struct BoolCheckable
+    {
+      typedef bool (T::*ValidityCheck)()  const;
+      typedef ValidityCheck _unspecified_bool_type;
+      
+      /** implicit conversion to "bool" */ 
+      operator _unspecified_bool_type()  const   ///< never throws
+        {
+          ValidityCheck isValid (&T::isValid);
+          T const& obj = static_cast<T const&> (*this);
+          
+          return  (obj.*isValid)()? isValid : 0;
+        }
+      
+      bool operator! ()  const ///< never throws
+        {
+          ValidityCheck isValid (&T::isValid);
+          T const& obj = static_cast<T const&> (*this);
+          
+          return !(obj.*isValid)();
+        }
+      
+    };
+  
+  
+  
+  
+} // namespace lib
+#endif
diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp
index 9cb95eb37..8f961b959 100644
--- a/src/lib/frameid.hpp
+++ b/src/lib/frameid.hpp
@@ -31,14 +31,14 @@ namespace lumiera
 
 
   /**
-   * Identification tuple for addressing frames unambiguosly.
+   * Identification tuple for addressing frames unambiguously.
    * 
    * @todo currently (7/08) this is a dummy implementation to find out
    *       what interface the Proc layer needs. Probably the backend will
    *       later on define what is actually needed; this header should then
    *       be replaced by a combined C/C++ header
    */
-  class FrameID : boost::totally_ordered<FrameID>
+  class FrameID : boost::totally_ordered<FrameID>  ////////////TODO it seems we don't need total ordering, only comparison. Clarify this!
     {
       long dummy;
     public:
diff --git a/src/lib/wrapperptr.hpp b/src/lib/wrapperptr.hpp
index db168cba1..ed4b43b82 100644
--- a/src/lib/wrapperptr.hpp
+++ b/src/lib/wrapperptr.hpp
@@ -27,7 +27,7 @@
 
 
 #include "lib/variant.hpp"
-#include "lib/accesscasted.hpp"
+#include "lib/access-casted.hpp"
 
 #include "lib/meta/typelist.hpp"
 #include "proc/mobject/placement.hpp"
diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index 8b350d382..33801eb4f 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -96,7 +96,7 @@ namespace engine {
       
       virtual BuffHandle fetch (FrameID const& fID)     { return current_.fetch (fID); }
       
-      // note: allocateBuffer()  is choosen specifically based on the actual node wiring
+      // note: allocateBuffer()  is chosen specifically based on the actual node wiring
       
     };
   
@@ -110,7 +110,7 @@ namespace engine {
    * which form the actual invocation sequence. The various operations in this sequence
    * access the context via the references in this struct, while also using the inherited
    * public State interface. The object instance actually used as Invocation is created
-   * on the stack and parametrized according to the necessities of the invocation sequence
+   * on the stack and parametrised according to the necessities of the invocation sequence
    * actually configured. Initially, this real instance is configured without BuffTable,
    * because the invocation may be short-circuited due to Cache hit. Otherwise, when
    * the invocation sequence actually prepares to call the process function of this
diff --git a/src/proc/state.hpp b/src/proc/state.hpp
index a4a95edb7..e021d5890 100644
--- a/src/proc/state.hpp
+++ b/src/proc/state.hpp
@@ -50,7 +50,7 @@ namespace engine {
        *  Intended as a performance shortcut to avoid calling
        *  up through a chain of virtual functions when deep down
        *  in chained ProcNode::pull() calls. This allows derived
-       *  classes to proxy the state inteface.
+       *  classes to proxy the state interface.
        */ 
       virtual State& getCurrentImplementation () =0;
       
@@ -62,7 +62,7 @@ namespace engine {
        *  on the State implementation; it could be a temporary, located in
        *  the cache, used for feeding calculated frames over a network, etc.
        *  @return a BuffHandle encapsulating the information necessary to get
-       *          at the actual buffer adress and for releasing the buffer.
+       *          at the actual buffer address and for releasing the buffer.
        */
       virtual BuffHandle allocateBuffer (BufferDescriptor const&)  =0;
       
@@ -79,7 +79,7 @@ namespace engine {
       /** try to fetch an existing buffer containing the denoted frame from
        *  a cache or similar backing system (e.g. peer over the network).
        *  @return either a handle to a readonly buffer, or a null handle
-       *  @note the client is resposible for not modifying the provided data
+       *  @note the client is responsible for not modifying the provided data
        */
       virtual BuffHandle fetch (FrameID const&)  =0;
       
diff --git a/src/tool/try.cpp b/src/tool/try.cpp
index f2496df9c..de0d698f9 100644
--- a/src/tool/try.cpp
+++ b/src/tool/try.cpp
@@ -17,7 +17,7 @@
 
 #include <nobug.h>
 //#include "include/nobugcfg.h"
-#include "lib/meta/function-erasure.hpp"
+#include "lib/bool-checkable.hpp"
 
 #include <iostream>
 //#include <typeinfo>
@@ -37,7 +37,7 @@ using boost::format;
   }
   
   struct TestIt1
-    : lumiera::typelist::BoolCheckable<TestIt1>
+    : lib::BoolCheckable<TestIt1>
     {
       
       int val_;
diff --git a/tests/40components.tests b/tests/40components.tests
index ba3050091..72174a526 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -2,18 +2,39 @@ TESTING "Component Test Suite: common and basic components" ./test-lib --group=c
 
 
 
-TEST "Hello test" HelloWorld_test 3 <<END
+TEST "Hello test world" HelloWorld_test 3 <<END
 out: ^This is how the world ends\.\.\.$
 return: 0
 END
 
 
-TEST "AllocationCluster_test" AllocationCluster_test <<END
+TEST "Allocation Cluster" AllocationCluster_test <<END
 return: 0
 END
 
 
-PLANNED "Appconfig_test" Appconfig_test <<END
+PLANNED "basic application state" Appconfig_test <<END
+return: 0
+END
+
+
+TEST "implicit conversion to bool" BoolCheckable_test <<END
+out: 1
+out: 2
+out: doIt
+out: 4
+out: 5
+out: doIt
+out: 7
+out: 8
+out: doIt
+out: 10
+out: 11
+out: doIt
+out: 13
+out: 14
+out: doIt
+out: sizeof.+lib.+test.+ExampleCustomType123.+ =   [248]
 return: 0
 END
 
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 19f4023b6..335d2d351 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -39,6 +39,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/allocationclustertest.cpp		\
 	$(testlib_srcdir)/appconfigtest.cpp			\
 	$(testlib_srcdir)/customsharedptrtest.cpp		\
+	$(testlib_srcdir)/bool-checkable-test.cpp		\
 	$(testlib_srcdir)/exceptionerrortest.cpp		\
 	$(testlib_srcdir)/factory-special-test.cpp		\
 	$(testlib_srcdir)/factorytest.cpp			\
diff --git a/tests/lib/bool-checkable-test.cpp b/tests/lib/bool-checkable-test.cpp
new file mode 100644
index 000000000..501bcb622
--- /dev/null
+++ b/tests/lib/bool-checkable-test.cpp
@@ -0,0 +1,105 @@
+/*
+  BoolCheckable(Test)  -  verify the mixin for implicit conversion to bool
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/bool-checkable.hpp"
+#include "lib/test/test-helper.hpp"
+
+#include <iostream>
+
+using std::cout;
+using lib::test::showSizeof;
+
+
+namespace lib {
+namespace test{
+  
+  /** 
+   * An example custom type,
+   * which provides an implicit bool conversion
+   * to express some special validity check. 
+   */
+  
+  class ExampleCustomType123
+    : public lib::BoolCheckable<ExampleCustomType123>
+    {
+      
+      int val_;
+      
+    public:
+      
+      ExampleCustomType123 (int i)
+        : val_(i)
+        { }
+      
+      /** implements the custom logic to decide
+       *  if this instance can be considered "valid"
+       */
+      bool
+      isValid()  const
+        {
+          return val_ % 3;
+        }
+      
+    };
+  
+  
+  
+  
+  /**********************************************************
+   * @test verify the implementation of a validity check,
+   *       to be accessed as an implicit conversion to bool.
+   *       
+   * @see lib::BoolCheckable
+   * @todo list some usage examples here 
+   */
+  class BoolCheckable_test : public Test
+    {
+      
+      virtual void
+      run (Arg)
+        {
+          for (int i=1; i<16; ++i)
+            {
+              ExampleCustomType123 test (i);
+              
+              if (!test)
+                cout << "doIt \n";
+              if (test)
+                cout << i << "\n";
+              
+              ASSERT (test.isValid() == bool(test) );
+              ASSERT (test.isValid() != !test);
+            }
+          
+          cout << showSizeof<ExampleCustomType123>() <<"\n";
+          ASSERT (sizeof (int) == sizeof (ExampleCustomType123));
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (BoolCheckable_test, "unit common");
+  
+  
+}} // namespace lib::test

From 8ea07bda7a6962593fd8969c4105baadb7ca5eb4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 26 Jun 2009 19:04:22 +0200
Subject: [PATCH 147/368] use the new bool conversion mixin to implement check
 for valid functor

---
 src/lib/meta/function-erasure.hpp        | 54 +++++++++++-------------
 src/proc/control/command-mutation.hpp    |  8 ++--
 tests/lib/meta/function-erasure-test.cpp |  8 ++--
 3 files changed, 33 insertions(+), 37 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 460143baf..f86de74b9 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -55,6 +55,7 @@
 
 #include "lib/util.hpp"
 #include "lib/error.hpp"
+#include "lib/bool-checkable.hpp"
 
 #include <tr1/functional>
 
@@ -76,7 +77,7 @@ namespace typelist{
    *   using the templated \c getFun()
    *   
    * @param FH policy to control the implementation.
-   *        In most cases, you should use "StoreFunction"  
+   *        In most cases, you should use "StoreFunction"
    * @note not statically typesafe. Depending on
    *       the specified policy, it \em might be
    *       run-time typesafe.
@@ -91,40 +92,19 @@ namespace typelist{
         { }
     };
   
-    
+  
   /* ====== Policy classes ====== */
-
-  template<class T>
-  struct BoolCheckable
-    {
-      typedef bool (T::*ValidityCheck)()  const;
-      typedef ValidityCheck _unspecified_bool_type;
-      
-      /** implicit conversion to "bool" */ 
-      operator _unspecified_bool_type()  const   ///< never throws
-        {
-          ValidityCheck isValid (&T::isValid);
-          T const& obj = static_cast<T const&> (*this);
-          return  (obj.*isValid)()? isValid : 0;
-        }
-      
-      bool operator! ()  const ///< never throws
-        {
-          ValidityCheck isValid (&T::isValid);
-          T const& obj = static_cast<T const&> (*this);
-          return !(obj.*isValid)();
-        }
-      
-    };
-    
+  
   /** 
    * Policy for FunErasure: store an embedded tr1::function
    * Using this policy allows to store arbitrary complex functor objects
    * embedded within a neutral container and retrieving them later type-safe.
-   * The price to pay is vtable access and heap storage of function arguments. 
+   * The price to pay is vtable access and heap storage of function arguments.
+   * 
+   * @note the bool conversion and #isValid are highly implementation dependent
    */
   class StoreFunction
-//    : public BoolCheckable<StoreFunction>
+    : public lib::BoolCheckable<StoreFunction>
     {
       /** Helper: type erasure */
       struct Holder
@@ -181,7 +161,7 @@ namespace typelist{
         }
       
       bool
-      isValid()  const
+      isValid()  const   ///< @note implementation dependent!!
         {
           return reinterpret_cast<void*> (holder_.storage_[0]);
         }
@@ -195,6 +175,7 @@ namespace typelist{
    * The price to pay is vtable access. 
    */
   class StoreFunPtr
+    : public lib::BoolCheckable<StoreFunPtr>
     {
       /** Helper: type erasure */
       struct Holder
@@ -241,6 +222,13 @@ namespace typelist{
           REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
           return static_cast<FunctionHolder<SIG>&> (holder_).get();
         }
+      
+      
+      bool
+      isValid()  const
+        {
+          return holder_.fP_;
+        }
     };
   
   
@@ -250,6 +238,7 @@ namespace typelist{
    * and to retrieve it without overhead, but also without safety.
    */
   class StoreUncheckedFunPtr
+    : public lib::BoolCheckable<StoreUncheckedFunPtr>
     {
       void *funP_;
       
@@ -271,6 +260,13 @@ namespace typelist{
         {
           return *reinterpret_cast<SIG*> (funP_);
         }
+      
+      
+      bool
+      isValid()  const
+        {
+          return funP_;
+        }
     };
   
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index df32cfe22..f0f77d704 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -84,7 +84,7 @@ namespace control {
       close (CmdClosure& cmdClosure)
         {
           REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
-//          REQUIRE (func_, "Param error: not bound to a valid function");
+          REQUIRE (func_, "Param error: not bound to a valid function");
           func_ = cmdClosure.bindArguments(func_);
           clo_ = &cmdClosure;
           return *this;
@@ -117,7 +117,7 @@ namespace control {
       virtual bool
       isValid ()   const
         {
-//          return func_ && clo_;
+          return func_ && clo_;
         }
       
       void
@@ -177,7 +177,7 @@ namespace control {
       close (CmdClosure& cmdClosure)
         {
           REQUIRE (!memento_,    "Lifecycle error: already closed over the arguments");
-//          REQUIRE (captureFunc_, "Param error: not bound to a valid function");
+          REQUIRE (captureFunc_, "Param error: not bound to a valid function");
           
           // create a special state closure, which can later on store the captured undo state (memento)
           scoped_ptr<CmdClosure> stateClosure (new MementoClosure (captureFunc_));
@@ -213,7 +213,7 @@ namespace control {
       virtual bool
       isValid ()   const
         {
-//          return Mutation::isValid() && captureFunc_ && memento_;
+          return Mutation::isValid() && captureFunc_ && memento_;
         }
       
       
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 6d98582f1..43320c453 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -212,10 +212,10 @@ namespace test {
           
           typedef typename BuildEmptyHolder<HOL>::Type EmptyHolder;
           EmptyHolder emptyHolder;
-//          ASSERT (!emptyHolder);
-//          ASSERT ( h1 );
-//          ASSERT ( h2 );
-//          ASSERT ( h3 );
+          ASSERT (!emptyHolder);
+          ASSERT ( h1 );
+          ASSERT ( h2 );
+          ASSERT ( h3 );
         }
       
 

From 51712f218d9332424d2bb9bf463e7948405b0f40 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 28 Jun 2009 15:27:27 +0200
Subject: [PATCH 148/368] still fighting to get capture fun and undo func bound
 together

---
 src/proc/control/command-argument-holder.hpp  | 100 ++++++++++++
 src/proc/control/command-def.hpp              |  60 +------
 src/proc/control/command-mutation.hpp         |  27 ++--
 src/proc/control/command-signature.hpp        | 153 ++++++++++++++++++
 src/proc/control/command.cpp                  |   6 -
 src/proc/control/memento-closure.hpp          | 126 ---------------
 src/proc/control/memento-tie.hpp              | 146 +++++++++++++++++
 tests/45controller.tests                      |   6 +-
 tests/components/Makefile.am                  |   3 +-
 .../proc/control/command-argument-test.cpp    | 110 +++++++++++++
 ...-closure-test.cpp => memento-tie-test.cpp} |   8 +-
 11 files changed, 535 insertions(+), 210 deletions(-)
 create mode 100644 src/proc/control/command-argument-holder.hpp
 create mode 100644 src/proc/control/command-signature.hpp
 delete mode 100644 src/proc/control/memento-closure.hpp
 create mode 100644 src/proc/control/memento-tie.hpp
 create mode 100644 tests/components/proc/control/command-argument-test.cpp
 rename tests/components/proc/control/{memento-closure-test.cpp => memento-tie-test.cpp} (95%)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
new file mode 100644
index 000000000..4a981588e
--- /dev/null
+++ b/src/proc/control/command-argument-holder.hpp
@@ -0,0 +1,100 @@
+/*
+  COMMAND-ARGUMENT-HOLDER.hpp  -  specifically typed container for storage of command arguments
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-argument-holder.hpp
+ ** A simple container record holding the actual command arguments. 
+ ** While all command objects themselves have a common type (type erasure),
+ ** the actual argument tuple and the state memento for undo can't. Especially,
+ ** the size of arguments and memento will depend on their respective types.
+ ** Thus, to manage somehow the storage of this data, we create a common holder,
+ ** to be managed by a custom allocator.
+ ** 
+ ** @todo doing just plain heap allocation for now :-P
+ **  
+ ** @see Command
+ ** @see UndoMutation
+ ** @see MementoTie
+ ** @see command-argument-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_ARGUMENT_HOLDER_H
+#define CONTROL_COMMAND_ARGUMENT_HOLDER_H
+
+//#include "pre.hpp"
+//#include "lib/error.hpp"
+
+//#include <tr1/memory>
+//#include <boost/scoped_ptr.hpp>
+//#include <tr1/functional>
+#include <iostream>
+#include <string>
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+//  using boost::scoped_ptr;
+//  using std::tr1::function;
+  using std::ostream;
+  using std::string;
+  
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class CommandArgumentHolder
+    {
+      
+    public:
+      virtual ~CommandArgumentHolder() { };
+      virtual operator string()  const  =0;
+    };
+  
+  
+  inline ostream& operator<< (ostream& os, CommandArgumentHolder const& arg) { return os << string(arg); }
+  
+  
+  
+  
+  /** specifically typed subclass used for actual storage */
+  template<typename SIG, typename MEM>
+  class ArgumentHolder
+    : public CommandArgumentHolder
+    {
+      
+      operator string()  const { return "bääääh!"; } /////////////////TODO
+      
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+    
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 5002e9452..ebfc7906b 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -50,6 +50,7 @@
 //#include "pre.hpp"
 #include "include/symbol.hpp"
 #include "proc/control/command.hpp"
+#include "proc/control/command-signature.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
 #include "lib/meta/function.hpp"
@@ -74,65 +75,6 @@ namespace control {
   using lumiera::typelist::Types;
 //using lumiera::typelist::NullType;
   using lumiera::typelist::Tuple;
-  using lumiera::typelist::Append;
-  using lumiera::typelist::SplitLast;
-  
-  
-  
-  
-  /** 
-   * Type analysis helper template. 
-   * Used for dissecting a given type signature to derive
-   * the related basic operation signature, the signature of a possible Undo-function
-   * and the signature necessary for capturing undo information. The implementation
-   * relies on re-binding an embedded type defining template, based on the actual
-   * case, as identified by the structure of the given parameter signature.
-   */
-  template<typename SIG>
-  struct UndoSignature
-    {
-    private:
-      typedef typename FunctionSignature< function<SIG> >::Args Args;
-      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-      
-      /** Case1: defining the Undo-Capture function */
-      template<typename RET, typename ARG>
-      struct Case
-        {
-          typedef RET Memento;
-          typedef typename Append<ARG, Memento>::List ExtendedArglist;
-          typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
-          
-          typedef typename FunctionTypedef<void, ARG>::Sig           OperateSig;
-          typedef typename FunctionTypedef<Ret,ARG>::Sig             CaptureSig;
-          typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
-        };
-      /** Case2: defining the actual Undo function */
-      template<typename ARG>
-      struct Case<void,ARG>
-        {
-          typedef typename ARG::List Args;
-          
-          typedef typename SplitLast<Args>::Type Memento;
-          typedef typename SplitLast<Args>::List OperationArglist;
-          typedef typename Tuple<OperationArglist>::Type OperationArgs;
-          
-          typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
-          typedef typename FunctionTypedef<Ret,OperationArgs>::Sig   CaptureSig;
-          typedef typename FunctionTypedef<void, ARG>::Sig           UndoOp_Sig;
-        };
-      
-    public:
-      typedef typename Case<Ret,Args>::CaptureSig CaptureSig;
-      typedef typename Case<Ret,Args>::UndoOp_Sig UndoOp_Sig;
-      typedef typename Case<Ret,Args>::OperateSig OperateSig;
-      typedef typename Case<Ret,Args>::Memento    Memento;
-    };
-  
-  
-  
-  
-  
   
   
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index f0f77d704..cf745b778 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -38,7 +38,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "proc/control/command-closure.hpp"
-#include "proc/control/memento-closure.hpp"
+#include "proc/control/memento-tie.hpp"
 
 //#include <tr1/memory>
 #include <boost/scoped_ptr.hpp>
@@ -135,7 +135,7 @@ namespace control {
     };
   
   
-  inline ostream& operator<< (ostream& os, const Mutation& muta) { return os << string(muta); }
+  inline ostream& operator<< (ostream& os, Mutation const& muta) { return os << string(muta); }
   
   
   
@@ -146,17 +146,17 @@ namespace control {
   class UndoMutation
     : public Mutation
     {
-      CmdFunctor         captureFunc_;
-      scoped_ptr<CmdClosure> memento_;
+      Mutation memento_;
       
     public:
       template<typename SIG_undo, typename SIG_cap>
       UndoMutation (function<SIG_undo> const& undoFunc,
                     function<SIG_cap> const& captureFunc)
         : Mutation (undoFunc)
-        , captureFunc_(captureFunc)
+        , memento_(captureFunc)
         { }
-      
+
+#if false /////////////////////////////////////////////////TODO: remove after refactoring
       UndoMutation (UndoMutation const& o)
         : Mutation (*this)
         , captureFunc_(o.captureFunc_)
@@ -180,16 +180,17 @@ namespace control {
           REQUIRE (captureFunc_, "Param error: not bound to a valid function");
           
           // create a special state closure, which can later on store the captured undo state (memento)
-          scoped_ptr<CmdClosure> stateClosure (new MementoClosure (captureFunc_));
-          CmdFunctor closedCaptureFunc = stateClosure->bindArguments(captureFunc_);
+          scoped_ptr<MementoClosure> stateClosure (new MementoClosure (captureFunc_));
+          CmdFunctor closedCaptureFunc = cmdClosure.bindArguments(captureFunc_);
           
           // the undoFunc (within parent class) will retrieve an argument tuple extended by the memento
-//          Mutation::close (stateClosure->decorate (cmdClosure));
+          Mutation::close (stateClosure->decorate (cmdClosure));
           
           captureFunc_ = closedCaptureFunc;
-          memento_.swap(stateClosure);
+//          memento_.swap(stateClosure);
           return *this;
         }
+#endif      
       
       Mutation&
       captureState ()
@@ -198,7 +199,7 @@ namespace control {
             throw lumiera::error::State ("need to bind function arguments prior to capturing undo state",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          invoke(captureFunc_);
+          memento_();
           return *this;
         }
       
@@ -206,14 +207,14 @@ namespace control {
       getMemento()
         {
           ASSERT (memento_, "Lifecycle error: need to close first");
-          return *memento_;
+//          return *memento_;
         }
       
     private:
       virtual bool
       isValid ()   const
         {
-          return Mutation::isValid() && captureFunc_ && memento_;
+//          return Mutation::isValid() && captureFunc_ && memento_;
         }
       
       
diff --git a/src/proc/control/command-signature.hpp b/src/proc/control/command-signature.hpp
new file mode 100644
index 000000000..503a212f2
--- /dev/null
+++ b/src/proc/control/command-signature.hpp
@@ -0,0 +1,153 @@
+/*
+  COMMAND-SIGNATURE.hpp  -  deriving suitable command function signatures
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-signature.hpp
+ ** Metaprogramming helpers for deriving the precise function signatures
+ ** necessary to implement a given command. Basically, commands can be implemented
+ ** by arbitrary functions, but the signatures of the operation function, the
+ ** undo function and the undo state capturing function are required to obey
+ ** fixed relationships. Thus, at various stages of the command definition,
+ ** we need to accept functor objects with a very specific and predetermined
+ ** signature, thus allowing for strict type checking by the compiler.
+ ** 
+ ** \par Relation of function signatures
+ ** - operation: void(P1,..PN)
+ ** - captureUndo: MEM(P1,..PN)
+ ** - undoOperation void(P1,..PN,MEM)
+ ** - bind takes the arguments:(P1,..PN)
+ ** 
+ ** @see Command
+ ** @see CommandDef
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_SIGNATURE_H
+#define CONTROL_COMMAND_SIGNATURE_H
+
+//#include "pre.hpp"
+//#include "include/symbol.hpp"
+#include "lib/meta/function.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/tuple.hpp"
+
+//#include <tr1/memory>
+#include <tr1/functional>
+
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  using std::tr1::function;
+  
+  using lumiera::typelist::FunctionSignature;
+  using lumiera::typelist::FunctionTypedef;
+  using lumiera::typelist::Types;
+//using lumiera::typelist::NullType;
+  using lumiera::typelist::Tuple;
+  using lumiera::typelist::Append;
+  using lumiera::typelist::SplitLast;
+  
+
+  /** 
+   * Metaprogramming helper for building Command function signatures. 
+   * The complete definition context of any command is templated to the signature
+   * of the actual command operation and to the memento type. The typedefs embedded
+   * within CommandSignature<SIG,MEM> allows accepting suitable typed functions
+   * to implement the command in question.
+   */
+  template<typename SIG, typename MEM>
+  class CommandSignature
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      
+      typedef typename Append<Args, MEM>::List ExtendedArglist;
+      typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
+      
+    public:
+      typedef typename FunctionTypedef<void, Args>::Sig          OperateSig;
+      typedef typename FunctionTypedef<MEM, Args>::Sig           CaptureSig;
+      typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
+      typedef MEM                                                Memento;
+    };
+  
+  
+  
+  
+  /** 
+   * Type analysis helper template. 
+   * Used for dissecting a given type signature to derive
+   * the related basic operation signature, the signature of a possible Undo-function
+   * and the signature necessary for capturing undo information. The implementation
+   * relies on re-binding an embedded type defining template, based on the actual
+   * case, as identified by the structure of the given parameter signature.
+   */
+  template<typename SIG>
+  class UndoSignature
+    {
+      typedef typename FunctionSignature< function<SIG> >::Args Args;
+      typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+      
+      /** Case1: defining the Undo-Capture function */
+      template<typename RET, typename ARG>
+      struct Case
+        {
+          typedef RET Memento;
+          typedef typename Append<ARG, Memento>::List ExtendedArglist;
+          typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
+          
+          typedef typename FunctionTypedef<void, ARG>::Sig           OperateSig;
+          typedef typename FunctionTypedef<Ret,ARG>::Sig             CaptureSig;
+          typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
+        };
+      /** Case2: defining the actual Undo function */
+      template<typename ARG>
+      struct Case<void,ARG>
+        {
+          typedef typename ARG::List Args;
+          
+          typedef typename SplitLast<Args>::Type Memento;
+          typedef typename SplitLast<Args>::List OperationArglist;
+          typedef typename Tuple<OperationArglist>::Type OperationArgs;
+          
+          typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
+          typedef typename FunctionTypedef<Ret,OperationArgs>::Sig   CaptureSig;
+          typedef typename FunctionTypedef<void, ARG>::Sig           UndoOp_Sig;
+        };
+      
+    public:
+      typedef typename Case<Ret,Args>::CaptureSig CaptureSig;
+      typedef typename Case<Ret,Args>::UndoOp_Sig UndoOp_Sig;
+      typedef typename Case<Ret,Args>::OperateSig OperateSig;
+      typedef typename Case<Ret,Args>::Memento    Memento;
+    };
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index fca9a6a8e..0b72a511e 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -51,12 +51,6 @@ namespace control {
     UNIMPLEMENTED ("fetch an existing command from the internal cmd registry");
   }
   
-  
-  MementoClosure::MementoClosure (CmdFunctor&)
-  {
-    
-  }
-  
 
   
   
diff --git a/src/proc/control/memento-closure.hpp b/src/proc/control/memento-closure.hpp
deleted file mode 100644
index 14741bca8..000000000
--- a/src/proc/control/memento-closure.hpp
+++ /dev/null
@@ -1,126 +0,0 @@
-/*
-  MEMENTO-CLOSURE.hpp  -  capturing and providing state for undoing commands
- 
-  Copyright (C)         Lumiera.org
-    2009,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-*/
-
-
-/** @file memento-closure.hpp
- ** Extension to the CmdClosure for storing and retrieving a state memento.
- ** //TODO
- **  
- ** @see CmdClosure
- ** @see UndoMutation
- ** @see memento-closure-test.cpp
- **
- */
-
-
-
-#ifndef CONTROL_MEMENTO_CLOSURE_H
-#define CONTROL_MEMENTO_CLOSURE_H
-
-//#include "pre.hpp"
-//#include "lib/meta/typelist.hpp"  ////////////////TODO include these??
-//#include "lib/meta/function.hpp"
-//#include "lib/meta/function-closure.hpp"
-//#include "lib/meta/function-erasure.hpp"
-//#include "lib/meta/tuple.hpp"
-#include "proc/control/command-closure.hpp"
-#include "lib/util.hpp"
-
-//#include <tr1/memory>
-//#include <tr1/functional>
-//#include <iostream> 
-//#include <string>
-
-
-#include "lib/test/test-helper.hpp"  /////////////////TODO remove this
-using lib::test::showSizeof;
-
-using std::cout;    //////////////////////////////////TODO remove this
-using std::endl;
-
-
-namespace control {
-  
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
-//  using util::unConst;
-  using std::string;
-//  using std::ostream;
-//  using std::tr1::function;
-//  using lumiera::typelist::FunctionSignature;
-//  using lumiera::typelist::Tuple;
-//  using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::typelist::TupleApplicator;
-//  using lumiera::typelist::FunErasure;
-//  using lumiera::typelist::StoreFunction;
-  
-//  using lumiera::typelist::NullType;
-    
-  
-  
-  /**
-   *  Special kind of Closure, which \em decorates an existing Closure
-   *  and provides a captured state memento as additional parameter on invocation.
-   *  
-   *  @todo concept isn't clear yet. Multiple MementoClosurese are to decorate a single Closure;
-   *        they have to match and extract the concrete type of the Closure and the provided Memento,
-   *        but the latter needs to be erased immediately. Basically, MementoClosure must be able
-   *        to stand-in for an simple parameter closure. 
-   */
-  class MementoClosure
-    : public CmdClosure   ///////////TODO hierararchy?
-    {
-    public:
-      
-      virtual PClosure clone()  const
-        {
-          return PClosure (new MementoClosure (*this));
-        }
-
-      virtual operator string()  const
-        {
-          return "TODO";
-        }
-      
-      virtual CmdFunctor bindArguments (CmdFunctor&)
-        {
-          UNIMPLEMENTED ("binding operation");
-        }
-      
-      
-      ////////////TODO how to give access to the following dedicated API?
-      MementoClosure (CmdFunctor&);
-      
-      
-      CmdClosure& decorate (CmdClosure& core) 
-        {
-          return *this; // TODO would be nice, but probably won't be thus simple ;-) 
-        }
-    };
-    
-  ////////////////TODO currently just fleshing  out the API....
-  
-  
-  
-  
-} // namespace control
-#endif
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
new file mode 100644
index 000000000..14fc45a90
--- /dev/null
+++ b/src/proc/control/memento-tie.hpp
@@ -0,0 +1,146 @@
+/*
+  MEMENTO-TIE.hpp  -  capturing and providing state for undoing commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file memento-tie.hpp
+ ** A special binding used by Proc-Layer commands for capturing UNDO state information.
+ ** The UndoMutation, which is the functor object created and configured by the Command
+ ** for handling UNDO, utilises a MementoTie (as ctor parameter) for binding together
+ ** the "undo capture function" and the actual "undo function", by retrieving the
+ ** memento data or memento object from the former and feeding it to the latter
+ ** as an additional parameter, when the undo operation is invoked.
+ ** //TODO
+ **  
+ ** @see CmdClosure
+ ** @see UndoMutation
+ ** @see memento-tie-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_MEMENTO_TIE_H
+#define CONTROL_MEMENTO_TIE_H
+
+//#include "pre.hpp"
+//#include "lib/meta/typelist.hpp"  ////////////////TODO include these??
+//#include "lib/meta/function.hpp"
+//#include "lib/meta/function-closure.hpp"
+//#include "lib/meta/function-erasure.hpp"
+//#include "lib/meta/tuple.hpp"
+#include "proc/control/command-signature.hpp"
+#include "proc/control/command-closure.hpp" ////////TODO really??
+#include "lib/util.hpp"
+
+//#include <tr1/memory>
+//#include <tr1/functional>
+//#include <iostream> 
+//#include <string>
+
+
+#include "lib/test/test-helper.hpp"  /////////////////TODO remove this
+using lib::test::showSizeof;
+
+using std::cout;    //////////////////////////////////TODO remove this
+using std::endl;
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+//  using util::unConst;
+  using std::string;
+//  using std::ostream;
+//  using std::tr1::function;
+//  using lumiera::typelist::FunctionSignature;
+//  using lumiera::typelist::Tuple;
+//  using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::typelist::TupleApplicator;
+//  using lumiera::typelist::FunErasure;
+//  using lumiera::typelist::StoreFunction;
+  
+//  using lumiera::typelist::NullType;
+    
+  
+  
+  /**
+   *  Binding together state capturing and execution of the undo operation.
+   *  MementoTie itself is passive container object with a very specific type,
+   *  depending on the type of the operation arguments and the type of the memento.
+   *  It is to be allocated within the ArgumentHolder of the command, thereby wrapping
+   *  or decorating the undo and capture function, setting up  the necessary bindings and
+   *  closures, allowing them to cooperate behind the scenes to carry out the UNDO functionality.
+   *  Through a reference to the MementoTie, the UndoMutation functor gets access to the prepared
+   *  functions, storing them into generic containers (type erasure) for later invocation. 
+   *  
+   *  More specifically, the \c captureFunction, which is expected to run immediately prior
+   *  to the actual command operation, returns a \b memento value object (of unspecific type),
+   *  which needs to be stored within the MementoTie. On UNDO, the undo-operation functor needs
+   *  to be provided with a reference to this stored memento value through an additional
+   *  parameter (which by convention is always the last argument of the undo function).
+   *  
+   */
+  template<typename SIG, typename MEM>
+  class MementoTie
+    {
+      typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
+      typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
+      
+      /** storage holding the captured state for undo */
+      MEM memento_;
+      
+      function<SIG> undo_;
+      function<SIG> capture_;
+      
+      
+      function<SIG>
+      buildFun()
+        {
+//          PlaceholderTuple<SIG> tup;
+//          return tupleApplicator(tup).bind(origFun);
+        }
+      
+      void capture ()
+        {
+          memento_ = capture();
+        }
+      
+    public:
+      /** creates an execution context tying together the provided functions.
+       *  Bound copies of these functors may be pulled from the MementoTie,
+       *  in order to build the closures (with the concrete operation arguments)
+       *  to be invoked later on command execution.
+       */
+      MementoTie (function<SIG_undo> const& undoFunc,
+                  function<SIG_cap> const& captureFunc)
+        { }
+      
+    };
+    
+  ////////////////TODO currently just fleshing  out the API....
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 761354de1..7c5fd6d31 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -7,9 +7,13 @@ PLANNED "CommandBasic_test" CommandBasic_test <<END
 END
 
 
+PLANNED "CommandArgument_test" CommandArgument_test <<END
+END
+
+
 PLANNED "CommandMutation_test" CommandMutation_test <<END
 END
 
 
-PLANNED "MementoClosure_test" MementoClosure_test <<END
+PLANNED "MementoTie_test" MementoTie_test <<END
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 783d21ce4..98d2a33ed 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -48,8 +48,9 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/asset/orderingofassetstest.cpp		\
 	$(testcomponents_srcdir)/proc/asset/testasset.cpp			\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-argument-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
-	$(testcomponents_srcdir)/proc/control/memento-closure-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp			\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
 	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
new file mode 100644
index 000000000..4d6020e87
--- /dev/null
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -0,0 +1,110 @@
+/*
+  CommandArgument(Test)  -  checking storage of specifically typed command arguments
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command-argument-holder.hpp"
+//#include "lib/meta/typelist.hpp"
+//#include "lib/meta/tuple.hpp"
+//#include "lib/util.hpp"
+
+//#include <tr1/functional>
+//#include <boost/format.hpp>
+#include <iostream>
+//#include <cstdlib>
+#include <string>
+
+//using std::tr1::bind;
+//using std::tr1::placeholders::_1;
+//using std::tr1::placeholders::_2;
+//using std::tr1::function;
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+using std::string;
+//using std::rand;
+using std::cout;
+using std::endl;
+
+
+namespace control {
+namespace test    {
+  
+  using lib::test::showSizeof;
+  
+//  using session::test::TestClip;
+//  using lumiera::P;
+//  using namespace lumiera::typelist;
+//  using lumiera::typelist::Tuple;
+  
+//  using control::CmdClosure;
+  
+  
+  
+  
+  
+  
+  namespace {
+  
+    int testVal=0;  ///< used to verify the effect of testFunc ////////////////////TODO
+  
+  }
+  
+  
+  
+  /***************************************************************************
+   * Verify the behaviour of the type erased closure, which is used
+   * by Proc-Layer commands to implement the capturing and later
+   * re-invocation of a function.
+   *       
+   * @see  control::Command
+   * @see  control::CommandDef
+   * @see  control::Mutation
+   * @see  control::UndoMutation
+   * @see  command-basic-test.hpp
+   */
+  class CommandArgument_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          UNIMPLEMENTED ("create various argument tuples and re-access their contents");
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandArgument_test, "unit controller");
+  
+  
+}} // namespace control::test
diff --git a/tests/components/proc/control/memento-closure-test.cpp b/tests/components/proc/control/memento-tie-test.cpp
similarity index 95%
rename from tests/components/proc/control/memento-closure-test.cpp
rename to tests/components/proc/control/memento-tie-test.cpp
index 62598dc85..938033e5e 100644
--- a/tests/components/proc/control/memento-closure-test.cpp
+++ b/tests/components/proc/control/memento-tie-test.cpp
@@ -1,5 +1,5 @@
 /*
-  MementoClosure(Test)  -  check the mechanism for capturing and providing undo-state
+  MementoTie(Test)  -  check the mechanism for capturing and providing undo-state
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -32,7 +32,7 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
-#include "proc/control/memento-closure.hpp"
+#include "proc/control/memento-tie.hpp"
 //#include "lib/meta/typelist.hpp"
 #include "lib/meta/tuple.hpp"
 //#include "lib/lumitime.hpp"
@@ -103,7 +103,7 @@ namespace test    {
    * @see  control::UndoMutation
    * @see  command-mutation-test.hpp
    */
-  class MementoClosure_test : public Test
+  class MementoTie_test : public Test
     {
       
       virtual void
@@ -169,7 +169,7 @@ namespace test    {
   
   
   /** Register this test class... */
-  LAUNCHER (MementoClosure_test, "unit controller");
+  LAUNCHER (MementoTie_test, "unit controller");
       
       
 }} // namespace control::test

From 14f3641f9b9e8d14ddd7ea70629750fcc00980fa Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 28 Jun 2009 20:41:33 +0200
Subject: [PATCH 149/368] helper: initialise a tuple from an existing sub-tuple

---
 src/lib/meta/tuple.hpp                       | 132 ++++++-
 tests/40components.tests                     |  18 +
 tests/lib/meta/function-composition-test.cpp | 351 +++++++++++++++++++
 tests/lib/meta/type-tuple-test.cpp           |  69 ++++
 4 files changed, 567 insertions(+), 3 deletions(-)
 create mode 100644 tests/lib/meta/function-composition-test.cpp

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index d8e4c8d39..cb7309765 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -214,9 +214,12 @@ namespace typelist{
       Tuple (HeadType const&, Tail const&) { }
       Tuple ()                             { }
       
-      template<uint> struct ShiftedTuple { typedef Tail Type;};
-      template<uint> Tail& getShifted () { return *this;     }
-      template<uint> NullType&  getAt () { return getHead(); }
+      template<uint> struct ShiftedTuple   { typedef Tail Type;};
+      template<uint> Tail& getShifted ()   { return *this;     }
+      template<uint> NullType&  getAt ()   { return getHead(); }
+      
+      const NullType getHead_const() const { return NullType();}
+      const Tail&    getTail_const() const { return *this;     }
       
       TupleType& 
       tupleCast ()
@@ -250,6 +253,9 @@ namespace typelist{
       TY  & getHead() { return val_; }
       Tail& getTail() { return static_cast<Tail&> (*this); }
       
+      TY   const& getHead_const() const { return val_; }
+      Tail const& getTail_const() const { return static_cast<const Tail&> (*this); }
+      
       
       template<uint i>
       class ShiftedTuple
@@ -509,6 +515,126 @@ namespace typelist{
       return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7,a8,a9);
     }
     
+    
+    
+    /** 
+     * Helper to construct a new tuple, partially using provided argument values.
+     * Arguments are expected as a tuple, which is assumed to be a sub-tuple of
+     * the target type to be created. The start index of this sub-tuple may be
+     * provided as additional parameter, otherwise it is assumed to be zero, 
+     * (i.e. the sub tuple starting left aligned). Any further arguments
+     * of the target type, which aren't covered by the argument tuple,
+     * are default initialised. 
+     * @param TYPES type sequence or type list denoting the target tuple type
+     * @param ARGS  type sequence of type list denoting the argument tuple type
+     * @param pos   start index of the ARGS sequence within the TYPES sequence
+     * 
+     * @note call the embedded #create function to invoke
+     * @note when types or positions disagree, argument tuple will be ignored
+     * @see TypeTuple_test#check_build_from_subTuple
+     */
+    template<typename TYPES, typename ARGS, uint pos=0>
+    struct BuildTuple
+      {
+        typedef typename Tuple<TYPES>::TupleType ThisTuple;
+        typedef typename Tuple<TYPES>::ArgList TypeList;
+        typedef typename Tuple<ARGS>::ArgList ArgTypeList;
+        
+        /**
+         * @param the argument values, contained in a list or flat- tuple
+         *          of the type denoted by ARGS
+         * @return a plain-flat Tuple<TYPES> instance, initialised with
+         *          the values found within arg
+         */
+        static ThisTuple
+        create (Tuple<ArgTypeList> const& arg)
+          {
+            return BuildTuple<TypeList,ArgTypeList,pos>
+                    ::create(arg)
+                      .tupleCast();
+          }
+      };
+    
+    template<typename TYPES, typename ARGS, uint pos>
+    struct BuildTuple<Tuple<TYPES>, Tuple<ARGS>, pos>  ///< tuples allowed instead of plain type sequences/lists
+      : BuildTuple<TYPES,ARGS,pos>
+      { };
+    
+    
+    template< typename T
+            , typename TS
+            , typename A
+            , typename AS
+            , uint pos
+            >
+    struct BuildTuple<Node<T,TS>, Node<A,AS>, pos>     ///< case: recursion \em before start of arg tuple
+      {
+        typedef Tuple<Node<T,TS> > ThisTuple;
+        typedef Tuple<Node<A,AS> > ThisArg;
+        
+        static ThisTuple
+        create (ThisArg const& arg)
+          {
+            return ThisTuple( T()
+                            , BuildTuple<TS, Node<A,AS>, pos-1>::create(arg)
+                            );
+          }
+      };
+    
+    
+    template< typename A
+            , typename TS
+            , typename AS
+            >
+    struct BuildTuple<Node<A,TS>, Node<A,AS>, 0>       ///< case: start of argument tuple detected
+      {
+        typedef Tuple<Node<A,TS> > ThisTuple;
+        typedef Tuple<Node<A,AS> > ThisArg;
+        
+        static ThisTuple
+        create (ThisArg const& arg)
+          {
+            return ThisTuple( arg.getHead_const()
+                            , BuildTuple<TS, AS, 0>::create (arg.getTail_const())
+                            );
+          }
+      };
+    
+    
+    template< typename ARGS
+            , uint i
+            >
+    struct BuildTuple<NullType, ARGS, i>               ///< case: hit end of target typelist
+      {
+        typedef Tuple<NullType> ThisTuple;
+        typedef Tuple<ARGS>     ThisArg;
+        
+        static ThisTuple
+        create (ThisArg const&)
+          {
+            return ThisTuple();
+          }
+      };
+    
+    
+    template< typename T
+            , typename TS
+            , uint i
+            >
+    struct BuildTuple<Node<T,TS>, NullType, i>         ///< case: hit end of argument tuple
+      {
+        typedef Tuple<Node<T,TS> > ThisTuple;
+        typedef Tuple<NullType>    ThisArg;
+        
+        static ThisTuple
+        create (ThisArg const&)
+          {
+            return ThisTuple();
+          }
+      };
+    
+    
+    
   } // (END) access / tuple building helper functions (namespace tuple)
   
   
diff --git a/tests/40components.tests b/tests/40components.tests
index 72174a526..8c4317699 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -666,6 +666,24 @@ out: nullL	:...Tuple\(\)
 out: nulTcpy	:...Tuple\(\)
 out: nulTref	:...Tuple\(\)
 out: 	:$
+out: 	: ---build-from-sub-Tuples---
+out: T1357L	:TYPES-\[\]-<1>-<3>-<5>-<7>-
+out: T1357T	:TYPES-<>-<1>-<3>-<5>-<7>-
+out: T135L	:TYPES-\[\]-<1>-<3>-<5>-
+out: T57T	:TYPES-<>-<5>-<7>-
+out: T35T	:TYPES-<>-<3>-<5>-
+out: sub135	:...Tuple\(\(1\),\(3\),\(5\)\)
+out: b_135	:...Tuple\(\(1\),\(3\),\(5\),\(7\)\)
+out: sub57	:...Tuple\(\(5\),\(7\)\)
+out: b_57	:...Tuple\(\(1\),\(3\),\(5\),\(7\)\)
+out: sub35	:...Tuple\(\{8\},\{8\}\)
+out: b_35	:...Tuple\(\(1\),\{8\},\{8\},\(7\)\)
+out: b_35	:...Tuple\(\(1\),\(3\),\(5\),\(7\)\)
+out: sub78	:...Tuple\(\{77\},\{88\}\)
+out: b_78	:...Tuple\(\(1\),\(3\),\(5\),\{77\}\)
+out: b_nul	:...Tuple\(\(1\),\(3\),\(5\),\(7\)\)
+out: b_nul2	:...Tuple\(\)
+out: 	:$
 out: 	: ---copy-operations---
 out: tup1	:...Tuple\(\{11\},\{33\},\(5\)\)
 out: tup11	:...Tuple\(\{11\},\{33\},\{44\}\)
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
new file mode 100644
index 000000000..72b458cf8
--- /dev/null
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -0,0 +1,351 @@
+/*
+  FunctionClosure(Test)  -  appending, mixing and filtering typelists
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file function-closure-test.cpp
+ ** Testing a combination of tr1::function objects and metaprogramming.
+ ** Argument types will be extracted and represented as typelist, so they
+ ** can be manipulated at compile time. This test uses some functions with
+ ** and systematically applies or binds them to corresponding data tuples.
+ ** Moreover, closure objects will be constructed in various flavours,
+ ** combining a function object and a set of parameters.
+ ** 
+ ** @see function-closure.hpp
+ ** @see control::CmdClosure real world usage example
+ **
+ */
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/function.hpp"
+#include "lib/meta/function-closure.hpp"
+#include "meta/dummy-functions.hpp"
+#include "meta/typelist-diagnostics.hpp"
+#include "meta/tuple-diagnostics.hpp"
+
+#include <iostream>
+
+using ::test::Test;
+using std::string;
+using std::cout;
+using std::endl;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test {
+      
+      
+      namespace { // test data
+        
+        
+        
+        typedef Types< Num<1>
+                     , Num<2>
+                     , Num<3>
+                     >::List List1;
+        typedef Types< Num<5>
+                     , Num<6>
+                     , Num<7>
+                     >::List List2;
+        
+        
+        /** special test fun 
+         *  accepting the terrific Num types */
+        template<char i,char ii, char iii>
+        int
+        getNumberz (Num<i> one, Num<ii> two, Num<iii> three)
+          {
+            return one.o_ + two.o_ + three.o_;
+          }
+        
+        
+        int fun0 ()                       { return -1;       }
+        int fun1 (int i1)                 { return i1;       }
+        int fun2 (int i1, int i2)         { return i1+i2;    }
+        int fun3 (int i1, int i2, int i3) { return i1+i2+i3; }
+        
+      } // (End) test data
+      
+      
+      
+      
+      
+      
+  /*************************************************************************
+   * @test building a function closure for a given function or functor,
+   *       while arguments are passed in as tuple
+   *       - accessing signatures as typelists
+   *       - apply free function to tuple
+   *       - apply functor to tuple 
+   *       - bind free function to tuple
+   *       - bind functor to tuple
+   *       - build a simple "tuple closure"
+   */
+  class FunctionClosure_test : public Test
+    {
+      virtual void
+      run (Arg) 
+        {
+          check_diagnostics ();
+          check_signatureTypeManip ();
+          check_applyFree ();
+          check_applyFunc ();
+          check_bindFree  ();
+          check_bindFunc  ();
+          build_closure ();
+        }
+      
+      
+      /** verify the test input data
+       *  @see TypeListManipl_test#check_diagnostics()
+       *       for an explanation of the DISPLAY macro
+       */
+      void
+      check_diagnostics ()
+        {
+          DISPLAY (List1);
+          DISPLAY (List2);
+          ;
+          ASSERT (6 == (getNumberz<1,2,3> (Num<1>(), Num<2>(), Num<3>())));
+          ASSERT (6 == (getNumberz<1,1,1> (Num<1>(), Num<1>(2), Num<1>(3))));
+        }
+      
+      
+      void
+      check_signatureTypeManip ()
+        {
+          typedef int someFunc(Num<5>,Num<9>);
+          typedef FunctionSignature<function<someFunc> >::Ret RetType;  // should be int
+          typedef FunctionSignature<function<someFunc> >::Args Args;
+          DISPLAY (Args);
+          
+          typedef Prepend<Num<1>, Args>::Tuple NewArgs;             // manipulate the argument type(s)
+          DISPLAY (NewArgs);
+          
+          typedef FunctionTypedef<RetType,NewArgs>::Sig NewSig;  // re-build a new function signature
+          
+          NewSig& fun =  getNumberz<1,5,9>;                    //...which is compatible to an existing real function signature!
+          
+          ASSERT (1+5+9 == fun(Num<1>(), Num<5>(), Num<9>()));
+        }
+      
+      
+      void
+      check_applyFree ()
+        {
+          cout << "\t:\n\t: ---Apply---\n";
+          
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          DUMPVAL (tup0);
+          DUMPVAL (tup1);
+          DUMPVAL (tup2);
+          DUMPVAL (tup3);
+          
+          ASSERT (-1       == func::Apply<0>::invoke<int> (fun0, tup0) );
+          ASSERT (11       == func::Apply<1>::invoke<int> (fun1, tup1) );
+          ASSERT (11+12    == func::Apply<2>::invoke<int> (fun2, tup2) );
+          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (fun3, tup3) );
+          
+          ASSERT (-1       == TupleApplicator<int()>            (tup0) (fun0) );
+          ASSERT (11       == TupleApplicator<int(int)>         (tup1) (fun1) );
+          ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (fun2) );
+          ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (fun3) );
+          
+          ASSERT (-1       == func::apply(fun0, tup0) );
+          ASSERT (11       == func::apply(fun1, tup1) );
+          ASSERT (11+12    == func::apply(fun2, tup2) );
+          ASSERT (11+12+13 == func::apply(fun3, tup3) );
+        
+        }
+      
+      
+      void
+      check_applyFunc ()
+        {
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          function<int()>            functor0 (fun0);
+          function<int(int)>         functor1 (fun1);
+          function<int(int,int)>     functor2 (fun2);
+          function<int(int,int,int)> functor3 (fun3);
+          
+          ASSERT (-1       == func::Apply<0>::invoke<int> (functor0, tup0) );
+          ASSERT (11       == func::Apply<1>::invoke<int> (functor1, tup1) );
+          ASSERT (11+12    == func::Apply<2>::invoke<int> (functor2, tup2) );
+          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (functor3, tup3) );
+          
+          ASSERT (-1       == TupleApplicator<int()>            (tup0) (functor0) );
+          ASSERT (11       == TupleApplicator<int(int)>         (tup1) (functor1) );
+          ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (functor2) );
+          ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (functor3) );
+          
+          ASSERT (-1       == func::apply(functor0, tup0) );
+          ASSERT (11       == func::apply(functor1, tup1) );
+          ASSERT (11+12    == func::apply(functor2, tup2) );
+          ASSERT (11+12+13 == func::apply(functor3, tup3) );
+          
+        }
+      
+      
+      void
+      check_bindFree ()
+        {
+          cout << "\t:\n\t: ---Bind----\n";
+          
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          
+          typedef function<int()> BoundFun;
+          
+          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (fun0, tup0);
+          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (fun1, tup1);
+          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (fun2, tup3);
+          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (fun3, tup3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
+          functor0 = TupleApplicator<int()>            (tup0).bind (fun0);
+          functor1 = TupleApplicator<int(int)>         (tup1).bind (fun1);
+          functor2 = TupleApplicator<int(int,int)>     (tup2).bind (fun2);
+          functor3 = TupleApplicator<int(int,int,int)> (tup3).bind (fun3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
+        }
+      
+      
+      void
+      check_bindFunc ()
+        {
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          function<int()>            unbound_functor0 (fun0);
+          function<int(int)>         unbound_functor1 (fun1);
+          function<int(int,int)>     unbound_functor2 (fun2);
+          function<int(int,int,int)> unbound_functor3 (fun3);
+          
+          typedef function<int()> BoundFun;
+          
+          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (unbound_functor0, tup0);
+          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (unbound_functor1, tup1);
+          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (unbound_functor2, tup3);
+          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (unbound_functor3, tup3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
+          functor0 = TupleApplicator<int()>            (tup0).bind (unbound_functor0);
+          functor1 = TupleApplicator<int(int)>         (tup1).bind (unbound_functor1);
+          functor2 = TupleApplicator<int(int,int)>     (tup2).bind (unbound_functor2);
+          functor3 = TupleApplicator<int(int,int,int)> (tup3).bind (unbound_functor3);
+          
+          ASSERT (-1       == functor0() );
+          ASSERT (11       == functor1() );
+          ASSERT (11+12    == functor2() );
+          ASSERT (11+12+13 == functor3() );
+          
+        }
+      
+      
+      void
+      build_closure ()
+        {
+          Tuple<Types<> >            tup0 ;
+          Tuple<Types<int> >         tup1 (11);
+          Tuple<Types<int,int> >     tup2 (11,12);
+          Tuple<Types<int,int,int> > tup3 (11,12,13);
+          
+          FunctionClosure<int()>            clo0 (fun0,tup0);
+          FunctionClosure<int(int)>         clo1 (fun1,tup1);
+          FunctionClosure<int(int,int)>     clo2 (fun2,tup2);
+          FunctionClosure<int(int,int,int)> clo3 (fun3,tup3);
+          
+          ASSERT (-1       == clo0() );
+          ASSERT (11       == clo1() );
+          ASSERT (11+12    == clo2() );
+          ASSERT (11+12+13 == clo3() );
+          
+          function<int()>            unbound_functor0 (fun0);
+          function<int(int)>         unbound_functor1 (fun1);
+          function<int(int,int)>     unbound_functor2 (fun2);
+          function<int(int,int,int)> unbound_functor3 (fun3);
+          
+          clo0 = FunctionClosure<int()>            (unbound_functor0,tup0);
+          clo1 = FunctionClosure<int(int)>         (unbound_functor1,tup1);
+          clo2 = FunctionClosure<int(int,int)>     (unbound_functor2,tup2);
+          clo3 = FunctionClosure<int(int,int,int)> (unbound_functor3,tup3);
+          
+          ASSERT (-1       == clo0() );
+          ASSERT (11       == clo1() );
+          ASSERT (11+12    == clo2() );
+          ASSERT (11+12+13 == clo3() );
+          
+          ASSERT (-1       == func::closure(fun0,tup0) () );
+          ASSERT (11       == func::closure(fun1,tup1) () );
+          ASSERT (11+12    == func::closure(fun2,tup2) () );
+          ASSERT (11+12+13 == func::closure(fun3,tup3) () );
+          
+          ASSERT (-1       == func::closure(unbound_functor0,tup0) () );
+          ASSERT (11       == func::closure(unbound_functor1,tup1) () );
+          ASSERT (11+12    == func::closure(unbound_functor2,tup2) () );
+          ASSERT (11+12+13 == func::closure(unbound_functor3,tup3) () );
+          
+          
+          // finally combine all techniques....
+          typedef Tuple<List2>::Type NumberzArg;
+          typedef FunctionTypedef<int,NumberzArg>::Sig NumberzSig;
+          Tuple<NumberzArg> numberzTup (Num<5>(22), Num<6>(33), Num<7>(44));
+          
+          FunctionClosure<NumberzSig> numClo (getNumberz<5,6,7>, numberzTup );
+          
+          ASSERT (22+33+44 == numClo() );
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (FunctionClosure_test, "unit common");
+  
+  
+  
+}}} // namespace lumiera::typelist::test
diff --git a/tests/lib/meta/type-tuple-test.cpp b/tests/lib/meta/type-tuple-test.cpp
index 80f15929a..932f56572 100644
--- a/tests/lib/meta/type-tuple-test.cpp
+++ b/tests/lib/meta/type-tuple-test.cpp
@@ -80,6 +80,7 @@ namespace test {
    *       are synthesised by recursion over the related typelist.
    *       - diagnostics through TupleAccessor retrieving stored values
    *       - creating tuples by direct function call, providing values
+   *       - creating tuples partially from an existing sub-argument tuple
    *       - copy and copy construct
    *       - access the "head" and access values by numeric index
    *       - create a tuple with shifted values 
@@ -94,6 +95,7 @@ namespace test {
           check_sub_tuple_types();
           check_shiftedTuple();
           check_tuple_creation();
+          check_build_from_subTuple();
           check_tuple_copy();
           check_value_access();
         }
@@ -312,6 +314,73 @@ namespace test {
         }
       
       
+      void
+      check_build_from_subTuple()
+        {
+          cout << "\t:\n\t: ---build-from-sub-Tuples---\n";
+          
+          typedef Append<Types1::List, Types3::List>::List TL;
+          typedef Tuple<TL>::Type                          TT;
+          typedef Tuple<TL> T1357L;
+          typedef Tuple<TT> T1357T;
+          DISPLAY (T1357L);
+          DISPLAY (T1357T);
+          
+          typedef Tuple<Types1::List> T135L;
+          typedef Tuple<Types<Num<5>,Num<7> > > T57T;
+          typedef Tuple<Types<Num<3>,Num<5> > > T35T;
+          DISPLAY (T135L);
+          DISPLAY (T57T);
+          DISPLAY (T35T);
+          
+          T135L sub135;
+          T57T sub57;
+          T35T sub35 (Num<3>(8),Num<5>(8));
+          
+          DUMPVAL (sub135);
+          T1357T   b_135  = tuple::BuildTuple<T1357T,T135L>::create(sub135);
+          DUMPVAL (b_135);
+                   b_135  = tuple::BuildTuple<T1357L,T135L>::create(sub135);
+          DUMPVAL (b_135);
+                   b_135  = tuple::BuildTuple<TL,Types1>::create(sub135);
+          DUMPVAL (b_135);
+                   b_135  = tuple::BuildTuple<TT,Types1::List>::create(sub135);
+          DUMPVAL (b_135);                              // all variations of type specification lead to the same result
+          
+          DUMPVAL (sub57);
+          T1357T   b_57   = tuple::BuildTuple<T1357T,T57T,2>::create(sub57);
+          DUMPVAL (b_57);
+          
+          DUMPVAL (sub35);
+          T1357T   b_35   = tuple::BuildTuple<T1357T,T35T,1>::create(sub35);
+          DUMPVAL (b_35);
+          
+                   b_35   = tuple::BuildTuple<T1357T,T35T,2>::create(sub35);
+          DUMPVAL (b_35);                               // note: wrong start position, argument tuple ignored completely
+                   b_35   = tuple::BuildTuple<T1357T,T35T,4>::create(sub35);
+          DUMPVAL (b_35);
+          
+          // use an argument tuple beyond the last argument of the target tuple... 
+          typedef  Tuple<Types<Num<7>,Num<8> > >  T78T;
+          T78T     sub78 (Num<7>(77),Num<8>(88));
+          DUMPVAL (sub78);
+          T1357T   b_78   = tuple::BuildTuple<T1357T,T78T,3>::create(sub78);
+          DUMPVAL (b_78);                              // note: superfluous arguments ignored
+          
+          typedef Tuple<Types<> > NulT;
+          NulT     nult;
+          T1357T   b_nul  = tuple::BuildTuple<T1357T,NulT,1>::create(nult);
+          DUMPVAL (b_nul);
+                   b_nul  = tuple::BuildTuple<T1357T,NulT,4>::create(nult);
+          DUMPVAL (b_nul);
+          
+          NulT     b_nul2 = tuple::BuildTuple<NulT,T78T>::create(sub78);
+          DUMPVAL (b_nul2)
+                   b_nul2 = tuple::BuildTuple<NulT,T78T,1>::create(sub78);
+          DUMPVAL (b_nul2)
+        }
+      
+      
       void
       check_tuple_copy()
         {

From 03c9edce49c6c012e17e7862d544c9c4d3639e09 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 29 Jun 2009 02:03:30 +0200
Subject: [PATCH 150/368] factored out yet another little helper, incl unit
 test

---
 src/lib/meta/typelistutil.hpp          | 24 +++++++++++++
 tests/40components.tests               | 13 +++++++
 tests/lib/meta/typelist-manip-test.cpp | 48 ++++++++++++++++++++++++++
 3 files changed, 85 insertions(+)

diff --git a/src/lib/meta/typelistutil.hpp b/src/lib/meta/typelistutil.hpp
index 1b89b26bc..1aa7b5451 100644
--- a/src/lib/meta/typelistutil.hpp
+++ b/src/lib/meta/typelistutil.hpp
@@ -152,6 +152,30 @@ namespace typelist {
     
     
     
+    /** 
+     * splice a typelist like an overlay
+     * into an base typelist, starting at given index
+     */
+    template<class BASE, class OVERLAY, uint i=0>
+    struct Overlay;
+    
+    template<class B, class BS,
+             class O, class OS, uint i>
+    struct Overlay<Node<B,BS>,Node<O,OS>,i>{ typedef Node<B, typename Overlay<BS, Node<O,OS>,i-1>::List>  List; };
+    
+    template<class B, class BS,
+             class O, class OS >
+    struct Overlay<Node<B,BS>,Node<O,OS>,0>{ typedef Node<O, typename Overlay<BS,OS, 0>::List>            List; };
+    
+    template<class B, class BS, uint i>
+    struct Overlay<Node<B,BS>, NullType, i>{ typedef Node<B,BS> List; };
+    
+    template<class XX, uint i>
+    struct Overlay<NullType, XX, i>        { typedef NullType   List; };
+    
+    
+    
+    
     /** 
      * prefix each of the elements,
      * yielding a list-of lists-of-types
diff --git a/tests/40components.tests b/tests/40components.tests
index 8c4317699..3a4c87f80 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -496,6 +496,19 @@ out: Append6	:-<5>-<6>-<7>-
 out: Append7	:-<111>-<5>-<6>-<7>-
 out: Append8	:-<1>-<2>-<3>-<222>-
 out: Append9	:-<1>-<2>-<3>-<5>-<6>-<7>-
+out: Overl01	:-
+out: Overl02	:-
+out: Overl03	:-
+out: Overl04	:-<9>-<8>-<3>-
+out: Overl05	:-<1>-<9>-<8>-
+out: Overl06	:-<1>-<2>-<9>-
+out: Overl07	:-<1>-<2>-<3>-
+out: Overl08	:-<1>-<2>-<3>-
+out: Overl09	:-<1>-<2>-<3>-
+out: Overl10	:-<1>-<1>-<2>-
+out: Overl11	:-<1>-<2>-<3>-
+out: Overl12	:-<1>-<2>-<3>-
+out: Overl13	:-<1>-<2>-<3>-
 out: FilterEven	:-<2>-<6>-
 out: Prefix1	:
 out: 	\+---<11>-<22>-\+-
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index f3096430e..2961ae664 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -98,6 +98,7 @@ namespace test {
               check_diagnostics ();
               check_apply  ();
               check_append ();
+              check_overlay();
               check_filter ();
               check_prefix ();
               check_distribute();
@@ -152,6 +153,53 @@ namespace test {
               DISPLAY (Append9);
             }
           
+          
+          void
+          check_overlay ()
+            {
+              typedef Types<Num<9>,Num<8> >::List OLi;
+              // will "paste" the list OLi "on top" of another Typelist...
+              
+              typedef Overlay<NullType, NullType> Overl01;
+              DISPLAY (Overl01);
+              
+              typedef Overlay<NullType, OLi>      Overl02;
+              DISPLAY (Overl02);
+              
+              typedef Overlay<NullType, OLi, 5>   Overl03;
+              DISPLAY (Overl03);
+              
+              typedef Overlay<List1, OLi>         Overl04;
+              DISPLAY (Overl04);
+              
+              typedef Overlay<List1, OLi, 1>      Overl05;
+              DISPLAY (Overl05);
+              
+              typedef Overlay<List1, OLi, 2>      Overl06;
+              DISPLAY (Overl06);
+              
+              typedef Overlay<List1, OLi, 3>      Overl07;
+              DISPLAY (Overl07);
+              
+              typedef Overlay<List1, OLi, 5>      Overl08;
+              DISPLAY (Overl08);
+              
+              typedef Overlay<List1, List1>       Overl09;
+              DISPLAY (Overl09);
+              
+              typedef Overlay<List1, List1, 1>    Overl10;
+              DISPLAY (Overl10);
+              
+              typedef Overlay<List1, NullType>    Overl11;
+              DISPLAY (Overl11);
+              
+              typedef Overlay<List1, NullType, 1> Overl12;
+              DISPLAY (Overl12);
+              
+              typedef Overlay<List1, NullType, 5> Overl13;
+              DISPLAY (Overl13);
+            }
+          
           template<class X> struct AddConst2          { typedef X        Type; };
           template<int I>   struct AddConst2<Num<I> > { typedef Num<I+2> Type; };
           

From 6029c2c4e2a2d00554e8d7f2da5b346d3fbe3366 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 29 Jun 2009 03:05:50 +0200
Subject: [PATCH 151/368] better name it Splice, and extend the capabilities a
 bit

---
 src/lib/meta/typelistutil.hpp          | 28 ++++++++++----
 tests/lib/meta/typelist-manip-test.cpp | 52 ++++++++++++++++++--------
 2 files changed, 57 insertions(+), 23 deletions(-)

diff --git a/src/lib/meta/typelistutil.hpp b/src/lib/meta/typelistutil.hpp
index 1aa7b5451..5fcded832 100644
--- a/src/lib/meta/typelistutil.hpp
+++ b/src/lib/meta/typelistutil.hpp
@@ -154,24 +154,36 @@ namespace typelist {
     
     /** 
      * splice a typelist like an overlay
-     * into an base typelist, starting at given index
+     * into an base typelist, starting at given index.
+     * @return either the combined (spliced) List, or
+     *         the Front/Back part before or after the Overlay
+     * @note using a NullType as OVERLAY allows to extract
+     *         an arbitrary Front/Back part of the list
      */
     template<class BASE, class OVERLAY, uint i=0>
-    struct Overlay;
+    struct Splice;
     
     template<class B, class BS,
-             class O, class OS, uint i>
-    struct Overlay<Node<B,BS>,Node<O,OS>,i>{ typedef Node<B, typename Overlay<BS, Node<O,OS>,i-1>::List>  List; };
+             class OVERLAY, uint i>
+    struct Splice<Node<B,BS>, OVERLAY, i>  { typedef Node<B, typename Splice<BS, OVERLAY, i-1>::List>  List;
+                                             typedef Node<B, typename Splice<BS, OVERLAY, i-1>::Front> Front;
+                                             typedef         typename Splice<BS, OVERLAY, i-1>::Back   Back; };
     
     template<class B, class BS,
              class O, class OS >
-    struct Overlay<Node<B,BS>,Node<O,OS>,0>{ typedef Node<O, typename Overlay<BS,OS, 0>::List>            List; };
+    struct Splice<Node<B,BS>,Node<O,OS>,0> { typedef Node<O, typename Splice<BS,OS, 0>::List>          List;
+                                             typedef NullType                                          Front; 
+                                             typedef         typename Splice<BS,OS, 0>::Back           Back; };
     
-    template<class B, class BS, uint i>
-    struct Overlay<Node<B,BS>, NullType, i>{ typedef Node<B,BS> List; };
+    template<class B, class BS>
+    struct Splice<Node<B,BS>, NullType, 0> { typedef Node<B, BS> List; 
+                                             typedef NullType    Front;
+                                             typedef Node<B, BS> Back; };
     
     template<class XX, uint i>
-    struct Overlay<NullType, XX, i>        { typedef NullType   List; };
+    struct Splice<NullType, XX, i>         { typedef NullType    List;
+                                             typedef NullType    Front;
+                                             typedef NullType    Back; };
     
     
     
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index 2961ae664..9c86a2e34 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -98,7 +98,7 @@ namespace test {
               check_diagnostics ();
               check_apply  ();
               check_append ();
-              check_overlay();
+              check_splice ();
               check_filter ();
               check_prefix ();
               check_distribute();
@@ -155,51 +155,73 @@ namespace test {
           
           
           void
-          check_overlay ()
+          check_splice ()
             {
               typedef Types<Num<9>,Num<8> >::List OLi;
               // will "paste" the list OLi "on top" of another Typelist...
               
-              typedef Overlay<NullType, NullType> Overl01;
+              typedef Splice<NullType, NullType> Overl01;
               DISPLAY (Overl01);
               
-              typedef Overlay<NullType, OLi>      Overl02;
+              typedef Splice<NullType, OLi>      Overl02;
               DISPLAY (Overl02);
               
-              typedef Overlay<NullType, OLi, 5>   Overl03;
+              typedef Splice<NullType, OLi, 5>   Overl03;
               DISPLAY (Overl03);
               
-              typedef Overlay<List1, OLi>         Overl04;
+              typedef Splice<List1, OLi>         Overl04;
               DISPLAY (Overl04);
               
-              typedef Overlay<List1, OLi, 1>      Overl05;
+              typedef Splice<List1, OLi, 1>      Overl05;
               DISPLAY (Overl05);
               
-              typedef Overlay<List1, OLi, 2>      Overl06;
+              typedef Splice<List1, OLi, 2>      Overl06;
               DISPLAY (Overl06);
               
-              typedef Overlay<List1, OLi, 3>      Overl07;
+              typedef Splice<List1, OLi, 3>      Overl07;
               DISPLAY (Overl07);
               
-              typedef Overlay<List1, OLi, 5>      Overl08;
+              typedef Splice<List1, OLi, 5>      Overl08;
               DISPLAY (Overl08);
               
-              typedef Overlay<List1, List1>       Overl09;
+              typedef Splice<List1, List1>       Overl09;
               DISPLAY (Overl09);
               
-              typedef Overlay<List1, List1, 1>    Overl10;
+              typedef Splice<List1, List1, 1>    Overl10;
               DISPLAY (Overl10);
               
-              typedef Overlay<List1, NullType>    Overl11;
+              typedef Splice<List1, NullType>    Overl11;
               DISPLAY (Overl11);
               
-              typedef Overlay<List1, NullType, 1> Overl12;
+              typedef Splice<List1, NullType, 1> Overl12;
               DISPLAY (Overl12);
               
-              typedef Overlay<List1, NullType, 5> Overl13;
+              typedef Splice<List1, NullType, 5> Overl13;
               DISPLAY (Overl13);
+              
+              
+              typedef Types<Num<99> >::List OLi2;
+              typedef Splice<List1, OLi2, 0>::Front Front1;
+              typedef Splice<List1, OLi2, 1>::Front Front2;
+              typedef Splice<List1, OLi2, 5>::Front Front3;
+              DISPLAY (Front1);
+              DISPLAY (Front2);
+              DISPLAY (Front3);
+              typedef Splice<List1, OLi2, 0>::Back  Back1;
+              typedef Splice<List1, OLi2, 1>::Back  Back2;
+              typedef Splice<List1, OLi2, 5>::Back  Back3;
+              DISPLAY (Back1);
+              DISPLAY (Back2);
+              DISPLAY (Back3);
+              
+              // Note: with a Null-Overlay, this can be used to extract arbitrary sublists:
+              typedef Splice<List1, NullType, 1>::Front Front4;
+              typedef Splice<List1, NullType, 1>::Back  Back4;
+              DISPLAY (Front4);
+              DISPLAY (Back4);
             }
           
+          
           template<class X> struct AddConst2          { typedef X        Type; };
           template<int I>   struct AddConst2<Num<I> > { typedef Num<I+2> Type; };
           

From a19892ac6a6412496f892e4e0864b68759ef4ef7 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 29 Jun 2009 06:33:42 +0200
Subject: [PATCH 152/368] WIP some steps towards a solution of the memento
 binding problem

---
 src/lumiera/main.cpp                          |   2 +-
 tests/40components.tests                      |  17 ++-
 .../proc/control/command-argument-test.cpp    |   9 +-
 tests/lib/Makefile.am                         |   1 +
 tests/lib/meta/function-closure-test.cpp      |   1 -
 tests/lib/meta/function-composition-test.cpp  | 143 +++++++++++-------
 6 files changed, 108 insertions(+), 65 deletions(-)

diff --git a/src/lumiera/main.cpp b/src/lumiera/main.cpp
index 002961de4..f5555e927 100644
--- a/src/lumiera/main.cpp
+++ b/src/lumiera/main.cpp
@@ -2,7 +2,7 @@
   main.cpp  -  start the Lumiera Application
 
   Copyright (C)         Lumiera.org
-    2007-2008,          Joel Holdsworth <joel@airwebreathe.org.uk>
+    2007-2009,          Joel Holdsworth <joel@airwebreathe.org.uk>
                         Christian Thaeter <ct@pipapo.org>
                         Hermann Vosseler <Ichthyostega@web.de>
 
diff --git a/tests/40components.tests b/tests/40components.tests
index 3a4c87f80..74592e8ab 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -234,7 +234,7 @@ out: dtor ~TargetObj\(12\) successful
 END
 
 
-TEST "FunctionClosure_test" FunctionClosure_test <<END
+TEST "closing function over its arguments" FunctionClosure_test <<END
 out: List1	:-<1>-<2>-<3>-
 out: List2	:-<5>-<6>-<7>-
 out: Args	:-<5>-<9>-
@@ -251,7 +251,12 @@ return: 0
 END
 
 
-TEST "FunctionErasure_test" FunctionErasure_test <<END
+TEST "functional composition" FunctionComposition_test <<END
+return: 0
+END
+
+
+TEST "function type erasure" FunctionErasure_test <<END
 return: 0
 END
 
@@ -509,6 +514,14 @@ out: Overl10	:-<1>-<1>-<2>-
 out: Overl11	:-<1>-<2>-<3>-
 out: Overl12	:-<1>-<2>-<3>-
 out: Overl13	:-<1>-<2>-<3>-
+out: Front1	:-
+out: Front2	:-<1>-
+out: Front3	:-<1>-<2>-<3>-
+out: Back1	:-<2>-<3>-
+out: Back2	:-<3>-
+out: Back3	:-
+out: Front4	:-<1>-
+out: Back4	:-<2>-<3>-
 out: FilterEven	:-<2>-<6>-
 out: Prefix1	:
 out: 	\+---<11>-<22>-\+-
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index 4d6020e87..578376671 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -82,14 +82,9 @@ namespace test    {
   
   
   /***************************************************************************
-   * Verify the behaviour of the type erased closure, which is used
-   * by Proc-Layer commands to implement the capturing and later
-   * re-invocation of a function.
+   * @test storing and retrieving command arguments of various types.
    *       
-   * @see  control::Command
-   * @see  control::CommandDef
-   * @see  control::Mutation
-   * @see  control::UndoMutation
+   * @see  control::CommandArgumentHolder
    * @see  command-basic-test.hpp
    */
   class CommandArgument_test : public Test
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 335d2d351..9277521de 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -50,6 +50,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/meta/typelist-test.cpp         	\
 	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
 	$(testlib_srcdir)/meta/type-tuple-test.cpp    		\
+	$(testlib_srcdir)/meta/function-composition-test.cpp   	\
 	$(testlib_srcdir)/meta/function-closure-test.cpp   	\
 	$(testlib_srcdir)/meta/function-erasure-test.cpp   	\
 	$(testlib_srcdir)/meta/generator-test.cpp        	\
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 72b458cf8..0a0cce750 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -41,7 +41,6 @@
 #include "lib/meta/typelistutil.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/function-closure.hpp"
-#include "meta/dummy-functions.hpp"
 #include "meta/typelist-diagnostics.hpp"
 #include "meta/tuple-diagnostics.hpp"
 
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index 72b458cf8..85701bace 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -1,5 +1,5 @@
 /*
-  FunctionClosure(Test)  -  appending, mixing and filtering typelists
+  FunctionComposition(Test)  -  functional composition and partial application
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,29 +21,12 @@
 * *****************************************************/
 
 
-/** @file function-closure-test.cpp
- ** Testing a combination of tr1::function objects and metaprogramming.
- ** Argument types will be extracted and represented as typelist, so they
- ** can be manipulated at compile time. This test uses some functions with
- ** and systematically applies or binds them to corresponding data tuples.
- ** Moreover, closure objects will be constructed in various flavours,
- ** combining a function object and a set of parameters.
- ** 
- ** @see function-closure.hpp
- ** @see control::CmdClosure real world usage example
- **
- */
-
-
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelistutil.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/function-closure.hpp"
-#include "meta/dummy-functions.hpp"
 #include "meta/typelist-diagnostics.hpp"
-#include "meta/tuple-diagnostics.hpp"
 
 #include <iostream>
 
@@ -56,13 +39,16 @@ using std::endl;
 namespace lumiera {
 namespace typelist{
 namespace test {
-      
-      
-      namespace { // test data
+  
+  using func::applyFirst;
+  using func::applyLast;
+  
+  
+      namespace { // test functions
         
         
         
-        typedef Types< Num<1>
+        typedef Types< Num<1>  ////////////////////////TODO kill kill kill
                      , Num<2>
                      , Num<3>
                      >::List List1;
@@ -71,51 +57,100 @@ namespace test {
                      , Num<7>
                      >::List List2;
         
+        Num<1> _1_;                     
+        Num<2> _2_;                     
+        Num<3> _3_;                     
+        Num<4> _4_;                     
+        Num<5> _5_;                     
+        Num<6> _6_;                     
+        Num<7> _7_;                     
+        Num<8> _8_;                     
+        Num<9> _9_;                     
         
-        /** special test fun 
-         *  accepting the terrific Num types */
-        template<char i,char ii, char iii>
-        int
-        getNumberz (Num<i> one, Num<ii> two, Num<iii> three)
+        /** "Function-1" will be used at the front side, accepting a tuple of values */
+        template<char i>
+        Num<i> 
+        fun1 ( Num<i>   val1
+             )
           {
-            return one.o_ + two.o_ + three.o_;
+            return val1;
+          }
+        
+        template<char i, char ii>
+        Num<i> 
+        fun1 ( Num<i>   val1
+             , Num<ii>  val2
+             )
+          {
+            val1.o_ += val2.o_;
+            return val1;
+          }
+        
+        template<char i, char ii, char iii>
+        Num<i> 
+        fun1 ( Num<i>   val1
+             , Num<ii>  val2
+             , Num<iii> val3
+             )
+          {
+            val1.o_ += val2.o_ + val3.o_;
+            return val1;
+          }
+        
+        template<char i, char ii, char iii, char iv>
+        Num<i> 
+        fun1 ( Num<i>   val1
+             , Num<ii>  val2
+             , Num<iii> val3
+             , Num<iv>  val4
+             )
+          {
+            val1.o_ += val2.o_ + val3.o_ + val4.o_;
+            return val1;
+          }
+        
+        template<char i, char ii, char iii, char iv, char v>
+        Num<i> 
+        fun1 ( Num<i>   val1
+             , Num<ii>  val2
+             , Num<iii> val3
+             , Num<iv>  val4
+             , Num<v>   val5
+             )
+          {
+            val1.o_ += val2.o_ + val3.o_ + val4.o_ + val5.o_;
+            return val1;
           }
         
         
-        int fun0 ()                       { return -1;       }
-        int fun1 (int i1)                 { return i1;       }
-        int fun2 (int i1, int i2)         { return i1+i2;    }
-        int fun3 (int i1, int i2, int i3) { return i1+i2+i3; }
+        /** "Function-2" can be chained behind fun1 */
+        template<class II>
+        int
+        fun2 (II val)
+          {
+            return val.o_;
+          }
         
       } // (End) test data
-      
-      
-      
-      
-      
-      
-  /*************************************************************************
-   * @test building a function closure for a given function or functor,
-   *       while arguments are passed in as tuple
-   *       - accessing signatures as typelists
-   *       - apply free function to tuple
-   *       - apply functor to tuple 
-   *       - bind free function to tuple
-   *       - bind functor to tuple
-   *       - build a simple "tuple closure"
+  
+  
+  
+  
+  
+  
+  /******************************************************************************
+   * @test this test covers some extensions and variations on function closures:
+   *       - partial application of a function, returning a binder
+   *       - chaining of two functions with suitable arguemnts ("composition")
    */
-  class FunctionClosure_test : public Test
+  class FunctionComposition_test : public Test
     {
       virtual void
       run (Arg) 
         {
           check_diagnostics ();
-          check_signatureTypeManip ();
-          check_applyFree ();
-          check_applyFunc ();
-          check_bindFree  ();
-          check_bindFunc  ();
-          build_closure ();
+          check_partialApplication ();
+          check_functionalComposition ();
         }
       
       

From 320f984270c1e796f684133fbad137b250be7e3d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 29 Jun 2009 06:34:20 +0200
Subject: [PATCH 153/368] got partial application working, at least in the
 "front" case

---
 src/lib/meta/function-closure.hpp            | 191 +++++++++++-
 tests/lib/meta/function-composition-test.cpp | 300 +++++++------------
 2 files changed, 293 insertions(+), 198 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 59348fd8e..4c354f751 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -362,6 +362,43 @@ namespace typelist{
           }
       };
     
+    
+    /* ===== Helpers for partial function application ===== */
+    
+    using std::tr1::_Placeholder;     // what is the "official" way to import them?
+    
+    template<typename TYPES, uint i=0>
+    class PlaceholderTuple
+      {
+//        typedef typename Tuple<TYPES>::HeadType HeadType;
+//        typedef typename Tuple<TYPES>::ArgList  TypeList;
+//        typedef typename Tuple<TYPES>::Tail::ArgList TailList;
+        typedef typename Tuple<TYPES>::Type     TypeSeq;
+        typedef typename Tuple<TYPES>::TailType TailSeq;
+        
+        typedef typename PlaceholderTuple<TailSeq, i+1>::PlaceholderSeq  TailPlaceholderSeq;
+        
+      public:
+        typedef typename Prepend<_Placeholder<i>, TailPlaceholderSeq>::Tuple PlaceholderSeq;
+        typedef Tuple<PlaceholderSeq> Type;
+        
+      };
+    
+    template<uint i>
+    struct PlaceholderTuple<Types<>, i> : PlaceholderTuple<NullType, i> {};
+    
+    template<uint i>
+    struct PlaceholderTuple<NullType, i>
+      {
+        typedef Types<> PlaceholderSeq;
+        typedef Tuple<Types<> > Type;
+      };
+    
+    
+    
+    
+    
+    
   } // (END) impl-namespace (func)
   
   
@@ -397,6 +434,103 @@ namespace typelist{
     };
   
   
+  /**
+   * Partial function application
+   * Takes a function and a value tuple,
+   * using the latter to close function arguments 
+   * either from the front (left) or aligned to the end
+   * of the function argument list. Result is a "reduced" function,
+   * expecting only the remaining "un-closed" arguments at invocation.  
+   */
+  template<typename SIG, typename VAL>
+  class PApply
+    {
+      typedef typename func::_Fun<SIG>::Args Args;
+      typedef typename func::_Fun<SIG>::Ret  Ret;
+      
+      enum { ARG_CNT = count<typename Args::List>::value
+           , VAL_CNT = count<typename VAL::List>::value
+           , ROFFSET = (VAL_CNT < ARG_CNT)? ARG_CNT-VAL_CNT : 0
+           };
+      
+      typedef typename func::PlaceholderTuple<Args>::PlaceholderSeq::List Placeholders;
+      typedef typename Args::List ArgsList;
+      typedef typename VAL::List ValList;
+      
+      typedef typename Splice<Placeholders, ValList>::List           LeftReplaced;
+      typedef typename Splice<Placeholders, ValList, ROFFSET>::List  RightReplaced;
+      
+      typedef typename Splice<ArgsList, ValList>::Back           LeftReduced;
+      typedef typename Splice<ArgsList, ValList, ROFFSET>::Front RightReduced;
+      
+      typedef Tuple<LeftReplaced>  TupleL;
+      typedef Tuple<RightReplaced> TupleR;
+      
+      typedef typename Tuple<LeftReduced>::Type  ArgsL;
+      typedef typename Tuple<RightReduced>::Type ArgsR;
+      
+      typedef tuple::BuildTuple<LeftReplaced, ValList>           BuildL;
+      typedef tuple::BuildTuple<RightReplaced, ValList, ROFFSET> BuildR;
+      
+      
+    public:
+      typedef function<typename FunctionTypedef<Ret,ArgsL>::Sig> LeftReducedFunc;
+      typedef function<typename FunctionTypedef<Ret,ArgsR>::Sig> RightReducedFunc;
+      
+      
+      /** Contains the argument values, starting from left.
+       *  Any remaining positions are occupied by binding placeholders */
+      struct LeftReplacedArgs
+        : TupleL
+        {
+          LeftReplacedArgs (Tuple<VAL> const& arg)
+            : TupleL ( BuildL::create(arg))
+            { }
+        };
+      
+      /** Contains the argument values, aligned to the end of the function argument list.
+       *  Any remaining positions before are occupied by binding placeholders */
+      struct RightReplacedArgs
+        : TupleR
+        {
+          RightReplacedArgs (Tuple<VAL> const& arg)
+            : TupleR ( BuildR::create(arg))
+            { }
+        };
+        
+      /** do a partial function application, closing the first arguments
+       *  f(a,b,c)->res  +  (a,b)  yields  f(c)->res
+       *  
+       *  @param f   function, function pointer or functor
+       *  @param arg value tuple, used to close function arguments starting from left
+       *  @return new function object, holding copies of the values and using them at the
+       *          closed arguments; on invocation, only the remaining arguments need to be supplied.
+       */
+      static LeftReducedFunc
+      bindFront (SIG& f, Tuple<VAL> const& arg)
+        {
+          LeftReplacedArgs params (arg);
+          return func::Apply<ARG_CNT>::template bind<LeftReducedFunc> (f, params.tupleCast());
+        }
+      
+      /** do a partial function application, closing the last arguments
+       *  f(a,b,c)->res  +  (b,c)  yields  f(a)->res
+       *  
+       *  @param f   function, function pointer or functor
+       *  @param arg value tuple, used to close function arguments starting from right
+       *  @return new function object, holding copies of the values and using them at the
+       *          closed arguments; on invocation, only the remaining arguments need to be supplied.
+       */
+      static RightReducedFunc
+      bindBack (SIG& f, Tuple<VAL> const& arg)
+        {
+          RightReplacedArgs params (arg);
+          return func::Apply<ARG_CNT>::template bind<RightReducedFunc> (f, params.tupleCast());
+        }
+    };
+  
+  
+  
   /**
    * Closing a function over its arguments.
    * This is a small usage example or spin-off,
@@ -430,6 +564,9 @@ namespace typelist{
   
   namespace func { // ...some convenience shortcuts
     
+    
+    // helpers for specifying types in function declarations....
+  
     template<typename RET, typename ARG>
     struct _Sig
       {
@@ -445,6 +582,32 @@ namespace typelist{
         typedef FunctionClosure<Signature> Type;
       };
     
+    template<typename SIG>
+    struct _PapS
+      {
+        typedef typename _Fun<SIG>::Ret Ret;
+        typedef typename _Fun<SIG>::Args Args;
+        typedef typename Split<Args>::Head Arg;
+        typedef typename Split<Args>::Tail Rest;
+        typedef typename _Sig<Ret,Rest>::Type Signature;
+        typedef function<Signature> Function;
+      };
+    
+    template<typename SIG>
+    struct _PapE
+      {
+        typedef typename _Fun<SIG>::Ret Ret;
+        typedef typename _Fun<SIG>::Args Args;
+        typedef typename Split<Args>::End Arg;
+        typedef typename Split<Args>::Prefix Rest;
+        typedef typename _Sig<Ret,Rest>::Type Signature;
+        typedef function<Signature> Function;
+      };
+    
+    
+    
+    
+    /*  ========== function-style interface =============  */
     
     /** build a TupleApplicator, which embodies the given
      *  argument tuple and can be used to apply various
@@ -483,7 +646,33 @@ namespace typelist{
       typedef typename _Clo<SIG,ARG>::Type Closure;
       return Closure (f,args);
     }
-  }
+    
+    
+    /** close the given function over the first argument */
+    template<typename SIG, typename ARG>
+    typename _PapS<SIG>::Function
+    applyFirst (SIG& f, ARG arg)
+    {
+      typedef typename _PapS<SIG>::Arg ArgType;
+      typedef Types<ArgType>           ArgTypeSeq;
+      typedef Tuple<ArgTypeSeq>        ArgTuple;
+      ArgTuple val(arg);
+      return PApply<SIG,ArgTypeSeq>::bindFront (f, val);
+    }
+    
+    /** close the given function over the last argument */
+    template<typename SIG, typename ARG>
+    typename _PapE<SIG>::Function
+    applyLast (SIG& f, ARG arg)
+    {
+      typedef typename _PapE<SIG>::Arg ArgType;
+      typedef Types<ArgType>           ArgTypeSeq;
+      typedef Tuple<ArgTypeSeq>        ArgTuple;
+      ArgTuple val(arg);
+      return PApply<SIG,ArgTypeSeq>::bindBack (f, val);
+    }
+    
+  } // (END) namespace func
   
   
   
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index 85701bace..aa3617744 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -163,223 +163,129 @@ namespace test {
         {
           DISPLAY (List1);
           DISPLAY (List2);
-          ;
-          ASSERT (6 == (getNumberz<1,2,3> (Num<1>(), Num<2>(), Num<3>())));
-          ASSERT (6 == (getNumberz<1,1,1> (Num<1>(), Num<1>(2), Num<1>(3))));
+          
+          ASSERT (6 == (fun1<1,2,3> (_1_, _2_, _3_)).o_ );
+          ASSERT (6 == (fun1<1,1,1> (Num<1>(3), Num<1>(2), Num<1>(1))).o_ );
+          
+          ASSERT ( 1 == fun2 (fun1<1> (_1_)) );
+          ASSERT ( 3 == fun2 (fun1<1,2> (_1_, _2_)) );
+          ASSERT ( 6 == fun2 (fun1<1,2,3> (_1_, _2_, _3_)) );
+          ASSERT (10 == fun2 (fun1<1,2,3,4> (_1_, _2_, _3_, _4_)) );
+          ASSERT (15 == fun2 (fun1<1,2,3,4,5> (_1_, _2_, _3_, _4_, _5_)) );
+          
+          ASSERT ( 9 == fun2 (fun1<2,3,4> (_2_, _3_, _4_)) );
+          ASSERT (18 == fun2 (fun1<5,6,7> (_5_, _6_, _7_)) );
+          ASSERT (24 == fun2 (fun1<9,8,7> (_9_, _8_, _7_)) );
         }
       
       
       void
-      check_signatureTypeManip ()
+      check_partialApplication ()
         {
-          typedef int someFunc(Num<5>,Num<9>);
-          typedef FunctionSignature<function<someFunc> >::Ret RetType;  // should be int
-          typedef FunctionSignature<function<someFunc> >::Args Args;
-          DISPLAY (Args);
+          // Because the code of the partial function application is very technical,
+          // the following might serve as explanation what actually happens....
+          // (and actually it's a leftover from initial debugging)
           
-          typedef Prepend<Num<1>, Args>::Tuple NewArgs;             // manipulate the argument type(s)
-          DISPLAY (NewArgs);
+          typedef Num<1> Sig123(Num<1>, Num<2>, Num<3>);             // signature of the original function
           
-          typedef FunctionTypedef<RetType,NewArgs>::Sig NewSig;  // re-build a new function signature
+          typedef Num<1> Sig23(Num<2>, Num<3>);                      // signature after having closed over the first argument
+          typedef function<Sig23> F23;                               // and a tr1::function object to hold such a function
           
-          NewSig& fun =  getNumberz<1,5,9>;                    //...which is compatible to an existing real function signature!
+          Sig123& f =fun1<1,2,3>;                                    // the actual input: a reference to the bare function
           
-          ASSERT (1+5+9 == fun(Num<1>(), Num<5>(), Num<9>()));
+          
+          // Version1: do a direct argument binding----------------- //
+          
+          typedef std::tr1::_Placeholder<1> PH1;                     // tr1::function argument placeholders
+          typedef std::tr1::_Placeholder<2> PH2;
+          
+          PH1 ph1;                                                   // these empty structs are used to mark the arguments to be kept "open"
+          PH2 ph2;
+          Num<1> num18 (18);                                         // ...and this value is for closing the first function argument
+          
+          F23 fun_23 = std::tr1::bind (f, num18                      // do the actual binding (i.e. close the first argument with a constant value)
+                                        , ph1
+                                        , ph2
+                                      );
+          
+          int res = 0;
+          res = fun_23 (_2_,_3_).o_;                                 // and invoke the resulting functor ("closure"), providing the remaining arguments
+          ASSERT (23 == res);
+          
+          
+          
+          // Version2: extract the binding arguments from a tuple--- //
+          
+          typedef Tuple<Types<Num<1>, PH1, PH2> > PartialArg;        // Tuple type to hold the binding values. Note the placeholder types
+          PartialArg arg(num18);                                     // Value for partial application (the placeholders are default constructed)
+          
+          fun_23 = std::tr1::bind (f, tuple::element<0>(arg)         // now extract the values to bind from this tuple
+                                    , tuple::element<1>(arg)
+                                    , tuple::element<2>(arg)
+                                  );
+          res = 0;
+          res = fun_23 (_2_,_3_).o_;                                 // and invoke the resulting functor....
+          ASSERT (23 == res);
+          
+          
+          
+          
+          // Version3: let the PApply-template do the work for us--- //
+          
+          typedef Types<Num<1> > ArgTypes;                           // now package just the argument(s) to be applied into a tuple
+          Tuple<ArgTypes> args_to_bind (Num<1>(18));
+          
+          fun_23 = PApply<Sig123, ArgTypes>::bindFront (f , args_to_bind);
+                                                                     // "bindFront" will close the parameters starting from left....
+          res = 0;
+          res = fun_23 (_2_,_3_).o_;                                 // invoke the resulting functor...
+          ASSERT (23 == res);
+          
+          
+          
+          
+          
+          
+          // Version4: as you'd typically do it in real life-------- //
+          
+          fun_23 = func::applyFirst (f, Num<1>(18));                 // use the convenience function API to close over a single value
+          
+          res = 0;
+          res = fun_23 (_2_,_3_).o_;                                 // invoke the resulting functor...
+          ASSERT (23 == res);
+          
+          
+          
+          // what follows is the real unit test...
+          function<Sig123> func123 (f);
+          fun_23 = func::applyFirst (func123, Num<1>(19));
+          res = fun_23 (_2_,_3_).o_;
+          ASSERT (24 == res);
+#if false                                                //////////////TODO silly bug in the Split template!
+          typedef function<Num<1>(Num<1>, Num<2>)> F12;
+          F12 fun_12 = func::applyLast(f, Num<3>(20));
+          res = fun_12 (_1_,_2_).o_;
+          ASSERT (23 == res);
+          
+          fun_12 = func::applyLast(func123, Num<3>(21));
+          res = fun_12 (_1_,_2_).o_;
+          ASSERT (24 == res);
+#endif          
         }
       
       
+      
       void
-      check_applyFree ()
+      check_functionalComposition ()
         {
-          cout << "\t:\n\t: ---Apply---\n";
-          
-          Tuple<Types<> >            tup0 ;
-          Tuple<Types<int> >         tup1 (11);
-          Tuple<Types<int,int> >     tup2 (11,12);
-          Tuple<Types<int,int,int> > tup3 (11,12,13);
-          DUMPVAL (tup0);
-          DUMPVAL (tup1);
-          DUMPVAL (tup2);
-          DUMPVAL (tup3);
-          
-          ASSERT (-1       == func::Apply<0>::invoke<int> (fun0, tup0) );
-          ASSERT (11       == func::Apply<1>::invoke<int> (fun1, tup1) );
-          ASSERT (11+12    == func::Apply<2>::invoke<int> (fun2, tup2) );
-          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (fun3, tup3) );
-          
-          ASSERT (-1       == TupleApplicator<int()>            (tup0) (fun0) );
-          ASSERT (11       == TupleApplicator<int(int)>         (tup1) (fun1) );
-          ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (fun2) );
-          ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (fun3) );
-          
-          ASSERT (-1       == func::apply(fun0, tup0) );
-          ASSERT (11       == func::apply(fun1, tup1) );
-          ASSERT (11+12    == func::apply(fun2, tup2) );
-          ASSERT (11+12+13 == func::apply(fun3, tup3) );
-        
+//          ASSERT (1+5+9 == fun(Num<1>(), Num<5>(), Num<9>()));
         }
       
-      
-      void
-      check_applyFunc ()
-        {
-          Tuple<Types<> >            tup0 ;
-          Tuple<Types<int> >         tup1 (11);
-          Tuple<Types<int,int> >     tup2 (11,12);
-          Tuple<Types<int,int,int> > tup3 (11,12,13);
-          function<int()>            functor0 (fun0);
-          function<int(int)>         functor1 (fun1);
-          function<int(int,int)>     functor2 (fun2);
-          function<int(int,int,int)> functor3 (fun3);
-          
-          ASSERT (-1       == func::Apply<0>::invoke<int> (functor0, tup0) );
-          ASSERT (11       == func::Apply<1>::invoke<int> (functor1, tup1) );
-          ASSERT (11+12    == func::Apply<2>::invoke<int> (functor2, tup2) );
-          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (functor3, tup3) );
-          
-          ASSERT (-1       == TupleApplicator<int()>            (tup0) (functor0) );
-          ASSERT (11       == TupleApplicator<int(int)>         (tup1) (functor1) );
-          ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (functor2) );
-          ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (functor3) );
-          
-          ASSERT (-1       == func::apply(functor0, tup0) );
-          ASSERT (11       == func::apply(functor1, tup1) );
-          ASSERT (11+12    == func::apply(functor2, tup2) );
-          ASSERT (11+12+13 == func::apply(functor3, tup3) );
-          
-        }
-      
-      
-      void
-      check_bindFree ()
-        {
-          cout << "\t:\n\t: ---Bind----\n";
-          
-          Tuple<Types<> >            tup0 ;
-          Tuple<Types<int> >         tup1 (11);
-          Tuple<Types<int,int> >     tup2 (11,12);
-          Tuple<Types<int,int,int> > tup3 (11,12,13);
-          
-          typedef function<int()> BoundFun;
-          
-          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (fun0, tup0);
-          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (fun1, tup1);
-          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (fun2, tup3);
-          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (fun3, tup3);
-          
-          ASSERT (-1       == functor0() );
-          ASSERT (11       == functor1() );
-          ASSERT (11+12    == functor2() );
-          ASSERT (11+12+13 == functor3() );
-          
-          functor0 = TupleApplicator<int()>            (tup0).bind (fun0);
-          functor1 = TupleApplicator<int(int)>         (tup1).bind (fun1);
-          functor2 = TupleApplicator<int(int,int)>     (tup2).bind (fun2);
-          functor3 = TupleApplicator<int(int,int,int)> (tup3).bind (fun3);
-          
-          ASSERT (-1       == functor0() );
-          ASSERT (11       == functor1() );
-          ASSERT (11+12    == functor2() );
-          ASSERT (11+12+13 == functor3() );
-          
-        }
-      
-      
-      void
-      check_bindFunc ()
-        {
-          Tuple<Types<> >            tup0 ;
-          Tuple<Types<int> >         tup1 (11);
-          Tuple<Types<int,int> >     tup2 (11,12);
-          Tuple<Types<int,int,int> > tup3 (11,12,13);
-          function<int()>            unbound_functor0 (fun0);
-          function<int(int)>         unbound_functor1 (fun1);
-          function<int(int,int)>     unbound_functor2 (fun2);
-          function<int(int,int,int)> unbound_functor3 (fun3);
-          
-          typedef function<int()> BoundFun;
-          
-          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (unbound_functor0, tup0);
-          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (unbound_functor1, tup1);
-          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (unbound_functor2, tup3);
-          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (unbound_functor3, tup3);
-          
-          ASSERT (-1       == functor0() );
-          ASSERT (11       == functor1() );
-          ASSERT (11+12    == functor2() );
-          ASSERT (11+12+13 == functor3() );
-          
-          functor0 = TupleApplicator<int()>            (tup0).bind (unbound_functor0);
-          functor1 = TupleApplicator<int(int)>         (tup1).bind (unbound_functor1);
-          functor2 = TupleApplicator<int(int,int)>     (tup2).bind (unbound_functor2);
-          functor3 = TupleApplicator<int(int,int,int)> (tup3).bind (unbound_functor3);
-          
-          ASSERT (-1       == functor0() );
-          ASSERT (11       == functor1() );
-          ASSERT (11+12    == functor2() );
-          ASSERT (11+12+13 == functor3() );
-          
-        }
-      
-      
-      void
-      build_closure ()
-        {
-          Tuple<Types<> >            tup0 ;
-          Tuple<Types<int> >         tup1 (11);
-          Tuple<Types<int,int> >     tup2 (11,12);
-          Tuple<Types<int,int,int> > tup3 (11,12,13);
-          
-          FunctionClosure<int()>            clo0 (fun0,tup0);
-          FunctionClosure<int(int)>         clo1 (fun1,tup1);
-          FunctionClosure<int(int,int)>     clo2 (fun2,tup2);
-          FunctionClosure<int(int,int,int)> clo3 (fun3,tup3);
-          
-          ASSERT (-1       == clo0() );
-          ASSERT (11       == clo1() );
-          ASSERT (11+12    == clo2() );
-          ASSERT (11+12+13 == clo3() );
-          
-          function<int()>            unbound_functor0 (fun0);
-          function<int(int)>         unbound_functor1 (fun1);
-          function<int(int,int)>     unbound_functor2 (fun2);
-          function<int(int,int,int)> unbound_functor3 (fun3);
-          
-          clo0 = FunctionClosure<int()>            (unbound_functor0,tup0);
-          clo1 = FunctionClosure<int(int)>         (unbound_functor1,tup1);
-          clo2 = FunctionClosure<int(int,int)>     (unbound_functor2,tup2);
-          clo3 = FunctionClosure<int(int,int,int)> (unbound_functor3,tup3);
-          
-          ASSERT (-1       == clo0() );
-          ASSERT (11       == clo1() );
-          ASSERT (11+12    == clo2() );
-          ASSERT (11+12+13 == clo3() );
-          
-          ASSERT (-1       == func::closure(fun0,tup0) () );
-          ASSERT (11       == func::closure(fun1,tup1) () );
-          ASSERT (11+12    == func::closure(fun2,tup2) () );
-          ASSERT (11+12+13 == func::closure(fun3,tup3) () );
-          
-          ASSERT (-1       == func::closure(unbound_functor0,tup0) () );
-          ASSERT (11       == func::closure(unbound_functor1,tup1) () );
-          ASSERT (11+12    == func::closure(unbound_functor2,tup2) () );
-          ASSERT (11+12+13 == func::closure(unbound_functor3,tup3) () );
-          
-          
-          // finally combine all techniques....
-          typedef Tuple<List2>::Type NumberzArg;
-          typedef FunctionTypedef<int,NumberzArg>::Sig NumberzSig;
-          Tuple<NumberzArg> numberzTup (Num<5>(22), Num<6>(33), Num<7>(44));
-          
-          FunctionClosure<NumberzSig> numClo (getNumberz<5,6,7>, numberzTup );
-          
-          ASSERT (22+33+44 == numClo() );
-        }
     };
   
   
   /** Register this test class... */
-  LAUNCHER (FunctionClosure_test, "unit common");
+  LAUNCHER (FunctionComposition_test, "unit common");
   
   
   

From ca807205f90e9738ba61d9f0c29d78100ac170fb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 30 Jun 2009 04:54:50 +0200
Subject: [PATCH 154/368] cleanup/refactor simple type seq handling, fix broken
 Split template

---
 src/lib/meta/function-closure.hpp             |   2 +-
 src/lib/meta/tuple.hpp                        | 132 +----------
 .../{typelistutil.hpp => typelist-util.hpp}   |  38 +++-
 src/lib/meta/typelist.hpp                     |   1 +
 src/lib/meta/typeseq-util.hpp                 | 207 ++++++++++++++++++
 src/lib/variant.hpp                           |   2 +-
 src/proc/control/command-def.hpp              |   2 +-
 src/proc/control/command-signature.hpp        |   2 +-
 src/proc/engine/nodewiring.cpp                |   2 +-
 .../proc/control/command-basic-test.cpp       |   2 +-
 tests/lib/meta/config-flags-test.cpp          |   2 +-
 tests/lib/meta/function-closure-test.cpp      |   4 +-
 tests/lib/meta/typelist-manip-test.cpp        |   4 +-
 13 files changed, 261 insertions(+), 139 deletions(-)
 rename src/lib/meta/{typelistutil.hpp => typelist-util.hpp} (89%)
 create mode 100644 src/lib/meta/typeseq-util.hpp

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 4c354f751..77ff9145a 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -379,7 +379,7 @@ namespace typelist{
         typedef typename PlaceholderTuple<TailSeq, i+1>::PlaceholderSeq  TailPlaceholderSeq;
         
       public:
-        typedef typename Prepend<_Placeholder<i>, TailPlaceholderSeq>::Tuple PlaceholderSeq;
+        typedef typename Prepend<_Placeholder<i>, TailPlaceholderSeq>::Seq PlaceholderSeq;
         typedef Tuple<PlaceholderSeq> Type;
         
       };
diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index cb7309765..ff03cfff6 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -24,9 +24,9 @@
 /** @file tuple.hpp
  ** Metaprogramming with tuples-of-types and a simple Tuple (record) datatype.
  ** The metaprogramming part of this header complements typelist.hpp and allows
- ** to re-build a new tuple-of-types from an existing typelist. Such a finite
- ** sequence or tuple of types can at times be more handy than a typelist,
- ** especially when capturing specific types to use as template parameter.
+ ** some additional manipulations on type sequences. Such a finite sequence or
+ ** tuple of types can at times be more handy than a typelist, especially when
+ ** capturing specific types to use as template parameter.
  ** 
  ** Additionally, this header augments the Tuple template into a simple Tuple
  ** (run time) datatype. This isn't meant as competing with std::tr1::tuple, which is
@@ -48,7 +48,8 @@
 #define LUMIERA_META_TUPLE_H
 
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
+#include "lib/meta/typeseq-util.hpp"
 #include "lib/meta/util.hpp"
 
 
@@ -58,123 +59,6 @@ namespace typelist{
   
   
   
-  /** 
-   * Helper: prepend a type to an existing type sequence,
-   * thus shifting all elements within the sequence 
-   * to the right, eventually dropping the last element
-   */
-  template<class T, class TYPES>
-  struct Prepend;
-  
-  template< typename T01
-          , typename T02
-          , typename T03
-          , typename T04
-          , typename T05
-          , typename T06
-          , typename T07
-          , typename T08
-          , typename T09
-          , typename T10
-          , typename T11
-          , typename T12
-          , typename T13
-          , typename T14
-          , typename T15
-          , typename T16
-          , typename T17
-          , typename T18
-          , typename T19
-          , typename T20
-          , typename IGN
-          >
-  struct Prepend<T01, Types<     T02,T03,T04,T05
-                           , T06,T07,T08,T09,T10
-                           , T11,T12,T13,T14,T15
-                           , T16,T17,T18,T19,T20
-                           , IGN
-                           > >
-  {
-    typedef Types< T01,T02,T03,T04,T05
-                 , T06,T07,T08,T09,T10
-                 , T11,T12,T13,T14,T15
-                 , T16,T17,T18,T19,T20 > Tuple;
-    
-    typedef typename Tuple::List         List;
-  };
-  
-  
-  
-  
-  /** Helper: separate parts of a type sequence */
-  template<class TYPES>
-  struct Split;
-  
-  template< typename T01
-          , typename T02
-          , typename T03
-          , typename T04
-          , typename T05
-          , typename T06
-          , typename T07
-          , typename T08
-          , typename T09
-          , typename T10
-          , typename T11
-          , typename T12
-          , typename T13
-          , typename T14
-          , typename T15
-          , typename T16
-          , typename T17
-          , typename T18
-          , typename T19
-          , typename T20
-          >
-  struct Split<Types< T01,T02,T03,T04,T05
-                    , T06,T07,T08,T09,T10
-                    , T11,T12,T13,T14,T15
-                    , T16,T17,T18,T19,T20
-                    > >
-  {
-    typedef        T01                   Head;
-    typedef Types< T01                 > First;
-    typedef Types< T01,T02,T03,T04,T05
-                 , T06,T07,T08,T09,T10
-                 , T11,T12,T13,T14,T15
-                 , T16,T17,T18,T19     > Prefix;
-    typedef Types<     T02,T03,T04,T05
-                 , T06,T07,T08,T09,T10
-                 , T11,T12,T13,T14,T15
-                 , T16,T17,T18,T19,T20 > Tail;
-    typedef Types<                 T20 > Last;
-    typedef                        T20   End;
-  };
-  
-  
-  
-  
-  /**
-   * Helper: generate a type sequence left shifted 
-   * by i steps, filling in NullType at the end
-   */  
-  template<class TYPES, uint i=1>
-  class Shifted
-    {
-      typedef typename Split<TYPES>::Tail Tail;
-    public:
-      typedef typename Shifted<Tail,i-1>::Type Type;
-      typedef typename Split<Type>::Head       Head;
-    };
-  
-  template<class TYPES>
-  struct Shifted<TYPES,0>
-    { 
-      typedef TYPES                      Type;
-      typedef typename Split<Type>::Head Head;
-    };
-  
-  
   /** 
    * simple generic Tuple datatype.
    * Usable both for metaprogramming and as a generic record.
@@ -233,9 +117,9 @@ namespace typelist{
   struct Tuple<Node<TY,TYPES> >
     : Tuple<TYPES>
     {
-      typedef TY                                   HeadType;
-      typedef typename Tuple<TYPES>::Type          TailType;
-      typedef typename Prepend<TY,TailType>::Tuple Type;
+      typedef TY                                 HeadType;
+      typedef typename Tuple<TYPES>::Type        TailType;
+      typedef typename Prepend<TY,TailType>::Seq Type;
       
       typedef Node<TY,TYPES> ArgList;
       typedef Tuple<Type>    TupleType;
diff --git a/src/lib/meta/typelistutil.hpp b/src/lib/meta/typelist-util.hpp
similarity index 89%
rename from src/lib/meta/typelistutil.hpp
rename to src/lib/meta/typelist-util.hpp
index 5fcded832..7e6c02a42 100644
--- a/src/lib/meta/typelistutil.hpp
+++ b/src/lib/meta/typelist-util.hpp
@@ -1,5 +1,5 @@
 /*
-  TYPELISTUTIL.hpp  -  Utils for working with lists-of-types
+  TYPELIST-UTIL.hpp  -  Utils for working with lists-of-types
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,15 +21,15 @@
 */
 
 
-#ifndef LUMIERA_META_TYPELISTUTIL_H
-#define LUMIERA_META_TYPELISTUTIL_H
+#ifndef LUMIERA_META_TYPELIST_UTIL_H
+#define LUMIERA_META_TYPELIST_UTIL_H
 
 
   
 #include "lib/meta/typelist.hpp"
 
 namespace lumiera {
-namespace typelist {
+namespace typelist{
     
     
     /**
@@ -188,6 +188,36 @@ namespace typelist {
     
     
     
+    template<class TYPES>
+    struct Dissect;
+    
+    template<class T, class TYPES>
+    struct Dissect<Node<T,TYPES> >
+      {
+        typedef Node<T,TYPES>                  List;
+        typedef T                              Head;
+        typedef Node<T,NullType>               First;
+        typedef TYPES                          Tail;
+        typedef typename SplitLast<List>::List Prefix;
+        typedef typename SplitLast<List>::Type End;
+        typedef Node<End,NullType>             Last;
+      };
+    
+    template<>
+    struct Dissect<NullType>
+      {
+        typedef NullType                       List;
+        typedef NullType                       Head;
+        typedef NullType                       First;
+        typedef NullType                       Tail;
+        typedef NullType                       Prefix;
+        typedef NullType                       End;
+        typedef NullType                       Last;
+      };
+    
+    
+    
+    
     /** 
      * prefix each of the elements,
      * yielding a list-of lists-of-types
diff --git a/src/lib/meta/typelist.hpp b/src/lib/meta/typelist.hpp
index 96c70c480..b3e44138d 100644
--- a/src/lib/meta/typelist.hpp
+++ b/src/lib/meta/typelist.hpp
@@ -112,6 +112,7 @@ namespace typelist{
     struct Types<>
       {
         typedef NullType List;
+        typedef Types<>  Seq;
       };
     
     
diff --git a/src/lib/meta/typeseq-util.hpp b/src/lib/meta/typeseq-util.hpp
new file mode 100644
index 000000000..23ffbdc77
--- /dev/null
+++ b/src/lib/meta/typeseq-util.hpp
@@ -0,0 +1,207 @@
+/*
+  TYPESEQ-UTIL.hpp  -  basic metaprogramming utilities for type sequences
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file typeseq-util.hpp
+ ** Some basic facilities for manipulating type sequences.
+ ** While typelist.hpp provides the foundation of metaprogramming with typelists,
+ ** manipulating the type sequences themselves (i.e. Types<T1,T2,...> instances)
+ ** requires some additional helper templates supplemented here.
+ ** - prepending to a type sequence
+ ** - dissecting a type sequence
+ ** - shifting a type sequence
+ ** - re-generating a type sequence from a typelist.
+ ** 
+ ** @see typeseq-manip-test.cpp
+ ** @see typelist.hpp
+ ** @see typelist-util.hpp
+ ** @see function.hpp
+ ** @see generator.hpp
+ ** @see tuple.hpp
+ ** 
+ */
+
+
+#ifndef LUMIERA_META_TYPESEQ_UTIL_H
+#define LUMIERA_META_TYPESEQ_UTIL_H
+
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/typelist-util.hpp"
+#include "lib/meta/util.hpp"
+
+
+
+namespace lumiera {
+namespace typelist{
+  
+  
+  
+  /** 
+   * Helper: prepend a type to an existing type sequence,
+   * thus shifting all elements within the sequence 
+   * to the right, eventually dropping the last element
+   */
+  template<class T, class TYPES>
+  struct Prepend;
+  
+  template< typename T01
+          , typename T02
+          , typename T03
+          , typename T04
+          , typename T05
+          , typename T06
+          , typename T07
+          , typename T08
+          , typename T09
+          , typename T10
+          , typename T11
+          , typename T12
+          , typename T13
+          , typename T14
+          , typename T15
+          , typename T16
+          , typename T17
+          , typename T18
+          , typename T19
+          , typename T20
+          , typename IGN
+          >
+  struct Prepend<T01, Types<     T02,T03,T04,T05
+                           , T06,T07,T08,T09,T10
+                           , T11,T12,T13,T14,T15
+                           , T16,T17,T18,T19,T20
+                           , IGN
+                           > >
+  {
+    typedef Types< T01,T02,T03,T04,T05
+                 , T06,T07,T08,T09,T10
+                 , T11,T12,T13,T14,T15
+                 , T16,T17,T18,T19,T20 > Seq;
+    
+    typedef typename Seq::List          List;
+  };
+  
+  
+  
+  /** 
+   * Additional specialisation of the basic type sequence type,
+   * allowing to re-create a (flat) type sequence from a typelist. 
+   */
+  template<class H, class T>
+  struct Types< Node<H,T> >
+    {
+      typedef Node<H,T> List;
+      
+      typedef typename Prepend< H
+                              , typename Types<T>::Seq
+                              >::Seq  Seq;
+    };
+  
+  
+  
+  
+  
+  
+  /** Helper: separate parts of a type sequence */
+  template<class TYPES>
+  struct Split;
+  
+  template< typename T01
+          , typename T02
+          , typename T03
+          , typename T04
+          , typename T05
+          , typename T06
+          , typename T07
+          , typename T08
+          , typename T09
+          , typename T10
+          , typename T11
+          , typename T12
+          , typename T13
+          , typename T14
+          , typename T15
+          , typename T16
+          , typename T17
+          , typename T18
+          , typename T19
+          , typename T20
+          >
+  struct Split<Types< T01,T02,T03,T04,T05
+                    , T06,T07,T08,T09,T10
+                    , T11,T12,T13,T14,T15
+                    , T16,T17,T18,T19,T20
+                    > >
+  {
+    typedef typename 
+            Types< T01,T02,T03,T04,T05
+                 , T06,T07,T08,T09,T10
+                 , T11,T12,T13,T14,T15
+                 , T16,T17,T18,T19,T20
+                 >::List                 List;
+    
+    typedef        T01                   Head;
+    typedef Types< T01                 > First;
+    typedef Types<     T02,T03,T04,T05
+                 , T06,T07,T08,T09,T10
+                 , T11,T12,T13,T14,T15
+                 , T16,T17,T18,T19,T20 > Tail;
+
+    // for finding the end we need the help of typelist-util.hpp
+    
+    typedef typename SplitLast<List>::List  PrefixList;
+    typedef typename Tail::List             TailList;
+    
+    typedef typename Types<PrefixList>::Seq Prefix;
+    typedef typename SplitLast<List>::Type  End;
+    typedef Types<End>                      Last;
+  };
+  
+  
+  
+  
+  /**
+   * Helper: generate a type sequence left shifted 
+   * by i steps, filling in NullType at the end
+   */  
+  template<class TYPES, uint i=1>
+  class Shifted
+    {
+      typedef typename Split<TYPES>::Tail Tail;
+    public:
+      typedef typename Shifted<Tail,i-1>::Type Type;
+      typedef typename Split<Type>::Head       Head;
+    };
+  
+  template<class TYPES>
+  struct Shifted<TYPES,0>
+    { 
+      typedef TYPES                      Type;
+      typedef typename Split<Type>::Head Head;
+    };
+  
+  
+  
+  
+  
+}} // namespace lumiera::typelist
+#endif
diff --git a/src/lib/variant.hpp b/src/lib/variant.hpp
index 3f9cea028..ebaac670a 100644
--- a/src/lib/variant.hpp
+++ b/src/lib/variant.hpp
@@ -41,7 +41,7 @@
 #define LUMIERA_VARIANT_H
 
 
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/generator.hpp"
 
 #include <boost/noncopyable.hpp>
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index ebfc7906b..acd3d71ce 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -55,7 +55,7 @@
 #include "proc/control/command-closure.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/tuple.hpp"
 
 //#include <tr1/memory>
diff --git a/src/proc/control/command-signature.hpp b/src/proc/control/command-signature.hpp
index 503a212f2..0def46d01 100644
--- a/src/proc/control/command-signature.hpp
+++ b/src/proc/control/command-signature.hpp
@@ -50,7 +50,7 @@
 //#include "include/symbol.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/tuple.hpp"
 
 //#include <tr1/memory>
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index e6449f755..8dab297b7 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -26,7 +26,7 @@
 #include "proc/engine/nodeoperation.hpp"
 #include "proc/engine/nodewiringconfig.hpp"
 
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 
 
 namespace engine {
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 76ccc20a1..accd9d3db 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -37,7 +37,7 @@
 //#include "lib/util.hpp"
 
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/generator.hpp"
 
 
diff --git a/tests/lib/meta/config-flags-test.cpp b/tests/lib/meta/config-flags-test.cpp
index 995ddef56..fd1e085ed 100644
--- a/tests/lib/meta/config-flags-test.cpp
+++ b/tests/lib/meta/config-flags-test.cpp
@@ -40,7 +40,7 @@
 #include "lib/test/run.hpp"
 #include "lib/meta/util.hpp"
 #include "lib/meta/generator.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/configflags.hpp"
 #include "meta/typelist-diagnostics.hpp"
 #include "proc/engine/nodewiringconfig.hpp"
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 0a0cce750..2def0fde4 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -38,7 +38,7 @@
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/function-closure.hpp"
 #include "meta/typelist-diagnostics.hpp"
@@ -141,7 +141,7 @@ namespace test {
           typedef FunctionSignature<function<someFunc> >::Args Args;
           DISPLAY (Args);
           
-          typedef Prepend<Num<1>, Args>::Tuple NewArgs;             // manipulate the argument type(s)
+          typedef Prepend<Num<1>, Args>::Seq NewArgs;               // manipulate the argument type(s)
           DISPLAY (NewArgs);
           
           typedef FunctionTypedef<RetType,NewArgs>::Sig NewSig;  // re-build a new function signature
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index 9c86a2e34..9fa1a73f8 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -32,7 +32,7 @@
  ** if various lists of such constant-wrapper types were manipulated as expected.
  **
  ** @see typelist-test.cpp
- ** @see typelistutil.hpp
+ ** @see typelist-util.hpp
  ** @see nodewiringconfig.hpp real world usage example
  **
  */
@@ -40,7 +40,7 @@
 
 #include "lib/test/run.hpp"
 #include "lib/meta/generator.hpp"
-#include "lib/meta/typelistutil.hpp"
+#include "lib/meta/typelist-util.hpp"
 #include "meta/typelist-diagnostics.hpp"
 //#include "lib/util.hpp"
 

From f70bb0ad6aec55d25b66e68b6fdf04abdb2cfdf5 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 30 Jun 2009 04:56:10 +0200
Subject: [PATCH 155/368] fill in some missing unit tests

---
 tests/lib/Makefile.am                  |   1 +
 tests/lib/meta/typelist-manip-test.cpp |  49 +++++++
 tests/lib/meta/typeseq-manip-test.cpp  | 177 +++++++++++++++++++++++++
 3 files changed, 227 insertions(+)
 create mode 100644 tests/lib/meta/typeseq-manip-test.cpp

diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 9277521de..f895638ce 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -49,6 +49,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/mainsuite.cpp				\
 	$(testlib_srcdir)/meta/typelist-test.cpp         	\
 	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
+	$(testlib_srcdir)/meta/typeseq-manip-test.cpp    	\
 	$(testlib_srcdir)/meta/type-tuple-test.cpp    		\
 	$(testlib_srcdir)/meta/function-composition-test.cpp   	\
 	$(testlib_srcdir)/meta/function-closure-test.cpp   	\
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index 9fa1a73f8..b015c000a 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -86,6 +86,7 @@ namespace test {
        *         print them for debugging purpose.
        *       - append lists, single elements and NullType
        *         in various combinations
+       *       - manipulations like splice, get end, dissect
        *       - filtering out some types from a typelist by
        *         using a "predicate template" (metafunction)
        *       - building combinations and permutations
@@ -99,6 +100,8 @@ namespace test {
               check_apply  ();
               check_append ();
               check_splice ();
+              check_s_last ();
+              check_dissect();
               check_filter ();
               check_prefix ();
               check_distribute();
@@ -222,6 +225,52 @@ namespace test {
             }
           
           
+          void
+          check_s_last()
+            {
+              typedef SplitLast<List1>::Type Elm;
+              typedef SplitLast<List1>::List Prefix;
+              
+              typedef Types<Elm>::List ElmL;
+              
+              DISPLAY (Prefix);
+              DISPLAY (ElmL);
+              
+              typedef SplitLast<ElmL>::Type Elm1;
+              typedef SplitLast<ElmL>::List NPrefix;
+              
+              DISPLAY (NPrefix);
+              DISPLAY (Types<Elm1>);
+              
+              typedef SplitLast<NullType>::Type Nil;
+              typedef SplitLast<NullType>::List NList;
+
+              DISPLAY (NList);
+              DISPLAY (Types<Nil>);
+            }
+          
+          
+          void
+          check_dissect()
+            {
+              typedef Append<List1,List2>::List LL;
+              DISPLAY (LL);
+              
+              typedef Dissect<LL>::List   List;     DISPLAY(List); 
+              typedef Dissect<LL>::First  First;    DISPLAY(First); 
+              typedef Dissect<LL>::Tail   Tail;     DISPLAY(Tail);
+              typedef Dissect<LL>::Prefix Prefix;   DISPLAY(Prefix);
+              typedef Dissect<LL>::Last   Last;     DISPLAY(Last);
+              
+              typedef Dissect<LL>::Head   Head;
+              typedef Dissect<LL>::End    End;
+              
+              typedef Types<Head,End>  HeadEnd;     DISPLAY(HeadEnd);
+            }
+          
+          
+          
+          
           template<class X> struct AddConst2          { typedef X        Type; };
           template<int I>   struct AddConst2<Num<I> > { typedef Num<I+2> Type; };
           
diff --git a/tests/lib/meta/typeseq-manip-test.cpp b/tests/lib/meta/typeseq-manip-test.cpp
new file mode 100644
index 000000000..76fa87387
--- /dev/null
+++ b/tests/lib/meta/typeseq-manip-test.cpp
@@ -0,0 +1,177 @@
+/*
+  TypeSeqManip(Test)  -  simple manipulations on type sequences
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file typeseq-manip-test.cpp
+ ** verify the proper working of simple type sequence manipulations.
+ ** Here, "type sequence" denotes an instance of the template Types<T1,T2,...> from
+ ** typelist.hpp . While this template is the entry point to type list metaprogramming,
+ ** in many cases it is useful on its own for specifying a fixed collection of types, e.g.
+ ** for building a tuple type. Thus, while more complicated manipulations typically rely
+ ** on typelists, sometimes we need simple manipulations working directly on type sequences.
+ ** These are covered here in a similar fashion as the typelist manipulators.
+ **
+ ** @see typeseq-util.hpp
+ ** @see typelist-util.hpp
+ ** @see typelist-manip-test.cpp
+ **
+ */
+
+
+#include "lib/test/run.hpp"
+#include "lib/meta/typeseq-util.hpp"
+#include "lib/meta/typelist-util.hpp"
+#include "meta/typelist-diagnostics.hpp"
+//#include "lib/util.hpp"
+
+#include <boost/format.hpp>
+#include <iostream>
+
+using ::test::Test;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace typelist{
+namespace test    {
+  
+  
+  namespace { // test data
+    
+    
+    
+    typedef Types< Num<1>
+                 , Num<2>
+                 , Num<3>
+                 >         Types1;
+    typedef Types< Num<7>
+                 , Num<8>
+                 , Num<9>
+                 >         Types2;
+    
+    
+    // see also the CountDown template in typelist-diagnostics.hpp...
+    
+  } // (End) test data
+  
+  
+  
+  
+  
+  
+  /**************************************************************************
+   * @test check the basic utilities for manipulating (fixed) type sequences.
+   *       - re-build an sequence from a type list
+   *       - prepend a type to a given type sequence
+   *       - create shifted sequences
+   *       - dissect a sequence to extract head, tail, prefix, last element
+   */
+  class TypeSeqManipl_test : public Test
+    {
+      virtual void
+      run (Arg) 
+        {
+          check_buildSeq();
+          check_prepend ();
+          check_shift   ();
+          check_split   ();
+        }
+      
+      
+      void
+      check_buildSeq ()
+        {
+          typedef Append<Types1::List, Types2::List>::List LL;
+          DISPLAY (LL);
+          
+          typedef Types<LL>::Seq Seq;
+          DISPLAY (Seq);
+          DISPLAY (Seq::List);
+          
+          typedef Types<NodeNull>::Seq NulS;
+          DISPLAY (NulS);
+        }
+      
+      
+      void
+      check_prepend ()
+        {
+          typedef Prepend<Num<5>, Types1> Prepend1;
+          DISPLAY(Prepend1);
+          
+          typedef Prepend<NullType, Types1> Prepend2;
+          DISPLAY(Prepend2);
+          
+          typedef Prepend<Num<5>,  Types<> > Prepend3;
+          DISPLAY(Prepend3);
+          
+          typedef Prepend<NullType,  Types<> > Prepend4;
+          DISPLAY(Prepend4);
+        }
+      
+      
+      void
+      check_shift ()
+        {
+          typedef Append<Types2::List, Types1::List>::List LL;
+          typedef Types<LL>::Seq Seq;
+          
+          typedef Shifted<Seq,0>::Type Seq_0;  DISPLAY (Seq_0);
+          typedef Shifted<Seq,1>::Type Seq_1;  DISPLAY (Seq_1);
+          typedef Shifted<Seq,2>::Type Seq_2;  DISPLAY (Seq_2);
+          typedef Shifted<Seq,3>::Type Seq_3;  DISPLAY (Seq_3);
+          typedef Shifted<Seq,4>::Type Seq_4;  DISPLAY (Seq_4);
+          
+          typedef Types<Shifted<Seq,2>::Head> Head_2; DISPLAY (Head_2);
+        }
+      
+      
+      void
+      check_split ()
+        {
+          typedef Append<Types1::List, Types2::List>::List LL;
+          typedef Types<LL>::Seq Seq;
+          DISPLAY (Seq);
+          
+          typedef Split<Seq>::List   List;     DISPLAY(List); 
+          typedef Split<Seq>::First  First;    DISPLAY(First); 
+          typedef Split<Seq>::Tail   Tail;     DISPLAY(Tail);
+          typedef Split<Seq>::Prefix Prefix;   DISPLAY(Prefix);
+          typedef Split<Seq>::Last   Last;     DISPLAY(Last);
+          
+          typedef Split<Seq>::Head   Head;
+          typedef Split<Seq>::End    End;
+          
+          typedef Types<Head,End>  HeadEnd;    DISPLAY(HeadEnd);
+        }
+      
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (TypeSeqManipl_test, "unit common");
+  
+  
+  
+}}} // namespace lumiera::typelist::test

From 81d0e133c8f2d03b943ac82b7aae28ff3a3c5158 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 1 Jul 2009 00:43:19 +0200
Subject: [PATCH 156/368] new additions in this area now reasonable covered
 (closes #142)

---
 src/lib/meta/typelist-util.hpp         | 22 ++++++-----
 tests/40components.tests               | 51 +++++++++++++++++++++++++-
 tests/lib/meta/typelist-manip-test.cpp |  5 +--
 tests/lib/meta/typeseq-manip-test.cpp  | 12 +++++-
 4 files changed, 74 insertions(+), 16 deletions(-)

diff --git a/src/lib/meta/typelist-util.hpp b/src/lib/meta/typelist-util.hpp
index 7e6c02a42..a55ca639f 100644
--- a/src/lib/meta/typelist-util.hpp
+++ b/src/lib/meta/typelist-util.hpp
@@ -172,11 +172,11 @@ namespace typelist{
     template<class B, class BS,
              class O, class OS >
     struct Splice<Node<B,BS>,Node<O,OS>,0> { typedef Node<O, typename Splice<BS,OS, 0>::List>          List;
-                                             typedef NullType                                          Front; 
+                                             typedef NullType                                          Front;
                                              typedef         typename Splice<BS,OS, 0>::Back           Back; };
     
     template<class B, class BS>
-    struct Splice<Node<B,BS>, NullType, 0> { typedef Node<B, BS> List; 
+    struct Splice<Node<B,BS>, NullType, 0> { typedef Node<B, BS> List;
                                              typedef NullType    Front;
                                              typedef Node<B, BS> Back; };
     
@@ -188,19 +188,23 @@ namespace typelist{
     
     
     
+    /**
+     * Allows to access various parts of a given typelist:
+     * Start and End, Prefix and Tail..
+     */
     template<class TYPES>
     struct Dissect;
     
     template<class T, class TYPES>
     struct Dissect<Node<T,TYPES> >
       {
-        typedef Node<T,TYPES>                  List;
-        typedef T                              Head;
-        typedef Node<T,NullType>               First;
-        typedef TYPES                          Tail;
-        typedef typename SplitLast<List>::List Prefix;
-        typedef typename SplitLast<List>::Type End;
-        typedef Node<End,NullType>             Last;
+        typedef Node<T,TYPES>                  List;  ///< the complete list
+        typedef T                              Head;  ///< first element
+        typedef Node<T,NullType>               First; ///< a list containing the first element
+        typedef TYPES                          Tail;  ///< remainder of the list starting with the second elm.
+        typedef typename SplitLast<List>::List Prefix;///< all of the list, up to but extcluding the last element
+        typedef typename SplitLast<List>::Type End;   ///< the last element
+        typedef Node<End,NullType>             Last;  ///< a list containing the last element
       };
     
     template<>
diff --git a/tests/40components.tests b/tests/40components.tests
index 74592e8ab..f333d87ae 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -488,10 +488,11 @@ return: 0
 END
 
 
-TEST "TypeListManipl_test" TypeListManipl_test <<END
+TEST "typelist manipulation" TypeListManipl_test <<END
 out: List1	:-<1>-<2>-<3>-
 out: List2	:-<5>-<6>-<7>-
 out: Added2	:-<3>-<4>-<5>-
+out: FilterEven	:-<2>-<6>-
 out: Append1	:-
 out: Append2	:-<11>-<22>-
 out: Append3	:-<111>-
@@ -522,7 +523,19 @@ out: Back2	:-<3>-
 out: Back3	:-
 out: Front4	:-<1>-
 out: Back4	:-<2>-<3>-
-out: FilterEven	:-<2>-<6>-
+out: Prefix	:-<1>-<2>-
+out: ElmL	:-<3>-
+out: NPrefix	:-
+out: Types<Elm1>	:-<3>-
+out: NList	:-
+out: Types<Nil>	:-
+out: LL	:-<1>-<2>-<3>-<5>-<6>-<7>-
+out: List	:-<1>-<2>-<3>-<5>-<6>-<7>-
+out: First	:-<1>-
+out: Tail	:-<2>-<3>-<5>-<6>-<7>-
+out: Prefix	:-<1>-<2>-<3>-<5>-<6>-
+out: Last	:-<7>-
+out: HeadEnd	:-<1>-<7>-
 out: Prefix1	:
 out: 	\+---<11>-<22>-\+-
 out: Prefix2	:
@@ -609,6 +622,40 @@ return: 0
 END
 
 
+TEST "type sequence manipulation" TypeSeqManipl_test <<END
+out: LL	:-<1>-<2>-<3>-<7>-<8>-<9>-
+out: Seq	:-<1>-<2>-<3>-<7>-<8>-<9>-
+out: SeqList	:-<1>-<2>-<3>-<7>-<8>-<9>-
+out: NulS	:-
+out: Prepend1	:-<5>-<1>-<2>-<3>-
+out: Prepend2	:-<·>-<1>-<2>-<3>-
+out: Prepend3	:-<5>-
+out: Prepend4	:-
+out: Seq_0	:-<7>-<8>-<9>-<1>-<2>-<3>-
+out: Seq_1	:-<8>-<9>-<1>-<2>-<3>-
+out: Seq_2	:-<9>-<1>-<2>-<3>-
+out: Seq_3	:-<1>-<2>-<3>-
+out: Seq_4	:-<2>-<3>-
+out: Seq_5	:-<3>-
+out: Seq_6	:-
+out: Head_0	:-<7>-
+out: Head_1	:-<8>-
+out: Head_2	:-<9>-
+out: Head_3	:-<1>-
+out: Head_4	:-<2>-
+out: Head_5	:-<3>-
+out: Head_6	:-
+out: Seq	:-<1>-<2>-<3>-<7>-<8>-<9>-
+out: List	:-<1>-<2>-<3>-<7>-<8>-<9>-
+out: First	:-<1>-
+out: Tail	:-<2>-<3>-<7>-<8>-<9>-
+out: Prefix	:-<1>-<2>-<3>-<7>-<8>-
+out: Last	:-<9>-
+out: HeadEnd	:-<1>-<9>-
+return: 0
+END
+
+
 TEST "TypeTuple_test" TypeTuple_test <<END
 out: L1	:-<1>-<3>-<5>-
 out: L2	:-<2>-<4>-
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index b015c000a..a7e37f18b 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -42,7 +42,6 @@
 #include "lib/meta/generator.hpp"
 #include "lib/meta/typelist-util.hpp"
 #include "meta/typelist-diagnostics.hpp"
-//#include "lib/util.hpp"
 
 #include <boost/format.hpp>
 #include <iostream>
@@ -98,11 +97,11 @@ namespace test {
             {
               check_diagnostics ();
               check_apply  ();
+              check_filter ();
               check_append ();
               check_splice ();
               check_s_last ();
               check_dissect();
-              check_filter ();
               check_prefix ();
               check_distribute();
               check_combine();
@@ -244,7 +243,7 @@ namespace test {
               
               typedef SplitLast<NullType>::Type Nil;
               typedef SplitLast<NullType>::List NList;
-
+              
               DISPLAY (NList);
               DISPLAY (Types<Nil>);
             }
diff --git a/tests/lib/meta/typeseq-manip-test.cpp b/tests/lib/meta/typeseq-manip-test.cpp
index 76fa87387..a64e5f02c 100644
--- a/tests/lib/meta/typeseq-manip-test.cpp
+++ b/tests/lib/meta/typeseq-manip-test.cpp
@@ -41,7 +41,6 @@
 #include "lib/meta/typeseq-util.hpp"
 #include "lib/meta/typelist-util.hpp"
 #include "meta/typelist-diagnostics.hpp"
-//#include "lib/util.hpp"
 
 #include <boost/format.hpp>
 #include <iostream>
@@ -105,8 +104,9 @@ namespace test    {
           DISPLAY (LL);
           
           typedef Types<LL>::Seq Seq;
+          typedef Seq::List SeqList;
           DISPLAY (Seq);
-          DISPLAY (Seq::List);
+          DISPLAY (SeqList);
           
           typedef Types<NodeNull>::Seq NulS;
           DISPLAY (NulS);
@@ -141,8 +141,16 @@ namespace test    {
           typedef Shifted<Seq,2>::Type Seq_2;  DISPLAY (Seq_2);
           typedef Shifted<Seq,3>::Type Seq_3;  DISPLAY (Seq_3);
           typedef Shifted<Seq,4>::Type Seq_4;  DISPLAY (Seq_4);
+          typedef Shifted<Seq,5>::Type Seq_5;  DISPLAY (Seq_5);
+          typedef Shifted<Seq,6>::Type Seq_6;  DISPLAY (Seq_6);
           
+          typedef Types<Shifted<Seq,0>::Head> Head_0; DISPLAY (Head_0);
+          typedef Types<Shifted<Seq,1>::Head> Head_1; DISPLAY (Head_1);
           typedef Types<Shifted<Seq,2>::Head> Head_2; DISPLAY (Head_2);
+          typedef Types<Shifted<Seq,3>::Head> Head_3; DISPLAY (Head_3);
+          typedef Types<Shifted<Seq,4>::Head> Head_4; DISPLAY (Head_4);
+          typedef Types<Shifted<Seq,5>::Head> Head_5; DISPLAY (Head_5);
+          typedef Types<Shifted<Seq,6>::Head> Head_6; DISPLAY (Head_6);
         }
       
       

From 67e5779d243f4cef853dd0c5222d23c0fca4ae3a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 1 Jul 2009 02:29:11 +0200
Subject: [PATCH 157/368] now also able to close the last function argument

---
 src/lib/meta/function-closure.hpp            | 63 ++++++++++++++------
 tests/lib/meta/function-composition-test.cpp |  4 +-
 2 files changed, 47 insertions(+), 20 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 77ff9145a..dedf14d70 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -24,8 +24,17 @@
 /** @file function-closure.hpp
  ** Partial function application and building a complete function closure.
  ** This is a small addendum to (and thin wrapper for) tr1/functional, supporting
- ** the case when a function should be closed over (all) arguments, where especially
- ** the parameter values to close on are provided as a tuple. 
+ ** the case when a function should be closed over (partially or all) arguments,
+ ** where especially the parameter values to close on are provided as a tuple. 
+ ** 
+ ** Because we have to deal with arbitrary functions and arbitrary parameter types,
+ ** we need a lot of repetitive code to "catch" functions from zero to nine arguments.
+ ** At the bottom of this header, you'll find a function-style interface, which
+ ** wraps up all these technicalities.
+ ** 
+ ** @todo the implementation is able to handle partial application with N arguments,
+ **       but currently we need just one argument, thus only this case was wrapped
+ **       up into a convenient functions func::applyFirst and func::applyLast  
  ** 
  ** @see control::CommandDef usage example
  ** @see function.hpp
@@ -363,23 +372,29 @@ namespace typelist{
       };
     
     
+    
+    
+    
     /* ===== Helpers for partial function application ===== */
     
     using std::tr1::_Placeholder;     // what is the "official" way to import them?
     
+    
+    /**
+     *  Build a sequence of tr1 function argument placeholder types.
+     *  For each of the elements of the provided reference sequence,
+     *  a Placeholder is added, numbers counting up starting with 1 (!)
+     */
     template<typename TYPES, uint i=0>
     class PlaceholderTuple
       {
-//        typedef typename Tuple<TYPES>::HeadType HeadType;
-//        typedef typename Tuple<TYPES>::ArgList  TypeList;
-//        typedef typename Tuple<TYPES>::Tail::ArgList TailList;
         typedef typename Tuple<TYPES>::Type     TypeSeq;
         typedef typename Tuple<TYPES>::TailType TailSeq;
         
         typedef typename PlaceholderTuple<TailSeq, i+1>::PlaceholderSeq  TailPlaceholderSeq;
         
       public:
-        typedef typename Prepend<_Placeholder<i>, TailPlaceholderSeq>::Seq PlaceholderSeq;
+        typedef typename Prepend<_Placeholder<i+1>, TailPlaceholderSeq>::Seq PlaceholderSeq;
         typedef Tuple<PlaceholderSeq> Type;
         
       };
@@ -397,12 +412,12 @@ namespace typelist{
     
     
     
-    
-    
   } // (END) impl-namespace (func)
   
   
   
+  /* ======= core operations: closures and partial application ========= */
+  
   /**
    * Closure-creating template.
    * @note taking functor objects \em and parameters per reference
@@ -434,6 +449,7 @@ namespace typelist{
     };
   
   
+  
   /**
    * Partial function application
    * Takes a function and a value tuple,
@@ -447,28 +463,38 @@ namespace typelist{
     {
       typedef typename func::_Fun<SIG>::Args Args;
       typedef typename func::_Fun<SIG>::Ret  Ret;
-      
-      enum { ARG_CNT = count<typename Args::List>::value
-           , VAL_CNT = count<typename VAL::List>::value
-           , ROFFSET = (VAL_CNT < ARG_CNT)? ARG_CNT-VAL_CNT : 0
-           };
-      
-      typedef typename func::PlaceholderTuple<Args>::PlaceholderSeq::List Placeholders;
       typedef typename Args::List ArgsList;
       typedef typename VAL::List ValList;
       
-      typedef typename Splice<Placeholders, ValList>::List           LeftReplaced;
-      typedef typename Splice<Placeholders, ValList, ROFFSET>::List  RightReplaced;
+      enum { ARG_CNT = count<ArgsList>::value
+           , VAL_CNT = count<ValList> ::value
+           , ROFFSET = (VAL_CNT < ARG_CNT)? ARG_CNT-VAL_CNT : 0
+           };
       
+      
+      // create list of the *remaining* arguments, after applying the ValList
       typedef typename Splice<ArgsList, ValList>::Back           LeftReduced;
       typedef typename Splice<ArgsList, ValList, ROFFSET>::Front RightReduced;
       
+      // build a list, where each of the *remaining* arguments is replaced by a placeholder marker
+      typedef typename func::PlaceholderTuple<LeftReduced>::PlaceholderSeq::List  LeftPlaceholders;
+      typedef typename func::PlaceholderTuple<RightReduced>::PlaceholderSeq::List RightPlaceholders;
+      
+      // ... and splice these placeholders on top of the original argument type list,
+      // thus retaining the types to be closed, but setting a placeholder for each remaining argument
+      typedef typename Splice<ArgsList, LeftPlaceholders, VAL_CNT>::List LeftReplaced;
+      typedef typename Splice<ArgsList, RightPlaceholders, 0     >::List RightReplaced;
+      
       typedef Tuple<LeftReplaced>  TupleL;
       typedef Tuple<RightReplaced> TupleR;
       
       typedef typename Tuple<LeftReduced>::Type  ArgsL;
       typedef typename Tuple<RightReduced>::Type ArgsR;
       
+      // create a "builder" helper, which accepts exactly the value tuple elements
+      // and puts them at the right location, while default-constructing the remaining
+      // (=placeholder)-arguments. Using this builder helper, we can finally set up
+      // the argument tuples (Left/RightReplacedArgs) used for the tr1::bind call
       typedef tuple::BuildTuple<LeftReplaced, ValList>           BuildL;
       typedef tuple::BuildTuple<RightReplaced, ValList, ROFFSET> BuildR;
       
@@ -497,7 +523,8 @@ namespace typelist{
             : TupleR ( BuildR::create(arg))
             { }
         };
-        
+      
+      
       /** do a partial function application, closing the first arguments
        *  f(a,b,c)->res  +  (a,b)  yields  f(c)->res
        *  
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index aa3617744..b659c280b 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -261,7 +261,7 @@ namespace test {
           fun_23 = func::applyFirst (func123, Num<1>(19));
           res = fun_23 (_2_,_3_).o_;
           ASSERT (24 == res);
-#if false                                                //////////////TODO silly bug in the Split template!
+          
           typedef function<Num<1>(Num<1>, Num<2>)> F12;
           F12 fun_12 = func::applyLast(f, Num<3>(20));
           res = fun_12 (_1_,_2_).o_;
@@ -270,7 +270,7 @@ namespace test {
           fun_12 = func::applyLast(func123, Num<3>(21));
           res = fun_12 (_1_,_2_).o_;
           ASSERT (24 == res);
-#endif          
+          
         }
       
       

From 8d8f184ede3a1b42a7ad95a78d866203d49aa7d6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 1 Jul 2009 03:23:26 +0200
Subject: [PATCH 158/368] check more cases, incl. function pointers

---
 src/lib/meta/function-closure.hpp            |  6 ++
 tests/lib/meta/function-composition-test.cpp | 90 +++++++++++---------
 2 files changed, 58 insertions(+), 38 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index dedf14d70..d2fc740fd 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -72,6 +72,12 @@ namespace typelist{
         typedef typename FunctionSignature<function<SIG> >::Args Args;
       };
     template<typename SIG>
+    struct _Fun<SIG*>
+      {
+        typedef typename FunctionSignature<function<SIG> >::Ret Ret;
+        typedef typename FunctionSignature<function<SIG> >::Args Args;
+      };
+    template<typename SIG>
     struct _Fun<function<SIG> >
       {
         typedef typename FunctionSignature<function<SIG> >::Ret Ret;
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index b659c280b..a7d3c66c8 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -70,17 +70,17 @@ namespace test {
         /** "Function-1" will be used at the front side, accepting a tuple of values */
         template<char i>
         Num<i> 
-        fun1 ( Num<i>   val1
-             )
+        fun11 ( Num<i>   val1
+              )
           {
             return val1;
           }
         
         template<char i, char ii>
         Num<i> 
-        fun1 ( Num<i>   val1
-             , Num<ii>  val2
-             )
+        fun12 ( Num<i>   val1
+              , Num<ii>  val2
+              )
           {
             val1.o_ += val2.o_;
             return val1;
@@ -88,10 +88,10 @@ namespace test {
         
         template<char i, char ii, char iii>
         Num<i> 
-        fun1 ( Num<i>   val1
-             , Num<ii>  val2
-             , Num<iii> val3
-             )
+        fun13 ( Num<i>   val1
+              , Num<ii>  val2
+              , Num<iii> val3
+              )
           {
             val1.o_ += val2.o_ + val3.o_;
             return val1;
@@ -99,11 +99,11 @@ namespace test {
         
         template<char i, char ii, char iii, char iv>
         Num<i> 
-        fun1 ( Num<i>   val1
-             , Num<ii>  val2
-             , Num<iii> val3
-             , Num<iv>  val4
-             )
+        fun14 ( Num<i>   val1
+              , Num<ii>  val2
+              , Num<iii> val3
+              , Num<iv>  val4
+              )
           {
             val1.o_ += val2.o_ + val3.o_ + val4.o_;
             return val1;
@@ -111,12 +111,12 @@ namespace test {
         
         template<char i, char ii, char iii, char iv, char v>
         Num<i> 
-        fun1 ( Num<i>   val1
-             , Num<ii>  val2
-             , Num<iii> val3
-             , Num<iv>  val4
-             , Num<v>   val5
-             )
+        fun15 ( Num<i>   val1
+              , Num<ii>  val2
+              , Num<iii> val3
+              , Num<iv>  val4
+              , Num<v>   val5
+              )
           {
             val1.o_ += val2.o_ + val3.o_ + val4.o_ + val5.o_;
             return val1;
@@ -141,7 +141,7 @@ namespace test {
   /******************************************************************************
    * @test this test covers some extensions and variations on function closures:
    *       - partial application of a function, returning a binder
-   *       - chaining of two functions with suitable arguemnts ("composition")
+   *       - chaining of two functions with suitable arguments ("composition")
    */
   class FunctionComposition_test : public Test
     {
@@ -161,21 +161,18 @@ namespace test {
       void
       check_diagnostics ()
         {
-          DISPLAY (List1);
-          DISPLAY (List2);
+          ASSERT (6 == (fun13<1,2,3> (_1_, _2_, _3_)).o_ );
+          ASSERT (6 == (fun13<1,1,1> (Num<1>(3), Num<1>(2), Num<1>(1))).o_ );
           
-          ASSERT (6 == (fun1<1,2,3> (_1_, _2_, _3_)).o_ );
-          ASSERT (6 == (fun1<1,1,1> (Num<1>(3), Num<1>(2), Num<1>(1))).o_ );
+          ASSERT ( 1 == fun2 (fun11<1> (_1_)) );
+          ASSERT ( 3 == fun2 (fun12<1,2> (_1_, _2_)) );
+          ASSERT ( 6 == fun2 (fun13<1,2,3> (_1_, _2_, _3_)) );
+          ASSERT (10 == fun2 (fun14<1,2,3,4> (_1_, _2_, _3_, _4_)) );
+          ASSERT (15 == fun2 (fun15<1,2,3,4,5> (_1_, _2_, _3_, _4_, _5_)) );
           
-          ASSERT ( 1 == fun2 (fun1<1> (_1_)) );
-          ASSERT ( 3 == fun2 (fun1<1,2> (_1_, _2_)) );
-          ASSERT ( 6 == fun2 (fun1<1,2,3> (_1_, _2_, _3_)) );
-          ASSERT (10 == fun2 (fun1<1,2,3,4> (_1_, _2_, _3_, _4_)) );
-          ASSERT (15 == fun2 (fun1<1,2,3,4,5> (_1_, _2_, _3_, _4_, _5_)) );
-          
-          ASSERT ( 9 == fun2 (fun1<2,3,4> (_2_, _3_, _4_)) );
-          ASSERT (18 == fun2 (fun1<5,6,7> (_5_, _6_, _7_)) );
-          ASSERT (24 == fun2 (fun1<9,8,7> (_9_, _8_, _7_)) );
+          ASSERT ( 9 == fun2 (fun13<2,3,4> (_2_, _3_, _4_)) );
+          ASSERT (18 == fun2 (fun13<5,6,7> (_5_, _6_, _7_)) );
+          ASSERT (24 == fun2 (fun13<9,8,7> (_9_, _8_, _7_)) );
         }
       
       
@@ -191,7 +188,7 @@ namespace test {
           typedef Num<1> Sig23(Num<2>, Num<3>);                      // signature after having closed over the first argument
           typedef function<Sig23> F23;                               // and a tr1::function object to hold such a function
           
-          Sig123& f =fun1<1,2,3>;                                    // the actual input: a reference to the bare function
+          Sig123& f =fun13<1,2,3>;                                   // the actual input: a reference to the bare function
           
           
           // Version1: do a direct argument binding----------------- //
@@ -257,20 +254,37 @@ namespace test {
           
           
           // what follows is the real unit test...
-          function<Sig123> func123 (f);
+          function<Sig123> func123 (f);                              // alternatively do it with an tr1::function object
           fun_23 = func::applyFirst (func123, Num<1>(19));
           res = fun_23 (_2_,_3_).o_;
           ASSERT (24 == res);
           
           typedef function<Num<1>(Num<1>, Num<2>)> F12;
-          F12 fun_12 = func::applyLast(f, Num<3>(20));
+          F12 fun_12 = func::applyLast(f, Num<3>(20));               // close the *last* argument of a function
           res = fun_12 (_1_,_2_).o_;
           ASSERT (23 == res);
           
-          fun_12 = func::applyLast(func123, Num<3>(21));
+          fun_12 = func::applyLast(func123, Num<3>(21));             // alternatively use a function object
           res = fun_12 (_1_,_2_).o_;
           ASSERT (24 == res);
           
+          Sig123 *fP = &f;                                           // a function pointer works too 
+          fun_12 = func::applyLast( fP, Num<3>(22));
+          res = fun_12 (_1_,_2_).o_;
+          ASSERT (25 == res);
+                                                                     // cover more cases....
+          
+          ASSERT (1         == (func::applyLast (fun11<1>        , _1_) ( )              ).o_);
+          ASSERT (1+3       == (func::applyLast (fun12<1,3>      , _3_) (_1_)            ).o_);
+          ASSERT (1+3+5     == (func::applyLast (fun13<1,3,5>    , _5_) (_1_,_3_)        ).o_);
+          ASSERT (1+3+5+7   == (func::applyLast (fun14<1,3,5,7>  , _7_) (_1_,_3_,_5_)    ).o_);
+          ASSERT (1+3+5+7+9 == (func::applyLast (fun15<1,3,5,7,9>, _9_) (_1_,_3_,_5_,_7_)).o_);
+          
+          ASSERT (9+8+7+6+5 == (func::applyFirst(fun15<9,8,7,6,5>, _9_) (_8_,_7_,_6_,_5_)).o_);
+          ASSERT (  8+7+6+5 == (func::applyFirst(  fun14<8,7,6,5>, _8_)     (_7_,_6_,_5_)).o_);
+          ASSERT (    7+6+5 == (func::applyFirst(    fun13<7,6,5>, _7_)         (_6_,_5_)).o_);
+          ASSERT (      6+5 == (func::applyFirst(      fun12<6,5>, _6_)             (_5_)).o_);
+          ASSERT (        5 == (func::applyFirst(        fun11<5>, _5_)               ( )).o_);
         }
       
       

From 31e9d59d808e985b71dca498fcc6ca5a52ff60bb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 1 Jul 2009 04:47:52 +0200
Subject: [PATCH 159/368] WIP draft solution for next task

---
 src/lib/meta/function-closure.hpp            | 67 ++++++++++++++++++++
 tests/lib/meta/function-composition-test.cpp | 36 ++++++++++-
 2 files changed, 102 insertions(+), 1 deletion(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index d2fc740fd..590753c74 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -562,6 +562,54 @@ namespace typelist{
         }
     };
   
+    
+  
+  
+  /**
+   * Functional composition. Create a functor, which
+   * on invocation will execute two functions chained,
+   * i.e. fed the result of invoking the first function
+   * as argument into the second function.  
+   */
+  template<typename SIG1, typename RET>
+  class FunctionComposition
+    {
+      typedef typename func::_Fun<SIG1>::Args Args;
+      typedef typename func::_Fun<SIG1>::Ret  Ret1;
+      
+      typedef Types<Ret1> ArgsF2;
+      typedef typename FunctionTypedef<RET, ArgsF2>::Sig SigF2;
+      
+      typedef typename FunctionTypedef<RET, Args>::Sig ChainedSig;
+      typedef function<ChainedSig> ChainedFunc;
+      
+      typedef typename func::PlaceholderTuple<Args>::PlaceholderSeq PlaceholderSeq;
+      typedef Tuple<PlaceholderSeq> Placeholders;
+      
+      enum { ARG_CNT = count<typename Args::List>::value };
+      
+      struct ComposedFunc
+        : ChainedFunc
+        {
+          template<class TUP>
+          ComposedFunc (SIG1& f1, SigF2& f2, TUP& args)
+            : ChainedFunc (std::tr1::bind (f2 ,
+                                           func::Apply<ARG_CNT>::template bind<function<SIG1> > (f1, args)
+                                          ))
+            { }
+        };
+      
+    public:
+      static ChainedFunc
+      chain (SIG1& f1, SigF2& f2)
+        {
+          Placeholders args;
+          return ComposedFunc (f1,f2,args);
+        }
+      
+    };
+
+  
   
   
   /**
@@ -615,6 +663,15 @@ namespace typelist{
         typedef FunctionClosure<Signature> Type;
       };
     
+    template<typename SIG1, typename SIG2>
+    struct _Chain
+      {
+        typedef typename func::_Fun<SIG1>::Args Args;
+        typedef typename func::_Fun<SIG2>::Ret  Ret;
+        typedef typename FunctionTypedef<Ret, Args>::Sig Chained;
+        typedef function<Chained> Function;
+      };
+    
     template<typename SIG>
     struct _PapS
       {
@@ -705,6 +762,16 @@ namespace typelist{
       return PApply<SIG,ArgTypeSeq>::bindBack (f, val);
     }
     
+    
+    /** build a functor chaining the given functions */
+    template<typename SIG1, typename SIG2>
+    typename _Chain<SIG1,SIG2>::Function
+    chained (SIG1& f1, SIG2& f2)
+    {
+      typedef typename _Chain<SIG1,SIG2>::Ret Ret;
+      return FunctionComposition<SIG1,Ret>::chain (f1, f2);
+    }
+    
   } // (END) namespace func
   
   
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index a7d3c66c8..5cfc3f7a5 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -285,6 +285,23 @@ namespace test {
           ASSERT (    7+6+5 == (func::applyFirst(    fun13<7,6,5>, _7_)         (_6_,_5_)).o_);
           ASSERT (      6+5 == (func::applyFirst(      fun12<6,5>, _6_)             (_5_)).o_);
           ASSERT (        5 == (func::applyFirst(        fun11<5>, _5_)               ( )).o_);
+          
+          
+          
+          // Finally a more convoluted example
+          // covering the general case of partial function closure:
+          typedef Num<5> Sig54321(Num<5>, Num<4>, Num<3>, Num<2>, Num<1>);   // Signature of the 5-argument function
+          typedef Num<5> Sig54   (Num<5>, Num<4>);                           // ...closing the last 3 arguments should yield this 2-argument function
+          typedef Types<Num<3>,Num<2>,Num<1> > Args2Close;                   // Tuple type to hold the 3 argument values used for the closure
+          
+          // Close the trailing 3 arguments of the 5-argument function...
+          function<Sig54> fun_54 = PApply<Sig54321, Args2Close>::bindBack(fun15<5,4,3,2,1>, 
+                                                                          tuple::make(_3_,_2_,_1_)
+                                                                         );
+          
+          // apply the remaining argument values
+          Num<5> resN5 = fun_54 (_5_,_4_);
+          ASSERT (5+4+3+2+1 == resN5.o_);
         }
       
       
@@ -292,7 +309,24 @@ namespace test {
       void
       check_functionalComposition ()
         {
-//          ASSERT (1+5+9 == fun(Num<1>(), Num<5>(), Num<9>()));
+          typedef Num<1> Sig12(Num<1>,Num<2>);
+          typedef int SigF21(Num<1>);
+          
+          Sig12  &f1 = fun12<1,2>;
+          SigF21 &f2 = fun2<Num<1> >;
+          
+          typedef function<int(Num<1>,Num<2>)> Chained;
+          
+          Chained funCh = func::chained (f1, f2 ); 
+          ASSERT (1+2       == funCh (_1_,_2_) );
+          
+#if false          
+          ASSERT (1         == func::chain(fun11<1>        , fun2) (_1_)                 );
+          ASSERT (1+2       == func::chain(fun12<1,2>      , fun2<Num<1> > ) (_1_,_2_)             );
+          ASSERT (1+2+3     == func::chain(fun13<1,2,3>    , fun2) (_1_,_2_,_3_)         );
+          ASSERT (1+2+3+4   == func::chain(fun14<1,2,3,4>  , fun2) (_1_,_2_,_3_,_4_)     );
+          ASSERT (1+2+3+4+5 == func::chain(fun15<1,2,3,4,5>, fun2) (_1_,_2_,_3_,_4_,_5_) );
+#endif          
         }
       
     };

From b7be61c4e643c2fe9f73120bbea288c03af71188 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 3 Jul 2009 13:49:12 +0200
Subject: [PATCH 160/368] composition now working

---
 src/lib/meta/function-closure.hpp            | 100 +++++++++++++++----
 tests/lib/meta/function-composition-test.cpp |  42 ++++----
 2 files changed, 104 insertions(+), 38 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 590753c74..10dcab8dd 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -57,7 +57,9 @@ namespace lumiera {
 namespace typelist{
 
   using std::tr1::function;
-  using std::tr1::bind;
+//using std::tr1::bind;
+//using std::tr1::placeholders::_1;
+
   
   
   
@@ -381,6 +383,7 @@ namespace typelist{
     
     
     
+    
     /* ===== Helpers for partial function application ===== */
     
     using std::tr1::_Placeholder;     // what is the "official" way to import them?
@@ -564,6 +567,82 @@ namespace typelist{
   
     
   
+  namespace _cmp {
+    using std::tr1::bind;
+    using std::tr1::placeholders::_1;
+    using std::tr1::placeholders::_2;
+    using std::tr1::placeholders::_3;
+    using std::tr1::placeholders::_4;
+    using std::tr1::placeholders::_5;
+    using std::tr1::placeholders::_6;
+    using std::tr1::placeholders::_7;
+    using std::tr1::placeholders::_8;
+    using std::tr1::placeholders::_9;
+    
+    template<typename RES, typename F1, typename F2, uint n>
+    struct BuildComposed;
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 0 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 1 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 2 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 3 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 4 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 5 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 6 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 7 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 8 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7,_8)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct BuildComposed<RES,F1,F2, 9 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7,_8,_9)); }
+      };
+  
+  }
   
   /**
    * Functional composition. Create a functor, which
@@ -579,32 +658,17 @@ namespace typelist{
       
       typedef Types<Ret1> ArgsF2;
       typedef typename FunctionTypedef<RET, ArgsF2>::Sig SigF2;
-      
       typedef typename FunctionTypedef<RET, Args>::Sig ChainedSig;
-      typedef function<ChainedSig> ChainedFunc;
       
-      typedef typename func::PlaceholderTuple<Args>::PlaceholderSeq PlaceholderSeq;
-      typedef Tuple<PlaceholderSeq> Placeholders;
       
       enum { ARG_CNT = count<typename Args::List>::value };
       
-      struct ComposedFunc
-        : ChainedFunc
-        {
-          template<class TUP>
-          ComposedFunc (SIG1& f1, SigF2& f2, TUP& args)
-            : ChainedFunc (std::tr1::bind (f2 ,
-                                           func::Apply<ARG_CNT>::template bind<function<SIG1> > (f1, args)
-                                          ))
-            { }
-        };
       
     public:
-      static ChainedFunc
+      static function<ChainedSig>
       chain (SIG1& f1, SigF2& f2)
         {
-          Placeholders args;
-          return ComposedFunc (f1,f2,args);
+          return _cmp::BuildComposed<ChainedSig,SIG1,SigF2, ARG_CNT>::func (f1,f2);
         }
       
     };
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index 5cfc3f7a5..a9e8d66ce 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -68,7 +68,7 @@ namespace test {
         Num<9> _9_;                     
         
         /** "Function-1" will be used at the front side, accepting a tuple of values */
-        template<char i>
+        template<uint i>
         Num<i> 
         fun11 ( Num<i>   val1
               )
@@ -76,7 +76,7 @@ namespace test {
             return val1;
           }
         
-        template<char i, char ii>
+        template<uint i, uint ii>
         Num<i> 
         fun12 ( Num<i>   val1
               , Num<ii>  val2
@@ -86,7 +86,7 @@ namespace test {
             return val1;
           }
         
-        template<char i, char ii, char iii>
+        template<uint i, uint ii, uint iii>
         Num<i> 
         fun13 ( Num<i>   val1
               , Num<ii>  val2
@@ -97,7 +97,7 @@ namespace test {
             return val1;
           }
         
-        template<char i, char ii, char iii, char iv>
+        template<uint i, uint ii, uint iii, uint iv>
         Num<i> 
         fun14 ( Num<i>   val1
               , Num<ii>  val2
@@ -109,7 +109,7 @@ namespace test {
             return val1;
           }
         
-        template<char i, char ii, char iii, char iv, char v>
+        template<uint i, uint ii, uint iii, uint iv, uint v>
         Num<i> 
         fun15 ( Num<i>   val1
               , Num<ii>  val2
@@ -306,27 +306,29 @@ namespace test {
       
       
       
+      
       void
       check_functionalComposition ()
         {
+          typedef int Sig2(Num<1>);
+          typedef Num<1> Sig11(Num<1>);
           typedef Num<1> Sig12(Num<1>,Num<2>);
-          typedef int SigF21(Num<1>);
+          typedef Num<1> Sig13(Num<1>,Num<2>,Num<3>);
+          typedef Num<1> Sig14(Num<1>,Num<2>,Num<3>,Num<4>);
+          typedef Num<1> Sig15(Num<1>,Num<2>,Num<3>,Num<4>,Num<5>);
           
-          Sig12  &f1 = fun12<1,2>;
-          SigF21 &f2 = fun2<Num<1> >;
+          Sig2 & ff = fun2< Num<1> >;
+          Sig11& f1 = fun11<1>;
+          Sig12& f2 = fun12<1,2>;
+          Sig13& f3 = fun13<1,2,3>;
+          Sig14& f4 = fun14<1,2,3,4>;
+          Sig15& f5 = fun15<1,2,3,4,5>;
           
-          typedef function<int(Num<1>,Num<2>)> Chained;
-          
-          Chained funCh = func::chained (f1, f2 ); 
-          ASSERT (1+2       == funCh (_1_,_2_) );
-          
-#if false          
-          ASSERT (1         == func::chain(fun11<1>        , fun2) (_1_)                 );
-          ASSERT (1+2       == func::chain(fun12<1,2>      , fun2<Num<1> > ) (_1_,_2_)             );
-          ASSERT (1+2+3     == func::chain(fun13<1,2,3>    , fun2) (_1_,_2_,_3_)         );
-          ASSERT (1+2+3+4   == func::chain(fun14<1,2,3,4>  , fun2) (_1_,_2_,_3_,_4_)     );
-          ASSERT (1+2+3+4+5 == func::chain(fun15<1,2,3,4,5>, fun2) (_1_,_2_,_3_,_4_,_5_) );
-#endif          
+          ASSERT (1         == func::chained(f1, ff) (_1_)                 );
+          ASSERT (1+2       == func::chained(f2, ff) (_1_,_2_)             );
+          ASSERT (1+2+3     == func::chained(f3, ff) (_1_,_2_,_3_)         );
+          ASSERT (1+2+3+4   == func::chained(f4, ff) (_1_,_2_,_3_,_4_)     );
+          ASSERT (1+2+3+4+5 == func::chained(f5, ff) (_1_,_2_,_3_,_4_,_5_) );
         }
       
     };

From d13d461a9c72b21ec316155e6805006cb568bdb5 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 3 Jul 2009 14:31:52 +0200
Subject: [PATCH 161/368] revamp namespace func. Finish excursion on function
 handling

---
 src/lib/meta/function-closure.hpp            | 616 +++++++++----------
 src/proc/control/command-closure.hpp         |   2 +-
 tests/40components.tests                     |   2 +-
 tests/lib/meta/function-closure-test.cpp     |  83 +--
 tests/lib/meta/function-composition-test.cpp |  22 +-
 5 files changed, 348 insertions(+), 377 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 10dcab8dd..74149ab40 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -25,7 +25,8 @@
  ** Partial function application and building a complete function closure.
  ** This is a small addendum to (and thin wrapper for) tr1/functional, supporting
  ** the case when a function should be closed over (partially or all) arguments,
- ** where especially the parameter values to close on are provided as a tuple. 
+ ** where especially the parameter values to close on are provided as a tuple.
+ ** Additionally, we allow for composing (chaining) of two functions.
  ** 
  ** Because we have to deal with arbitrary functions and arbitrary parameter types,
  ** we need a lot of repetitive code to "catch" functions from zero to nine arguments.
@@ -55,15 +56,14 @@
 
 namespace lumiera {
 namespace typelist{
-
+namespace func    {
+  
   using std::tr1::function;
-//using std::tr1::bind;
-//using std::tr1::placeholders::_1;
-
   
   
   
-  namespace func { ///< helpers for binding and applying a function to an argument tuple 
+  
+  namespace { // helpers for binding and applying a function to an argument tuple
     
     using tuple::element;
     
@@ -96,7 +96,7 @@ namespace typelist{
     /**
      * this Helper with repetitive specialisations for up to nine arguments
      * is used either to apply a function to arguments given as a tuple, or
-     * to create the actual closure (functor) over all function arguments. 
+     * to create the actual closure (functor) over all function arguments.
      */
     template<uint n>
     struct Apply;
@@ -419,9 +419,7 @@ namespace typelist{
       };
     
     
-    
-    
-  } // (END) impl-namespace (func)
+  } // (END) impl-namespace
   
   
   
@@ -450,232 +448,15 @@ namespace typelist{
         : params_(args)
         { }
       
-      BoundFunc bind (SIG& f)                 { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
-      BoundFunc bind (function<SIG> const& f) { return func::Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
+      BoundFunc bind (SIG& f)                 { return Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
+      BoundFunc bind (function<SIG> const& f) { return Apply<ARG_CNT>::template bind<BoundFunc> (f, params_); }
       
-      Ret operator() (SIG& f)                 { return func::Apply<ARG_CNT>::template invoke<Ret> (f, params_); }
-      Ret operator() (function<SIG>& f)       { return func::Apply<ARG_CNT>::template invoke<Ret> (f, params_); }
+      Ret operator() (SIG& f)                 { return Apply<ARG_CNT>::template invoke<Ret> (f, params_); }
+      Ret operator() (function<SIG>& f)       { return Apply<ARG_CNT>::template invoke<Ret> (f, params_); }
     };
   
   
   
-  /**
-   * Partial function application
-   * Takes a function and a value tuple,
-   * using the latter to close function arguments 
-   * either from the front (left) or aligned to the end
-   * of the function argument list. Result is a "reduced" function,
-   * expecting only the remaining "un-closed" arguments at invocation.  
-   */
-  template<typename SIG, typename VAL>
-  class PApply
-    {
-      typedef typename func::_Fun<SIG>::Args Args;
-      typedef typename func::_Fun<SIG>::Ret  Ret;
-      typedef typename Args::List ArgsList;
-      typedef typename VAL::List ValList;
-      
-      enum { ARG_CNT = count<ArgsList>::value
-           , VAL_CNT = count<ValList> ::value
-           , ROFFSET = (VAL_CNT < ARG_CNT)? ARG_CNT-VAL_CNT : 0
-           };
-      
-      
-      // create list of the *remaining* arguments, after applying the ValList
-      typedef typename Splice<ArgsList, ValList>::Back           LeftReduced;
-      typedef typename Splice<ArgsList, ValList, ROFFSET>::Front RightReduced;
-      
-      // build a list, where each of the *remaining* arguments is replaced by a placeholder marker
-      typedef typename func::PlaceholderTuple<LeftReduced>::PlaceholderSeq::List  LeftPlaceholders;
-      typedef typename func::PlaceholderTuple<RightReduced>::PlaceholderSeq::List RightPlaceholders;
-      
-      // ... and splice these placeholders on top of the original argument type list,
-      // thus retaining the types to be closed, but setting a placeholder for each remaining argument
-      typedef typename Splice<ArgsList, LeftPlaceholders, VAL_CNT>::List LeftReplaced;
-      typedef typename Splice<ArgsList, RightPlaceholders, 0     >::List RightReplaced;
-      
-      typedef Tuple<LeftReplaced>  TupleL;
-      typedef Tuple<RightReplaced> TupleR;
-      
-      typedef typename Tuple<LeftReduced>::Type  ArgsL;
-      typedef typename Tuple<RightReduced>::Type ArgsR;
-      
-      // create a "builder" helper, which accepts exactly the value tuple elements
-      // and puts them at the right location, while default-constructing the remaining
-      // (=placeholder)-arguments. Using this builder helper, we can finally set up
-      // the argument tuples (Left/RightReplacedArgs) used for the tr1::bind call
-      typedef tuple::BuildTuple<LeftReplaced, ValList>           BuildL;
-      typedef tuple::BuildTuple<RightReplaced, ValList, ROFFSET> BuildR;
-      
-      
-    public:
-      typedef function<typename FunctionTypedef<Ret,ArgsL>::Sig> LeftReducedFunc;
-      typedef function<typename FunctionTypedef<Ret,ArgsR>::Sig> RightReducedFunc;
-      
-      
-      /** Contains the argument values, starting from left.
-       *  Any remaining positions are occupied by binding placeholders */
-      struct LeftReplacedArgs
-        : TupleL
-        {
-          LeftReplacedArgs (Tuple<VAL> const& arg)
-            : TupleL ( BuildL::create(arg))
-            { }
-        };
-      
-      /** Contains the argument values, aligned to the end of the function argument list.
-       *  Any remaining positions before are occupied by binding placeholders */
-      struct RightReplacedArgs
-        : TupleR
-        {
-          RightReplacedArgs (Tuple<VAL> const& arg)
-            : TupleR ( BuildR::create(arg))
-            { }
-        };
-      
-      
-      /** do a partial function application, closing the first arguments
-       *  f(a,b,c)->res  +  (a,b)  yields  f(c)->res
-       *  
-       *  @param f   function, function pointer or functor
-       *  @param arg value tuple, used to close function arguments starting from left
-       *  @return new function object, holding copies of the values and using them at the
-       *          closed arguments; on invocation, only the remaining arguments need to be supplied.
-       */
-      static LeftReducedFunc
-      bindFront (SIG& f, Tuple<VAL> const& arg)
-        {
-          LeftReplacedArgs params (arg);
-          return func::Apply<ARG_CNT>::template bind<LeftReducedFunc> (f, params.tupleCast());
-        }
-      
-      /** do a partial function application, closing the last arguments
-       *  f(a,b,c)->res  +  (b,c)  yields  f(a)->res
-       *  
-       *  @param f   function, function pointer or functor
-       *  @param arg value tuple, used to close function arguments starting from right
-       *  @return new function object, holding copies of the values and using them at the
-       *          closed arguments; on invocation, only the remaining arguments need to be supplied.
-       */
-      static RightReducedFunc
-      bindBack (SIG& f, Tuple<VAL> const& arg)
-        {
-          RightReplacedArgs params (arg);
-          return func::Apply<ARG_CNT>::template bind<RightReducedFunc> (f, params.tupleCast());
-        }
-    };
-  
-    
-  
-  namespace _cmp {
-    using std::tr1::bind;
-    using std::tr1::placeholders::_1;
-    using std::tr1::placeholders::_2;
-    using std::tr1::placeholders::_3;
-    using std::tr1::placeholders::_4;
-    using std::tr1::placeholders::_5;
-    using std::tr1::placeholders::_6;
-    using std::tr1::placeholders::_7;
-    using std::tr1::placeholders::_8;
-    using std::tr1::placeholders::_9;
-    
-    template<typename RES, typename F1, typename F2, uint n>
-    struct BuildComposed;
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 0 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 1 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 2 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 3 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 4 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 5 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 6 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 7 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 8 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7,_8)); }
-      };
-    
-    template<typename RES, typename F1, typename F2>
-    struct BuildComposed<RES,F1,F2, 9 >
-      {
-        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7,_8,_9)); }
-      };
-  
-  }
-  
-  /**
-   * Functional composition. Create a functor, which
-   * on invocation will execute two functions chained,
-   * i.e. fed the result of invoking the first function
-   * as argument into the second function.  
-   */
-  template<typename SIG1, typename RET>
-  class FunctionComposition
-    {
-      typedef typename func::_Fun<SIG1>::Args Args;
-      typedef typename func::_Fun<SIG1>::Ret  Ret1;
-      
-      typedef Types<Ret1> ArgsF2;
-      typedef typename FunctionTypedef<RET, ArgsF2>::Sig SigF2;
-      typedef typename FunctionTypedef<RET, Args>::Sig ChainedSig;
-      
-      
-      enum { ARG_CNT = count<typename Args::List>::value };
-      
-      
-    public:
-      static function<ChainedSig>
-      chain (SIG1& f1, SigF2& f2)
-        {
-          return _cmp::BuildComposed<ChainedSig,SIG1,SigF2, ARG_CNT>::func (f1,f2);
-        }
-      
-    };
-
-  
-  
-  
   /**
    * Closing a function over its arguments.
    * This is a small usage example or spin-off,
@@ -707,11 +488,212 @@ namespace typelist{
   
   
   
-  namespace func { // ...some convenience shortcuts
-    
-    
-    // helpers for specifying types in function declarations....
   
+  /**
+   * Partial function application
+   * Takes a function and a value tuple,
+   * using the latter to close function arguments 
+   * either from the front (left) or aligned to the end
+   * of the function argument list. Result is a "reduced" function,
+   * expecting only the remaining "un-closed" arguments at invocation.
+   */
+  template<typename SIG, typename VAL>
+  class PApply
+    {
+      typedef typename _Fun<SIG>::Args Args;
+      typedef typename _Fun<SIG>::Ret  Ret;
+      typedef typename Args::List ArgsList;
+      typedef typename VAL::List ValList;
+      
+      enum { ARG_CNT = count<ArgsList>::value
+           , VAL_CNT = count<ValList> ::value
+           , ROFFSET = (VAL_CNT < ARG_CNT)? ARG_CNT-VAL_CNT : 0
+           };
+      
+      
+      // create list of the *remaining* arguments, after applying the ValList
+      typedef typename Splice<ArgsList, ValList>::Back           LeftReduced;
+      typedef typename Splice<ArgsList, ValList, ROFFSET>::Front RightReduced;
+      
+      // build a list, where each of the *remaining* arguments is replaced by a placeholder marker
+      typedef typename func::PlaceholderTuple<LeftReduced>::PlaceholderSeq::List  LeftPlaceholders;
+      typedef typename func::PlaceholderTuple<RightReduced>::PlaceholderSeq::List RightPlaceholders;
+      
+      // ... and splice these placeholders on top of the original argument type list,
+      // thus retaining the types to be closed, but setting a placeholder for each remaining argument
+      typedef typename Splice<ArgsList, LeftPlaceholders, VAL_CNT>::List LeftReplaced;
+      typedef typename Splice<ArgsList, RightPlaceholders, 0     >::List RightReplaced;
+      
+      typedef typename Tuple<LeftReduced>::Type  ArgsL;
+      typedef typename Tuple<RightReduced>::Type ArgsR;
+      
+      // create a "builder" helper, which accepts exactly the value tuple elements
+      // and puts them at the right location, while default-constructing the remaining
+      // (=placeholder)-arguments. Using this builder helper, we can finally set up
+      // the argument tuples (Left/RightReplacedArgs) used for the tr1::bind call
+      typedef tuple::BuildTuple<LeftReplaced, ValList>           BuildL;
+      typedef tuple::BuildTuple<RightReplaced, ValList, ROFFSET> BuildR;
+      
+      /** Contains the argument values, starting from left.
+       *  Any remaining positions are occupied by binding placeholders */
+      typedef typename Tuple<LeftReplaced>::TupleType  LeftReplacedArgs;
+      
+      /** Contains the argument values, aligned to the end of the function argument list.
+       *  Any remaining positions before are occupied by binding placeholders */
+      typedef typename Tuple<RightReplaced>::TupleType RightReplacedArgs;
+      
+      
+    public:
+      typedef function<typename FunctionTypedef<Ret,ArgsL>::Sig> LeftReducedFunc;
+      typedef function<typename FunctionTypedef<Ret,ArgsR>::Sig> RightReducedFunc;
+      
+      
+      /** do a partial function application, closing the first arguments
+       *  f(a,b,c)->res  +  (a,b)  yields  f(c)->res
+       *  
+       *  @param f   function, function pointer or functor
+       *  @param arg value tuple, used to close function arguments starting from left
+       *  @return new function object, holding copies of the values and using them at the
+       *          closed arguments; on invocation, only the remaining arguments need to be supplied.
+       */
+      static LeftReducedFunc
+      bindFront (SIG& f, Tuple<VAL> const& arg)
+        {
+          LeftReplacedArgs params (BuildL::create(arg));
+          return func::Apply<ARG_CNT>::template bind<LeftReducedFunc> (f, params);
+        }
+      
+      /** do a partial function application, closing the last arguments
+       *  f(a,b,c)->res  +  (b,c)  yields  f(a)->res
+       *  
+       *  @param f   function, function pointer or functor
+       *  @param arg value tuple, used to close function arguments starting from right
+       *  @return new function object, holding copies of the values and using them at the
+       *          closed arguments; on invocation, only the remaining arguments need to be supplied.
+       */
+      static RightReducedFunc
+      bindBack (SIG& f, Tuple<VAL> const& arg)
+        {
+          RightReplacedArgs params (BuildR::create(arg));
+          return func::Apply<ARG_CNT>::template bind<RightReducedFunc> (f, params);
+        }
+    };
+  
+  
+  
+  
+  
+  
+  
+  namespace _composed { // repetitive impl.code for function composition
+    using std::tr1::bind;
+    using std::tr1::placeholders::_1;
+    using std::tr1::placeholders::_2;
+    using std::tr1::placeholders::_3;
+    using std::tr1::placeholders::_4;
+    using std::tr1::placeholders::_5;
+    using std::tr1::placeholders::_6;
+    using std::tr1::placeholders::_7;
+    using std::tr1::placeholders::_8;
+    using std::tr1::placeholders::_9;
+    
+    template<typename RES, typename F1, typename F2, uint n>
+    struct Build;
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 0 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 1 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 2 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 3 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 4 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 5 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 6 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 7 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 8 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7,_8)); }
+      };
+    
+    template<typename RES, typename F1, typename F2>
+    struct Build<RES,F1,F2, 9 >
+      {
+        static function<RES> func(F1& f1, F2& f2) { return bind (f2, bind (f1,_1,_2,_3,_4,_5,_6,_7,_8,_9)); }
+      };
+  } // (End) impl namespace (_composed)
+  
+  
+  
+  /**
+   * Functional composition. Create a functor, which
+   * on invocation will execute two functions chained,
+   * i.e. fed the result of invoking the first function
+   * as argument into the second function.  
+   */
+  template<typename SIG1, typename RET>
+  class FunctionComposition
+    {
+      typedef typename func::_Fun<SIG1>::Args Args;
+      typedef typename func::_Fun<SIG1>::Ret  Ret1;
+      
+      typedef Types<Ret1> ArgsF2;
+      typedef typename FunctionTypedef<RET, ArgsF2>::Sig SigF2;
+      typedef typename FunctionTypedef<RET, Args>::Sig ChainedSig;
+      
+      enum { ARG_CNT = count<typename Args::List>::value };
+      
+      
+    public:
+      static function<ChainedSig>
+      chain (SIG1& f1, SigF2& f2)
+        {
+          return _composed::Build<ChainedSig,SIG1,SigF2, ARG_CNT>::func (f1,f2);
+        }
+    };
+  
+  
+  
+  namespace { // ...helpers for specifying types in function declarations....
+    
     template<typename RET, typename ARG>
     struct _Sig
       {
@@ -730,8 +712,8 @@ namespace typelist{
     template<typename SIG1, typename SIG2>
     struct _Chain
       {
-        typedef typename func::_Fun<SIG1>::Args Args;
-        typedef typename func::_Fun<SIG2>::Ret  Ret;
+        typedef typename _Fun<SIG1>::Args Args;
+        typedef typename _Fun<SIG2>::Ret  Ret;
         typedef typename FunctionTypedef<Ret, Args>::Sig Chained;
         typedef function<Chained> Function;
       };
@@ -758,87 +740,87 @@ namespace typelist{
         typedef function<Signature> Function;
       };
     
-    
-    
-    
-    /*  ========== function-style interface =============  */
-    
-    /** build a TupleApplicator, which embodies the given
-     *  argument tuple and can be used to apply various
-     *  functions to them.
-     */
-    template<typename ARG>
-    typename _Sig<void, ARG>::Applicator
-    tupleApplicator (Tuple<ARG>& args)
-    {
-      typedef typename _Sig<void,ARG>::Type Signature;
-      return TupleApplicator<Signature> (args);
-    }
-    
-    
-    /** apply the given function to the argument tuple */
-    template<typename SIG, typename ARG>
-    typename _Fun<SIG>::Ret
-    apply (SIG& f, Tuple<ARG>& args)
-    {
-      typedef typename _Fun<SIG>::Ret Ret;                //
-      typedef typename _Sig<Ret,ARG>::Type Signature;    // Note: deliberately re-building the Signature Type
-      return TupleApplicator<Signature> (args) (f);     //        in order to get better error messages here
-    }
-    
-    /** close the given function over all arguments,
-     *  using the values from the argument tuple.
-     *  @return a closure object, which can be 
-     *          invoked later to yield the
-     *          function result. */
-    template<typename SIG, typename ARG>
-    typename _Clo<SIG,ARG>::Type
-    closure (SIG& f, Tuple<ARG>& args)
-    {
-      typedef typename _Fun<SIG>::Ret Ret;
-      typedef typename _Sig<Ret,ARG>::Type Signature;
-      typedef typename _Clo<SIG,ARG>::Type Closure;
-      return Closure (f,args);
-    }
-    
-    
-    /** close the given function over the first argument */
-    template<typename SIG, typename ARG>
-    typename _PapS<SIG>::Function
-    applyFirst (SIG& f, ARG arg)
-    {
-      typedef typename _PapS<SIG>::Arg ArgType;
-      typedef Types<ArgType>           ArgTypeSeq;
-      typedef Tuple<ArgTypeSeq>        ArgTuple;
-      ArgTuple val(arg);
-      return PApply<SIG,ArgTypeSeq>::bindFront (f, val);
-    }
-    
-    /** close the given function over the last argument */
-    template<typename SIG, typename ARG>
-    typename _PapE<SIG>::Function
-    applyLast (SIG& f, ARG arg)
-    {
-      typedef typename _PapE<SIG>::Arg ArgType;
-      typedef Types<ArgType>           ArgTypeSeq;
-      typedef Tuple<ArgTypeSeq>        ArgTuple;
-      ArgTuple val(arg);
-      return PApply<SIG,ArgTypeSeq>::bindBack (f, val);
-    }
-    
-    
-    /** build a functor chaining the given functions */
-    template<typename SIG1, typename SIG2>
-    typename _Chain<SIG1,SIG2>::Function
-    chained (SIG1& f1, SIG2& f2)
-    {
-      typedef typename _Chain<SIG1,SIG2>::Ret Ret;
-      return FunctionComposition<SIG1,Ret>::chain (f1, f2);
-    }
-    
-  } // (END) namespace func
+  } // (End) argument type shortcuts
   
   
   
-}} // namespace lumiera::typelist
+  
+  /*  ========== function-style interface =============  */
+  
+  /** build a TupleApplicator, which embodies the given
+   *  argument tuple and can be used to apply various
+   *  functions to them.
+   */
+  template<typename ARG>
+  typename _Sig<void, ARG>::Applicator
+  tupleApplicator (Tuple<ARG>& args)
+  {
+    typedef typename _Sig<void,ARG>::Type Signature;
+    return TupleApplicator<Signature> (args);
+  }
+  
+  
+  /** apply the given function to the argument tuple */
+  template<typename SIG, typename ARG>
+  typename _Fun<SIG>::Ret
+  apply (SIG& f, Tuple<ARG>& args)
+  {
+    typedef typename _Fun<SIG>::Ret Ret;                //
+    typedef typename _Sig<Ret,ARG>::Type Signature;    // Note: deliberately re-building the Signature Type
+    return TupleApplicator<Signature> (args) (f);     //        in order to get better error messages here
+  }
+  
+  /** close the given function over all arguments,
+   *  using the values from the argument tuple.
+   *  @return a closure object, which can be 
+   *          invoked later to yield the
+   *          function result. */
+  template<typename SIG, typename ARG>
+  typename _Clo<SIG,ARG>::Type
+  closure (SIG& f, Tuple<ARG>& args)
+  {
+    typedef typename _Fun<SIG>::Ret Ret;
+    typedef typename _Sig<Ret,ARG>::Type Signature;
+    typedef typename _Clo<SIG,ARG>::Type Closure;
+    return Closure (f,args);
+  }
+  
+  
+  /** close the given function over the first argument */
+  template<typename SIG, typename ARG>
+  typename _PapS<SIG>::Function
+  applyFirst (SIG& f, ARG arg)
+  {
+    typedef typename _PapS<SIG>::Arg ArgType;
+    typedef Types<ArgType>           ArgTypeSeq;
+    typedef Tuple<ArgTypeSeq>        ArgTuple;
+    ArgTuple val(arg);
+    return PApply<SIG,ArgTypeSeq>::bindFront (f, val);
+  }
+  
+  /** close the given function over the last argument */
+  template<typename SIG, typename ARG>
+  typename _PapE<SIG>::Function
+  applyLast (SIG& f, ARG arg)
+  {
+    typedef typename _PapE<SIG>::Arg ArgType;
+    typedef Types<ArgType>           ArgTypeSeq;
+    typedef Tuple<ArgTypeSeq>        ArgTuple;
+    ArgTuple val(arg);
+    return PApply<SIG,ArgTypeSeq>::bindBack (f, val);
+  }
+  
+  
+  /** build a functor chaining the given functions */
+  template<typename SIG1, typename SIG2>
+  typename _Chain<SIG1,SIG2>::Function
+  chained (SIG1& f1, SIG2& f2)
+  {
+    typedef typename _Chain<SIG1,SIG2>::Ret Ret;
+    return FunctionComposition<SIG1,Ret>::chain (f1, f2);
+  }
+  
+  
+  
+}}} // namespace lumiera::typelist::func
 #endif
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index f309d0aef..ff2dc3ec6 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -67,7 +67,7 @@ namespace control {
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::Tuple;
   using lumiera::typelist::BuildTupleAccessor;
-  using lumiera::typelist::TupleApplicator;
+  using lumiera::typelist::func::TupleApplicator;
   using lumiera::typelist::FunErasure;
   using lumiera::typelist::StoreFunction;
   
diff --git a/tests/40components.tests b/tests/40components.tests
index f333d87ae..a04bcd63c 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -234,7 +234,7 @@ out: dtor ~TargetObj\(12\) successful
 END
 
 
-TEST "closing function over its arguments" FunctionClosure_test <<END
+TEST "functional closure" FunctionClosure_test <<END
 out: List1	:-<1>-<2>-<3>-
 out: List2	:-<5>-<6>-<7>-
 out: Args	:-<5>-<9>-
diff --git a/tests/lib/meta/function-closure-test.cpp b/tests/lib/meta/function-closure-test.cpp
index 2def0fde4..faa998fae 100644
--- a/tests/lib/meta/function-closure-test.cpp
+++ b/tests/lib/meta/function-closure-test.cpp
@@ -54,7 +54,7 @@ using std::endl;
 
 namespace lumiera {
 namespace typelist{
-namespace test {
+namespace test    {
       
       
       namespace { // test data
@@ -87,12 +87,17 @@ namespace test {
         int fun3 (int i1, int i2, int i3) { return i1+i2+i3; }
         
       } // (End) test data
-      
-      
-      
-      
-      
-      
+  
+  
+  
+  
+  using func::Apply;
+  using func::TupleApplicator;
+  using func::FunctionClosure;
+  using func::closure;
+  using func::apply;
+  
+  
   /*************************************************************************
    * @test building a function closure for a given function or functor,
    *       while arguments are passed in as tuple
@@ -166,20 +171,20 @@ namespace test {
           DUMPVAL (tup2);
           DUMPVAL (tup3);
           
-          ASSERT (-1       == func::Apply<0>::invoke<int> (fun0, tup0) );
-          ASSERT (11       == func::Apply<1>::invoke<int> (fun1, tup1) );
-          ASSERT (11+12    == func::Apply<2>::invoke<int> (fun2, tup2) );
-          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (fun3, tup3) );
+          ASSERT (-1       == Apply<0>::invoke<int> (fun0, tup0) );
+          ASSERT (11       == Apply<1>::invoke<int> (fun1, tup1) );
+          ASSERT (11+12    == Apply<2>::invoke<int> (fun2, tup2) );
+          ASSERT (11+12+13 == Apply<3>::invoke<int> (fun3, tup3) );
           
           ASSERT (-1       == TupleApplicator<int()>            (tup0) (fun0) );
           ASSERT (11       == TupleApplicator<int(int)>         (tup1) (fun1) );
           ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (fun2) );
           ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (fun3) );
           
-          ASSERT (-1       == func::apply(fun0, tup0) );
-          ASSERT (11       == func::apply(fun1, tup1) );
-          ASSERT (11+12    == func::apply(fun2, tup2) );
-          ASSERT (11+12+13 == func::apply(fun3, tup3) );
+          ASSERT (-1       == apply(fun0, tup0) );
+          ASSERT (11       == apply(fun1, tup1) );
+          ASSERT (11+12    == apply(fun2, tup2) );
+          ASSERT (11+12+13 == apply(fun3, tup3) );
         
         }
       
@@ -196,20 +201,20 @@ namespace test {
           function<int(int,int)>     functor2 (fun2);
           function<int(int,int,int)> functor3 (fun3);
           
-          ASSERT (-1       == func::Apply<0>::invoke<int> (functor0, tup0) );
-          ASSERT (11       == func::Apply<1>::invoke<int> (functor1, tup1) );
-          ASSERT (11+12    == func::Apply<2>::invoke<int> (functor2, tup2) );
-          ASSERT (11+12+13 == func::Apply<3>::invoke<int> (functor3, tup3) );
+          ASSERT (-1       == Apply<0>::invoke<int> (functor0, tup0) );
+          ASSERT (11       == Apply<1>::invoke<int> (functor1, tup1) );
+          ASSERT (11+12    == Apply<2>::invoke<int> (functor2, tup2) );
+          ASSERT (11+12+13 == Apply<3>::invoke<int> (functor3, tup3) );
           
           ASSERT (-1       == TupleApplicator<int()>            (tup0) (functor0) );
           ASSERT (11       == TupleApplicator<int(int)>         (tup1) (functor1) );
           ASSERT (11+12    == TupleApplicator<int(int,int)>     (tup2) (functor2) );
           ASSERT (11+12+13 == TupleApplicator<int(int,int,int)> (tup3) (functor3) );
           
-          ASSERT (-1       == func::apply(functor0, tup0) );
-          ASSERT (11       == func::apply(functor1, tup1) );
-          ASSERT (11+12    == func::apply(functor2, tup2) );
-          ASSERT (11+12+13 == func::apply(functor3, tup3) );
+          ASSERT (-1       == apply(functor0, tup0) );
+          ASSERT (11       == apply(functor1, tup1) );
+          ASSERT (11+12    == apply(functor2, tup2) );
+          ASSERT (11+12+13 == apply(functor3, tup3) );
           
         }
       
@@ -226,10 +231,10 @@ namespace test {
           
           typedef function<int()> BoundFun;
           
-          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (fun0, tup0);
-          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (fun1, tup1);
-          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (fun2, tup3);
-          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (fun3, tup3);
+          BoundFun functor0 = Apply<0>::bind<BoundFun> (fun0, tup0);
+          BoundFun functor1 = Apply<1>::bind<BoundFun> (fun1, tup1);
+          BoundFun functor2 = Apply<2>::bind<BoundFun> (fun2, tup3);
+          BoundFun functor3 = Apply<3>::bind<BoundFun> (fun3, tup3);
           
           ASSERT (-1       == functor0() );
           ASSERT (11       == functor1() );
@@ -263,10 +268,10 @@ namespace test {
           
           typedef function<int()> BoundFun;
           
-          BoundFun functor0 = func::Apply<0>::bind<BoundFun> (unbound_functor0, tup0);
-          BoundFun functor1 = func::Apply<1>::bind<BoundFun> (unbound_functor1, tup1);
-          BoundFun functor2 = func::Apply<2>::bind<BoundFun> (unbound_functor2, tup3);
-          BoundFun functor3 = func::Apply<3>::bind<BoundFun> (unbound_functor3, tup3);
+          BoundFun functor0 = Apply<0>::bind<BoundFun> (unbound_functor0, tup0);
+          BoundFun functor1 = Apply<1>::bind<BoundFun> (unbound_functor1, tup1);
+          BoundFun functor2 = Apply<2>::bind<BoundFun> (unbound_functor2, tup3);
+          BoundFun functor3 = Apply<3>::bind<BoundFun> (unbound_functor3, tup3);
           
           ASSERT (-1       == functor0() );
           ASSERT (11       == functor1() );
@@ -319,15 +324,15 @@ namespace test {
           ASSERT (11+12    == clo2() );
           ASSERT (11+12+13 == clo3() );
           
-          ASSERT (-1       == func::closure(fun0,tup0) () );
-          ASSERT (11       == func::closure(fun1,tup1) () );
-          ASSERT (11+12    == func::closure(fun2,tup2) () );
-          ASSERT (11+12+13 == func::closure(fun3,tup3) () );
+          ASSERT (-1       == closure(fun0,tup0) () );
+          ASSERT (11       == closure(fun1,tup1) () );
+          ASSERT (11+12    == closure(fun2,tup2) () );
+          ASSERT (11+12+13 == closure(fun3,tup3) () );
           
-          ASSERT (-1       == func::closure(unbound_functor0,tup0) () );
-          ASSERT (11       == func::closure(unbound_functor1,tup1) () );
-          ASSERT (11+12    == func::closure(unbound_functor2,tup2) () );
-          ASSERT (11+12+13 == func::closure(unbound_functor3,tup3) () );
+          ASSERT (-1       == closure(unbound_functor0,tup0) () );
+          ASSERT (11       == closure(unbound_functor1,tup1) () );
+          ASSERT (11+12    == closure(unbound_functor2,tup2) () );
+          ASSERT (11+12+13 == closure(unbound_functor3,tup3) () );
           
           
           // finally combine all techniques....
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index a9e8d66ce..cfeb26539 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -28,35 +28,19 @@
 #include "lib/meta/function-closure.hpp"
 #include "meta/typelist-diagnostics.hpp"
 
-#include <iostream>
-
-using ::test::Test;
-using std::string;
-using std::cout;
-using std::endl;
-
 
 namespace lumiera {
 namespace typelist{
-namespace test {
+namespace test    {
   
+  using ::test::Test;
   using func::applyFirst;
   using func::applyLast;
+  using func::PApply;
   
   
       namespace { // test functions
         
-        
-        
-        typedef Types< Num<1>  ////////////////////////TODO kill kill kill
-                     , Num<2>
-                     , Num<3>
-                     >::List List1;
-        typedef Types< Num<5>
-                     , Num<6>
-                     , Num<7>
-                     >::List List2;
-        
         Num<1> _1_;                     
         Num<2> _2_;                     
         Num<3> _3_;                     

From b65658c10ddb2f9fb55230e4dc5bf030043cd380 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 00:22:16 +0200
Subject: [PATCH 162/368] try to fix a failing test (not really fixed yet)

---
 src/lib/meta/function-erasure.hpp        | 14 ++++++++++----
 tests/lib/meta/function-erasure-test.cpp |  9 +++++----
 2 files changed, 15 insertions(+), 8 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index f86de74b9..6d3729160 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -64,6 +64,7 @@ namespace lumiera {
 namespace typelist{
   
   using std::tr1::function;
+  using util::unConst;
   
   
   
@@ -100,8 +101,6 @@ namespace typelist{
    * Using this policy allows to store arbitrary complex functor objects
    * embedded within a neutral container and retrieving them later type-safe.
    * The price to pay is vtable access and heap storage of function arguments.
-   * 
-   * @note the bool conversion and #isValid are highly implementation dependent
    */
   class StoreFunction
     : public lib::BoolCheckable<StoreFunction>
@@ -112,6 +111,7 @@ namespace typelist{
           enum { SIZE = sizeof(function<void(void)>) };
           char storage_[SIZE];
           virtual ~Holder() {}
+          virtual bool isValid()  const { return false; }
         };
       
       /** embedding the concrete functor object */
@@ -129,6 +129,12 @@ namespace typelist{
             {
               get().~Functor();
             }
+          bool
+          isValid()  const
+            {
+              const Functor& func (unConst(this)->get());
+              return bool(func);
+            }
           Functor&
           get()
             {
@@ -161,9 +167,9 @@ namespace typelist{
         }
       
       bool
-      isValid()  const   ///< @note implementation dependent!!
+      isValid()  const
         {
-          return reinterpret_cast<void*> (holder_.storage_[0]);
+          return holder_.isValid();
         }
     };
   
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 43320c453..aadd03e14 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -47,9 +47,9 @@ namespace test {
   typedef FunErasure<StoreUncheckedFunPtr> Evoid;
   
   template<class HOL>
-  struct BuildEmptyHolder       { typedef long (*Type)(int,char); };
+  struct BuildEmptyFunctor       { typedef long (*Type)(int,char); };
   template<>
-  struct BuildEmptyHolder<Efun> { typedef function<long(int,char)> Type; };
+  struct BuildEmptyFunctor<Efun> { typedef function<long(int,char)> Type; };
   
   
   /***********************************************************************
@@ -210,8 +210,9 @@ namespace test {
         {
           // fabricate an unbound functor...
           
-          typedef typename BuildEmptyHolder<HOL>::Type EmptyHolder;
-          EmptyHolder emptyHolder;
+          typedef typename BuildEmptyFunctor<HOL>::Type NoFunc;
+          NoFunc noFunction;
+          HOL emptyHolder (noFunction);
           ASSERT (!emptyHolder);
           ASSERT ( h1 );
           ASSERT ( h2 );

From 98510cc943e285dcab7710883b47dac7a6c871d8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 00:24:55 +0200
Subject: [PATCH 163/368] rename and clean up some headers

---
 src/lib/allocationcluster.hpp                 |   2 +-
 .../{scopedholder.hpp => scoped-holder.hpp}   |   8 +-
 src/lib/scoped-ptrvect.hpp                    |   2 +-
 src/lib/scopedholdertransfer.hpp              |   2 +-
 tests/lib/Makefile.am                         |   2 +-
 tests/lib/allocationclustertest.cpp           |   2 +-
 tests/lib/scoped-holder-test.cpp              | 275 +++++++++++++++++
 tests/lib/scopedholdertest.cpp                | 277 ------------------
 tests/lib/scopedholdertransfertest.cpp        |   2 +-
 9 files changed, 285 insertions(+), 287 deletions(-)
 rename src/lib/{scopedholder.hpp => scoped-holder.hpp} (98%)
 create mode 100644 tests/lib/scoped-holder-test.cpp
 delete mode 100644 tests/lib/scopedholdertest.cpp

diff --git a/src/lib/allocationcluster.hpp b/src/lib/allocationcluster.hpp
index a9593316e..be99f7329 100644
--- a/src/lib/allocationcluster.hpp
+++ b/src/lib/allocationcluster.hpp
@@ -53,7 +53,7 @@
 
 #include "lib/error.hpp"
 #include "lib/sync-classlock.hpp"
-#include "lib/scopedholder.hpp"
+#include "lib/scoped-holder.hpp"
 #include "lib/scopedholdertransfer.hpp"
 
 
diff --git a/src/lib/scopedholder.hpp b/src/lib/scoped-holder.hpp
similarity index 98%
rename from src/lib/scopedholder.hpp
rename to src/lib/scoped-holder.hpp
index 042c78844..bb535be2e 100644
--- a/src/lib/scopedholder.hpp
+++ b/src/lib/scoped-holder.hpp
@@ -1,5 +1,5 @@
 /*
-  SCOPEDHOLDER.hpp  -  general purpose wrapper for dealing with ownership problems 
+  SCOPED-HOLDER.hpp  -  general purpose wrapper for dealing with ownership problems 
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -20,7 +20,7 @@
  
 */
 
-/** @file scopedholder.hpp
+/** @file scoped-holder.hpp
  ** Some wrappers for coping with ownership problems.
  ** Working with collections of objects, especially in conjunction with
  ** polymorphism, can be challenging when we are bound to care for lifecycle
@@ -46,7 +46,7 @@
  ** holder instances. This is the purpose of the \c transfer_control
  ** friend function.  
  ** 
- ** @see scopedholdertest.cpp
+ ** @see scoped-holder-test.cpp
  ** @see scopedholdertransfer.hpp use in std::vector
  ** @see AllocationCluster usage example
  ** @see scoped-ptrvect.hpp simple pointer-holding collection
@@ -246,7 +246,7 @@ namespace lib {
           }
       }
     };
-
+  
   
   
   
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index af48dac45..0dc509e8d 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -35,7 +35,7 @@
  ** - TODO: retro-fit with refarray interface (--> builder branch)
  ** 
  ** @see scoped-ptrvect-test.cpp
- ** @see scopedholder.hpp
+ ** @see scoped-holder.hpp
  ** @see gui::DisplayService usage example
  */
 
diff --git a/src/lib/scopedholdertransfer.hpp b/src/lib/scopedholdertransfer.hpp
index c4e4e66e9..3d600e61a 100644
--- a/src/lib/scopedholdertransfer.hpp
+++ b/src/lib/scopedholdertransfer.hpp
@@ -35,7 +35,7 @@ namespace lib {
   
   
   /**
-   * Addendum to scopedholder.hpp for transferring the lifecycle
+   * Addendum to scoped-holder.hpp for transferring the lifecycle
    * management to another instance. Using these wrappers within
    * STL vector and similar containers may result in the need to
    * do a re-allocation in response to a request to grow.
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index f895638ce..ad0844463 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -59,7 +59,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/query/queryutilstest.cpp		\
 	$(testlib_srcdir)/removefromsettest.cpp			\
 	$(testlib_srcdir)/sanitizedidentifiertest.cpp		\
-	$(testlib_srcdir)/scopedholdertest.cpp			\
+	$(testlib_srcdir)/scoped-holder-test.cpp			\
 	$(testlib_srcdir)/scopedholdertransfertest.cpp		\
 	$(testlib_srcdir)/scoped-ptrvect-test.cpp		\
 	$(testlib_srcdir)/singletonsubclasstest.cpp		\
diff --git a/tests/lib/allocationclustertest.cpp b/tests/lib/allocationclustertest.cpp
index c818ad63e..1badb8ac9 100644
--- a/tests/lib/allocationclustertest.cpp
+++ b/tests/lib/allocationclustertest.cpp
@@ -26,7 +26,7 @@
 #include "lib/util.hpp"
 
 #include "lib/allocationcluster.hpp"
-#include "lib/scopedholder.hpp"
+#include "lib/scoped-holder.hpp"
 
 #include <vector>
 #include <limits>
diff --git a/tests/lib/scoped-holder-test.cpp b/tests/lib/scoped-holder-test.cpp
new file mode 100644
index 000000000..62011d193
--- /dev/null
+++ b/tests/lib/scoped-holder-test.cpp
@@ -0,0 +1,275 @@
+/*
+  ScopedHolder(Test)  -  holding and owning noncopyable objects
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+
+#include "lib/scoped-holder.hpp"
+#include "testdummy.hpp"
+
+#include <boost/noncopyable.hpp>
+#include <iostream>
+#include <map>
+
+
+namespace lib {
+namespace test{
+  
+  using ::Test;
+  using util::isnil;
+  
+  using std::map;
+  using std::cout;
+  
+  typedef ScopedHolder<Dummy>    HolderD;
+  typedef ScopedPtrHolder<Dummy> PtrHolderD;
+  
+  
+  /**********************************************************************************
+   *  @test ScopedHolder and ScopedPtrHolder are initially empty and copyable. 
+   *        After taking ownership, they prohibit copy operations, manage the
+   *        lifecycle of the contained object and provide smart-ptr like access.
+   *        A series of identical tests is conducted both with the ScopedPtrHolder
+   *        (the contained objects are heap allocated but managed by the holder)
+   *        and with the ScopedHolder (objects placed inline)
+   */
+  class ScopedHolder_test : public Test
+    {
+      
+      virtual void
+      run (Arg)
+        {
+          
+          cout << "checking ScopedHolder<Dummy>...\n";
+          checkAllocation<HolderD>();
+          checkErrorHandling<HolderD>();
+          checkCopyProtocol<HolderD>();
+          checkSTLContainer<HolderD>();
+          
+          cout << "checking ScopedPtrHolder<Dummy>...\n";
+          checkAllocation<PtrHolderD>();
+          checkErrorHandling<PtrHolderD>();
+          checkCopyProtocol<PtrHolderD>();
+          checkSTLContainer<PtrHolderD>();
+        }
+      
+      void create_contained_object (HolderD&    holder) { holder.create();           }
+      void create_contained_object (PtrHolderD& holder) { holder.reset(new Dummy()); }
+      
+      
+      template<class HO>
+      void
+      checkAllocation()
+        {
+          ASSERT (0==checksum);
+          {
+            HO holder;
+            ASSERT (!holder);
+            ASSERT (0==checksum);
+            
+            create_contained_object (holder);
+            ASSERT (holder);
+            ASSERT (false!=holder);
+            ASSERT (holder!=false);
+            
+            ASSERT (0!=checksum);
+            ASSERT ( &(*holder));
+            ASSERT (holder->add(2) == checksum+2);
+            
+            Dummy *rawP = holder.get();
+            ASSERT (rawP);
+            ASSERT (holder);
+            ASSERT (rawP == &(*holder));
+            ASSERT (rawP->add(-5) == holder->add(-5));
+            
+            TRACE (test, "holder at %x", &holder);
+            TRACE (test, "object at %x", holder.get() );
+            TRACE (test, "size(object) = %d", sizeof(*holder));
+            TRACE (test, "size(holder) = %d", sizeof(holder));
+          }
+          ASSERT (0==checksum);
+        }
+      
+      
+      template<class HO>
+      void
+      checkErrorHandling()
+        {
+          ASSERT (0==checksum);
+          {
+            HO holder;
+            
+            throw_in_ctor = true;
+            try
+              {
+                create_contained_object (holder);
+                NOTREACHED ;
+              }
+            catch (int val)
+              {
+                ASSERT (0!=checksum);
+                checksum -= val;
+                ASSERT (0==checksum);
+              }
+            ASSERT (!holder); /* because the exception happens in ctor
+                                 object doesn't count as "created" */
+            throw_in_ctor = false;
+          }
+          ASSERT (0==checksum);
+        }
+      
+      
+      template<class HO>
+      void
+      checkCopyProtocol()
+        {
+          ASSERT (0==checksum);
+          {
+            HO holder;
+            HO holder2 (holder);
+            holder2 = holder;
+            // copy and assignment of empty holders is tolerated
+            
+            // but after enclosing an object it will be copy protected...
+            ASSERT (!holder);
+            create_contained_object (holder);
+            ASSERT (holder);
+            long currSum = checksum;
+            void* adr = holder.get();
+            try
+              {
+                holder2 = holder;
+                NOTREACHED ;
+              }
+            catch (lumiera::error::Logic&)
+              {
+                ASSERT (holder);
+                ASSERT (!holder2);
+                ASSERT (holder.get()==adr);
+                ASSERT (checksum==currSum);
+              }
+            
+            try
+              {
+                holder = holder2;
+                NOTREACHED ;
+              }
+            catch (lumiera::error::Logic&)
+              {
+                ASSERT (holder);
+                ASSERT (!holder2);
+                ASSERT (holder.get()==adr);
+                ASSERT (checksum==currSum);
+              }
+            
+            create_contained_object (holder2);
+            ASSERT (holder2);
+            ASSERT (checksum != currSum);
+            currSum = checksum;
+            try
+              {
+                holder = holder2;
+                NOTREACHED ;
+              }
+            catch (lumiera::error::Logic&)
+              {
+                ASSERT (holder);
+                ASSERT (holder2);
+                ASSERT (holder.get()==adr);
+                ASSERT (checksum==currSum);
+              }
+            
+            try
+              {
+                HO holder3 (holder2);
+                NOTREACHED ;
+              }
+            catch (lumiera::error::Logic&)
+              {
+                ASSERT (holder);
+                ASSERT (holder2);
+                ASSERT (checksum==currSum);
+              }
+          }
+          ASSERT (0==checksum);
+        }
+      
+      
+      /** @test collection of noncopyable objects
+       *        maintained within a STL map
+       */
+      template<class HO>
+      void
+      checkSTLContainer()
+        {
+          typedef std::map<int,HO> MapHO;
+          
+          ASSERT (0==checksum);
+          {
+            MapHO maph;
+            ASSERT (isnil (maph));
+            
+            for (uint i=0; i<100; ++i)
+              {
+                HO & contained = maph[i];
+                ASSERT (!contained);
+              }                      // 100 holder objects created by sideeffect
+                                    
+            ASSERT (0==checksum);  // ..... without creating any contained object!
+            ASSERT (!isnil (maph));
+            ASSERT (100==maph.size());
+            
+            for (uint i=0; i<100; ++i)
+              {
+                create_contained_object (maph[i]);
+                ASSERT (maph[i]);
+                ASSERT (0 < maph[i]->add(12));
+              }
+            ASSERT (100==maph.size());
+            ASSERT (0!=checksum);
+            
+            
+            long value55 = maph[55]->add(0); 
+            long currSum = checksum;
+            
+            ASSERT (1 == maph.erase(55));
+            ASSERT (checksum == currSum - value55); // proves object#55's dtor has been invoked
+            ASSERT (maph.size() == 99);
+            
+            maph[55];                            // create new empty holder by sideeffect...
+            ASSERT (&maph[55]);
+            ASSERT (!maph[55]);
+            ASSERT (maph.size() == 100);
+          }
+          ASSERT (0==checksum);
+        }
+      
+      
+    };
+  
+  LAUNCHER (ScopedHolder_test, "unit common");
+  
+  
+}} // namespace lib::test
+
diff --git a/tests/lib/scopedholdertest.cpp b/tests/lib/scopedholdertest.cpp
deleted file mode 100644
index 778cc2e4f..000000000
--- a/tests/lib/scopedholdertest.cpp
+++ /dev/null
@@ -1,277 +0,0 @@
-/*
-  ScopedHolder(Test)  -  holding and owning noncopyable objects
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-
-#include "lib/test/run.hpp"
-#include "lib/util.hpp"
-
-#include "lib/scopedholder.hpp"
-#include "testdummy.hpp"
-
-#include <boost/noncopyable.hpp>
-#include <iostream>
-#include <map>
-
-
-namespace lib {
-  namespace test {
-    
-    using ::Test;
-    using util::isnil;
-    
-    using std::map;
-    using std::cout;
-      
-    typedef ScopedHolder<Dummy>    HolderD;
-    typedef ScopedPtrHolder<Dummy> PtrHolderD;
-    
-    
-    /**********************************************************************************
-     *  @test ScopedHolder and ScopedPtrHolder are initially empty and copyable. 
-     *        After taking ownership, they prohibit copy operations, manage the
-     *        lifecycle of the contained object and provide smart-ptr like access.
-     *        A series of identical tests is conducted both with the ScopedPtrHolder
-     *        (the contained objects are heap allocated but managed by the holder)
-     *        and with the ScopedHolder (objects placed inline)
-     */
-    class ScopedHolder_test : public Test
-      {
-        
-        virtual void 
-        run (Arg)
-          {
-            
-            cout << "checking ScopedHolder<Dummy>...\n";
-            checkAllocation<HolderD>();
-            checkErrorHandling<HolderD>();
-            checkCopyProtocol<HolderD>();
-            checkSTLContainer<HolderD>();
-            
-            cout << "checking ScopedPtrHolder<Dummy>...\n";
-            checkAllocation<PtrHolderD>();
-            checkErrorHandling<PtrHolderD>();
-            checkCopyProtocol<PtrHolderD>();
-            checkSTLContainer<PtrHolderD>();
-          }
-        
-        void create_contained_object (HolderD&    holder) { holder.create();           }
-        void create_contained_object (PtrHolderD& holder) { holder.reset(new Dummy()); }
-        
-        
-        template<class HO>
-        void
-        checkAllocation()
-          {
-            ASSERT (0==checksum);
-            {
-              HO holder;
-              ASSERT (!holder);
-              ASSERT (0==checksum);
-              
-              create_contained_object (holder);
-              ASSERT (holder);
-              ASSERT (false!=holder);
-              ASSERT (holder!=false);
-              
-              ASSERT (0!=checksum);
-              ASSERT ( &(*holder));
-              ASSERT (holder->add(2) == checksum+2);
-              
-              Dummy *rawP = holder.get();
-              ASSERT (rawP);
-              ASSERT (holder);
-              ASSERT (rawP == &(*holder));
-              ASSERT (rawP->add(-5) == holder->add(-5));
-              
-              TRACE (test, "holder at %x", &holder);
-              TRACE (test, "object at %x", holder.get() );
-              TRACE (test, "size(object) = %d", sizeof(*holder));
-              TRACE (test, "size(holder) = %d", sizeof(holder));
-            }
-            ASSERT (0==checksum);
-          }
-        
-        
-        template<class HO>
-        void
-        checkErrorHandling()
-          {
-            ASSERT (0==checksum);
-            {
-              HO holder;
-              
-              throw_in_ctor = true;
-              try
-                {
-                  create_contained_object (holder);
-                  NOTREACHED ;
-                }
-              catch (int val)
-                {
-                  ASSERT (0!=checksum);
-                  checksum -= val;
-                  ASSERT (0==checksum);
-                }
-              ASSERT (!holder); /* because the exception happens in ctor
-                                   object doesn't count as "created" */
-              throw_in_ctor = false;
-            }
-            ASSERT (0==checksum);
-          }
-        
-        
-        template<class HO>
-        void
-        checkCopyProtocol()
-          {
-            ASSERT (0==checksum);
-            {
-              HO holder;
-              HO holder2 (holder);
-              holder2 = holder;
-              // copy and assignment of empty holders is tolerated
-              
-              // but after enclosing an object it will be copy protected...
-              ASSERT (!holder);
-              create_contained_object (holder);
-              ASSERT (holder);
-              long currSum = checksum;
-              void* adr = holder.get();
-              try
-                {
-                  holder2 = holder;
-                  NOTREACHED ;
-                }
-              catch (lumiera::error::Logic&)
-                {
-                  ASSERT (holder);
-                  ASSERT (!holder2);
-                  ASSERT (holder.get()==adr);
-                  ASSERT (checksum==currSum);
-                }
-              
-              try
-                {
-                  holder = holder2;
-                  NOTREACHED ;
-                }
-              catch (lumiera::error::Logic&)
-                {
-                  ASSERT (holder);
-                  ASSERT (!holder2);
-                  ASSERT (holder.get()==adr);
-                  ASSERT (checksum==currSum);
-                }
-              
-              create_contained_object (holder2);
-              ASSERT (holder2);
-              ASSERT (checksum != currSum);
-              currSum = checksum;
-              try
-                {
-                  holder = holder2;
-                  NOTREACHED ;
-                }
-              catch (lumiera::error::Logic&)
-                {
-                  ASSERT (holder);
-                  ASSERT (holder2);
-                  ASSERT (holder.get()==adr);
-                  ASSERT (checksum==currSum);
-                }
-              
-              try
-                {
-                  HO holder3 (holder2);
-                  NOTREACHED ;
-                }
-              catch (lumiera::error::Logic&)
-                {
-                  ASSERT (holder);
-                  ASSERT (holder2);
-                  ASSERT (checksum==currSum);
-                }
-            }
-            ASSERT (0==checksum);
-          }
-        
-        
-        /** @test collection of noncopyable objects
-         *        maintained within a STL map
-         */
-        template<class HO>
-        void
-        checkSTLContainer()
-          {
-            typedef std::map<int,HO> MapHO;
-            
-            ASSERT (0==checksum);
-            {
-              MapHO maph;
-              ASSERT (isnil (maph));
-              
-              for (uint i=0; i<100; ++i)
-                {
-                  HO & contained = maph[i];
-                  ASSERT (!contained);
-                }                      // 100 holder objects created by sideeffect
-                                      
-              ASSERT (0==checksum);  // ..... without creating any contained object!
-              ASSERT (!isnil (maph));
-              ASSERT (100==maph.size());
-              
-              for (uint i=0; i<100; ++i)
-                {
-                  create_contained_object (maph[i]);
-                  ASSERT (maph[i]);
-                  ASSERT (0 < maph[i]->add(12));
-                }
-              ASSERT (100==maph.size());
-              ASSERT (0!=checksum);
-              
-              
-              long value55 = maph[55]->add(0); 
-              long currSum = checksum;
-              
-              ASSERT (1 == maph.erase(55));
-              ASSERT (checksum == currSum - value55); // proves object#55's dtor has been invoked
-              ASSERT (maph.size() == 99);
-              
-              maph[55];                            // create new empty holder by sideeffect...
-              ASSERT (&maph[55]);
-              ASSERT (!maph[55]);
-              ASSERT (maph.size() == 100);
-            }
-            ASSERT (0==checksum);
-          }
-        
-        
-      };
-    
-    LAUNCHER (ScopedHolder_test, "unit common");
-    
-    
-  }// namespace test
-
-} // namespace lib
-
diff --git a/tests/lib/scopedholdertransfertest.cpp b/tests/lib/scopedholdertransfertest.cpp
index abbd3a959..274a4b31f 100644
--- a/tests/lib/scopedholdertransfertest.cpp
+++ b/tests/lib/scopedholdertransfertest.cpp
@@ -25,7 +25,7 @@
 #include "lib/test/run.hpp"
 #include "lib/util.hpp"
 
-#include "lib/scopedholder.hpp"
+#include "lib/scoped-holder.hpp"
 #include "lib/scopedholdertransfer.hpp"
 #include "testdummy.hpp"
 

From c48f9086b7e2d074a2be64106f8d0fb09ea059e6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 02:43:49 +0200
Subject: [PATCH 164/368] extract util: isSameObject (bare ptr comparison)

---
 src/lib/util.hpp                                    | 13 +++++++++++++
 .../components/proc/mobject/placement-ref-test.cpp  | 11 ++---------
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index 40845283f..1893dda10 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -201,6 +201,19 @@ namespace util {
   }
   
   
+  /** compare plain object identity,
+   *  bypassing any custom comparison operators.
+   */
+  template<class A, class B>
+  inline bool
+  isSameObject (A const& a, B const& b)
+  {
+    return static_cast<const void*> (&a)
+        == static_cast<const void*> (&b);
+  }
+  
+  
+  
   
   /** produce an identifier based on the given string.
    *  remove non-standard-chars, reduce sequences of punctuation 
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index 5883b47f1..b8e4a5001 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -28,9 +28,11 @@
 #include "proc/mobject/placement-index.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/test-dummy-mobject.hpp"
+#include "lib/util.hpp"
 
 #include <iostream>
 
+using util::isSameObject;
 using lumiera::Time;
 using std::string;
 using std::cout;
@@ -45,15 +47,6 @@ namespace test    {
   typedef TestPlacement<TestSubMO21> PSub;
   
   
-  template<class A, class B>
-  inline bool
-  isSameObject (A const& a, B const& b)
-  {
-    return static_cast<const void*> (&a)
-        == static_cast<const void*> (&b);
-  }
-  
-  
   /***************************************************************************
    * @test properties and behaviour of the reference-mechanism for Placements.
    *       We create an mock placement index and install it to be used

From 3cc49d0f68707afbafa80f3baffab4f036a4c63c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 03:32:15 +0200
Subject: [PATCH 165/368] need to factor out a special holder class to solve
 the problem with the empty check

---
 src/lib/error.hpp          |   3 +
 src/lib/exception.cpp      |   3 +
 src/lib/opaque-holder.hpp  | 157 +++++++++++++++++++++++++++++++++++++
 src/lib/scoped-holder.hpp  |   4 +-
 src/proc/asset/unknown.cpp |   2 +-
 5 files changed, 166 insertions(+), 3 deletions(-)
 create mode 100644 src/lib/opaque-holder.hpp

diff --git a/src/lib/error.hpp b/src/lib/error.hpp
index 2dd654037..2c5a14d72 100644
--- a/src/lib/error.hpp
+++ b/src/lib/error.hpp
@@ -121,6 +121,9 @@ namespace lumiera {
     LUMIERA_ERROR_DECLARE (EXTERNAL );    ///< failure in external service the application relies on
     LUMIERA_ERROR_DECLARE (ASSERTION);    ///< assertion failure
     
+    /* generic error situations */
+    LUMIERA_ERROR_DECLARE (WRONG_TYPE);   ///< runtime type mismatch 
+    
 /** Macro for creating derived exception classes properly 
  *  integrated into Lumiera's exception hierarchy. Using
  *  this macro assures that the new class will get the full
diff --git a/src/lib/exception.cpp b/src/lib/exception.cpp
index 091319110..82b4a93f1 100644
--- a/src/lib/exception.cpp
+++ b/src/lib/exception.cpp
@@ -64,6 +64,9 @@ namespace lumiera {
     LUMIERA_ERROR_DEFINE (EXTERNAL , "failure in external service"); 
     LUMIERA_ERROR_DEFINE (ASSERTION, "assertion failure");
 
+    /* some further generic error situations */
+    LUMIERA_ERROR_DEFINE (WRONG_TYPE, "runtime type mismatch"); 
+    
   } // namespace error
   
   LUMIERA_ERROR_DEFINE (EXCEPTION, "generic Lumiera exception"); 
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
new file mode 100644
index 000000000..e64b81c41
--- /dev/null
+++ b/src/lib/opaque-holder.hpp
@@ -0,0 +1,157 @@
+/*
+  OPAQUE-HOLDER.hpp  -  buffer holding an object inline while hiding the concrete type 
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file opaque-holder.hpp
+ ** Helper allowing type erasure while holding the actual object inline.
+ ** Controlling the actual storage of objects usually binds us to commit
+ ** to a specific type, thus ruling out polymorphism. But sometimes, when
+ ** we are able to control the maximum storage for a family of classes, we
+ ** can escape this dilemma by using the type erasure pattern combined with
+ ** an inline buffer holding the object of the concrete subclass. Frequently
+ ** this situation arises when dealing with functor objects.
+ ** 
+ ** This template helps building custom objects and wrappers based on this
+ ** pattern: it provides an buffer for the target objects and controls access
+ ** through a two-layer capsule; while the outer container provides a neutral
+ ** interface, the inner container keeps track of the actual type using a
+ ** vtable. OpaqueHolder can be empty; but re-accessing the concrete
+ ** object requires knowledge of the actual type, similar to boost::any
+ ** (but the latter uses heap storage). 
+ ** 
+ ** Using this approach is bound by specific stipulations regarding the
+ ** properties of the contained object and the kind of access needed.
+ ** When, to the contrary, the contained types are \em not related
+ ** and you need to re-discover their concrete type, then maybe
+ ** a visitor or variant record might be a better solution.
+ ** 
+ ** @see opaque-holder-test.cpp
+ ** @see function-erasure.hpp usage example
+ ** @see variant.hpp 
+ */
+
+
+#ifndef LIB_OPAQUE_HOLDER_H
+#define LIB_OPAQUE_HOLDER_H
+
+
+#include "lib/error.hpp"
+#include "lib/bool-checkable.hpp"
+
+
+
+namespace lib {
+  
+  using lumiera::error::LUMIERA_ERROR_WRONG_TYPE;
+  
+  
+  /**
+   * Inline buffer holding and owning an object while concealing the
+   * concrete type. Access to the contained object is similar to a
+   * smart-pointer, but the object isn't heap allocated. OpaqueHolder
+   * may be created empty, which can be checked by a bool test.
+   * The whole compound is copyable if and only if the contained object
+   * is copyable.
+   */
+  template
+    < class BA
+    , size_t siz = sizeof(BA) 
+    >
+  class OpaqueHolder
+    : public BoolCheckable<OpaqueHolder<BA,siz> >
+    {
+      char content_[siz];
+      
+      typedef OpaqueHolder<BA,siz> _ThisType;
+      
+      
+      
+    public:
+      OpaqueHolder()
+//      : created_(0)
+        { }
+      
+      template<class SUB>
+      OpaqueHolder(SUB const& obj)
+//      : created_(0)
+        { }
+      
+      ~OpaqueHolder() { clear(); }
+      
+      
+      void
+      clear ()
+        {
+          UNIMPLEMENTED ("delete contained object, if any");
+        }
+      
+      
+      OpaqueHolder (OpaqueHolder const& ref)
+//      : created_(must_be_empty (ref))
+        { }
+      
+      OpaqueHolder&
+      operator= (OpaqueHolder const& ref)
+        {
+          UNIMPLEMENTED ("copy operation");
+          return *this;
+        }
+        
+      
+      BA&
+      operator* ()  const  // never throws
+        {
+          ASSERT (!empty());
+          return (BA&) content_;
+        }
+      
+      BA* 
+      operator-> ()  const // never throws
+        {
+          ASSERT (!empty());
+          return (BA*) &content_;
+        }
+      
+      template<class SUB>
+      SUB& get()  const
+        {
+          UNIMPLEMENTED ("downcast to concrete type");
+//          return (SUB*) &content_; 
+        }
+      
+      bool empty() const
+        {
+          UNIMPLEMENTED ("check for empty container");
+        }
+      
+      bool isValid() const
+        {
+          UNIMPLEMENTED ("empty check and forward to contained object");
+        }
+      
+      
+    };
+  
+  
+  
+  
+} // namespace lib
+#endif
diff --git a/src/lib/scoped-holder.hpp b/src/lib/scoped-holder.hpp
index bb535be2e..95c0909a6 100644
--- a/src/lib/scoped-holder.hpp
+++ b/src/lib/scoped-holder.hpp
@@ -53,8 +53,8 @@
  */
 
 
-#ifndef LIB_SCOPEDHOLDER_H
-#define LIB_SCOPEDHOLDER_H
+#ifndef LIB_SCOPED_HOLDER_H
+#define LIB_SCOPED_HOLDER_H
 
 #include <boost/scoped_ptr.hpp>
 
diff --git a/src/proc/asset/unknown.cpp b/src/proc/asset/unknown.cpp
index b47a60113..e1b50cae7 100644
--- a/src/proc/asset/unknown.cpp
+++ b/src/proc/asset/unknown.cpp
@@ -60,7 +60,7 @@ namespace asset
                                     );
   }
   
-  LUMIERA_ERROR_DEFINE (ORIG_NOT_FOUND, "Media refered by placeholder not found");
+  LUMIERA_ERROR_DEFINE (ORIG_NOT_FOUND, "Media referred by placeholder not found");
 
   
   

From ec2e4e36ea540dd3a1457af5430e173dde329fca Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 03:33:15 +0200
Subject: [PATCH 166/368] define required properties through unit test

---
 tests/40components.tests         |   5 +
 tests/lib/Makefile.am            |   3 +-
 tests/lib/opaque-holder-test.cpp | 225 +++++++++++++++++++++++++++++++
 tests/lib/testdummy.hpp          |  82 ++++++-----
 4 files changed, 272 insertions(+), 43 deletions(-)
 create mode 100644 tests/lib/opaque-holder-test.cpp

diff --git a/tests/40components.tests b/tests/40components.tests
index a04bcd63c..109611c46 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -271,6 +271,11 @@ return: 0
 END
 
 
+TEST "inline type erasure" OpaqueHolder_test  <<END
+return: 0
+END
+
+
 TEST "RemoveFromSet_test" RemoveFromSet_test <<END
 out: removed  nothing  ---> \[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
 out: removed 0 ---> \[ 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index ad0844463..bba91c3ea 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -59,7 +59,8 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/query/queryutilstest.cpp		\
 	$(testlib_srcdir)/removefromsettest.cpp			\
 	$(testlib_srcdir)/sanitizedidentifiertest.cpp		\
-	$(testlib_srcdir)/scoped-holder-test.cpp			\
+	$(testlib_srcdir)/opaque-holder-test.cpp		\
+	$(testlib_srcdir)/scoped-holder-test.cpp		\
 	$(testlib_srcdir)/scopedholdertransfertest.cpp		\
 	$(testlib_srcdir)/scoped-ptrvect-test.cpp		\
 	$(testlib_srcdir)/singletonsubclasstest.cpp		\
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
new file mode 100644
index 000000000..4c589ff7b
--- /dev/null
+++ b/tests/lib/opaque-holder-test.cpp
@@ -0,0 +1,225 @@
+/*
+  OpaqueHolder(Test)  -  check the inline type erasure helper
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+#include "lib/util.hpp"
+
+#include "lib/opaque-holder.hpp"
+#include "lib/bool-checkable.hpp"
+
+#include <iostream>
+#include <vector>
+
+
+namespace lib {
+namespace test{
+  
+  using ::Test;
+  using util::isnil;
+  using util::for_each;
+  using util::isSameObject;
+  
+  using std::vector;
+  using std::cout;
+  using std::endl;
+  
+  namespace { // test dummy hierarchy
+             //  Note: no vtable and common storage
+    
+    long _checksum = 0;
+    
+    
+    struct Base   
+      {
+        uint id_;
+        
+        Base(uint i=0) : id_(i) { _checksum +=id_; }
+        
+        uint getIt() { return id_; }
+      };
+    
+    template<uint ii>
+    struct DD : Base
+      {
+        DD() : Base(ii)       { }
+       ~DD() { _checksum -= ii; }
+      };
+    
+    
+    struct Special
+      : DD<7>
+      , BoolCheckable<Special>
+      {
+        uint myVal_;
+        
+        Special (uint val)
+          : myVal_(val)
+          { }
+        
+        bool
+        isValid ()  const
+          {
+            return myVal_ % 2;
+          }
+      };
+          
+    
+  }
+  
+  typedef OpaqueHolder<Base> Opaque;
+  typedef vector<Opaque> TestList;
+  
+  /**********************************************************************************
+   *  @test use the OpaqueHolder inline buffer to handle a family of classes
+   *        through a common interface, without being forced to use heap storage
+   *        or a custom allocator.
+   */
+  class OpaqueHolder_test : public Test
+    {
+      
+      virtual void
+      run (Arg)
+        {
+          _checksum = 0;
+          {
+            TestList objs = createDummies ();
+            for_each (objs, reAccess);
+            checkHandling (objs);
+            checkSpecialSubclass ();
+          }
+          ASSERT (0 == _checksum); // all dead
+        }
+      
+      
+      TestList
+      createDummies ()
+        {
+          TestList list;
+          list.push_back (DD<1>());
+          list.push_back (DD<3>());
+          list.push_back (DD<5>());
+          list.push_back (DD<7>());
+          return list;
+        }
+      
+      
+      static void
+      reAccess (Opaque& elm)
+        {
+          cout << elm->getIt() << endl;
+        }
+      
+      
+      void
+      checkHandling (TestList& objs)
+        {
+          Opaque oo;
+          ASSERT (!oo);
+          ASSERT (isnil(oo));
+          
+          oo = objs[1];
+          ASSERT (oo);
+          ASSERT (!isnil(oo));
+          
+          typedef DD<3> D3;
+          typedef DD<5> D5;
+          D3 d3 (oo.get<D3>() );
+          ASSERT (3 == oo->getIt());
+          ASSERT (isSameObject (d3, *oo));
+          VERIFY_ERROR (WRONG_TYPE, oo.get<D5>() );
+          
+          oo = D5();
+          ASSERT (oo);
+          ASSERT (5 == oo->getIt());
+          VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
+          
+          oo.clear();
+          ASSERT (!oo);
+          ASSERT (isnil(oo));
+          
+          Opaque o1 (oo);
+          ASSERT (!o1);
+          
+          Opaque o2 (d3);
+          ASSERT (!isSameObject (d3, *oo));
+          ASSERT (3 == oo->getIt());
+          
+          ASSERT (sizeof(Opaque) == sizeof(Base) + sizeof(void*));
+        }
+      
+      
+      void
+      checkSpecialSubclass ()
+        {
+          // define a "special" OpaqueHolder with enough storage to hold a Special 
+          typedef OpaqueHolder<Base, sizeof(Special)> SpecialOpaque;
+          
+          ASSERT (sizeof(Special) > sizeof(Base));
+          ASSERT (sizeof(SpecialOpaque) > sizeof(Opaque));
+          ASSERT (sizeof(SpecialOpaque) == sizeof(Special) + sizeof(void*));
+          
+          Special s1 (6);
+          Special s2 (3);
+          ASSERT (!s1);               // even value
+          ASSERT (s2);                // odd value
+          ASSERT (7 == s1.getIt());   // indeed subclass of DD<7>
+          ASSERT (7 == s2.getIt());
+          
+          SpecialOpaque ospe0;
+          SpecialOpaque ospe1 (s1);
+          SpecialOpaque ospe2 (s2);
+          
+          ASSERT (!ospe0);            // note: bool test (isValid)
+          ASSERT (!ospe1);            // also forwarded to contained object (myVal_==6 is even)
+          ASSERT ( ospe2);
+          ASSERT ( isnil(ospe0));     // while isnil just checks the empty state
+          ASSERT (!isnil(ospe1));
+          ASSERT (!isnil(ospe2));
+          
+          ASSERT (7 == ospe1->getIt());
+          ASSERT (5 == ospe1.get<Special>().myVal_);
+          ASSERT (6 == ospe2.get<Special>().myVal_);
+          
+          ospe1 = DD<5>();            // but can be reassigned like any normal Opaque
+          ASSERT (ospe1);
+          ASSERT (5 == ospe1->getIt());
+          VERIFY_ERROR (WRONG_TYPE, ospe1.get<Special>() );
+          
+          Opaque normal = DD<5>();
+          ASSERT (normal);
+          ASSERT (5 == normal->getIt());
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          // Assertion protects against SEGV
+          VERIFY_ERROR (ASSERTION, normal = s1 );
+#endif////////////////////////////////////////////////////////////
+        }
+    };
+  
+  
+  LAUNCHER (OpaqueHolder_test, "unit common");
+  
+  
+}} // namespace lib::test
+
diff --git a/tests/lib/testdummy.hpp b/tests/lib/testdummy.hpp
index 7bfffb4bc..99a5ee3c1 100644
--- a/tests/lib/testdummy.hpp
+++ b/tests/lib/testdummy.hpp
@@ -26,48 +26,46 @@
 
 
 namespace lib {
-  namespace test {
+namespace test{
     
-    namespace { // yet another test dummy
-      
-      long checksum = 0;
-      bool throw_in_ctor = false;
-      
-      class Dummy 
-        : boost::noncopyable
-        {
-          int val_;
-          
-        public:
-          Dummy ()
-            : val_(1 + (rand() % 100000000))
-            {
-              checksum += val_;
-              if (throw_in_ctor)
-                throw val_;
-            }
-          
-          ~Dummy()
-            {
-              checksum -= val_;
-            }
-          
-          long add (int i)  { return val_+i; }
-          
-        protected:
-          int getVal()  const { return val_; }
-          
-          void
-          setVal (int newVal)
-            {
-              checksum += newVal - val_;
-              val_ = newVal;
-            }
-        };
+  namespace { // yet another test dummy
+    
+    long checksum = 0;
+    bool throw_in_ctor = false;
+    
+    class Dummy 
+      : boost::noncopyable
+      {
+        int val_;
         
-    }// anonymous test dummy 
-    
-  }// namespace test
-
-} // namespace lib
+      public:
+        Dummy ()
+          : val_(1 + (rand() % 100000000))
+          {
+            checksum += val_;
+            if (throw_in_ctor)
+              throw val_;
+          }
+        
+        ~Dummy()
+          {
+            checksum -= val_;
+          }
+        
+        long add (int i)  { return val_+i; }
+        
+      protected:
+        int getVal()  const { return val_; }
+        
+        void
+        setVal (int newVal)
+          {
+            checksum += newVal - val_;
+            val_ = newVal;
+          }
+      };
+      
+  }  // anonymous test dummy
+  
+}} // namespace lib::test
 

From 077d3d176eaf2fc1dba07b77d9d85a15ece079a3 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 04:35:17 +0200
Subject: [PATCH 167/368] WIP implementation draft

---
 src/lib/opaque-holder.hpp        | 115 +++++++++++++++++++++++++++----
 tests/lib/opaque-holder-test.cpp |  16 +++++
 2 files changed, 117 insertions(+), 14 deletions(-)

diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index e64b81c41..c5e732d07 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -26,18 +26,18 @@
  ** to a specific type, thus ruling out polymorphism. But sometimes, when
  ** we are able to control the maximum storage for a family of classes, we
  ** can escape this dilemma by using the type erasure pattern combined with
- ** an inline buffer holding the object of the concrete subclass. Frequently
+ ** an inline buffer holding an object of the concrete subclass. Typically,
  ** this situation arises when dealing with functor objects.
  ** 
  ** This template helps building custom objects and wrappers based on this
  ** pattern: it provides an buffer for the target objects and controls access
- ** through a two-layer capsule; while the outer container provides a neutral
- ** interface, the inner container keeps track of the actual type using a
- ** vtable. OpaqueHolder can be empty; but re-accessing the concrete
+ ** through a two-layer capsule; while the outer container exposes a neutral
+ ** interface, the inner container keeps track of the actual type by means
+ ** of a vtable. OpaqueHolder can be empty; but re-accessing the concrete
  ** object requires knowledge of the actual type, similar to boost::any
  ** (but the latter uses heap storage). 
  ** 
- ** Using this approach is bound by specific stipulations regarding the
+ ** Using this approach is bound to specific stipulations regarding the
  ** properties of the contained object and the kind of access needed.
  ** When, to the contrary, the contained types are \em not related
  ** and you need to re-discover their concrete type, then maybe
@@ -78,21 +78,106 @@ namespace lib {
   class OpaqueHolder
     : public BoolCheckable<OpaqueHolder<BA,siz> >
     {
-      char content_[siz];
       
-      typedef OpaqueHolder<BA,siz> _ThisType;
+      /** Inner capsule managing the contained object (interface) */
+      struct Buffer
+        {
+          char content_[siz];
+          virtual ~Buffer() {}
+          virtual bool isValid()  const { return false; }
+          virtual bool empty()    const { return true; }
+          
+          virtual void
+          clone (void* targetStorage)  const
+            {
+              new(targetStorage) Buffer();
+            }
+        };
       
       
+      /** concrete subclass managing a specific kind of contained object */
+      template<typename SUB>
+      struct Buff : Buffer
+        {
+          ~Buff()
+            {
+              get().~SUB();
+            }
+          
+          explicit
+          Buff (SUB const& obj)
+            {
+              REQUIRE (siz >= sizeof(SUB));
+              new(&content_) SUB (obj);
+            }
+          
+          Buff (Buff const& oBuff)
+            {
+              new(&content_) SUB (oBuff.get());
+            }
+      
+          Buff&
+          operator= (Buff const& ref)
+            {
+              if (&ref != this)
+                get() = ref.get();
+              return *this;
+            }
+          
+          
+          void
+          clone (void* targetStorage)  const
+            {
+              new(targetStorage) Buff(this->get());
+            }
+          
+          bool
+          empty()  const
+            {
+              return false;
+            }
+          
+          bool
+          isValid()  const
+            {
+              UNIMPLEMENTED ("maybe forward bool check to contained object...");
+            }
+          SUB&
+          get()  const
+            {
+              return *reinterpret_cast<SUB*> (&content_);
+            }
+        };
+      
+      
+      enum{ BUFFSIZE = sizeof(Buffer) };
+      
+      /** embedded buffer actually holding the concrete Buff object,
+       *  which in turn holds and manages the target object */
+      char storage_[BUFFSIZE];
+      
+      
+      
+      typedef OpaqueHolder<BA,siz> _ThisType;   /////TODO needed?
+      
+      Buffer&
+      buff()
+        {
+          return *reinterpret_cast<Buffer*> (&storage_);
+        }
+      
       
     public:
       OpaqueHolder()
-//      : created_(0)
-        { }
+        { 
+          new(&storage_) Buffer();
+        }
       
       template<class SUB>
       OpaqueHolder(SUB const& obj)
-//      : created_(0)
-        { }
+        { 
+          new(&storage_) Buff<SUB> (obj);
+        }
       
       ~OpaqueHolder() { clear(); }
       
@@ -100,13 +185,15 @@ namespace lib {
       void
       clear ()
         {
-          UNIMPLEMENTED ("delete contained object, if any");
+          buff().~Holder();
+          //////////////////////TODO sufficient?
         }
       
       
       OpaqueHolder (OpaqueHolder const& ref)
-//      : created_(must_be_empty (ref))
-        { }
+        {
+          ref.clone (storage_);
+        }
       
       OpaqueHolder&
       operator= (OpaqueHolder const& ref)
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
index 4c589ff7b..3b8e7f94d 100644
--- a/tests/lib/opaque-holder-test.cpp
+++ b/tests/lib/opaque-holder-test.cpp
@@ -91,6 +91,8 @@ namespace test{
   typedef OpaqueHolder<Base> Opaque;
   typedef vector<Opaque> TestList;
   
+  
+  
   /**********************************************************************************
    *  @test use the OpaqueHolder inline buffer to handle a family of classes
    *        through a common interface, without being forced to use heap storage
@@ -155,6 +157,20 @@ namespace test{
           ASSERT (5 == oo->getIt());
           VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
           
+          D5 &rd5 (oo.get<D5>());
+          ASSERT (isSameObject (rd5, *oo));
+
+          // verify that self-assignment is properly detected...
+          oo = oo;
+          ASSERT (oo);
+          ASSERT (isSameObject (rd5, *oo));
+          oo = oo.get<D5>();
+          ASSERT (isSameObject (rd5, *oo));
+          ASSERT (oo);
+          oo = *oo;
+          ASSERT (isSameObject (rd5, *oo));
+          ASSERT (oo);
+          
           oo.clear();
           ASSERT (!oo);
           ASSERT (isnil(oo));

From 6e3bfb08e69c76c080dc83651771688f31b57f31 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 4 Jul 2009 19:30:54 +0200
Subject: [PATCH 168/368] OpaqueHolder implemented and passes unit test

---
 src/lib/opaque-holder.hpp        | 215 ++++++++++++++++++++++++-------
 src/lib/scoped-holder.hpp        |   4 +-
 tests/lib/opaque-holder-test.cpp |  55 ++++++--
 3 files changed, 216 insertions(+), 58 deletions(-)

diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index c5e732d07..1a09fc057 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -55,12 +55,40 @@
 
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
-
+#include "lib/access-casted.hpp"
+#include "lib/util.hpp"
 
 
 namespace lib {
   
   using lumiera::error::LUMIERA_ERROR_WRONG_TYPE;
+  using util::isSameObject;
+  using util::AccessCasted;
+  using util::unConst;
+  
+  
+  namespace { // implementation helpers...
+    
+    using boost::disable_if;
+    using boost::is_convertible;
+    
+    bool
+    validitySelfCheck (bool boolConvertible)
+      {
+        return boolConvertible;
+      }
+    
+    template<typename X>
+        typename disable_if< is_convertible<X,bool>, 
+    bool >::type
+    validitySelfCheck (X const&)
+      {
+        return true; // just pass if this type doesn't provide a validity check...
+      }
+    
+  }
+  
+  
   
   
   /**
@@ -70,10 +98,14 @@ namespace lib {
    * may be created empty, which can be checked by a bool test.
    * The whole compound is copyable if and only if the contained object
    * is copyable.
+   * 
+   * For using OpaqueHolder, several \b assumptions need to be fulfilled
+   * - any instance placed into OpaqueHolder is below the specified maximum size
+   * - the caller cares for thread safety. No concurrent get calls while in mutation!
    */
   template
-    < class BA
-    , size_t siz = sizeof(BA) 
+    < class BA                   ///< the nominal Base/Interface class for a family of types
+    , size_t siz = sizeof(BA)    ///< maximum storage required for the targets to be held inline
     >
   class OpaqueHolder
     : public BoolCheckable<OpaqueHolder<BA,siz> >
@@ -83,6 +115,8 @@ namespace lib {
       struct Buffer
         {
           char content_[siz];
+          void* ptr() { return &content_; }
+          
           virtual ~Buffer() {}
           virtual bool isValid()  const { return false; }
           virtual bool empty()    const { return true; }
@@ -92,13 +126,26 @@ namespace lib {
             {
               new(targetStorage) Buffer();
             }
+          
+          virtual BA&
+          get()  const
+            {
+              throw lumiera::error::Logic ("get() called on empty Buffer");
+            }
         };
       
       
-      /** concrete subclass managing a specific kind of contained object */
+      /** concrete subclass managing a specific kind of contained object.
+       *  @note invariant: content_ always contains a valid SUB object */
       template<typename SUB>
       struct Buff : Buffer
         {
+          SUB&
+          get()  const  ///< core operation: target is contained within the inline buffer
+            {
+              return *reinterpret_cast<SUB*> (unConst(this)->ptr());
+            }
+          
           ~Buff()
             {
               get().~SUB();
@@ -108,16 +155,16 @@ namespace lib {
           Buff (SUB const& obj)
             {
               REQUIRE (siz >= sizeof(SUB));
-              new(&content_) SUB (obj);
+              new(Buffer::ptr()) SUB (obj);
             }
           
           Buff (Buff const& oBuff)
             {
-              new(&content_) SUB (oBuff.get());
+              new(Buffer::ptr()) SUB (oBuff.get());
             }
       
           Buff&
-          operator= (Buff const& ref)
+          operator= (Buff const& ref) ///< not used currently 
             {
               if (&ref != this)
                 get() = ref.get();
@@ -140,12 +187,7 @@ namespace lib {
           bool
           isValid()  const
             {
-              UNIMPLEMENTED ("maybe forward bool check to contained object...");
-            }
-          SUB&
-          get()  const
-            {
-              return *reinterpret_cast<SUB*> (&content_);
+              return validitySelfCheck (get());
             }
         };
       
@@ -153,88 +195,175 @@ namespace lib {
       enum{ BUFFSIZE = sizeof(Buffer) };
       
       /** embedded buffer actually holding the concrete Buff object,
-       *  which in turn holds and manages the target object */
+       *  which in turn holds and manages the target object.
+       *  @note Invariant: always contains a valid Buffer subclass */
       char storage_[BUFFSIZE];
       
       
       
-      typedef OpaqueHolder<BA,siz> _ThisType;   /////TODO needed?
       
       Buffer&
       buff()
         {
           return *reinterpret_cast<Buffer*> (&storage_);
         }
+      const Buffer&
+      buff()  const
+        {
+          return *reinterpret_cast<const Buffer *> (&storage_);
+        }
       
+      void killBuffer()                          
+        { 
+          buff().~Buffer();
+        }
+      
+      void make_emptyBuff()
+        {
+          new(&storage_) Buffer();
+        }
+      
+      template<class SUB>
+      void place_inBuff (SUB const& obj)
+        {
+          new(&storage_) Buff<SUB> (obj);
+        }
+      
+      void clone_inBuff (OpaqueHolder const& ref)
+        {
+          ref.buff().clone (storage_);
+        }
+    
       
     public:
+      ~OpaqueHolder()
+        {
+          killBuffer();
+        }
+      
+      void
+      clear ()
+        {
+          killBuffer();
+          make_emptyBuff();
+        }
+      
+      
       OpaqueHolder()
         { 
-          new(&storage_) Buffer();
+          make_emptyBuff();
         }
       
       template<class SUB>
       OpaqueHolder(SUB const& obj)
         { 
-          new(&storage_) Buff<SUB> (obj);
+          place_inBuff (obj);
         }
       
-      ~OpaqueHolder() { clear(); }
-      
-      
-      void
-      clear ()
-        {
-          buff().~Holder();
-          //////////////////////TODO sufficient?
-        }
-      
-      
       OpaqueHolder (OpaqueHolder const& ref)
         {
-          ref.clone (storage_);
+          clone_inBuff (ref);
         }
       
       OpaqueHolder&
       operator= (OpaqueHolder const& ref)
         {
-          UNIMPLEMENTED ("copy operation");
+          if (!isSameObject (*this, ref))
+            {
+              killBuffer();
+              try
+                {
+                  clone_inBuff (ref);
+                }
+              catch (...)
+                {
+                  make_emptyBuff();
+                  throw;
+                }
+            }
           return *this;
         }
-        
+      
+      template<class SUB>
+      OpaqueHolder&
+      operator= (SUB const& newContent)
+        {
+          if (  !empty() 
+             && !isSameObject (buff().get(), newContent)
+             )
+            {
+              killBuffer();
+              try
+                {
+                  place_inBuff (newContent);
+                }
+              catch (...)
+                {
+                  make_emptyBuff();
+                  throw;
+                }
+            }
+          return *this;
+        }
+      
+      
+      /* === smart-ptr style access === */
       
       BA&
-      operator* ()  const  // never throws
+      operator* ()  const
         {
           ASSERT (!empty());
-          return (BA&) content_;
+          return buff().get();
         }
       
       BA* 
-      operator-> ()  const // never throws
+      operator-> ()  const
         {
           ASSERT (!empty());
-          return (BA*) &content_;
+          return &(buff().get());
         }
       
       template<class SUB>
       SUB& get()  const
         {
-          UNIMPLEMENTED ("downcast to concrete type");
-//          return (SUB*) &content_; 
+          typedef const Buffer* Iface;
+          typedef const Buff<SUB> * Actual;
+          Iface interface = &buff();
+          Actual actual = dynamic_cast<Actual> (interface);
+          if (actual)
+            return actual->get();
+          
+          // second try: maybe we can perform a
+          // dynamic upcast or direct conversion on the
+          // concrete target object. But we need to exclude a
+          // brute force static cast (which might slice or reinterpret)
+          if (!util::use_static_downcast<BA*,SUB*>::value)
+            {
+              BA*  asBase  = &(buff().get());
+              SUB* content = AccessCasted<SUB*>::access (asBase);
+              if (content) 
+                return *content;
+            }
+          
+          throw lumiera::error::Logic ("Attempt to access OpaqueHolder's contents "
+                                       "specifying incompatible target type"
+                                      , LUMIERA_ERROR_WRONG_TYPE
+                                      );
         }
       
-      bool empty() const
+      
+      bool
+      empty() const
         {
-          UNIMPLEMENTED ("check for empty container");
+          return buff().empty();
         }
       
-      bool isValid() const
+      
+      bool
+      isValid() const
         {
-          UNIMPLEMENTED ("empty check and forward to contained object");
+          return buff().isValid();
         }
-      
-      
     };
   
   
diff --git a/src/lib/scoped-holder.hpp b/src/lib/scoped-holder.hpp
index 95c0909a6..0a1a1d3a8 100644
--- a/src/lib/scoped-holder.hpp
+++ b/src/lib/scoped-holder.hpp
@@ -195,14 +195,14 @@ namespace lib {
         
       
       TY&
-      operator* ()  const  // never throws
+      operator* ()  const
         {
           ASSERT (created_);
           return (TY&) content_;
         }
       
       TY* 
-      operator-> ()  const // never throws
+      operator-> ()  const
         {
           ASSERT (created_);
           return (TY*) &content_;
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
index 3b8e7f94d..3a5d8e5bd 100644
--- a/tests/lib/opaque-holder-test.cpp
+++ b/tests/lib/opaque-holder-test.cpp
@@ -40,13 +40,14 @@ namespace test{
   using util::isnil;
   using util::for_each;
   using util::isSameObject;
+  using lumiera::error::LUMIERA_ERROR_ASSERTION;
   
   using std::vector;
   using std::cout;
   using std::endl;
   
   namespace { // test dummy hierarchy
-             //  Note: no vtable and common storage
+             //  Note: common storage but no vtable 
     
     long _checksum = 0;
     
@@ -55,11 +56,13 @@ namespace test{
       {
         uint id_;
         
-        Base(uint i=0) : id_(i) { _checksum +=id_; }
+        Base(uint i=0)      : id_(i)     { _checksum +=id_; }
+        Base(Base const& o) : id_(o.id_) { _checksum +=id_; }
         
         uint getIt() { return id_; }
       };
     
+    
     template<uint ii>
     struct DD : Base
       {
@@ -72,7 +75,7 @@ namespace test{
       : DD<7>
       , BoolCheckable<Special>
       {
-        uint myVal_;
+        ulong myVal_;
         
         Special (uint val)
           : myVal_(val)
@@ -85,6 +88,12 @@ namespace test{
           }
       };
           
+      
+      /** maximum additional storage maybe wasted
+       *  due to alignment of the contained object
+       *  within OpaqueHolder's buffer
+       */
+      const size_t ALLIGNMENT = sizeof(size_t);
     
   }
   
@@ -97,6 +106,11 @@ namespace test{
    *  @test use the OpaqueHolder inline buffer to handle a family of classes
    *        through a common interface, without being forced to use heap storage
    *        or a custom allocator.
+   *        
+   *  @todo this test doesn't cover automatic conversions and conversions using
+   *        RTTI from the target objects, while OpaqueHolder.tempate get() would
+   *        allow for such conversions. This is similar to Ticket #141, and actually
+   *        based on the same code as variant.hpp (access-casted.hpp)
    */
   class OpaqueHolder_test : public Test
     {
@@ -149,17 +163,17 @@ namespace test{
           typedef DD<5> D5;
           D3 d3 (oo.get<D3>() );
           ASSERT (3 == oo->getIt());
-          ASSERT (isSameObject (d3, *oo));
+          ASSERT (!isSameObject (d3, *oo));
           VERIFY_ERROR (WRONG_TYPE, oo.get<D5>() );
           
-          oo = D5();
+          oo = D5();        // direct assignment of target into Buffer
           ASSERT (oo);
           ASSERT (5 == oo->getIt());
           VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
           
           D5 &rd5 (oo.get<D5>());
           ASSERT (isSameObject (rd5, *oo));
-
+          
           // verify that self-assignment is properly detected...
           oo = oo;
           ASSERT (oo);
@@ -179,22 +193,37 @@ namespace test{
           ASSERT (!o1);
           
           Opaque o2 (d3);
-          ASSERT (!isSameObject (d3, *oo));
-          ASSERT (3 == oo->getIt());
+          ASSERT (!isSameObject (d3, *o2));
+          ASSERT (3 == o2->getIt());
           
-          ASSERT (sizeof(Opaque) == sizeof(Base) + sizeof(void*));
+          ASSERT (sizeof(Opaque) <= sizeof(Base) + sizeof(void*) + ALLIGNMENT);
         }
       
       
+      /** @test OpaqueHolder with additional storage for subclass.
+       *        When a subclass requires more storage than the base class or
+       *        Interface, we need to create a custom OpaqueHolder, specifying the
+       *        actually necessary storage. Such a custom OpaqueHolder behaves exactly
+       *        like the standard variant, but there is protection against accidentally
+       *        using a standard variant to hold an instance of the larger subclass.
+       *        
+       *  @test Moreover, if the concrete class has a custom operator bool(), it
+       *        will be invoked automatically from OpaqueHolder's operator bool()
+       * 
+       */ 
       void
       checkSpecialSubclass ()
         {
-          // define a "special" OpaqueHolder with enough storage to hold a Special 
           typedef OpaqueHolder<Base, sizeof(Special)> SpecialOpaque;
           
+          cout << showSizeof<Base>() << endl;
+          cout << showSizeof<Special>() << endl;
+          cout << showSizeof<Opaque>() << endl;
+          cout << showSizeof<SpecialOpaque>() << endl;
+          
           ASSERT (sizeof(Special) > sizeof(Base));
           ASSERT (sizeof(SpecialOpaque) > sizeof(Opaque));
-          ASSERT (sizeof(SpecialOpaque) == sizeof(Special) + sizeof(void*));
+          ASSERT (sizeof(SpecialOpaque) <= sizeof(Special) + sizeof(void*) + ALLIGNMENT);
           
           Special s1 (6);
           Special s2 (3);
@@ -215,8 +244,8 @@ namespace test{
           ASSERT (!isnil(ospe2));
           
           ASSERT (7 == ospe1->getIt());
-          ASSERT (5 == ospe1.get<Special>().myVal_);
-          ASSERT (6 == ospe2.get<Special>().myVal_);
+          ASSERT (6 == ospe1.get<Special>().myVal_);
+          ASSERT (3 == ospe2.get<Special>().myVal_);
           
           ospe1 = DD<5>();            // but can be reassigned like any normal Opaque
           ASSERT (ospe1);

From 4d1f45fc43157103ac95b35e271e86e5d19444ab Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 5 Jul 2009 02:26:59 +0200
Subject: [PATCH 169/368] activate the new test, some comments

---
 src/lib/opaque-holder.hpp        | 16 ++++++++++------
 tests/40components.tests         |  5 +++++
 tests/lib/opaque-holder-test.cpp |  8 ++++----
 3 files changed, 19 insertions(+), 10 deletions(-)

diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index 1a09fc057..ab637f082 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -35,7 +35,7 @@
  ** interface, the inner container keeps track of the actual type by means
  ** of a vtable. OpaqueHolder can be empty; but re-accessing the concrete
  ** object requires knowledge of the actual type, similar to boost::any
- ** (but the latter uses heap storage). 
+ ** (but contrary to OpaqueHolder the latter uses heap storage). 
  ** 
  ** Using this approach is bound to specific stipulations regarding the
  ** properties of the contained object and the kind of access needed.
@@ -63,7 +63,6 @@ namespace lib {
   
   using lumiera::error::LUMIERA_ERROR_WRONG_TYPE;
   using util::isSameObject;
-  using util::AccessCasted;
   using util::unConst;
   
   
@@ -202,6 +201,9 @@ namespace lib {
       
       
       
+      
+      /* === internal interface for managing the storage === */
+      
       Buffer&
       buff()
         {
@@ -213,6 +215,7 @@ namespace lib {
           return *reinterpret_cast<const Buffer *> (&storage_);
         }
       
+      
       void killBuffer()                          
         { 
           buff().~Buffer();
@@ -233,7 +236,8 @@ namespace lib {
         {
           ref.buff().clone (storage_);
         }
-    
+      
+      
       
     public:
       ~OpaqueHolder()
@@ -334,13 +338,13 @@ namespace lib {
             return actual->get();
           
           // second try: maybe we can perform a
-          // dynamic upcast or direct conversion on the
-          // concrete target object. But we need to exclude a
+          // dynamic downcast or direct conversion to the
+          // actual target type. But we need to exclude a
           // brute force static cast (which might slice or reinterpret)
           if (!util::use_static_downcast<BA*,SUB*>::value)
             {
               BA*  asBase  = &(buff().get());
-              SUB* content = AccessCasted<SUB*>::access (asBase);
+              SUB* content = util::AccessCasted<SUB*>::access (asBase);
               if (content) 
                 return *content;
             }
diff --git a/tests/40components.tests b/tests/40components.tests
index 109611c46..06cfc0073 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -272,6 +272,11 @@ END
 
 
 TEST "inline type erasure" OpaqueHolder_test  <<END
+out: 1
+out: 3
+out: 5
+out: 7
+out: sizeof\( .+ \) = .*[12468]{1,2}
 return: 0
 END
 
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
index 3a5d8e5bd..e026e1ffd 100644
--- a/tests/lib/opaque-holder-test.cpp
+++ b/tests/lib/opaque-holder-test.cpp
@@ -67,8 +67,8 @@ namespace test{
     struct DD : Base
       {
         DD() : Base(ii)       { }
-       ~DD() { _checksum -= ii; }
-      };
+       ~DD() { _checksum -= ii; }  // doing the decrement here
+      };                          //  verifies the correct dtor is called
     
     
     struct Special
@@ -82,7 +82,7 @@ namespace test{
           { }
         
         bool
-        isValid ()  const
+        isValid ()  const ///< custom boolean "validity" check
           {
             return myVal_ % 2;
           }
@@ -138,7 +138,7 @@ namespace test{
           list.push_back (DD<5>());
           list.push_back (DD<7>());
           return list;
-        }
+        } //note: copy
       
       
       static void

From e2bb2c440c7f20d25f723bb5023f160043125c70 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 5 Jul 2009 03:38:33 +0200
Subject: [PATCH 170/368] use OpaqueHolder to solve the problem with the
 function type erasure... ...tried to use 2 policies, but doesn't work correct
 (and is uggly)

---
 src/lib/meta/function-erasure.hpp | 71 ++++++---------------------
 src/lib/opaque-holder.hpp         | 79 +++++++++++++++++++++++++------
 2 files changed, 80 insertions(+), 70 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 6d3729160..5690c745a 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -56,6 +56,7 @@
 #include "lib/util.hpp"
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
+#include "lib/opaque-holder.hpp"
 
 #include <tr1/functional>
 
@@ -96,80 +97,38 @@ namespace typelist{
   
   /* ====== Policy classes ====== */
   
-  /** 
+  typedef function<void(void)> FunVoid;
+  typedef lib::OpaqueHolder< FunVoid
+                           , sizeof(FunVoid)                      // same size for all function objects 
+                           , lib::OpaqueHolder_useBruteForceCast  // no common base class!
+                           > FunHolder;
+  
+  /**
    * Policy for FunErasure: store an embedded tr1::function
    * Using this policy allows to store arbitrary complex functor objects
    * embedded within a neutral container and retrieving them later type-safe.
    * The price to pay is vtable access and heap storage of function arguments.
    */
   class StoreFunction
-    : public lib::BoolCheckable<StoreFunction>
+    : public FunHolder
     {
-      /** Helper: type erasure */
-      struct Holder
-        {
-          enum { SIZE = sizeof(function<void(void)>) };
-          char storage_[SIZE];
-          virtual ~Holder() {}
-          virtual bool isValid()  const { return false; }
-        };
-      
-      /** embedding the concrete functor object */
-      template<typename SIG>
-      struct FunctionHolder : Holder
-        {
-          typedef function<SIG> Functor;
-          
-          FunctionHolder (Functor const& fun)
-            {
-              REQUIRE (SIZE >= sizeof(Functor));
-              new(&storage_) Functor (fun);
-            }
-          ~FunctionHolder()
-            {
-              get().~Functor();
-            }
-          bool
-          isValid()  const
-            {
-              const Functor& func (unConst(this)->get());
-              return bool(func);
-            }
-          Functor&
-          get()
-            {
-              return *reinterpret_cast<Functor*> (&storage_);
-            }
-        };
-      
-      /** embedded buffer actually holding
-       *  the concrete Functor object */
-      Holder holder_;
       
     public:
       template<typename SIG>
       StoreFunction (SIG& fun)
-        {
-          new(&holder_) FunctionHolder<SIG> (function<SIG>(fun));
-        }
+        : FunHolder(function<SIG>(fun))
+        { }
+      
       template<typename SIG>
       StoreFunction (function<SIG> const& fun)
-        {
-          new(&holder_) FunctionHolder<SIG> (fun);
-        }
+        : FunHolder(fun)
+        { }
       
       template<typename SIG>
       function<SIG>&
       getFun ()
         {
-          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
-          return static_cast<FunctionHolder<SIG>&> (holder_).get();
-        }
-      
-      bool
-      isValid()  const
-        {
-          return holder_.isValid();
+          return get<function<SIG> >();
         }
     };
   
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index ab637f082..67e4eb6fc 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -87,6 +87,47 @@ namespace lib {
     
   }
   
+  /* ==== Policy classes for OpaqueHolder ==== */
+  
+  /**
+   * Standard policy for accessing the contents via 
+   * a common base class interface. Using this policy
+   * causes a virtual get() function to be used, where
+   * the actual Buff-subclasses will define overrides
+   * with covariant return types.
+   */
+  template<class STO>
+  class OpaqueHolder_useCommonBase
+    : public STO
+    {
+      typedef typename STO::BaseType Base;
+      
+    public:
+      /** @note a virtual get() function to be overridden */
+      virtual Base&  get()  const =0;  
+    };
+  
+  /**
+   * Alternative policy for accessing the contents via
+   * a common interface; use this policy if the intention is
+   * to use OpaqueHolder with a family of similar classes, 
+   * \em without requiring all of them to be derived from
+   * a common base class. (E.g. tr1::function objects).
+   * In this case, the BA template  parameter of OpaqueHolder
+   * can be considered just a nominal placeholder. 
+   * @note using this policy renders the smart-ptr style
+   *       access largely useless and might even cause
+   *       segmentation errors, when trying to access
+   *       the contents of the buffer this way through
+   *       a brute force reinterpret_cast.
+   */
+  template<class STO>
+  class OpaqueHolder_useBruteForceCast
+    : public STO
+    {
+      
+    };
+  
   
   
   
@@ -105,20 +146,33 @@ namespace lib {
   template
     < class BA                   ///< the nominal Base/Interface class for a family of types
     , size_t siz = sizeof(BA)    ///< maximum storage required for the targets to be held inline
+    , template<class STO> class AccessPolicy = OpaqueHolder_useCommonBase
+                                 ///< how to access the contents via a common interface?
     >
   class OpaqueHolder
     : public BoolCheckable<OpaqueHolder<BA,siz> >
     {
       
-      /** Inner capsule managing the contained object (interface) */
-      struct Buffer
+      /** Storage buffer holding the target object inline */
+      struct Storage
         {
           char content_[siz];
           void* ptr() { return &content_; }
           
-          virtual ~Buffer() {}
-          virtual bool isValid()  const { return false; }
-          virtual bool empty()    const { return true; }
+          typedef BA BaseType;
+          
+          virtual ~Storage() {}
+        };
+      
+      /** Inner capsule managing the contained object (interface) */
+      struct Buffer
+        : AccessPolicy<Storage>
+        {
+          BA&
+          get()  const
+            {
+              return *reinterpret_cast<BA*> (unConst(this)->ptr());
+            }
           
           virtual void
           clone (void* targetStorage)  const
@@ -126,11 +180,8 @@ namespace lib {
               new(targetStorage) Buffer();
             }
           
-          virtual BA&
-          get()  const
-            {
-              throw lumiera::error::Logic ("get() called on empty Buffer");
-            }
+          virtual bool isValid()  const { return false; }
+          virtual bool empty()    const { return true; }
         };
       
       
@@ -171,22 +222,22 @@ namespace lib {
             }
           
           
-          void
+          virtual void
           clone (void* targetStorage)  const
             {
               new(targetStorage) Buff(this->get());
             }
           
-          bool
+          virtual bool
           empty()  const
             {
               return false;
             }
           
-          bool
+          virtual bool
           isValid()  const
             {
-              return validitySelfCheck (get());
+              return validitySelfCheck (this->get());
             }
         };
       

From c3b8d39507e70a45bcb440c7edc861edb7d1d4a4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 5 Jul 2009 22:05:11 +0200
Subject: [PATCH 171/368] refactoring into two distinct concepts. maybe
 solution?

---
 src/lib/access-casted.hpp         |   9 +-
 src/lib/meta/function-erasure.hpp |   7 +-
 src/lib/opaque-holder.hpp         | 261 +++++++++++++++++++++---------
 tests/lib/opaque-holder-test.cpp  |  32 +++-
 4 files changed, 221 insertions(+), 88 deletions(-)

diff --git a/src/lib/access-casted.hpp b/src/lib/access-casted.hpp
index 1a5d69f72..503262294 100644
--- a/src/lib/access-casted.hpp
+++ b/src/lib/access-casted.hpp
@@ -142,21 +142,24 @@ namespace util {
       using NullAccessor<TAR>::access;
       
       template<typename ELM>
-      static  typename enable_if< use_dynamic_downcast<ELM&,TAR>, TAR>::type
+      static  typename enable_if< use_dynamic_downcast<ELM&,TAR>,
+      TAR     >::type
       access (ELM& elem)
         {
           return dynamic_cast<TAR> (elem);
         }
       
       template<typename ELM>
-      static  typename enable_if< use_static_downcast<ELM&,TAR>, TAR>::type
+      static  typename enable_if< use_static_downcast<ELM&,TAR>,
+      TAR     >::type
       access (ELM& elem)
         {
           return static_cast<TAR> (elem);
         }
       
       template<typename ELM>
-      static  typename enable_if< use_conversion<ELM&,TAR>, TAR>::type
+      static  typename enable_if< use_conversion<ELM&,TAR>,
+      TAR     >::type
       access (ELM& elem)
         {
           return elem;
diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 5690c745a..75bf5d2ce 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -98,10 +98,9 @@ namespace typelist{
   /* ====== Policy classes ====== */
   
   typedef function<void(void)> FunVoid;
-  typedef lib::OpaqueHolder< FunVoid
-                           , sizeof(FunVoid)                      // same size for all function objects 
-                           , lib::OpaqueHolder_useBruteForceCast  // no common base class!
-                           > FunHolder;
+  typedef lib::InPlaceAnyHolder< sizeof(FunVoid)                       // same size for all function objects 
+                               , lib::InPlaceAnyHolder_unrelatedTypes  // no common base class!
+                               > FunHolder;
   
   /**
    * Policy for FunErasure: store an embedded tr1::function
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index 67e4eb6fc..e54116a30 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -96,15 +96,41 @@ namespace lib {
    * the actual Buff-subclasses will define overrides
    * with covariant return types.
    */
-  template<class STO>
-  class OpaqueHolder_useCommonBase
-    : public STO
+  template<class BA>
+  struct InPlaceAnyHolder_useCommonBase
     {
-      typedef typename STO::BaseType Base;
+      typedef BA Base;
       
-    public:
-      /** @note a virtual get() function to be overridden */
-      virtual Base&  get()  const =0;  
+      template<class SUB>
+      static Base*
+      convert2base (SUB& obj)
+        {
+          SUB* oPtr = &obj;
+          BA* asBase = util::AccessCasted<BA*>::access (oPtr);
+          if (asBase) 
+            return asBase;
+          
+          throw lumiera::error::Logic ("Unable to convert concrete object to Base interface"
+                                      , LUMIERA_ERROR_WRONG_TYPE
+                                      );
+        }
+      
+      template<class SUB>
+      static SUB*
+      access (Base* asBase)
+        {
+          // Because we don't know anything about the involved types,
+          // we need to exclude a brute force static cast
+          // (which might slice or reinterpret or even cause SEGV)
+          if (!util::use_static_downcast<Base*,SUB*>::value)
+            {
+              SUB* content = util::AccessCasted<SUB*>::access (asBase);
+              return content;
+              // might be NULL
+            }
+          else
+            return 0;
+        }
     };
   
   /**
@@ -121,14 +147,32 @@ namespace lib {
    *       the contents of the buffer this way through
    *       a brute force reinterpret_cast.
    */
-  template<class STO>
-  class OpaqueHolder_useBruteForceCast
-    : public STO
+  struct InPlaceAnyHolder_unrelatedTypes
     {
+      typedef void Base;
       
+      template<class SUB>
+      static void*
+      convert2base (SUB& obj)
+        {
+          return static_cast<void*> (&obj);
+        }
+      
+      template<class SUB>
+      static SUB*
+      access (Base*)
+        {
+          return 0;
+        }
     };
   
-  
+
+/////////////////////////////TODO
+/////////////////////////////: separieren in einen InPlaceAnyHolder
+/////////////////////////////: und als dessen Kind den OpaqueHolder
+/////////////////////////////: AccessPolicy unter die konkrete Buff-Klasse einschieben
+/////////////////////////////: EmptyBuffer als abgeleitet.
+    
   
   
   /**
@@ -144,58 +188,71 @@ namespace lib {
    * - the caller cares for thread safety. No concurrent get calls while in mutation!
    */
   template
-    < class BA                   ///< the nominal Base/Interface class for a family of types
-    , size_t siz = sizeof(BA)    ///< maximum storage required for the targets to be held inline
-    , template<class STO> class AccessPolicy = OpaqueHolder_useCommonBase
-                                 ///< how to access the contents via a common interface?
+    < size_t siz           ///< maximum storage required for the targets to be held inline
+    , class AccessPolicy = InPlaceAnyHolder_unrelatedTypes
+                           ///< how to access the contents via a common interface?
     >
-  class OpaqueHolder
-    : public BoolCheckable<OpaqueHolder<BA,siz> >
+  class InPlaceAnyHolder
+    : public BoolCheckable<InPlaceAnyHolder<siz, AccessPolicy> >
     {
+      typedef typename AccessPolicy::Base * BaseP;
       
-      /** Storage buffer holding the target object inline */
-      struct Storage
+      /** Inner capsule managing the contained object (interface) */
+      struct Buffer
         {
           char content_[siz];
           void* ptr() { return &content_; }
           
-          typedef BA BaseType;
+          virtual ~Buffer() {}
+          virtual bool isValid()  const =0;
+          virtual bool empty()    const =0;
+          virtual BaseP getBase() const =0;
           
-          virtual ~Storage() {}
+          virtual void   clone (void* targetStorage)  const =0;
         };
       
-      /** Inner capsule managing the contained object (interface) */
-      struct Buffer
-        : AccessPolicy<Storage>
+      template<typename TY>
+      struct AbstractBuff : Buffer
         {
-          BA&
-          get()  const
+          TY&
+          get()  const  ///< core operation: target is contained within the inline buffer
             {
-              return *reinterpret_cast<BA*> (unConst(this)->ptr());
+              return *reinterpret_cast<TY*> (unConst(this)->ptr());
+            }
+          
+          BaseP
+          getBase()  const
+            {
+              return AccessPolicy::convert2base (get());
+            }
+          
+        };
+      
+      struct EmptyBuff : Buffer
+        {
+          virtual bool isValid()  const { return false; }
+          virtual bool empty()    const { return true; }
+          
+          BaseP
+          getBase()  const
+            {
+              throw lumiera::error::Invalid("accessing empty holder");
             }
           
           virtual void
           clone (void* targetStorage)  const
             {
-              new(targetStorage) Buffer();
+              new(targetStorage) EmptyBuff();
             }
           
-          virtual bool isValid()  const { return false; }
-          virtual bool empty()    const { return true; }
         };
       
       
       /** concrete subclass managing a specific kind of contained object.
        *  @note invariant: content_ always contains a valid SUB object */
       template<typename SUB>
-      struct Buff : Buffer
+      struct Buff : AbstractBuff<SUB>
         {
-          SUB&
-          get()  const  ///< core operation: target is contained within the inline buffer
-            {
-              return *reinterpret_cast<SUB*> (unConst(this)->ptr());
-            }
-          
           ~Buff()
             {
               get().~SUB();
@@ -254,7 +311,7 @@ namespace lib {
       
       
       /* === internal interface for managing the storage === */
-      
+    protected:
       Buffer&
       buff()
         {
@@ -274,7 +331,7 @@ namespace lib {
       
       void make_emptyBuff()
         {
-          new(&storage_) Buffer();
+          new(&storage_) EmptyBuff();
         }
       
       template<class SUB>
@@ -283,7 +340,7 @@ namespace lib {
           new(&storage_) Buff<SUB> (obj);
         }
       
-      void clone_inBuff (OpaqueHolder const& ref)
+      void clone_inBuff (InPlaceAnyHolder const& ref)
         {
           ref.buff().clone (storage_);
         }
@@ -291,7 +348,7 @@ namespace lib {
       
       
     public:
-      ~OpaqueHolder()
+      ~InPlaceAnyHolder()
         {
           killBuffer();
         }
@@ -304,24 +361,24 @@ namespace lib {
         }
       
       
-      OpaqueHolder()
+      InPlaceAnyHolder()
         { 
           make_emptyBuff();
         }
       
       template<class SUB>
-      OpaqueHolder(SUB const& obj)
+      InPlaceAnyHolder(SUB const& obj)
         { 
           place_inBuff (obj);
         }
       
-      OpaqueHolder (OpaqueHolder const& ref)
+      InPlaceAnyHolder (InPlaceAnyHolder const& ref)
         {
           clone_inBuff (ref);
         }
       
-      OpaqueHolder&
-      operator= (OpaqueHolder const& ref)
+      InPlaceAnyHolder&
+      operator= (InPlaceAnyHolder const& ref)
         {
           if (!isSameObject (*this, ref))
             {
@@ -340,11 +397,11 @@ namespace lib {
         }
       
       template<class SUB>
-      OpaqueHolder&
+      InPlaceAnyHolder&
       operator= (SUB const& newContent)
         {
-          if (  !empty() 
-             && !isSameObject (buff().get(), newContent)
+          if (  empty() 
+             || !isSameObject (*buff().getBase(), newContent)
              )
             {
               killBuffer();
@@ -362,21 +419,8 @@ namespace lib {
         }
       
       
-      /* === smart-ptr style access === */
       
-      BA&
-      operator* ()  const
-        {
-          ASSERT (!empty());
-          return buff().get();
-        }
-      
-      BA* 
-      operator-> ()  const
-        {
-          ASSERT (!empty());
-          return &(buff().get());
-        }
+      /* === re-accessing the concrete contained object === */
       
       template<class SUB>
       SUB& get()  const
@@ -388,17 +432,13 @@ namespace lib {
           if (actual)
             return actual->get();
           
-          // second try: maybe we can perform a
-          // dynamic downcast or direct conversion to the
-          // actual target type. But we need to exclude a
-          // brute force static cast (which might slice or reinterpret)
-          if (!util::use_static_downcast<BA*,SUB*>::value)
-            {
-              BA*  asBase  = &(buff().get());
-              SUB* content = util::AccessCasted<SUB*>::access (asBase);
-              if (content) 
-                return *content;
-            }
+          // second try: maybe we can perform a dynamic downcast
+          // or direct conversion to the actual target type.
+          BaseP asBase = buff().getBase(); 
+          ASSERT (asBase);
+          SUB* content = AccessPolicy::template access<SUB> (asBase);
+          if (content) 
+            return *content;
           
           throw lumiera::error::Logic ("Attempt to access OpaqueHolder's contents "
                                        "specifying incompatible target type"
@@ -423,6 +463,79 @@ namespace lib {
   
   
   
+  /**
+   * Inline buffer holding and owning an object while concealing the
+   * concrete type. Access to the contained object is similar to a
+   * smart-pointer, but the object isn't heap allocated. OpaqueHolder
+   * may be created empty, which can be checked by a bool test.
+   * The whole compound is copyable if and only if the contained object
+   * is copyable.
+   *
+   * \par using OpaqueHolder
+   * OpaqueHolder instances are copyable value objects. They are created
+   * either empty, by copy from an existing OpaqueHolder, or by directly
+   * specifying the concrete object to embed. This target object will be
+   * \em copy-constructed into the internal buffer. Additionally, you
+   * may assign a new value, which causes the old value object to be
+   * destroyed and a new one to be copy-constructed into the buffer.
+   * Later on, the embedded value might be accessed
+   * - using the smart-ptr-like access through the common base interface BA
+   * - when knowing the exact type to access, the templated #get might be an option
+   * - the empty state of the container and a \c isValid() on the target may be checked
+   * - a combination of both is available as a \c bool check on the OpaqueHolder instance.
+   *  
+   * For using OpaqueHolder, several \b assumptions need to be fulfilled
+   * - any instance placed into OpaqueHolder is below the specified maximum size
+   * - the caller cares for thread safety. No concurrent get calls while in mutation!
+   */
+  template
+    < class BA                   ///< the nominal Base/Interface class for a family of types
+    , size_t siz = sizeof(BA)    ///< maximum storage required for the targets to be held inline
+    >
+  class OpaqueHolder
+    : public InPlaceAnyHolder<siz, InPlaceAnyHolder_useCommonBase<BA> >
+    {
+      typedef InPlaceAnyHolder<siz, InPlaceAnyHolder_useCommonBase<BA> > InPlaceHolder;
+      
+    public:
+      OpaqueHolder() : InPlaceHolder() {}
+      
+      template<class SUB>
+      OpaqueHolder(SUB const& obj) : InPlaceHolder(obj) {}
+      
+      template<class SUB>
+      OpaqueHolder&
+      operator= (SUB const& newContent)
+        {
+          static_cast<InPlaceHolder&>(*this) = newContent;
+          return *this;
+        }
+      
+      // note: using standard copy operations 
+      
+      
+      
+      /* === smart-ptr style access === */
+      
+      BA&
+      operator* ()  const
+        {
+          ASSERT (!InPlaceHolder::empty());
+          return *InPlaceHolder::buff().getBase();
+        }
+      
+      BA* 
+      operator-> ()  const
+        {
+          ASSERT (!InPlaceHolder::empty());
+          return InPlaceHolder::buff().getBase();
+        }
+      
+    };
+  
+  
+  
+  
   
 } // namespace lib
 #endif
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
index e026e1ffd..26b9fb25d 100644
--- a/tests/lib/opaque-holder-test.cpp
+++ b/tests/lib/opaque-holder-test.cpp
@@ -50,14 +50,15 @@ namespace test{
              //  Note: common storage but no vtable 
     
     long _checksum = 0;
+    uint _create_count = 0;
     
     
     struct Base   
       {
         uint id_;
         
-        Base(uint i=0)      : id_(i)     { _checksum +=id_; }
-        Base(Base const& o) : id_(o.id_) { _checksum +=id_; }
+        Base(uint i=0)      : id_(i)     { _checksum +=id_; ++_create_count; }
+        Base(Base const& o) : id_(o.id_) { _checksum +=id_; ++_create_count; }
         
         uint getIt() { return id_; }
       };
@@ -119,6 +120,7 @@ namespace test{
       run (Arg)
         {
           _checksum = 0;
+          _create_count = 0;
           {
             TestList objs = createDummies ();
             for_each (objs, reAccess);
@@ -171,18 +173,34 @@ namespace test{
           ASSERT (5 == oo->getIt());
           VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
           
-          D5 &rd5 (oo.get<D5>());
+          D5 &rd5 (oo.get<D5>());   // can get a direct reference to contained object 
           ASSERT (isSameObject (rd5, *oo));
           
+          ASSERT (!isnil(oo));
+          oo = objs[3];     // copy construction also works on non-empty object
+          ASSERT (7 == oo->getIt());
+          
+          ASSERT (7 == rd5.getIt()); // WARNING: direct ref has been messed up through the backdoor!
+          ASSERT (isSameObject (rd5, *oo));
+
+          uint cnt_before = _create_count;
+          
+          oo.clear();
+          ASSERT (!oo);
+          oo = D5();        // direct assignment also works on empty object
+          ASSERT (oo);
+          ASSERT (5 == oo->getIt());
+          ASSERT (_create_count == 2 + cnt_before); // one within buff and one for the anonymous temporary D5()
+          
           // verify that self-assignment is properly detected...
+          cnt_before = _create_count;
           oo = oo;
           ASSERT (oo);
-          ASSERT (isSameObject (rd5, *oo));
+          ASSERT (_create_count == cnt_before);
           oo = oo.get<D5>();
-          ASSERT (isSameObject (rd5, *oo));
-          ASSERT (oo);
+          ASSERT (_create_count == cnt_before);
           oo = *oo;
-          ASSERT (isSameObject (rd5, *oo));
+          ASSERT (_create_count == cnt_before);
           ASSERT (oo);
           
           oo.clear();

From 2462dee5ca5c941857a0442c20be36dde1884418 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 6 Jul 2009 02:25:19 +0200
Subject: [PATCH 172/368] issue resolved, tests pass, finally (whew)

---
 src/lib/meta/function-erasure.hpp        |  56 ++------
 src/lib/opaque-holder.hpp                | 169 +++++++++++++----------
 tests/lib/meta/function-erasure-test.cpp |   5 +-
 tests/lib/opaque-holder-test.cpp         |  52 ++++---
 4 files changed, 148 insertions(+), 134 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 75bf5d2ce..eaca137d0 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -101,7 +101,11 @@ namespace typelist{
   typedef lib::InPlaceAnyHolder< sizeof(FunVoid)                       // same size for all function objects 
                                , lib::InPlaceAnyHolder_unrelatedTypes  // no common base class!
                                > FunHolder;
+  typedef lib::InPlaceAnyHolder< sizeof(void*) 
+                               , lib::InPlaceAnyHolder_unrelatedTypes
+                               > FunPtrHolder;
   
+                               
   /**
    * Policy for FunErasure: store an embedded tr1::function
    * Using this policy allows to store arbitrary complex functor objects
@@ -111,7 +115,6 @@ namespace typelist{
   class StoreFunction
     : public FunHolder
     {
-      
     public:
       template<typename SIG>
       StoreFunction (SIG& fun)
@@ -139,59 +142,26 @@ namespace typelist{
    * The price to pay is vtable access. 
    */
   class StoreFunPtr
-    : public lib::BoolCheckable<StoreFunPtr>
+    : public FunPtrHolder
     {
-      /** Helper: type erasure */
-      struct Holder
-        {
-          void *fP_;
-          virtual ~Holder() {}
-        };
-      
-      /** storing and retrieving concrete function ptr */
-      template<typename SIG>
-      struct FunctionHolder : Holder
-        {
-          FunctionHolder (SIG *fun)
-            {
-              REQUIRE (fun);
-              fP_ = reinterpret_cast<void*> (fun);
-            }
-          SIG&
-          get()
-            {
-              return *reinterpret_cast<SIG*> (fP_);
-            }
-        };
-      
-      /** embedded container holding the pointer */
-      Holder holder_;
-      
     public:
       template<typename SIG>
       StoreFunPtr (SIG& fun)
-        {
-          new(&holder_) FunctionHolder<SIG> (&fun);
-        }
+        : FunPtrHolder(&fun)
+        { }
+      
       template<typename SIG>
       StoreFunPtr (SIG *fun)
-        {
-          new(&holder_) FunctionHolder<SIG> (fun);
-        }
+        : FunPtrHolder(fun)
+        { }
       
       template<typename SIG>
       SIG&
       getFun ()
         {
-          REQUIRE (INSTANCEOF (FunctionHolder<SIG>, &holder_));
-          return static_cast<FunctionHolder<SIG>&> (holder_).get();
-        }
-      
-      
-      bool
-      isValid()  const
-        {
-          return holder_.fP_;
+          SIG *fun = get<SIG*>();
+          REQUIRE (fun);
+          return *fun;
         }
     };
   
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index e54116a30..d3a9b38fc 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -29,11 +29,21 @@
  ** an inline buffer holding an object of the concrete subclass. Typically,
  ** this situation arises when dealing with functor objects.
  ** 
- ** This template helps building custom objects and wrappers based on this
- ** pattern: it provides an buffer for the target objects and controls access
- ** through a two-layer capsule; while the outer container exposes a neutral
- ** interface, the inner container keeps track of the actual type by means
- ** of a vtable. OpaqueHolder can be empty; but re-accessing the concrete
+ ** These templates help with building custom objects and wrappers based on
+ ** this pattern: InPlaceAnyHolder provides an buffer for the target objects
+ ** and controls access through a two-layer capsule; while the outer container
+ ** exposes a neutral interface, the inner container keeps track of the actual
+ ** type by means of a vtable. OpaqueHolder is built on top of InPlaceAnyHolder
+ ** additionally to support a "common base interface" and re-access of the
+ ** embedded object through this interface. For this to work, all of the 
+ ** stored types need to be derived from this common base interface.
+ ** OpaqueHolder then may be even used like a smart-ptr, exposing this
+ ** base interface. To the contrary, InPlaceAnyHolder has lesser requirements
+ ** on the types to be stored within. It can be configured with policy classes
+ ** to control the re-access; when using InPlaceAnyHolder_unrelatedTypes
+ ** the individual types to be stored need not be related in any way, but
+ ** of course this rules out anything beyond re-accessing the embedded object
+ ** by knowing it's exact type. Generally speaking, re-accessing the concrete
  ** object requires knowledge of the actual type, similar to boost::any
  ** (but contrary to OpaqueHolder the latter uses heap storage). 
  ** 
@@ -87,14 +97,15 @@ namespace lib {
     
   }
   
-  /* ==== Policy classes for OpaqueHolder ==== */
+  
+  
+  /* ==== Policy classes controlling re-Access ==== */
   
   /**
    * Standard policy for accessing the contents via 
    * a common base class interface. Using this policy
-   * causes a virtual get() function to be used, where
-   * the actual Buff-subclasses will define overrides
-   * with covariant return types.
+   * causes static or dynamic casts or direct conversion
+   * to be employed as appropriate.
    */
   template<class BA>
   struct InPlaceAnyHolder_useCommonBase
@@ -134,18 +145,15 @@ namespace lib {
     };
   
   /**
-   * Alternative policy for accessing the contents via
+   * Alternative policy for accessing the contents without
    * a common interface; use this policy if the intention is
    * to use OpaqueHolder with a family of similar classes, 
    * \em without requiring all of them to be derived from
    * a common base class. (E.g. tr1::function objects).
-   * In this case, the BA template  parameter of OpaqueHolder
-   * can be considered just a nominal placeholder. 
-   * @note using this policy renders the smart-ptr style
-   *       access largely useless and might even cause
-   *       segmentation errors, when trying to access
-   *       the contents of the buffer this way through
-   *       a brute force reinterpret_cast.
+   * In this case, the "Base" type will be defined to void*
+   * As a consequence, we loose all type information and
+   * no conversions are possible on re-access. You need
+   * to know the \em exact type to get back at the object.
    */
   struct InPlaceAnyHolder_unrelatedTypes
     {
@@ -166,26 +174,28 @@ namespace lib {
         }
     };
   
-
-/////////////////////////////TODO
-/////////////////////////////: separieren in einen InPlaceAnyHolder
-/////////////////////////////: und als dessen Kind den OpaqueHolder
-/////////////////////////////: AccessPolicy unter die konkrete Buff-Klasse einschieben
-/////////////////////////////: EmptyBuffer als abgeleitet.
-    
+  
+  
+  
+  
   
   
   /**
    * Inline buffer holding and owning an object while concealing the
-   * concrete type. Access to the contained object is similar to a
-   * smart-pointer, but the object isn't heap allocated. OpaqueHolder
-   * may be created empty, which can be checked by a bool test.
-   * The whole compound is copyable if and only if the contained object
-   * is copyable.
+   * concrete type. The object is given either as ctor parameter or
+   * by direct assignment; it is copy-constructed into the buffer.
+   * It is necessary to specify the required buffer storage space
+   * as a template parameter. InPlaceAnyHolder may be created empty
+   * or cleared afterwards, and this #empty() state may be detected
+   * at runtime. In a similar vein, when the stored object has a
+   * \c bool validity check, this can be accessed though #isValid().
+   * Moreover \code !empty() && isValid() \endcode may be tested
+   * as by \bool conversion of the Holder object. The whole compound
+   * is copyable if and only if the contained object is copyable.
    * 
-   * For using OpaqueHolder, several \b assumptions need to be fulfilled
-   * - any instance placed into OpaqueHolder is below the specified maximum size
-   * - the caller cares for thread safety. No concurrent get calls while in mutation!
+   * @note assertion failure when trying to place an instance not
+   *       fitting into given size.
+   * @note \em not threadsafe!
    */
   template
     < size_t siz           ///< maximum storage required for the targets to be held inline
@@ -204,30 +214,14 @@ namespace lib {
           void* ptr() { return &content_; }
           
           virtual ~Buffer() {}
-          virtual bool isValid()  const =0;
-          virtual bool empty()    const =0;
-          virtual BaseP getBase() const =0;
-          
-          virtual void   clone (void* targetStorage)  const =0;
-        };
-      
-      template<typename TY>
-      struct AbstractBuff : Buffer
-        {
-          TY&
-          get()  const  ///< core operation: target is contained within the inline buffer
-            {
-              return *reinterpret_cast<TY*> (unConst(this)->ptr());
-            }
-          
-          BaseP
-          getBase()  const
-            {
-              return AccessPolicy::convert2base (get());
-            }
+          virtual bool  isValid()  const =0;
+          virtual bool  empty()    const =0;
+          virtual BaseP getBase()  const =0;
           
+          virtual void  clone (void* targetStorage)  const =0;
         };
       
+      /** special case: no stored object */
       struct EmptyBuff : Buffer
         {
           virtual bool isValid()  const { return false; }
@@ -244,15 +238,20 @@ namespace lib {
             {
               new(targetStorage) EmptyBuff();
             }
-          
         };
       
       
       /** concrete subclass managing a specific kind of contained object.
-       *  @note invariant: content_ always contains a valid SUB object */
+       *  @note invariant: #content_ always contains a valid SUB object */
       template<typename SUB>
-      struct Buff : AbstractBuff<SUB>
+      struct Buff : Buffer
         {
+          SUB&
+          get()  const  ///< core operation: target is contained within the inline buffer
+            {
+              return *reinterpret_cast<SUB*> (unConst(this)->ptr());
+            }
+          
           ~Buff()
             {
               get().~SUB();
@@ -269,20 +268,27 @@ namespace lib {
             {
               new(Buffer::ptr()) SUB (oBuff.get());
             }
-      
+          
           Buff&
-          operator= (Buff const& ref) ///< not used currently 
+          operator= (Buff const& ref) ///< currently not used
             {
               if (&ref != this)
                 get() = ref.get();
               return *this;
             }
           
+          /* == virtual access functions == */
           
           virtual void
           clone (void* targetStorage)  const
             {
-              new(targetStorage) Buff(this->get());
+              new(targetStorage) Buff(get());
+            }
+          
+          virtual BaseP
+          getBase()  const
+            {
+              return AccessPolicy::convert2base (get());
             }
           
           virtual bool
@@ -299,6 +305,7 @@ namespace lib {
         };
       
       
+      
       enum{ BUFFSIZE = sizeof(Buffer) };
       
       /** embedded buffer actually holding the concrete Buff object,
@@ -310,8 +317,9 @@ namespace lib {
       
       
       
-      /* === internal interface for managing the storage === */
-    protected:
+      
+    protected: /* === internal interface for managing the storage === */
+      
       Buffer&
       buff()
         {
@@ -324,23 +332,27 @@ namespace lib {
         }
       
       
-      void killBuffer()                          
-        { 
+      void
+      killBuffer()                          
+        {
           buff().~Buffer();
         }
       
-      void make_emptyBuff()
+      void
+      make_emptyBuff()
         {
           new(&storage_) EmptyBuff();
         }
       
       template<class SUB>
-      void place_inBuff (SUB const& obj)
+      void
+      place_inBuff (SUB const& obj)
         {
           new(&storage_) Buff<SUB> (obj);
         }
       
-      void clone_inBuff (InPlaceAnyHolder const& ref)
+      void
+      clone_inBuff (InPlaceAnyHolder const& ref)
         {
           ref.buff().clone (storage_);
         }
@@ -348,6 +360,7 @@ namespace lib {
       
       
     public:
+      
       ~InPlaceAnyHolder()
         {
           killBuffer();
@@ -420,8 +433,21 @@ namespace lib {
       
       
       
-      /* === re-accessing the concrete contained object === */
-      
+      /** re-accessing the concrete contained object.
+       *  When the specified type is exactly the same
+       *  as used when storing the object, we can directly
+       *  re-access the buffer. Otherwise, a conversion might
+       *  be possible going through the Base type, depending
+       *  on the actual types involved and the AccessPolicy.
+       *  But, as we don't "know" the actual type of the object
+       *  in storage, a \em static upcast to any type \em between
+       *  the concrete object type and the base type has to be
+       *  ruled out for safety reasons. When the contained object
+       *  has RTTI, a \em dynamic cast can be performed in this
+       *  situation. You might consider using visitor.hpp instead
+       *  if this imposes a serious limitation.
+       *  @throws lumiera::error::Logic when conversion/access fails
+       */
       template<class SUB>
       SUB& get()  const
         {
@@ -463,13 +489,16 @@ namespace lib {
   
   
   
+  
+  
+  
   /**
    * Inline buffer holding and owning an object while concealing the
    * concrete type. Access to the contained object is similar to a
    * smart-pointer, but the object isn't heap allocated. OpaqueHolder
    * may be created empty, which can be checked by a bool test.
-   * The whole compound is copyable if and only if the contained object
-   * is copyable.
+   * The whole compound is copyable if and only if the contained
+   * object is copyable.
    *
    * \par using OpaqueHolder
    * OpaqueHolder instances are copyable value objects. They are created
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index aadd03e14..4c0922e2e 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -211,15 +211,16 @@ namespace test {
           // fabricate an unbound functor...
           
           typedef typename BuildEmptyFunctor<HOL>::Type NoFunc;
-          NoFunc noFunction;
+          NoFunc noFunction = NoFunc();
           HOL emptyHolder (noFunction);
           ASSERT (!emptyHolder);
+          
           ASSERT ( h1 );
           ASSERT ( h2 );
           ASSERT ( h3 );
         }
       
-
+      
     };
   
   
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
index 26b9fb25d..90d9a5333 100644
--- a/tests/lib/opaque-holder-test.cpp
+++ b/tests/lib/opaque-holder-test.cpp
@@ -40,6 +40,7 @@ namespace test{
   using util::isnil;
   using util::for_each;
   using util::isSameObject;
+  using lumiera::error::LUMIERA_ERROR_INVALID;
   using lumiera::error::LUMIERA_ERROR_ASSERTION;
   
   using std::vector;
@@ -88,13 +89,13 @@ namespace test{
             return myVal_ % 2;
           }
       };
-          
-      
-      /** maximum additional storage maybe wasted
-       *  due to alignment of the contained object
-       *  within OpaqueHolder's buffer
-       */
-      const size_t ALLIGNMENT = sizeof(size_t);
+    
+    
+    /** maximum additional storage maybe wasted
+     *  due to alignment of the contained object
+     *  within OpaqueHolder's buffer
+     */
+    const size_t ALLIGNMENT = sizeof(size_t);
     
   }
   
@@ -104,14 +105,14 @@ namespace test{
   
   
   /**********************************************************************************
-   *  @test use the OpaqueHolder inline buffer to handle a family of classes
+   *  @test use the OpaqueHolder inline buffer to handle objects of a family of types
    *        through a common interface, without being forced to use heap storage
    *        or a custom allocator.
-   *        
-   *  @todo this test doesn't cover automatic conversions and conversions using
-   *        RTTI from the target objects, while OpaqueHolder.tempate get() would
-   *        allow for such conversions. This is similar to Ticket #141, and actually
-   *        based on the same code as variant.hpp (access-casted.hpp)
+   *
+   *  @todo this test doesn't cover automatic conversions and conversions using RTTI
+   *        from the target objects, while \code OpaqueHolder.template get() \endcode
+   *        would allow for such conversions. This is similar to Ticket #141, and
+   *        actually based on the same code as variant.hpp (access-casted.hpp)
    */
   class OpaqueHolder_test : public Test
     {
@@ -150,6 +151,9 @@ namespace test{
         }
       
       
+      /** @test cover the basic situations of object handling,
+       *        especially copy operations and re-assignments
+       */
       void
       checkHandling (TestList& objs)
         {
@@ -164,25 +168,28 @@ namespace test{
           typedef DD<3> D3;
           typedef DD<5> D5;
           D3 d3 (oo.get<D3>() );
-          ASSERT (3 == oo->getIt());
+          ASSERT (3 == oo->getIt());    // re-access through Base interface
           ASSERT (!isSameObject (d3, *oo));
           VERIFY_ERROR (WRONG_TYPE, oo.get<D5>() );
           
-          oo = D5();        // direct assignment of target into Buffer
+          // direct assignment of target into Buffer
+          oo = D5();
           ASSERT (oo);
           ASSERT (5 == oo->getIt());
           VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
           
-          D5 &rd5 (oo.get<D5>());   // can get a direct reference to contained object 
+          // can get a direct reference to contained object
+          D5 &rd5 (oo.get<D5>()); 
           ASSERT (isSameObject (rd5, *oo));
           
           ASSERT (!isnil(oo));
           oo = objs[3];     // copy construction also works on non-empty object
           ASSERT (7 == oo->getIt());
           
-          ASSERT (7 == rd5.getIt()); // WARNING: direct ref has been messed up through the backdoor!
+          // WARNING: direct ref has been messed up through the backdoor!
+          ASSERT (7 == rd5.getIt());
           ASSERT (isSameObject (rd5, *oo));
-
+          
           uint cnt_before = _create_count;
           
           oo.clear();
@@ -190,7 +197,9 @@ namespace test{
           oo = D5();        // direct assignment also works on empty object
           ASSERT (oo);
           ASSERT (5 == oo->getIt());
-          ASSERT (_create_count == 2 + cnt_before); // one within buff and one for the anonymous temporary D5()
+          ASSERT (_create_count == 2 + cnt_before);
+          // one within buff and one for the anonymous temporary D5()
+          
           
           // verify that self-assignment is properly detected...
           cnt_before = _create_count;
@@ -206,6 +215,11 @@ namespace test{
           oo.clear();
           ASSERT (!oo);
           ASSERT (isnil(oo));
+          VERIFY_ERROR (INVALID, oo.get<D5>() );
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          VERIFY_ERROR (ASSERTION, oo->getIt() );
+#endif////////////////////////////////////////////////////////////
+          // can't access empty holder...
           
           Opaque o1 (oo);
           ASSERT (!o1);

From bb390f2ef17251c6a530ef916a665169dbf624bc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 6 Jul 2009 03:48:45 +0200
Subject: [PATCH 173/368] WIP: back to the original topic, define how capturing
 should work

---
 .../proc/control/command-mutation-test.cpp    | 74 +++++++++----------
 1 file changed, 36 insertions(+), 38 deletions(-)

diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index 424a66445..dc2f5e95a 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -33,6 +33,7 @@
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-mutation.hpp"
+#include "proc/control/memento-tie.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/tuple.hpp"
 //#include "lib/lumitime.hpp"
@@ -113,6 +114,7 @@ namespace test    {
         {
           checkMutation();
           checkUndoMutation();
+          checkStateCapturingMechanism();
         }
       
       
@@ -152,10 +154,15 @@ namespace test    {
        *        "undo" function; thus its parameter has now the meaning of an
        *        captured state value. Consequently this time the \em operation
        *        which is to be undone would have the signature \c void(void) .
-       *        To carry out the test, we first have to trigger the state
-       *        capturing mechanism; after that, invoking the UndoMutation
-       *        will call the testFunc with the previously captured state.
-       *  @note Mutation and UndoMutation are value objects.
+       *        Obviously this is a rather silly "undo" function, but it is
+       *        easy to check in a unit test. To carry out this test, we first
+       *        have to trigger the state capturing mechanism; after that,
+       *        invoking the UndoMutation will call the testFunc with the
+       *        previously captured state.
+       *  @note Mutation and UndoMutation are value objects, but they refer
+       *        to a common command state, which for this test is modelled
+       *        by local variables and which for the real commands is 
+       *        contained in a CommandArgumentHolder
        */
       void
       checkUndoMutation ()
@@ -163,7 +170,8 @@ namespace test    {
           function<void(int)> undo_func  = bind (&testFunc,_1);
           function<int(void)> cap_func   = bind (&capture    );
           
-          UndoMutation undoFunctor (undo_func,cap_func);
+          MementoTie mementoHolder (undo_func,cap_func);
+          UndoMutation undoFunctor (mementoHolder);
           ASSERT (!undoFunctor);
           VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor() );
           
@@ -173,15 +181,14 @@ namespace test    {
           undoFunctor.close(clo);
           ASSERT (!undoFunctor);
           VERIFY_ERROR (MISSING_MEMENTO, undoFunctor() );
-          VERIFY_ERROR (MISSING_MEMENTO, undoFunctor.getMemento() );
+          VERIFY_ERROR (MISSING_MEMENTO, mementoHoder.getState() );
           
           testVal = 11;
           undoFunctor.captureState();
           ASSERT (undoFunctor);
           ASSERT (testVal == 11);
           
-          CmdClosure& mem = undoFunctor.getMemento();
-          cout << showSizeof(mem) << endl;
+          int mem = mementoHolder.getState();
           cout << "saved state: " << mem << endl;
           
           undoFunctor();
@@ -189,19 +196,20 @@ namespace test    {
           undoFunctor();
           ASSERT (testVal == 11 + 11 + 11);
           undoFunctor.captureState();
+          ASSERT (33 == mementoHolder.getState());
           undoFunctor();
           ASSERT (testVal == 33 + 33);
           testVal = 9;
           undoFunctor();
           ASSERT (testVal == 42);
           
-          UndoMutation clonedFunc (undoFunctor);
-          ASSERT (&undoFunctor.getMemento() != &clonedFunc.getMemento());
+          UndoMutation clonedFunc (undoFunctor);    // refers to the same state
+          ASSERT (clonedFunc);
           
+          ASSERT (33 == mementoHolder.getState());
           clonedFunc.captureState();
-          testVal = 0;
-          undoFunctor();
-          ASSERT (testVal == 33);
+          ASSERT (42 == mementoHolder.getState());  // and captures into the same storage
+          
           testVal = 0;
           clonedFunc();
           ASSERT (testVal == 42);
@@ -209,48 +217,38 @@ namespace test    {
       
       
       void
-      checkStateCapturingClosure ()
+      checkStateCapturingMechanism ()
         {
           function<void(int)> undo_func  = bind (&testFunc,_1);
           function<int(void)> cap_func   = bind (&capture    );
 
-#if false ////////////////////////////////////////////////////////////////////TODO: doesn't compile, lots of undefined stuff          
-          MementoClosure memClo (cap_func);
-          CmdFunctor closed_cap_func = memClo.bindArguments (cap_func);
-          Tuple<Types<> > param;
-          Closure<void()> clo (param);
-          cout << "plain param values: " << clo << endl;
+          MementoTie mementoHolder (undo_func,cap_func);
           
-          Closure<void(int)> extendedClo = memClo.decorate (clo);
-          cout << "params including memento storage: " << extendedClo << endl;
+          function<void()> bound_undo_func = mementoHolder.tieUndoFunc();
+          function<void()> bound_cap_func  = mementoHolder.tieCaptureFunc();
           
-          CmdFunctor closed_undo_func = extendedClo.bindArguments (undo_func);
-          
-          VERIFY_ERROR (MISSING_MEMENTO, closed_undo_func() );     // invalid, because no state was captured
+          VERIFY_ERROR (MISSING_MEMENTO, bound_undo_func() );
+          VERIFY_ERROR (MISSING_MEMENTO, mementoHoder.getState() );
           
           int rr (rand() %100);
-          
           testVal = rr;
-          closed_cap_func();      // invoke state capturing 
+          bound_cap_func();       // invoke state capturing 
           
-          cout << "params including memento: " << memClo << endl;
-          cout << "captured memento state  : " << extendedClo << endl;
+          ASSERT (rr == mementoHolder.getState());
           
           testVal = -10;          // meanwhile "somehow" mutate the state
-          
-          closed_undo_func();     // invoking the undo() feeds back the memento
-          ASSERT (rr == testVal); // which is then restored into the state
+          bound_undo_func();      // invoking the undo() feeds back the memento
+          ASSERT (rr-10 == testVal);
           
           // this cycle can be repeated with different state values
           rr = (rand() %100);
           testVal = rr;
-          closed_cap_func();      // capture new state
-          cout << "params including memento: " << memClo << endl;
-                                //   ....note the changed memento!
+          bound_cap_func();       // capture new state
+          ASSERT (rr == mementoHolder.getState());
+          
           testVal = -20;
-          closed_undo_func();
-          ASSERT (rr == testVal);
-#endif          
+          bound_undo_func();
+          ASSERT (rr-20 == testVal);
         }
     };
   

From c8c577c4cc8b26f6899f0bc253cb5078ba9803dc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 6 Jul 2009 05:25:33 +0200
Subject: [PATCH 174/368] WIP factored out another helper, not yet tested...

---
 src/lib/meta/function-closure.hpp            | 58 +++++++++++++++++---
 tests/lib/meta/function-composition-test.cpp | 35 ++++++++++++
 2 files changed, 85 insertions(+), 8 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 74149ab40..bb4350410 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -692,6 +692,46 @@ namespace func    {
   
   
   
+  /**
+   * Bind a specific argument to an arbitrary value.
+   * Especially, this "value" might be another binder.
+   */
+  template<typename SIG, typename X, uint n>
+  class BindToArgument
+    {
+      typedef typename _Fun<SIG>::Args Args;
+      typedef typename _Fun<SIG>::Ret  Ret;
+      typedef typename Args::List ArgsList;
+      typedef typename Types<X>::List ValList;
+      
+      enum { ARG_CNT = count<ArgsList>::value };
+
+      typedef typename Splice<ArgsList, ValList, n>::Front RemainingFront;
+      typedef typename Splice<ArgsList, ValList, n>::Back  RemainingBack;
+      typedef typename func::PlaceholderTuple<RemainingFront>::PlaceholderSeq::List PlaceholdersBefore;
+      typedef typename func::PlaceholderTuple<RemainingBack,n>::PlaceholderSeq::List PlaceholdersBehind;
+      typedef typename Append<typename Append<PlaceholdersBefore,ValList>::List
+                             ,PlaceholdersBehind
+                             >::List                               PreparedArgs;
+      typedef typename Append<RemainingFront, RemainingBack>::List ReducedArgs;
+      
+      typedef tuple::BuildTuple<PreparedArgs, ValList, n> BuildPreparedArgs;
+      typedef typename Tuple<LeftReplaced>::TupleType  PreparedArgTuple;
+      
+      
+    public:
+      typedef function<typename FunctionTypedef<Ret,ReducedArgs>::Sig> ReducedFunc;
+      
+      static ReducedFunc
+      reduced (SIG& f, Tuple<ValList> const& val)
+        {
+          PreparedArgTuple params (BuildPreparedArgs::create(val));
+          return func::Apply<ARG_CNT>::template bind<ReducedFunc> (f, params);
+        }
+    };
+  
+  
+  
   namespace { // ...helpers for specifying types in function declarations....
     
     template<typename RET, typename ARG>
@@ -798,16 +838,18 @@ namespace func    {
     return PApply<SIG,ArgTypeSeq>::bindFront (f, val);
   }
   
-  /** close the given function over the last argument */
-  template<typename SIG, typename ARG>
+  
+  /** bind the last function argument to an arbitrary term,
+   *  which especially might be a (nested) binder... */
+  template<typename SIG, typename TERM>
   typename _PapE<SIG>::Function
-  applyLast (SIG& f, ARG arg)
+  bindLast (SIG& f, TERM arg)
   {
-    typedef typename _PapE<SIG>::Arg ArgType;
-    typedef Types<ArgType>           ArgTypeSeq;
-    typedef Tuple<ArgTypeSeq>        ArgTuple;
-    ArgTuple val(arg);
-    return PApply<SIG,ArgTypeSeq>::bindBack (f, val);
+    typedef Types<TERM>     ArgTypeSeq;
+    typedef Tuple<ArgTypeSeq> ArgTuple;
+    ArgTuple argT(arg);
+    const int LAST_POS = count<typename _Fun<SIG>::Args>::value;
+    return BindToArgument<SIG,TERM,LAST_POS>::reduced (f, argT);
   }
   
   
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index cfeb26539..3ce70af52 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -135,6 +135,7 @@ namespace test    {
           check_diagnostics ();
           check_partialApplication ();
           check_functionalComposition ();
+          check_bindToArbitraryParameter ();
         }
       
       
@@ -315,6 +316,40 @@ namespace test    {
           ASSERT (1+2+3+4+5 == func::chained(f5, ff) (_1_,_2_,_3_,_4_,_5_) );
         }
       
+      
+      
+      void
+      check_bindToArbitraryParameter ()
+        {
+          typedef Num<1> Sig15(Num<1>,Num<2>,Num<3>,Num<4>,Num<5>);
+          typedef Num<1> SigR1(       Num<2>,Num<3>,Num<4>,Num<5>);
+          typedef Num<1> SigR2(Num<1>,       Num<3>,Num<4>,Num<5>);
+          typedef Num<1> SigR3(Num<1>,Num<2>,       Num<4>,Num<5>);
+          typedef Num<1> SigR4(Num<1>,Num<2>,Num<3>,       Num<5>);
+          typedef Num<1> SigR5(Num<1>,Num<2>,Num<3>,Num<4>       );
+
+          typedef Num<5> SigI5(Num<5>);
+          
+          Sig15& f = fun15<1,2,3,4,5>;
+          SigI5& f5 = fun11<5>;
+          Tuple<Types<char> > argT(55);
+          
+          SigR1& f_red1 = BindToArgument<Sig15,char,0>::reduced (f, argT);
+          SigR2& f_red2 = BindToArgument<Sig15,char,1>::reduced (f, argT);
+          SigR3& f_red3 = BindToArgument<Sig15,char,2>::reduced (f, argT);
+          SigR4& f_red4 = BindToArgument<Sig15,char,3>::reduced (f, argT);
+          SigR5& f_red5 = BindToArgument<Sig15,char,4>::reduced (f, argT);
+          
+          ASSERT (55+2+3+4+5 == f_red1 (    _2_,_3_,_4_,_5_) );
+          ASSERT (1+55+3+4+5 == f_red1 (_1_,    _3_,_4_,_5_) );
+          ASSERT (1+2+55+4+5 == f_red1 (_1_,_2_,    _4_,_5_) );
+          ASSERT (1+2+3+55+5 == f_red1 (_1_,_2_,_3_,    _5_) );
+          ASSERT (1+2+3+4+55 == f_red1 (_1_,_2_,_3_,_4_    ) );
+          
+          SigR5& f_2bind = bindLast (f, bind(f5, Num<5>(99)));
+          ASSERT (1+2+3+4+99 == f_2bind (_1_,_2_,_3_,_4_   ) );
+        }
+      
     };
   
   

From 2348a5af2b5298df175ddba67d9912f96335587b Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 6 Jul 2009 05:26:31 +0200
Subject: [PATCH 175/368] WIP draft capturing mechanism implementation, using
 the new tools and helpers...

---
 src/proc/control/command-mutation.hpp | 72 +++++--------------------
 src/proc/control/memento-tie.hpp      | 78 ++++++++++++++++++++-------
 2 files changed, 74 insertions(+), 76 deletions(-)

diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index cf745b778..0b1fa9937 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -37,6 +37,7 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
+#include "lib/bool-checkable.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 
@@ -66,6 +67,7 @@ namespace control {
    * @todo Type-comment
    */
   class Mutation
+    : public lib::BoolCheckable<Mutation>
     {
       CmdFunctor func_;
       CmdClosure* clo_;
@@ -101,37 +103,24 @@ namespace control {
         }
       
       
-      /* == diagnostics == */
-      typedef CmdClosure* Mutation::*_unspecified_bool_type;
-      
-      /** implicit conversion to "bool" */ 
-      operator _unspecified_bool_type()  const { return  isValid()? &Mutation::clo_ : 0; }  // never throws
-      bool operator! ()                  const { return !isValid(); }                      //  ditto
-      
+      /** diagnostics */
       operator string()  const
         { 
           return isValid()? string (*clo_) : "Mutation(state missing)";
         }
       
-    protected:
       virtual bool
       isValid ()   const
         {
           return func_ && clo_;
         }
       
+    protected:
       void
       invoke (CmdFunctor & closedFunction)
         {
           closedFunction.getFun<void()>() ();
         }
-      
-      CmdClosure&
-      getClosure() ///< Interface for subclasses to access the bound parameters
-        {
-          REQUIRE (clo_, "Lifecycle error: function arguments not yet bound");
-          return *clo_;
-        }
     };
   
   
@@ -146,51 +135,24 @@ namespace control {
   class UndoMutation
     : public Mutation
     {
-      Mutation memento_;
+      Mutation captureMemento_;
       
     public:
-      template<typename SIG_undo, typename SIG_cap>
-      UndoMutation (function<SIG_undo> const& undoFunc,
-                    function<SIG_cap> const& captureFunc)
-        : Mutation (undoFunc)
-        , memento_(captureFunc)
+      template<typename TIE>
+      UndoMutation (TIE & mementoHolder)
+        : Mutation (mementoHolder.tieUndoFunc())
+        , captureMemento_(mementoHolder.tieCaptureFunc())
         { }
-
-#if false /////////////////////////////////////////////////TODO: remove after refactoring
-      UndoMutation (UndoMutation const& o)
-        : Mutation (*this)
-        , captureFunc_(o.captureFunc_)
-        , memento_(o.memento_->clone().get())
-        { }
-      
-      UndoMutation&
-      operator= (UndoMutation const& o)
-        {
-          Mutation::operator= (o);
-          captureFunc_ = o.captureFunc_;
-          memento_.reset(o.memento_->clone().get());
-          return *this;
-        }
       
       
       virtual Mutation&
       close (CmdClosure& cmdClosure)
         {
-          REQUIRE (!memento_,    "Lifecycle error: already closed over the arguments");
-          REQUIRE (captureFunc_, "Param error: not bound to a valid function");
-          
-          // create a special state closure, which can later on store the captured undo state (memento)
-          scoped_ptr<MementoClosure> stateClosure (new MementoClosure (captureFunc_));
-          CmdFunctor closedCaptureFunc = cmdClosure.bindArguments(captureFunc_);
-          
-          // the undoFunc (within parent class) will retrieve an argument tuple extended by the memento
-          Mutation::close (stateClosure->decorate (cmdClosure));
-          
-          captureFunc_ = closedCaptureFunc;
-//          memento_.swap(stateClosure);
+          Mutation::close(cmdClosure);
+          captureMemento_.close(cmdClosure);
           return *this;
         }
-#endif      
+      
       
       Mutation&
       captureState ()
@@ -199,22 +161,16 @@ namespace control {
             throw lumiera::error::State ("need to bind function arguments prior to capturing undo state",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          memento_();
+          captureMemento_();
           return *this;
         }
       
-      CmdClosure&
-      getMemento()
-        {
-          ASSERT (memento_, "Lifecycle error: need to close first");
-//          return *memento_;
-        }
       
     private:
       virtual bool
       isValid ()   const
         {
-//          return Mutation::isValid() && captureFunc_ && memento_;
+          return Mutation::isValid() && memento_;
         }
       
       
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index 14fc45a90..2f73575b7 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -28,7 +28,6 @@
  ** the "undo capture function" and the actual "undo function", by retrieving the
  ** memento data or memento object from the former and feeding it to the latter
  ** as an additional parameter, when the undo operation is invoked.
- ** //TODO
  **  
  ** @see CmdClosure
  ** @see UndoMutation
@@ -44,7 +43,7 @@
 //#include "pre.hpp"
 //#include "lib/meta/typelist.hpp"  ////////////////TODO include these??
 //#include "lib/meta/function.hpp"
-//#include "lib/meta/function-closure.hpp"
+#include "lib/meta/function-closure.hpp"
 //#include "lib/meta/function-erasure.hpp"
 //#include "lib/meta/tuple.hpp"
 #include "proc/control/command-signature.hpp"
@@ -52,7 +51,7 @@
 #include "lib/util.hpp"
 
 //#include <tr1/memory>
-//#include <tr1/functional>
+#include <tr1/functional>
 //#include <iostream> 
 //#include <string>
 
@@ -70,6 +69,7 @@ namespace control {
 //  using std::tr1::shared_ptr;
 //  using util::unConst;
   using std::string;
+  using lumiera::typelist::func::bindLast;
 //  using std::ostream;
 //  using std::tr1::function;
 //  using lumiera::typelist::FunctionSignature;
@@ -85,10 +85,10 @@ namespace control {
   
   /**
    *  Binding together state capturing and execution of the undo operation.
-   *  MementoTie itself is passive container object with a very specific type,
+   *  MementoTie itself is a passive container object with a very specific type,
    *  depending on the type of the operation arguments and the type of the memento.
    *  It is to be allocated within the ArgumentHolder of the command, thereby wrapping
-   *  or decorating the undo and capture function, setting up  the necessary bindings and
+   *  or decorating the undo and capture function, setting up the necessary bindings and
    *  closures, allowing them to cooperate behind the scenes to carry out the UNDO functionality.
    *  Through a reference to the MementoTie, the UndoMutation functor gets access to the prepared
    *  functions, storing them into generic containers (type erasure) for later invocation. 
@@ -109,20 +109,15 @@ namespace control {
       /** storage holding the captured state for undo */
       MEM memento_;
       
-      function<SIG> undo_;
-      function<SIG> capture_;
+      bool isCaptured_;
       
+      function<SIG_undo> undo_;
+      function<SIG_cap> capture_;
       
-      function<SIG>
-      buildFun()
+      void capture (MEM const& mementoVal)
         {
-//          PlaceholderTuple<SIG> tup;
-//          return tupleApplicator(tup).bind(origFun);
-        }
-      
-      void capture ()
-        {
-          memento_ = capture();
+          memento_ = mementoVal;
+          isCaptured_ = true;
         }
       
     public:
@@ -133,11 +128,58 @@ namespace control {
        */
       MementoTie (function<SIG_undo> const& undoFunc,
                   function<SIG_cap> const& captureFunc)
+        : memento_()
+        , isCaptured_(false)
+        , undo_(undoFunc)
+        , capture_(captureFunc)
         { }
       
+      
+      /** bind the undo function to the internal memento store within this object.
+       *  @return a functor, which, when invoked with the remaining arguments, will
+       *        automatically call #getState() to retrieve the current memento value.
+       *  @note similar to #getState(), the returned functor will throw
+       *        when the state capturing wasn't yet invoked
+       */
+      function<SIG>
+      tieUndoFunc()
+        {
+          using std::tr1::bind;
+          
+          return bindLast( undo_
+                         , bind (&MementoTie::getState, this)
+                         );
+        }
+      
+      /** bind the capturing function to the internal memento store within this object.
+       *  @return a functor, which on invocation will automatically store the return value
+       *        of the capturing function (= the current memento value) into the field
+       *        #memento_ within this object 
+       */
+      function<SIG>
+      tieCaptureFunc()
+        {
+          using std::tr1::placeholders::_1;
+          
+          function<void(MEM)> doCaptureMemento = bind (&MementoTie::capture, this, _1);
+          
+          return chained(capture_, doCaptureMemento);
+        }
+      
+      
+      /** get the currently captured memento state value
+       *  @throw when the capturing function wasn't yet invoked
+       */
+      MEM&
+      getState ()
+        {
+          if (!isCaptured_)
+            throw lumiera::error::State ("need to invoke memento state capturing beforehand",
+                                         LUMIERA_ERROR_MISSING_MEMENTO);
+          return memento_;
+        }
+      
     };
-    
-  ////////////////TODO currently just fleshing  out the API....
   
   
   

From c7b6165c6cab93995c0d43228c62319c6d697233 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 8 Jul 2009 05:36:02 +0200
Subject: [PATCH 176/368] WIP resolved the simple mismatches, but still...

---
 src/lib/meta/function-closure.hpp             | 26 ++++++++---
 src/proc/control/command-mutation.hpp         | 12 +++--
 src/proc/control/memento-tie.hpp              |  2 +
 .../proc/control/command-mutation-test.cpp    | 41 ++---------------
 .../proc/control/memento-tie-test.cpp         | 44 ++++++++-----------
 tests/lib/meta/function-composition-test.cpp  | 33 ++++++++------
 tests/lib/meta/typelist-diagnostics.hpp       |  1 +
 7 files changed, 72 insertions(+), 87 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index bb4350410..d0060fdca 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -710,17 +710,19 @@ namespace func    {
       typedef typename Splice<ArgsList, ValList, n>::Back  RemainingBack;
       typedef typename func::PlaceholderTuple<RemainingFront>::PlaceholderSeq::List PlaceholdersBefore;
       typedef typename func::PlaceholderTuple<RemainingBack,n>::PlaceholderSeq::List PlaceholdersBehind;
-      typedef typename Append<typename Append<PlaceholdersBefore,ValList>::List
-                             ,PlaceholdersBehind
-                             >::List                               PreparedArgs;
+      typedef typename Append< typename Append< PlaceholdersBefore
+                                              , ValList >::List
+                             , PlaceholdersBehind >::List          PreparedArgs;
       typedef typename Append<RemainingFront, RemainingBack>::List ReducedArgs;
       
       typedef tuple::BuildTuple<PreparedArgs, ValList, n> BuildPreparedArgs;
-      typedef typename Tuple<LeftReplaced>::TupleType  PreparedArgTuple;
+      typedef typename Tuple<PreparedArgs>::TupleType  PreparedArgTuple;
+      typedef typename Types<ReducedArgs>::Seq RemainingArgs;
       
+      typedef typename FunctionTypedef<Ret,RemainingArgs>::Sig ReducedSig;
       
     public:
-      typedef function<typename FunctionTypedef<Ret,ReducedArgs>::Sig> ReducedFunc;
+      typedef function<ReducedSig> ReducedFunc;
       
       static ReducedFunc
       reduced (SIG& f, Tuple<ValList> const& val)
@@ -838,6 +840,18 @@ namespace func    {
     return PApply<SIG,ArgTypeSeq>::bindFront (f, val);
   }
   
+  /** close the given function over the last argument */
+  template<typename SIG, typename ARG>
+  typename _PapE<SIG>::Function
+  applyLast (SIG& f, ARG arg)
+  {
+    typedef typename _PapE<SIG>::Arg ArgType;
+    typedef Types<ArgType>           ArgTypeSeq;
+    typedef Tuple<ArgTypeSeq>        ArgTuple;
+    ArgTuple val(arg);
+    return PApply<SIG,ArgTypeSeq>::bindBack (f, val);
+  }
+  
   
   /** bind the last function argument to an arbitrary term,
    *  which especially might be a (nested) binder... */
@@ -848,7 +862,7 @@ namespace func    {
     typedef Types<TERM>     ArgTypeSeq;
     typedef Tuple<ArgTypeSeq> ArgTuple;
     ArgTuple argT(arg);
-    const int LAST_POS = count<typename _Fun<SIG>::Args>::value;
+    enum { LAST_POS = count<typename _Fun<SIG>::Args::List>::value };
     return BindToArgument<SIG,TERM,LAST_POS>::reduced (f, argT);
   }
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 0b1fa9937..223e36a6f 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -60,7 +60,6 @@ namespace control {
   
   
   LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Mutation functor not yet usable, because arguments aren't bound
-  LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);   ///<  Undo functor not yet usable, because no undo state has been captured
   
   
   /**
@@ -138,12 +137,17 @@ namespace control {
       Mutation captureMemento_;
       
     public:
-      template<typename TIE>
-      UndoMutation (TIE & mementoHolder)
+      template<typename SIG, typename MEM>
+      UndoMutation (MementoTie<SIG,MEM> & mementoHolder)
         : Mutation (mementoHolder.tieUndoFunc())
         , captureMemento_(mementoHolder.tieCaptureFunc())
         { }
       
+//      UndoMutation (UndoMutation const& o)
+//        : Mutation(o)
+//        , captureMemento_(o.captureMemento_)
+//        { }
+      
       
       virtual Mutation&
       close (CmdClosure& cmdClosure)
@@ -170,7 +174,7 @@ namespace control {
       virtual bool
       isValid ()   const
         {
-          return Mutation::isValid() && memento_;
+          return Mutation::isValid() && captureMemento_;
         }
       
       
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index 2f73575b7..eb6baf506 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -70,6 +70,7 @@ namespace control {
 //  using util::unConst;
   using std::string;
   using lumiera::typelist::func::bindLast;
+  using lumiera::typelist::func::chained;
 //  using std::ostream;
 //  using std::tr1::function;
 //  using lumiera::typelist::FunctionSignature;
@@ -81,6 +82,7 @@ namespace control {
   
 //  using lumiera::typelist::NullType;
     
+  LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);  ///<  Undo functor not yet usable, because no undo state has been captured
   
   
   /**
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index dc2f5e95a..d8f6fb885 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -114,7 +114,6 @@ namespace test    {
         {
           checkMutation();
           checkUndoMutation();
-          checkStateCapturingMechanism();
         }
       
       
@@ -170,7 +169,9 @@ namespace test    {
           function<void(int)> undo_func  = bind (&testFunc,_1);
           function<int(void)> cap_func   = bind (&capture    );
           
-          MementoTie mementoHolder (undo_func,cap_func);
+          typedef MementoTie<void(),int> MemHolder;
+          
+          MemHolder mementoHolder (undo_func,cap_func);
           UndoMutation undoFunctor (mementoHolder);
           ASSERT (!undoFunctor);
           VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor() );
@@ -181,7 +182,7 @@ namespace test    {
           undoFunctor.close(clo);
           ASSERT (!undoFunctor);
           VERIFY_ERROR (MISSING_MEMENTO, undoFunctor() );
-          VERIFY_ERROR (MISSING_MEMENTO, mementoHoder.getState() );
+          VERIFY_ERROR (MISSING_MEMENTO, mementoHolder.getState() );
           
           testVal = 11;
           undoFunctor.captureState();
@@ -216,40 +217,6 @@ namespace test    {
         }
       
       
-      void
-      checkStateCapturingMechanism ()
-        {
-          function<void(int)> undo_func  = bind (&testFunc,_1);
-          function<int(void)> cap_func   = bind (&capture    );
-
-          MementoTie mementoHolder (undo_func,cap_func);
-          
-          function<void()> bound_undo_func = mementoHolder.tieUndoFunc();
-          function<void()> bound_cap_func  = mementoHolder.tieCaptureFunc();
-          
-          VERIFY_ERROR (MISSING_MEMENTO, bound_undo_func() );
-          VERIFY_ERROR (MISSING_MEMENTO, mementoHoder.getState() );
-          
-          int rr (rand() %100);
-          testVal = rr;
-          bound_cap_func();       // invoke state capturing 
-          
-          ASSERT (rr == mementoHolder.getState());
-          
-          testVal = -10;          // meanwhile "somehow" mutate the state
-          bound_undo_func();      // invoking the undo() feeds back the memento
-          ASSERT (rr-10 == testVal);
-          
-          // this cycle can be repeated with different state values
-          rr = (rand() %100);
-          testVal = rr;
-          bound_cap_func();       // capture new state
-          ASSERT (rr == mementoHolder.getState());
-          
-          testVal = -20;
-          bound_undo_func();
-          ASSERT (rr-20 == testVal);
-        }
     };
   
   
diff --git a/tests/components/proc/control/memento-tie-test.cpp b/tests/components/proc/control/memento-tie-test.cpp
index 938033e5e..c0dbfb28c 100644
--- a/tests/components/proc/control/memento-tie-test.cpp
+++ b/tests/components/proc/control/memento-tie-test.cpp
@@ -109,7 +109,7 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          checkStateCapturingClosure();
+          checkStateCapturingMechanism();
         }
       
       
@@ -122,48 +122,40 @@ namespace test    {
        *        state is captured by each invocation.
        */
       void
-      checkStateCapturingClosure ()
+      checkStateCapturingMechanism ()
         {
           function<void(int)> undo_func  = bind (&testFunc,_1);
           function<int(void)> cap_func   = bind (&capture    );
           
-#if false ////////////////////////////////////////////////////////////////////////TODO doesn't compile yet, lots of missing stuff          
-          MementoClosure memClo (cap_func);
-          CmdFunctor closed_cap_func = memClo.bindArguments (cap_func);
-          Tuple<Types<> > param;
-          Closure<void()> clo (param);
-          cout << "plain param values: " << clo << endl;
+          typedef MementoTie<void(),int> MemHolder;
+
+          MemHolder mementoHolder (undo_func,cap_func);
           
-          Closure<void(int)> extendedClo = memClo.decorate (clo);
-          cout << "params including memento storage: " << extendedClo << endl;
+          function<void()> bound_undo_func = mementoHolder.tieUndoFunc();
+          function<void()> bound_cap_func  = mementoHolder.tieCaptureFunc();
           
-          CmdFunctor closed_undo_func = extendedClo.bindArguments (undo_func);
-          
-          VERIFY_ERROR (MISSING_MEMENTO, closed_undo_func() );     // invalid, because no state was captured
+          VERIFY_ERROR (MISSING_MEMENTO, bound_undo_func() );
+          VERIFY_ERROR (MISSING_MEMENTO, mementoHolder.getState() );
           
           int rr (rand() %100);
-          
           testVal = rr;
-          closed_cap_func();      // invoke state capturing 
+          bound_cap_func();       // invoke state capturing 
           
-          cout << "params including memento: " << memClo << endl;
-          cout << "captured memento state  : " << extendedClo << endl;
+          ASSERT (rr == mementoHolder.getState());
           
           testVal = -10;          // meanwhile "somehow" mutate the state
-          
-          closed_undo_func();     // invoking the undo() feeds back the memento
-          ASSERT (rr == testVal); // which is then restored into the state
+          bound_undo_func();      // invoking the undo() feeds back the memento
+          ASSERT (rr-10 == testVal);
           
           // this cycle can be repeated with different state values
           rr = (rand() %100);
           testVal = rr;
-          closed_cap_func();      // capture new state
-          cout << "params including memento: " << memClo << endl;
-                                //   ....note the changed memento!
+          bound_cap_func();       // capture new state
+          ASSERT (rr == mementoHolder.getState());
+          
           testVal = -20;
-          closed_undo_func();
-          ASSERT (rr == testVal);
-#endif          
+          bound_undo_func();
+          ASSERT (rr-20 == testVal);
         }
     };
   
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index 3ce70af52..d67900d0e 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -36,7 +36,9 @@ namespace test    {
   using ::test::Test;
   using func::applyFirst;
   using func::applyLast;
+  using func::bindLast;
   using func::PApply;
+  using func::BindToArgument;
   
   
       namespace { // test functions
@@ -322,32 +324,35 @@ namespace test    {
       check_bindToArbitraryParameter ()
         {
           typedef Num<1> Sig15(Num<1>,Num<2>,Num<3>,Num<4>,Num<5>);
+          
           typedef Num<1> SigR1(       Num<2>,Num<3>,Num<4>,Num<5>);
           typedef Num<1> SigR2(Num<1>,       Num<3>,Num<4>,Num<5>);
           typedef Num<1> SigR3(Num<1>,Num<2>,       Num<4>,Num<5>);
           typedef Num<1> SigR4(Num<1>,Num<2>,Num<3>,       Num<5>);
           typedef Num<1> SigR5(Num<1>,Num<2>,Num<3>,Num<4>       );
 
-          typedef Num<5> SigI5(Num<5>);
+          typedef Num<5> SigA5(Num<5>);
           
           Sig15& f = fun15<1,2,3,4,5>;
-          SigI5& f5 = fun11<5>;
+          SigA5& f5 = fun11<5>;
           Tuple<Types<char> > argT(55);
           
-          SigR1& f_red1 = BindToArgument<Sig15,char,0>::reduced (f, argT);
-          SigR2& f_red2 = BindToArgument<Sig15,char,1>::reduced (f, argT);
-          SigR3& f_red3 = BindToArgument<Sig15,char,2>::reduced (f, argT);
-          SigR4& f_red4 = BindToArgument<Sig15,char,3>::reduced (f, argT);
-          SigR5& f_red5 = BindToArgument<Sig15,char,4>::reduced (f, argT);
+          function<SigR1> f_bound_1 = BindToArgument<Sig15,char,0>::reduced (f, argT);
+          function<SigR2> f_bound_2 = BindToArgument<Sig15,char,1>::reduced (f, argT);
+          function<SigR3> f_bound_3 = BindToArgument<Sig15,char,2>::reduced (f, argT);
+          function<SigR4> f_bound_4 = BindToArgument<Sig15,char,3>::reduced (f, argT);
+          function<SigR5> f_bound_5 = BindToArgument<Sig15,char,4>::reduced (f, argT);
           
-          ASSERT (55+2+3+4+5 == f_red1 (    _2_,_3_,_4_,_5_) );
-          ASSERT (1+55+3+4+5 == f_red1 (_1_,    _3_,_4_,_5_) );
-          ASSERT (1+2+55+4+5 == f_red1 (_1_,_2_,    _4_,_5_) );
-          ASSERT (1+2+3+55+5 == f_red1 (_1_,_2_,_3_,    _5_) );
-          ASSERT (1+2+3+4+55 == f_red1 (_1_,_2_,_3_,_4_    ) );
+          ASSERT (55+2+3+4+5 == f_bound_1 (    _2_,_3_,_4_,_5_) );
+          ASSERT (1+55+3+4+5 == f_bound_2 (_1_,    _3_,_4_,_5_) );
+          ASSERT (1+2+55+4+5 == f_bound_3 (_1_,_2_,    _4_,_5_) );
+          ASSERT (1+2+3+55+5 == f_bound_4 (_1_,_2_,_3_,    _5_) );
+          ASSERT (1+2+3+4+55 == f_bound_5 (_1_,_2_,_3_,_4_    ) );
           
-          SigR5& f_2bind = bindLast (f, bind(f5, Num<5>(99)));
-          ASSERT (1+2+3+4+99 == f_2bind (_1_,_2_,_3_,_4_   ) );
+          using std::tr1::bind;
+          
+          f_bound_5 = bindLast (f, bind(f5, Num<5>(99)));
+          ASSERT (1+2+3+4+99 == f_bound_5 (_1_,_2_,_3_,_4_   ) );
         }
       
     };
diff --git a/tests/lib/meta/typelist-diagnostics.hpp b/tests/lib/meta/typelist-diagnostics.hpp
index a5b77ac71..98728f3a7 100644
--- a/tests/lib/meta/typelist-diagnostics.hpp
+++ b/tests/lib/meta/typelist-diagnostics.hpp
@@ -58,6 +58,7 @@ namespace typelist{
     {
       char o_;
       Numz (char x =0) : o_(x) { }
+      operator char ()  const { return o_; }
     };
   
   

From 2eb8b763d6c46e6e7ba861f11e2a8455ddcb98ae Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 9 Jul 2009 04:41:44 +0200
Subject: [PATCH 177/368] got the helper working (prepending a binder to an
 argument position)

---
 src/lib/meta/function-closure.hpp            | 19 +++++++++++-------
 tests/lib/meta/function-composition-test.cpp | 21 ++++++++++++++++++--
 2 files changed, 31 insertions(+), 9 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index d0060fdca..80173ad74 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -669,11 +669,11 @@ namespace func    {
    * i.e. fed the result of invoking the first function
    * as argument into the second function.  
    */
-  template<typename SIG1, typename RET>
+  template<typename F1, typename RET>
   class FunctionComposition
     {
-      typedef typename func::_Fun<SIG1>::Args Args;
-      typedef typename func::_Fun<SIG1>::Ret  Ret1;
+      typedef typename func::_Fun<F1>::Args Args;
+      typedef typename func::_Fun<F1>::Ret  Ret1;
       
       typedef Types<Ret1> ArgsF2;
       typedef typename FunctionTypedef<RET, ArgsF2>::Sig SigF2;
@@ -684,9 +684,14 @@ namespace func    {
       
     public:
       static function<ChainedSig>
-      chain (SIG1& f1, SigF2& f2)
+      chain (F1& f1, SigF2& f2)
         {
-          return _composed::Build<ChainedSig,SIG1,SigF2, ARG_CNT>::func (f1,f2);
+          return _composed::Build<ChainedSig,F1,SigF2, ARG_CNT>::func (f1,f2);
+        }
+      static function<ChainedSig>
+      chain (F1& f1, function<SigF2>& f2)
+        {
+          return _composed::Build<ChainedSig,F1,function<SigF2>, ARG_CNT>::func (f1,f2);
         }
     };
   
@@ -857,12 +862,12 @@ namespace func    {
    *  which especially might be a (nested) binder... */
   template<typename SIG, typename TERM>
   typename _PapE<SIG>::Function
-  bindLast (SIG& f, TERM arg)
+  bindLast (SIG& f, TERM const& arg)
   {
     typedef Types<TERM>     ArgTypeSeq;
     typedef Tuple<ArgTypeSeq> ArgTuple;
     ArgTuple argT(arg);
-    enum { LAST_POS = count<typename _Fun<SIG>::Args::List>::value };
+    enum { LAST_POS = -1 + count<typename _Fun<SIG>::Args::List>::value };
     return BindToArgument<SIG,TERM,LAST_POS>::reduced (f, argT);
   }
   
diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index d67900d0e..50af03949 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -126,7 +126,8 @@ namespace test    {
   
   /******************************************************************************
    * @test this test covers some extensions and variations on function closures:
-   *       - partial application of a function, returning a binder
+   *       - partial application of a function, returning a partial closure
+   *       - variation: binding a arbitrary term, might even be a nested binder
    *       - chaining of two functions with suitable arguments ("composition")
    */
   class FunctionComposition_test : public Test
@@ -330,7 +331,7 @@ namespace test    {
           typedef Num<1> SigR3(Num<1>,Num<2>,       Num<4>,Num<5>);
           typedef Num<1> SigR4(Num<1>,Num<2>,Num<3>,       Num<5>);
           typedef Num<1> SigR5(Num<1>,Num<2>,Num<3>,Num<4>       );
-
+          
           typedef Num<5> SigA5(Num<5>);
           
           Sig15& f = fun15<1,2,3,4,5>;
@@ -349,10 +350,26 @@ namespace test    {
           ASSERT (1+2+3+55+5 == f_bound_4 (_1_,_2_,_3_,    _5_) );
           ASSERT (1+2+3+4+55 == f_bound_5 (_1_,_2_,_3_,_4_    ) );
           
+          
+          // degenerate case: specify wrong argument position (behind end of argument list)
+          // causes the argument to be simply ignored and no binding to happen
+          function<Sig15> f_bound_X = BindToArgument<Sig15,char,5>::reduced (f, argT);
+          ASSERT (1+2+3+4+5  == f_bound_X (_1_,_2_,_3_,_4_,_5_) );
+          
+          
+          /* check the convenient function-style API */
+          
           using std::tr1::bind;
           
           f_bound_5 = bindLast (f, bind(f5, Num<5>(99)));
           ASSERT (1+2+3+4+99 == f_bound_5 (_1_,_2_,_3_,_4_   ) );
+          
+          f_bound_5 = bindLast (f, bind(&f5, Num<5>(99)));        // can bind function pointer
+          ASSERT (1+2+3+4+99 == f_bound_5 (_1_,_2_,_3_,_4_   ) );
+          
+          function<Sig15> asFunctor(f);
+          f_bound_5 = bindLast (asFunctor, bind(f5, Num<5>(88))); // use functor instead of direct ref
+          ASSERT (1+2+3+4+88 == f_bound_5 (_1_,_2_,_3_,_4_   ) );
         }
       
     };

From ba910a126ed9cae07fe51425808ac907c105aa07 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 9 Jul 2009 17:22:44 +0200
Subject: [PATCH 178/368] also cover the combination cases

---
 tests/lib/meta/function-composition-test.cpp | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tests/lib/meta/function-composition-test.cpp b/tests/lib/meta/function-composition-test.cpp
index 50af03949..e6cec1f41 100644
--- a/tests/lib/meta/function-composition-test.cpp
+++ b/tests/lib/meta/function-composition-test.cpp
@@ -317,6 +317,13 @@ namespace test    {
           ASSERT (1+2+3     == func::chained(f3, ff) (_1_,_2_,_3_)         );
           ASSERT (1+2+3+4   == func::chained(f4, ff) (_1_,_2_,_3_,_4_)     );
           ASSERT (1+2+3+4+5 == func::chained(f5, ff) (_1_,_2_,_3_,_4_,_5_) );
+          
+          
+          function<Sig15> f5_fun = f5;     // also works with function objects...
+          function<Sig2>  ff_fun = ff;
+          ASSERT (1+2+3+4+5 == func::chained(f5_fun, ff    ) (_1_,_2_,_3_,_4_,_5_) );
+          ASSERT (1+2+3+4+5 == func::chained(f5,     ff_fun) (_1_,_2_,_3_,_4_,_5_) );
+          ASSERT (1+2+3+4+5 == func::chained(f5_fun, ff_fun) (_1_,_2_,_3_,_4_,_5_) );
         }
       
       

From 9e95ec8b60e7956043f0bc4a9545a85a5f91f823 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 9 Jul 2009 18:35:22 +0200
Subject: [PATCH 179/368] MementoTie unit test pass

---
 src/proc/control/command-signature.hpp             | 14 ++++++++------
 tests/components/proc/control/memento-tie-test.cpp |  2 +-
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/src/proc/control/command-signature.hpp b/src/proc/control/command-signature.hpp
index 0def46d01..a408724f2 100644
--- a/src/proc/control/command-signature.hpp
+++ b/src/proc/control/command-signature.hpp
@@ -51,7 +51,8 @@
 #include "lib/meta/function.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelist-util.hpp"
-#include "lib/meta/tuple.hpp"
+#include "lib/meta/typeseq-util.hpp"
+//#include "lib/meta/tuple.hpp"
 
 //#include <tr1/memory>
 #include <tr1/functional>
@@ -69,7 +70,7 @@ namespace control {
   using lumiera::typelist::FunctionTypedef;
   using lumiera::typelist::Types;
 //using lumiera::typelist::NullType;
-  using lumiera::typelist::Tuple;
+//using lumiera::typelist::Tuple;
   using lumiera::typelist::Append;
   using lumiera::typelist::SplitLast;
   
@@ -86,8 +87,9 @@ namespace control {
     {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       
-      typedef typename Append<Args, MEM>::List ExtendedArglist;
-      typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
+      typedef typename Args::List ArgList;
+      typedef typename Append<ArgList, MEM>::List ExtendedArglist;
+      typedef typename Types<ExtendedArglist>::Seq ExtendedArgs;
       
     public:
       typedef typename FunctionTypedef<void, Args>::Sig          OperateSig;
@@ -119,7 +121,7 @@ namespace control {
         {
           typedef RET Memento;
           typedef typename Append<ARG, Memento>::List ExtendedArglist;
-          typedef typename Tuple<ExtendedArglist>::Type ExtendedArgs;
+          typedef typename Types<ExtendedArglist>::Seq ExtendedArgs;
           
           typedef typename FunctionTypedef<void, ARG>::Sig           OperateSig;
           typedef typename FunctionTypedef<Ret,ARG>::Sig             CaptureSig;
@@ -133,7 +135,7 @@ namespace control {
           
           typedef typename SplitLast<Args>::Type Memento;
           typedef typename SplitLast<Args>::List OperationArglist;
-          typedef typename Tuple<OperationArglist>::Type OperationArgs;
+          typedef typename Types<OperationArglist>::Seq OperationArgs;
           
           typedef typename FunctionTypedef<void, OperationArgs>::Sig OperateSig;
           typedef typename FunctionTypedef<Ret,OperationArgs>::Sig   CaptureSig;
diff --git a/tests/components/proc/control/memento-tie-test.cpp b/tests/components/proc/control/memento-tie-test.cpp
index c0dbfb28c..28f7b957e 100644
--- a/tests/components/proc/control/memento-tie-test.cpp
+++ b/tests/components/proc/control/memento-tie-test.cpp
@@ -34,7 +34,7 @@
 //#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/memento-tie.hpp"
 //#include "lib/meta/typelist.hpp"
-#include "lib/meta/tuple.hpp"
+//#include "lib/meta/tuple.hpp"
 //#include "lib/lumitime.hpp"
 //#include "lib/util.hpp"
 

From 6bd1e8e179c87ef3c0ad74d3136a27a6e79ac1fd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 9 Jul 2009 20:47:21 +0200
Subject: [PATCH 180/368] tidy up and finish the MementoTie + unit test

---
 src/lib/bool-checkable.hpp                    |   9 +-
 src/proc/control/memento-tie.hpp              | 103 ++++++++-------
 tests/45controller.tests                      |   3 +-
 .../proc/control/memento-tie-test.cpp         | 119 +++++++-----------
 tests/lib/opaque-holder-test.cpp              |   6 +-
 5 files changed, 114 insertions(+), 126 deletions(-)

diff --git a/src/lib/bool-checkable.hpp b/src/lib/bool-checkable.hpp
index d10a1a150..bbae1a35f 100644
--- a/src/lib/bool-checkable.hpp
+++ b/src/lib/bool-checkable.hpp
@@ -57,7 +57,9 @@
 
 namespace lib {
   
-  
+  namespace imp {
+    struct Dummy {};
+  }
   
   
   /*
@@ -89,8 +91,11 @@ namespace lib {
    * @todo list some usage examples here
    * @see bool-checkable-test.cpp 
    */
-  template<class T>
+  template< class T                 ///< the target type implementing \c isValid()
+          , class PAR = imp::Dummy ///<  optional parent for inheritance chain
+          >
   struct BoolCheckable
+    : PAR
     {
       typedef bool (T::*ValidityCheck)()  const;
       typedef ValidityCheck _unspecified_bool_type;
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index eb6baf506..6e939811d 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -40,47 +40,19 @@
 #ifndef CONTROL_MEMENTO_TIE_H
 #define CONTROL_MEMENTO_TIE_H
 
-//#include "pre.hpp"
-//#include "lib/meta/typelist.hpp"  ////////////////TODO include these??
-//#include "lib/meta/function.hpp"
+#include "lib/bool-checkable.hpp"
 #include "lib/meta/function-closure.hpp"
-//#include "lib/meta/function-erasure.hpp"
-//#include "lib/meta/tuple.hpp"
 #include "proc/control/command-signature.hpp"
-#include "proc/control/command-closure.hpp" ////////TODO really??
 #include "lib/util.hpp"
 
-//#include <tr1/memory>
 #include <tr1/functional>
-//#include <iostream> 
-//#include <string>
-
-
-#include "lib/test/test-helper.hpp"  /////////////////TODO remove this
-using lib::test::showSizeof;
-
-using std::cout;    //////////////////////////////////TODO remove this
-using std::endl;
 
 
 namespace control {
   
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
-//  using util::unConst;
-  using std::string;
+  using std::tr1::ref;
   using lumiera::typelist::func::bindLast;
   using lumiera::typelist::func::chained;
-//  using std::ostream;
-//  using std::tr1::function;
-//  using lumiera::typelist::FunctionSignature;
-//  using lumiera::typelist::Tuple;
-//  using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::typelist::TupleApplicator;
-//  using lumiera::typelist::FunErasure;
-//  using lumiera::typelist::StoreFunction;
-  
-//  using lumiera::typelist::NullType;
     
   LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);  ///<  Undo functor not yet usable, because no undo state has been captured
   
@@ -90,39 +62,74 @@ namespace control {
    *  MementoTie itself is a passive container object with a very specific type,
    *  depending on the type of the operation arguments and the type of the memento.
    *  It is to be allocated within the ArgumentHolder of the command, thereby wrapping
-   *  or decorating the undo and capture function, setting up the necessary bindings and
-   *  closures, allowing them to cooperate behind the scenes to carry out the UNDO functionality.
-   *  Through a reference to the MementoTie, the UndoMutation functor gets access to the prepared
-   *  functions, storing them into generic containers (type erasure) for later invocation. 
+   *  the undo and capture function, setting up the necessary bindings and closures for
+   *  allowing them to cooperate behind the scenes to carry out the UNDO functionality.
+   *  On construction, the UndoMutation functor retrieves the wired up functions,
+   *  storing them into generic containers (type erasure) for later invocation. 
    *  
    *  More specifically, the \c captureFunction, which is expected to run immediately prior
    *  to the actual command operation, returns a \b memento value object (of unspecific type),
    *  which needs to be stored within the MementoTie. On UNDO, the undo-operation functor needs
    *  to be provided with a reference to this stored memento value through an additional
    *  parameter (which by convention is always the last argument of the undo function).
-   *  
    */
   template<typename SIG, typename MEM>
   class MementoTie
+    : public lib::BoolCheckable<MementoTie<SIG,MEM> >
     {
       typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
       typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
       
-      /** storage holding the captured state for undo */
-      MEM memento_;
+      MEM memento_; ///< storage holding the captured state for undo
       
       bool isCaptured_;
       
       function<SIG_undo> undo_;
       function<SIG_cap> capture_;
       
+      
+      /* == internal functionality binding the functions to the memento == */
+      
+      /** to be chained behind the capture function */
       void capture (MEM const& mementoVal)
         {
           memento_ = mementoVal;
           isCaptured_ = true;
         }
       
+      /** partially closed undo function:
+       *  on invocation, receive the current memento value
+       *  and feed it to the wrapped undo function. Additionally
+       *  provides a \c bool() conversion to check if any memento
+       *  state has yet been captured.  
+       */
+      struct WiredUndoFunc
+        : function<SIG> 
+        , lib::BoolCheckable<WiredUndoFunc>
+        {
+          
+          WiredUndoFunc (MementoTie& thisTie)
+            : function<SIG> (
+                bindLast( thisTie.undo_   // getState() bound to last argument of undo(...)
+                        , bind (&MementoTie::getState, ref(thisTie))
+                        )   )
+            , mementoHolder_(thisTie)
+            { }
+          
+          bool
+          isValid () const
+            {
+              return function<SIG>::operator bool()
+                  && bool(mementoHolder_);
+            }
+          
+        private:
+          MementoTie & mementoHolder_;
+        };
+      
+      
     public:
+      
       /** creates an execution context tying together the provided functions.
        *  Bound copies of these functors may be pulled from the MementoTie,
        *  in order to build the closures (with the concrete operation arguments)
@@ -143,14 +150,10 @@ namespace control {
        *  @note similar to #getState(), the returned functor will throw
        *        when the state capturing wasn't yet invoked
        */
-      function<SIG>
+      WiredUndoFunc
       tieUndoFunc()
         {
-          using std::tr1::bind;
-          
-          return bindLast( undo_
-                         , bind (&MementoTie::getState, this)
-                         );
+          return WiredUndoFunc(*this);
         }
       
       /** bind the capturing function to the internal memento store within this object.
@@ -163,13 +166,13 @@ namespace control {
         {
           using std::tr1::placeholders::_1;
           
-          function<void(MEM)> doCaptureMemento = bind (&MementoTie::capture, this, _1);
+          function<void(MEM)> doCaptureMemento = bind (&MementoTie::capture, this, _1 );
           
           return chained(capture_, doCaptureMemento);
         }
       
       
-      /** get the currently captured memento state value
+      /** access the currently captured memento state value
        *  @throw when the capturing function wasn't yet invoked
        */
       MEM&
@@ -181,6 +184,16 @@ namespace control {
           return memento_;
         }
       
+      
+      /** conversion to bool() yields true
+       *  if all functions are usable and 
+       *  memento state has been captured
+       */
+      bool
+      isValid ()  const
+        {
+          return undo_ && capture_ && isCaptured_;
+        }
     };
   
   
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 7c5fd6d31..46a33000c 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -15,5 +15,6 @@ PLANNED "CommandMutation_test" CommandMutation_test <<END
 END
 
 
-PLANNED "MementoTie_test" MementoTie_test <<END
+Test "MementoTie_test" MementoTie_test <<END
+return: 0
 END
diff --git a/tests/components/proc/control/memento-tie-test.cpp b/tests/components/proc/control/memento-tie-test.cpp
index 28f7b957e..18e1bfab2 100644
--- a/tests/components/proc/control/memento-tie-test.cpp
+++ b/tests/components/proc/control/memento-tie-test.cpp
@@ -23,80 +23,52 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/memento-tie.hpp"
-//#include "lib/meta/typelist.hpp"
-//#include "lib/meta/tuple.hpp"
-//#include "lib/lumitime.hpp"
-//#include "lib/util.hpp"
 
 #include <tr1/functional>
-//#include <boost/format.hpp>
-#include <iostream>
 #include <cstdlib>
-#include <string>
 
-using std::tr1::bind;
-//using std::tr1::placeholders::_1;
-//using std::tr1::placeholders::_2;
 using std::tr1::function;
-//using boost::format;
-//using lumiera::Time;
-//using util::contains;
-using std::string;
+using std::tr1::bind;
 using std::rand;
-using std::cout;
-using std::endl;
 
 
 namespace control {
 namespace test    {
-
-  using lib::test::showSizeof;
-
-//  using session::test::TestClip;
-//  using lumiera::P;
-  using namespace lumiera::typelist;
-  using lumiera::typelist::Tuple;
-  
-  using control::CmdClosure;
   
   
   
   
-  
-  
-  namespace {                                                     /////////////////TODO: use a more interesting function here.....
-  
-    int testVal=0;  ///< used to verify the effect of testFunc
-  
+  namespace {
+    
+    int testVal=0;                   ///< used to verify the effect of testFunc
+    
     void
-    testFunc (int val)
+    undo (short param, int memento)  ///< simulates "Undo" of the command operation
     {
-      testVal += val;
+      testVal += param-memento;
     }
     
     int
-    capture ()
+    capture (short param)            ///< simulates capturing the undo state
     {
-      return testVal;
+      return testVal+param;
     }
-  
+    
+    
+    /** maximum additional storage maybe wasted due
+     *  to alignment of the memento value within MementoTie
+     */
+    const size_t ALIGNMENT = sizeof(size_t);
   }
   
   
   
-  /***************************************************************************
-   * Verify the state capturing mechanism (memento), which is used
-   * to implement the Undo() functionality for Proc-Layer commands
+  /*****************************************************************************************
+   * @test Verify the state capturing mechanism (memento), which is used to implement
+   * the Undo() functionality for Proc-Layer commands. Bind an undo function and a state
+   * capturing function and wire up both to store and retrieve a memento value. 
+   * Verify that after closing the functions, actually state is captured by each invocation.
    *       
    * @see  control::Command
    * @see  control::CmdClosure
@@ -113,55 +85,52 @@ namespace test    {
         }
       
       
-      /** @test check the functionality used to implement UndoMutation:
-       *        bind an undo function and a state capturing function
-       *        and use the latter to define the special CmdClosure
-       *        with the ability hold the memento and bind it into
-       *        the relevant parameter of the undo function.
-       *        Verify that, after closing the functions, actually
-       *        state is captured by each invocation.
-       */
       void
       checkStateCapturingMechanism ()
         {
-          function<void(int)> undo_func  = bind (&testFunc,_1);
-          function<int(void)> cap_func   = bind (&capture    );
+          typedef void OpSIG(short); // assumed signature of the Command "Operation"
           
-          typedef MementoTie<void(),int> MemHolder;
-
+          function<void(short,int)> undo_func  = undo;
+          function< int(short)>     cap_func   = capture;
+          
+          typedef MementoTie<OpSIG,int> MemHolder;
           MemHolder mementoHolder (undo_func,cap_func);
           
-          function<void()> bound_undo_func = mementoHolder.tieUndoFunc();
-          function<void()> bound_cap_func  = mementoHolder.tieCaptureFunc();
+          ASSERT (sizeof(MemHolder) <= sizeof(int)                   // storage for the memento
+                                     + 2 * sizeof(function<void()>)  // storage for the 2 undecorated functors
+                                     + ALIGNMENT);
           
-          VERIFY_ERROR (MISSING_MEMENTO, bound_undo_func() );
+          function<OpSIG> bound_undo_func = mementoHolder.tieUndoFunc();
+          function<OpSIG> bound_cap_func  = mementoHolder.tieCaptureFunc();
+          
+          VERIFY_ERROR (MISSING_MEMENTO, bound_undo_func(123) );
           VERIFY_ERROR (MISSING_MEMENTO, mementoHolder.getState() );
           
-          int rr (rand() %100);
-          testVal = rr;
-          bound_cap_func();       // invoke state capturing 
+          short rr (rand() %100);
+          testVal = 0;
+          bound_cap_func(rr);     // invoke state capturing 
           
           ASSERT (rr == mementoHolder.getState());
           
-          testVal = -10;          // meanwhile "somehow" mutate the state
-          bound_undo_func();      // invoking the undo() feeds back the memento
-          ASSERT (rr-10 == testVal);
+          testVal = 10;           // meanwhile "somehow" mutate the state
+          bound_undo_func(0);     // invoking the undo() feeds back the memento
+          ASSERT (testVal == 10-rr);
           
           // this cycle can be repeated with different state values
           rr = (rand() %100);
           testVal = rr;
-          bound_cap_func();       // capture new state
-          ASSERT (rr == mementoHolder.getState());
+          bound_cap_func(5);      // capture new state
+          ASSERT (5+rr == mementoHolder.getState());
           
           testVal = -20;
-          bound_undo_func();
-          ASSERT (rr-20 == testVal);
+          bound_undo_func(3*rr);
+          ASSERT (testVal == -20 + 3*rr - (5+rr));
         }
     };
   
   
   /** Register this test class... */
   LAUNCHER (MementoTie_test, "unit controller");
-      
-      
+  
+  
 }} // namespace control::test
diff --git a/tests/lib/opaque-holder-test.cpp b/tests/lib/opaque-holder-test.cpp
index 90d9a5333..b7be45f8a 100644
--- a/tests/lib/opaque-holder-test.cpp
+++ b/tests/lib/opaque-holder-test.cpp
@@ -95,7 +95,7 @@ namespace test{
      *  due to alignment of the contained object
      *  within OpaqueHolder's buffer
      */
-    const size_t ALLIGNMENT = sizeof(size_t);
+    const size_t _ALIGN_ = sizeof(size_t);
     
   }
   
@@ -228,7 +228,7 @@ namespace test{
           ASSERT (!isSameObject (d3, *o2));
           ASSERT (3 == o2->getIt());
           
-          ASSERT (sizeof(Opaque) <= sizeof(Base) + sizeof(void*) + ALLIGNMENT);
+          ASSERT (sizeof(Opaque) <= sizeof(Base) + sizeof(void*) + _ALIGN_);
         }
       
       
@@ -255,7 +255,7 @@ namespace test{
           
           ASSERT (sizeof(Special) > sizeof(Base));
           ASSERT (sizeof(SpecialOpaque) > sizeof(Opaque));
-          ASSERT (sizeof(SpecialOpaque) <= sizeof(Special) + sizeof(void*) + ALLIGNMENT);
+          ASSERT (sizeof(SpecialOpaque) <= sizeof(Special) + sizeof(void*) + _ALIGN_);
           
           Special s1 (6);
           Special s2 (3);

From e892a0087a4d5042a87c608f50c5cc27b390d54b Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 10 Jul 2009 19:00:40 +0200
Subject: [PATCH 181/368] remove this bool check... seems to be
 overengineering! The same information can be easily accessed throught the
 ArgumentHolder

---
 src/proc/control/memento-tie.hpp | 40 +++++---------------------------
 1 file changed, 6 insertions(+), 34 deletions(-)

diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index 6e939811d..b5d42fd15 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -88,8 +88,6 @@ namespace control {
       function<SIG_cap> capture_;
       
       
-      /* == internal functionality binding the functions to the memento == */
-      
       /** to be chained behind the capture function */
       void capture (MEM const& mementoVal)
         {
@@ -97,36 +95,6 @@ namespace control {
           isCaptured_ = true;
         }
       
-      /** partially closed undo function:
-       *  on invocation, receive the current memento value
-       *  and feed it to the wrapped undo function. Additionally
-       *  provides a \c bool() conversion to check if any memento
-       *  state has yet been captured.  
-       */
-      struct WiredUndoFunc
-        : function<SIG> 
-        , lib::BoolCheckable<WiredUndoFunc>
-        {
-          
-          WiredUndoFunc (MementoTie& thisTie)
-            : function<SIG> (
-                bindLast( thisTie.undo_   // getState() bound to last argument of undo(...)
-                        , bind (&MementoTie::getState, ref(thisTie))
-                        )   )
-            , mementoHolder_(thisTie)
-            { }
-          
-          bool
-          isValid () const
-            {
-              return function<SIG>::operator bool()
-                  && bool(mementoHolder_);
-            }
-          
-        private:
-          MementoTie & mementoHolder_;
-        };
-      
       
     public:
       
@@ -150,10 +118,14 @@ namespace control {
        *  @note similar to #getState(), the returned functor will throw
        *        when the state capturing wasn't yet invoked
        */
-      WiredUndoFunc
+      function<SIG> 
       tieUndoFunc()
         {
-          return WiredUndoFunc(*this);
+          using std::tr1::bind;
+          
+          return bindLast( undo_           // getState() bound to last argument of undo(...)
+                         , bind (&MementoTie::getState, this)
+                         ); 
         }
       
       /** bind the capturing function to the internal memento store within this object.

From 9aa5ba560c1c780848db4f2294158f0ca50001a5 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 10 Jul 2009 19:04:01 +0200
Subject: [PATCH 182/368] finish and tidy up control::Mutation, unit test pass

---
 src/lib/bool-checkable.hpp                    |  4 +-
 src/lib/opaque-holder.hpp                     |  2 +-
 src/proc/control/command-closure.hpp          | 33 ++++----
 src/proc/control/command-mutation.hpp         | 73 +++++++++++------
 src/proc/control/memento-tie.hpp              |  1 -
 tests/45controller.tests                      |  8 +-
 tests/components/Makefile.am                  |  2 +-
 .../proc/control/command-basic-test.cpp       |  2 +-
 .../proc/control/command-mutation-test.cpp    | 82 +++++++++----------
 9 files changed, 119 insertions(+), 88 deletions(-)

diff --git a/src/lib/bool-checkable.hpp b/src/lib/bool-checkable.hpp
index bbae1a35f..dd03610b8 100644
--- a/src/lib/bool-checkable.hpp
+++ b/src/lib/bool-checkable.hpp
@@ -88,8 +88,8 @@ namespace lib {
    * \c isValid() function, the conversion operator returns either a
    * bound or unbound member pointer. 
    * 
-   * @todo list some usage examples here
-   * @see bool-checkable-test.cpp 
+   * @see bool-checkable-test.cpp
+   * @see control::Mutation usage example 
    */
   template< class T                 ///< the target type implementing \c isValid()
           , class PAR = imp::Dummy ///<  optional parent for inheritance chain
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index d3a9b38fc..2fab78582 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -381,7 +381,7 @@ namespace lib {
       
       template<class SUB>
       InPlaceAnyHolder(SUB const& obj)
-        { 
+        {
           place_inBuff (obj);
         }
       
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index ff2dc3ec6..c4ae309fc 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -45,7 +45,8 @@
 
 #include <tr1/memory>
 #include <tr1/functional>
-#include <iostream> 
+#include <iostream>
+#include <sstream>
 #include <string>
 
 
@@ -119,14 +120,12 @@ namespace control {
         
       ParamAccessor(TUP const& tuple)
         : BASE(tuple)
-        { 
-          cout << showSizeof(element()) << endl;   //////////TODO remove this test code
-        }
+        { }
       
-      string
-      dump (string const& prefix = "(")  const
+      ostream&
+      dump (ostream& output)  const
         {
-          return BASE::dump (prefix+element()+",");
+          return BASE::dump (output << element() << ',');
         }
       
       
@@ -144,14 +143,10 @@ namespace control {
       
       ////////////////////TODO the recursion-end of the access operations goes here
       
-      string
-      dump (string const& prefix ="(")  const
+      ostream&
+      dump (ostream& output)  const
         { 
-          if (1 < prefix.length())
-            // remove trailing comma...
-            return prefix.substr (0, prefix.length()-1) +")";
-          else
-            return prefix+")";
+          return output;
         }
       
     };
@@ -212,7 +207,15 @@ namespace control {
       
       operator string()  const
         {
-          UNIMPLEMENTED ("how to do a string conversion on the variable argument tuple??");
+          std::ostringstream buff;
+          params_.dump (buff << "Closure(" );
+          
+          string dumped (buff.str());
+          if (1 < dumped.length())
+            // remove trailing comma...
+            return dumped.substr (0, dumped.length()-1) +")";
+          else
+            return dumped+")";
         }
     };
     
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 223e36a6f..db3152785 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -22,11 +22,32 @@
 
 
 /** @file command-mutation.hpp
- ** The core of a Proc-Layer command: functor containing the actual operation to be executed.
- ** //TODO
- **  
+ ** Core of a Proc-Layer command: functor containing the actual operation to be executed.
+ ** Each command holds two of these functors: one representing the actual operation
+ ** and one to undo the effect of this operation. The latter involves the capturing
+ ** and storing of a "memento" value behind the scenes. But towards Command, the
+ ** Mutation acts as interface to conceal these details, as well as the actual
+ ** type and parameters of the functions to be invoked. Thus, Mutation's
+ ** public interface just consists of a function call operator \c void() .
+ ** 
+ ** \par Lifecycle
+ ** Mutation objects are to be created based on a concrete function object, which then
+ ** gets embedded into a type erasure container, thus disposing the specific type information.
+ ** Moreover, building on this lib::OpaqueHolder yields a fixed size storage for Mutation objects,
+ ** allowing them to be embedded immediately within the Command instance.
+ ** 
+ ** Later on, any command needs to be made ready for execution by binding it to a specific
+ ** execution environment, which especially includes the target objects to be mutated by the
+ ** command. This procedure includes "closing" the Mutation (and UNDO) functor(s) with the
+ ** actual function arguments. These arguments are stored embedded within an ArgumentHolder,
+ ** which thereby acts as closure. Besides, the ArgumentHolder also has to accommodate for
+ ** storage holding the captured UNDO state (memento). Thus, internally the ArgumentHolder
+ ** has to keep track of the actual types, thus allowing to re-construct the concrete
+ ** function signature when closing the Mutation.
+ ** 
  ** @see Command
  ** @see ProcDispatcher
+ ** @see MementoTie binding memento state
  **
  */
 
@@ -41,9 +62,6 @@
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 
-//#include <tr1/memory>
-#include <boost/scoped_ptr.hpp>
-#include <tr1/functional>
 #include <iostream>
 #include <string>
 
@@ -51,10 +69,6 @@
 
 namespace control {
   
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
-  using boost::scoped_ptr;
-  using std::tr1::function;
   using std::ostream;
   using std::string;
   
@@ -63,7 +77,13 @@ namespace control {
   
   
   /**
-   * @todo Type-comment
+   * Unspecific command functor for implementing Proc-Layer Command.
+   * To be created from an tr1::function object, which later on
+   * can be \link #close closed \endlink with a set of actual 
+   * function arguments. The concrete type of the function
+   * and the arguments is concealed (erased) on the interface,
+   * while the unclosed/closed - state of the functor can be
+   * checked by bool() conversion.
    */
   class Mutation
     : public lib::BoolCheckable<Mutation>
@@ -105,7 +125,8 @@ namespace control {
       /** diagnostics */
       operator string()  const
         { 
-          return isValid()? string (*clo_) : "Mutation(state missing)";
+          return isValid()? "Mutation("+string (*clo_)+")"
+                          : "Mutation(untied)";
         }
       
       virtual bool
@@ -114,7 +135,8 @@ namespace control {
           return func_ && clo_;
         }
       
-    protected:
+      
+    private:
       void
       invoke (CmdFunctor & closedFunction)
         {
@@ -128,8 +150,21 @@ namespace control {
   
   
   
+  
+  
+  
+  
   /**
-   * @todo Type-comment
+   * Specialised version of the command Mutation functor,
+   * used to implement the UNDO functionality. The operation
+   * executed when invoking this functor is the UNDO operation
+   * of the respective command; additionally we need another
+   * functor to capture the state to be restored on UNDO.
+   * Both functors are wired up internally to cooperate
+   * and store the state (memento), which is implemented
+   * by the specifically typed MementoTie object passed
+   * in on construction. All these specific details
+   * are concealed on the interface
    */
   class UndoMutation
     : public Mutation
@@ -143,11 +178,6 @@ namespace control {
         , captureMemento_(mementoHolder.tieCaptureFunc())
         { }
       
-//      UndoMutation (UndoMutation const& o)
-//        : Mutation(o)
-//        , captureMemento_(o.captureMemento_)
-//        { }
-      
       
       virtual Mutation&
       close (CmdClosure& cmdClosure)
@@ -172,16 +202,13 @@ namespace control {
       
     private:
       virtual bool
-      isValid ()   const
+      isValid ()  const
         {
           return Mutation::isValid() && captureMemento_;
         }
       
       
     };
-  ////////////////TODO currently just fleshing  out the API....
-  
-    
   
   
 } // namespace control
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index b5d42fd15..ed4a44380 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -50,7 +50,6 @@
 
 namespace control {
   
-  using std::tr1::ref;
   using lumiera::typelist::func::bindLast;
   using lumiera::typelist::func::chained;
     
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 46a33000c..5f4cc95f2 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -11,10 +11,14 @@ PLANNED "CommandArgument_test" CommandArgument_test <<END
 END
 
 
-PLANNED "CommandMutation_test" CommandMutation_test <<END
+TEST "Command functor" CommandMutation_test <<END
+out: Mutation\(untied\)
+out: param values: Closure\(23\)
+out: Mutation\(Closure\(23\)\)
+out: saved state: 11
 END
 
 
-Test "MementoTie_test" MementoTie_test <<END
+TEST "Memento binding" MementoTie_test <<END
 return: 0
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 98d2a33ed..62c6f0155 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -50,7 +50,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-argument-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
-	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp			\
+	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
 	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index accd9d3db..f7d0bacf1 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -69,7 +69,7 @@ namespace test    {
   using lumiera::P;
   
   
-  using lumiera::typelist::BuildTupleAccessor;
+  //using lumiera::typelist::BuildTupleAccessor;
   
   
   
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index d8f6fb885..b52a10a5f 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -22,36 +22,17 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/tuple.hpp"
-//#include "lib/lumitime.hpp"
-//#include "lib/util.hpp"
 
 #include <tr1/functional>
-//#include <boost/format.hpp>
 #include <iostream>
 #include <cstdlib>
 #include <string>
 
-using std::tr1::bind;
-//using std::tr1::placeholders::_1;
-//using std::tr1::placeholders::_2;
 using std::tr1::function;
-//using boost::format;
-//using lumiera::Time;
-//using util::contains;
 using std::string;
 using std::rand;
 using std::cout;
@@ -60,25 +41,15 @@ using std::endl;
 
 namespace control {
 namespace test    {
-
-  using lib::test::showSizeof;
-
-//  using session::test::TestClip;
-//  using lumiera::P;
-  using namespace lumiera::typelist;
-  using lumiera::typelist::Tuple;
   
+  using namespace lumiera::typelist;
   using control::CmdClosure;
   
   
-  
-  
-  
-  
-  namespace {
-  
+  namespace { /* ======= test functions to bind ========= */
+    
     int testVal=0;  ///< used to verify the effect of testFunc
-  
+    
     void
     testFunc (int val)
     {
@@ -114,6 +85,7 @@ namespace test    {
         {
           checkMutation();
           checkUndoMutation();
+          checkStateCapturingMechanism();
         }
       
       
@@ -125,11 +97,12 @@ namespace test    {
       void
       checkMutation ()
         {
-          function<void(int)> funky  = bind (testFunc, _1);
+          function<void(int)> funky  = testFunc;
           
           Mutation functor (funky);
           ASSERT (!functor);
           VERIFY_ERROR (UNBOUND_ARGUMENTS, functor() );
+          cout << functor << endl;
           
           Tuple<Types<int> > param = tuple::make(23);
           Closure<void(int)> close_over (param);
@@ -139,6 +112,7 @@ namespace test    {
           ASSERT (functor);
           
           cout << "param values: " << clo << endl;
+          cout << functor << endl;
           
           testVal = 0;
           functor();
@@ -154,8 +128,8 @@ namespace test    {
        *        captured state value. Consequently this time the \em operation
        *        which is to be undone would have the signature \c void(void) .
        *        Obviously this is a rather silly "undo" function, but it is
-       *        easy to check in a unit test. To carry out this test, we first
-       *        have to trigger the state capturing mechanism; after that,
+       *        easy to check for unit testing. To carry out this test, we
+       *        first have to trigger the state capturing mechanism; after that,
        *        invoking the UndoMutation will call the testFunc with the
        *        previously captured state.
        *  @note Mutation and UndoMutation are value objects, but they refer
@@ -166,27 +140,29 @@ namespace test    {
       void
       checkUndoMutation ()
         {
-          function<void(int)> undo_func  = bind (&testFunc,_1);
-          function<int(void)> cap_func   = bind (&capture    );
+          function<void(int)> undo_func  = testFunc;
+          function<int(void)> cap_func   = capture;
           
           typedef MementoTie<void(),int> MemHolder;
           
           MemHolder mementoHolder (undo_func,cap_func);
           UndoMutation undoFunctor (mementoHolder);
           ASSERT (!undoFunctor);
+          ASSERT (!mementoHolder);
           VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor() );
           
           Tuple<Types<> > param;
           Closure<void()> clo (param);
           
           undoFunctor.close(clo);
-          ASSERT (!undoFunctor);
+          ASSERT ( undoFunctor);
+          ASSERT (!mementoHolder);
           VERIFY_ERROR (MISSING_MEMENTO, undoFunctor() );
           VERIFY_ERROR (MISSING_MEMENTO, mementoHolder.getState() );
           
           testVal = 11;
           undoFunctor.captureState();
-          ASSERT (undoFunctor);
+          ASSERT (mementoHolder);
           ASSERT (testVal == 11);
           
           int mem = mementoHolder.getState();
@@ -217,11 +193,33 @@ namespace test    {
         }
       
       
+      /** @test check the undo memento capturing mechanism in isolation 
+       *  @see memento-tie-test.cpp more in-depth coverage */
+      void
+      checkStateCapturingMechanism ()
+        {
+          typedef MementoTie<void(),int> MemHolder;
+          
+          MemHolder mementoHolder (testFunc, capture);
+          
+          function<void()> bound_undo_func = mementoHolder.tieUndoFunc();
+          function<void()> bound_cap_func  = mementoHolder.tieCaptureFunc();
+          
+          
+          int rr (rand() % 100);
+          testVal = rr;
+          bound_cap_func();       // invoke state capturing 
+          ASSERT (rr == mementoHolder.getState());
+          
+          testVal = 10;        // meanwhile "somehow" mutate the state
+          bound_undo_func();  // invoking the undo() feeds back the memento
+          ASSERT (testVal == 10+rr);
+        }
     };
   
   
   /** Register this test class... */
   LAUNCHER (CommandMutation_test, "unit controller");
-      
-      
+  
+  
 }} // namespace control::test

From 892f382f0f25b6df141c9faaad093ea09f2658f4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 11 Jul 2009 19:23:20 +0200
Subject: [PATCH 183/368] Ticket #182

---
 src/lib/iter-adaptor.hpp        | 78 +++++++++++++++++++++++++++
 src/lib/lumitime-fmt.hpp        | 94 +++++++++++++++++++++++++++++++++
 src/lib/scoped-ptrvect.hpp      | 21 +++++++-
 tests/40components.tests        |  4 ++
 tests/lib/Makefile.am           |  1 +
 tests/lib/iter-adaptor-test.cpp | 71 +++++++++++++++++++++++++
 6 files changed, 268 insertions(+), 1 deletion(-)
 create mode 100644 src/lib/iter-adaptor.hpp
 create mode 100644 src/lib/lumitime-fmt.hpp
 create mode 100644 tests/lib/iter-adaptor-test.cpp

diff --git a/src/lib/iter-adaptor.hpp b/src/lib/iter-adaptor.hpp
new file mode 100644
index 000000000..5adc27f66
--- /dev/null
+++ b/src/lib/iter-adaptor.hpp
@@ -0,0 +1,78 @@
+/*
+  ITER-ADAPTOR.hpp  -  helpers for building simple forward iterators 
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file iter-adaptor.hpp
+ ** Helper template(s) for creating <b>lumiera forward iterators</b>.
+ ** This denotes a concept similar to STL's  "forward iterator", with
+ ** the addition of an bool check to detect iteration end. The latter
+ ** is inspired by the \c hasNext() function found in many current
+ ** languages supporting iterators. In a similar vein (inspired from
+ ** functional programming), we deliberately don't support the various
+ ** extended iterator concepts from STL and boost (random access iterators,
+ ** output iterators and the like). According to this concept, <i>an iterator
+ ** is a promise for pulling values</i> -- and nothing beyond that.
+ ** 
+ ** @todo WIP WIP WIP
+ ** @todo see Ticket #182
+ ** 
+ ** @see scoped-ptrvect.hpp
+ */
+
+
+#ifndef LIB_ITER_ADAPTOR_H
+#define LIB_ITER_ADAPTOR_H
+
+
+//#include "include/logging.h"
+//#include "lib/error.hpp"
+//#include "lib/util.hpp"
+
+//#include <vector>
+//#include <boost/noncopyable.hpp>
+
+
+namespace lib {
+  
+//  using util::for_each;
+  
+  
+  
+  /**
+   */
+  template<class T, class CON>
+  class PtrIter
+    {
+    };
+  
+  
+  /**
+   */
+  template<class T, class CON>
+  class PtrDerefIter
+    {
+    };
+  
+  
+  
+  
+} // namespace lib
+#endif
diff --git a/src/lib/lumitime-fmt.hpp b/src/lib/lumitime-fmt.hpp
new file mode 100644
index 000000000..da0d58ee7
--- /dev/null
+++ b/src/lib/lumitime-fmt.hpp
@@ -0,0 +1,94 @@
+/*
+  LUMITIME.hpp  -  convenience wrapper for working with gavl_time in C++
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef LUMIERA_LUMITIME_H
+#define LUMIERA_LUMITIME_H
+
+#include <boost/operators.hpp>
+
+extern "C" {
+#include <gavl/gavltime.h>
+}
+
+namespace lumiera {
+
+
+  /**
+   * C++ convenience wrapper representing a time value, which could denote
+   * a temporal position (time point) relative to an (implicit) timeline zero
+   * point, or it could represent a time interval.
+   * 
+   * This wrapper is deliberately kept rather limited as not to be completely
+   * interchangeable with and integral type. The rationale is that time values
+   * should be kept separate and tagged as time values. The following is supported:
+   * - conversions from / to gavl_time_t (which is effectively a int64_t)
+   * - additions and subtractions of time values
+   * - multiplication with an integral factor
+   * - comparisons between time values and gavl_time_t values
+   * 
+   * @todo consider the possible extensions
+   *       - parsing and pretty printing
+   *       - quantising of floating point values
+   *       - conversion to boost::rational
+   *       - define a Framerate type
+   * 
+   * @note this is currently (10/08) an experimental implementation to ease
+   *       the time handling within C++ code. It is advisable not to use it
+   *       on external interfaces (use gavl_time_t there please).
+   */
+  class Time 
+    : boost::additive<Time,
+      boost::totally_ordered<Time,
+      boost::totally_ordered<Time, gavl_time_t> > >
+    {
+      gavl_time_t t_;
+      
+    public:
+      static const Time MAX ; 
+      static const Time MIN ;
+      
+      explicit Time (gavl_time_t val=0) : t_(val) {}
+      
+      operator gavl_time_t () { return t_; }
+      
+      
+      // Supporting additive
+      Time& operator+= (Time const& tx)  { t_ += tx.t_; return *this; }
+      Time& operator-= (Time const& tx)  { t_ -= tx.t_; return *this; }
+      
+      // Supporting multiplication with integral factor
+      Time& operator*= (int64_t fact)    { t_ *= fact;  return *this; }
+       
+      // Supporting totally_ordered
+      friend bool operator<  (Time const& t1, Time const& t2)  { return t1.t_ <  t2.t_; }
+      friend bool operator<  (Time const& t1, gavl_time_t t2)  { return t1.t_ <  t2   ; }
+      friend bool operator>  (Time const& t1, gavl_time_t t2)  { return t1.t_ >  t2   ; }
+      friend bool operator== (Time const& t1, Time const& t2)  { return t1.t_ == t2.t_; }
+      friend bool operator== (Time const& t1, gavl_time_t t2)  { return t1.t_ == t2   ; }
+    };
+  
+  
+  
+  
+} // namespace lumiera
+#endif
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index 0dc509e8d..ca17b057f 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -135,6 +135,25 @@ namespace lib {
         }
       
       
+      /* === Element access and iteration === */
+      
+      T&
+      operator[] (size_type i)
+        {
+          return *get(i);
+        }
+      
+      typedef PtrDerefIter<reference,       _Vec> iterator;
+      typedef PtrDerefIter<const_reference, _Vec> const_iterator;
+      
+      iterator       begin()        { return       iterator (_Vec::begin()); }
+      const_iterator begin()  const { return const_iterator (_Vec::begin()); }
+      iterator       end()          { return       iterator (); }
+      const_iterator end()    const { return const_iterator (); }
+      
+      
+      
+      
       /* ====== proxied vector functions ==================== */
       
       size_type  size ()      const  { return _Vec::size();     }
@@ -144,7 +163,7 @@ namespace lib {
       
       
     private:
-      /** currently not used as of 2/2009 */
+      /** internal element access, including null check */
       T* get(size_type i)
         {
           T* p (_Vec::at (i));
diff --git a/tests/40components.tests b/tests/40components.tests
index 06cfc0073..daca5bee5 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -281,6 +281,10 @@ return: 0
 END
 
 
+PLANNED "Lumiera Iterator Concept" IterAdaptor_test  <<END
+END
+
+
 TEST "RemoveFromSet_test" RemoveFromSet_test <<END
 out: removed  nothing  ---> \[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
 out: removed 0 ---> \[ 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index bba91c3ea..1679c19cf 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -46,6 +46,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
+	$(testlib_srcdir)/iter-adaptor-test.cpp			\
 	$(testlib_srcdir)/mainsuite.cpp				\
 	$(testlib_srcdir)/meta/typelist-test.cpp         	\
 	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
diff --git a/tests/lib/iter-adaptor-test.cpp b/tests/lib/iter-adaptor-test.cpp
new file mode 100644
index 000000000..4bb6df4ba
--- /dev/null
+++ b/tests/lib/iter-adaptor-test.cpp
@@ -0,0 +1,71 @@
+/*
+  IterAdaptor(Test)  -  building simple iterators for a given container
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+
+//#include "lib/scoped-ptrvect.hpp"
+//#include "testdummy.hpp"
+
+
+namespace lib {
+namespace test{
+  
+  using ::Test;
+  using util::isnil;
+  
+  
+  
+  /********************************************************************
+   *  @test create an iterator element for a given container and
+   *        verify its behaviour in accordance to the concept
+   *        "lumiera forward iterator"
+   * @todo see Ticket #182
+   */
+  class IterAdaptor_test : public Test
+    {
+      
+      virtual void
+      run (Arg)
+        {
+          UNIMPLEMENTED ("build a simple lumiera forward iterator");
+          simpleUsage();
+//        iterating();
+//        detaching();
+        }
+      
+      
+      
+      void
+      simpleUsage()
+        {
+        }
+      
+    };
+  
+  LAUNCHER (IterAdaptor_test, "unit common");
+  
+  
+}} // namespace lib::test
+

From 6ef1aca3a4a70ea5af31bf74e454020c20c5366e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 11 Jul 2009 20:06:35 +0200
Subject: [PATCH 184/368] test driven brainstorming

---
 src/lib/lumitime-fmt.hpp                      |  92 +++----
 src/lib/lumitime.cpp                          |  24 +-
 src/lib/lumitime.hpp                          |   3 +-
 .../proc/control/command-argument-test.cpp    | 251 +++++++++++++++++-
 tests/lib/scoped-ptrvect-test.cpp             | 134 +++++-----
 5 files changed, 358 insertions(+), 146 deletions(-)

diff --git a/src/lib/lumitime-fmt.hpp b/src/lib/lumitime-fmt.hpp
index da0d58ee7..c7bab597b 100644
--- a/src/lib/lumitime-fmt.hpp
+++ b/src/lib/lumitime-fmt.hpp
@@ -1,8 +1,8 @@
 /*
-  LUMITIME.hpp  -  convenience wrapper for working with gavl_time in C++
+  LUMITIME-FMT.hpp  -  output and formatting of time(code) values
  
   Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
  
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
@@ -21,71 +21,47 @@
 */
 
 
-#ifndef LUMIERA_LUMITIME_H
-#define LUMIERA_LUMITIME_H
+/** @file lumitime-fmt.hpp
+ ** Extension to the lumiera::Time wrapper, adding output and specific
+ ** time formats. For now (7/09) this header serves the purpose to add
+ ** the (not so lightweight) includes necessary for formatting. For later
+ ** the intention is to have "format aware" time values (as a subclass),
+ ** carrying the additional information about current framerate and
+ ** other time-format preferences
+ ** 
+ ** @todo this should be a mixed C/C++ header and really add the handling
+ **       of multiple timecode-formats :-P
+ **  
+ ** @see time.h
+ ** @see lumitime.hpp
+ **
+ */
 
-#include <boost/operators.hpp>
+
+
+
+
+#ifndef LUMIERA_LUMITIME_FMT_H
+#define LUMIERA_LUMITIME_FMT_H
+
+#include "lib/lumitime.hpp"
 
 extern "C" {
-#include <gavl/gavltime.h>
+#include "lib/time.h"
 }
 
+#include <iostream>
+
 namespace lumiera {
 
 
-  /**
-   * C++ convenience wrapper representing a time value, which could denote
-   * a temporal position (time point) relative to an (implicit) timeline zero
-   * point, or it could represent a time interval.
-   * 
-   * This wrapper is deliberately kept rather limited as not to be completely
-   * interchangeable with and integral type. The rationale is that time values
-   * should be kept separate and tagged as time values. The following is supported:
-   * - conversions from / to gavl_time_t (which is effectively a int64_t)
-   * - additions and subtractions of time values
-   * - multiplication with an integral factor
-   * - comparisons between time values and gavl_time_t values
-   * 
-   * @todo consider the possible extensions
-   *       - parsing and pretty printing
-   *       - quantising of floating point values
-   *       - conversion to boost::rational
-   *       - define a Framerate type
-   * 
-   * @note this is currently (10/08) an experimental implementation to ease
-   *       the time handling within C++ code. It is advisable not to use it
-   *       on external interfaces (use gavl_time_t there please).
-   */
-  class Time 
-    : boost::additive<Time,
-      boost::totally_ordered<Time,
-      boost::totally_ordered<Time, gavl_time_t> > >
+  /** writes time value, formatted as HH:MM:SS:mmm
+   *  @see lumiera_tmpbuf_print_time  */
+  inline std::ostream&
+  operator<< (ostream& os, Time const& t)
     {
-      gavl_time_t t_;
-      
-    public:
-      static const Time MAX ; 
-      static const Time MIN ;
-      
-      explicit Time (gavl_time_t val=0) : t_(val) {}
-      
-      operator gavl_time_t () { return t_; }
-      
-      
-      // Supporting additive
-      Time& operator+= (Time const& tx)  { t_ += tx.t_; return *this; }
-      Time& operator-= (Time const& tx)  { t_ -= tx.t_; return *this; }
-      
-      // Supporting multiplication with integral factor
-      Time& operator*= (int64_t fact)    { t_ *= fact;  return *this; }
-       
-      // Supporting totally_ordered
-      friend bool operator<  (Time const& t1, Time const& t2)  { return t1.t_ <  t2.t_; }
-      friend bool operator<  (Time const& t1, gavl_time_t t2)  { return t1.t_ <  t2   ; }
-      friend bool operator>  (Time const& t1, gavl_time_t t2)  { return t1.t_ >  t2   ; }
-      friend bool operator== (Time const& t1, Time const& t2)  { return t1.t_ == t2.t_; }
-      friend bool operator== (Time const& t1, gavl_time_t t2)  { return t1.t_ == t2   ; }
-    };
+      return os << lumiera_tmpbuf_print_time(t);
+    }
   
   
   
diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index 867477c5f..0f9d993d5 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -22,14 +22,28 @@
 
 
 #include "lib/lumitime.hpp"
+extern "C" {
+#include "lib/time.h"
+}
+
 #include <limits>
+#include <string>
+
+using std::string;
 
 
 namespace lumiera {
-
   
-   const Time Time::MAX ( +std::numeric_limits<int64_t>::max() );
-   const Time Time::MIN ( -std::numeric_limits<int64_t>::max() );
-
-
+  
+  const Time Time::MAX ( +std::numeric_limits<int64_t>::max() );
+  const Time Time::MIN ( -std::numeric_limits<int64_t>::max() );
+  
+  
+  Time::operator string()  const
+  {
+    return string (lumiera_tmpbuf_print_time (t_));
+  }
+  
+  
+  
 } // namespace lumiera
diff --git a/src/lib/lumitime.hpp b/src/lib/lumitime.hpp
index da0d58ee7..f1503f848 100644
--- a/src/lib/lumitime.hpp
+++ b/src/lib/lumitime.hpp
@@ -69,7 +69,8 @@ namespace lumiera {
       
       explicit Time (gavl_time_t val=0) : t_(val) {}
       
-      operator gavl_time_t () { return t_; }
+      operator gavl_time_t ()  const { return t_; }
+      operator string()  const;
       
       
       // Supporting additive
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index 578376671..eb3702410 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -33,13 +33,16 @@
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-argument-holder.hpp"
+#include "lib/scoped-ptrvect.hpp"
+#include "lib/lumitime-fmt.hpp"
 //#include "lib/meta/typelist.hpp"
 //#include "lib/meta/tuple.hpp"
-//#include "lib/util.hpp"
+#include "lib/util.hpp"
 
 //#include <tr1/functional>
-//#include <boost/format.hpp>
+#include <boost/format.hpp>
 #include <iostream>
+#include <strstream>
 //#include <cstdlib>
 #include <string>
 
@@ -47,11 +50,15 @@
 //using std::tr1::placeholders::_1;
 //using std::tr1::placeholders::_2;
 //using std::tr1::function;
-//using boost::format;
-//using lumiera::Time;
+using util::isnil;
+using util::and_all;
+using boost::format;
+using lumiera::Time;
 //using util::contains;
 using std::string;
 //using std::rand;
+using std::ostream;
+using std::ostrstream;
 using std::cout;
 using std::endl;
 
@@ -73,16 +80,99 @@ namespace test    {
   
   
   
-  namespace {
-  
-    int testVal=0;  ///< used to verify the effect of testFunc ////////////////////TODO
-  
-  }
+  namespace { // test helpers
+    
+    ostrstream protocol;     ///< used to verify the test function calls
+    
+    
+    template<typename TY>
+    struct Tracker
+      {
+        TY element_;
+        static int instanceCnt;
+        
+        Tracker (TY init = TY())
+          : element_(init)
+          {
+            ++instanceCnt;
+          }
+        
+       ~Tracker()
+          {
+            --instanceCnt; 
+          }
+       
+       TY&
+       operator* () const
+         {
+           return element_;
+         }
+       
+       friend ostream&
+       operator<< (ostream& out, const Tracker& tra)
+         {
+           return out << element_;
+         }
+      };
+    
+    template<typename TY>
+    int Tracker<TY>::instanceCnt (0);
+    
+    
+    
+    void
+    doIt (Tracker<Time> time, Tracker<string> str, int rand)
+      {
+        static format fmt ("doIt( Time=%s \"%s\" rand=%2d )");
+        protocol << fmt % *time % *str % rand;
+      }
+    
+    Tracker<string>
+    captureState (Tracker<Time> time, Tracker<string> str, int rand)
+      {
+        return protocol.str();
+      }
+    
+    void
+    undoIt (Tracker<Time> time, Tracker<string> str, int rand, Tracker<string> memento)
+      {
+        protocol << "undoIt(time="<<time<<")---state-was-:"<< *memento;
+      }
+    
+    
+    
+    void
+    showIt (CmdClosure& clo)
+      {
+        cout << clo << endl;
+      }
+    
+    void
+    checkSerialisation (CmdClosure& clo)
+      {
+        TODO ("implement serialisation/de-serialisation-Check");
+        cout << "would be serialised....." << clo;
+        
+        // serialise, then de-serialise into a new instance and compare both
+      }
+    
+    Time
+    randTime ()
+      {
+        UNIMPLEMENTED ("create a random but not insane Time value");
+      }
+    
+    
+  } // test-helper implementation
   
   
   
+  
+  
+  typedef lib::ScopedPtrVect<CmdClosure> ArgTuples;
+  
   /***************************************************************************
-   * @test storing and retrieving command arguments of various types.
+   * @test Check storage handling of the command parameters and state memento.
    *       
    * @see  control::CommandArgumentHolder
    * @see  command-basic-test.hpp
@@ -93,11 +183,150 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          UNIMPLEMENTED ("create various argument tuples and re-access their contents");
+          ArgTuples testTuples;
+          Tracker<Time>::instanceCnt = 0;
+          Tracker<string>::instanceCnt = 0;
+          
+          createArgTuples (testTuples);
+          checkArgumentComparison ();
+          serialiseArgTuples (testTuples);
+          
+          simulateCmdLifecycle();
+          
+          ASSERT (0 == Tracker<Time>::instanceCnt);
+          ASSERT (0 == Tracker<string>::instanceCnt);
+        }
+      
+      
+      /** @test create various argument tuples and re-access their contents */
+      void
+      createTuples (ArgTuples& tup)
+        {
+          tup.manage (new ArgumentHolder<void()>);
+          tup.manage (new ArgumentHolder<void(int)>);
+          tup.manage (new ArgumentHolder<void(int,Time)>);
+          tup.manage (new ArgumentHolder<void(int,Time), Time>);
+          tup.manage (new ArgumentHolder<void(int,Time), int[5]>);
+          
+          ASSERT (and_all (tup, isnil));
+          
+          for_each (tup, showIt);
+          
+          tup[1].bind (rand() % 20);
+          tup[2].bind (rand() % 20, randTime());
+          tup[3].bind (rand() % 20, randTime());
+          tup[4].bind (rand() % 20, randTime());
+          
+          tup[1].memento() = 42;
+          tup[4].memento()[3] = 513;
+        }
+      
+      
+      /** @test serialise and de-serialise each tuple and check validity
+       *  @todo unimplemented, waiting on Serialiser
+       */
+      void 
+      serialiseArgTuples (ArgTuples& tup)
+        {
+          for_each (tup, checkSerialisation);
+        }
+      
+      
+      /** @test verify the comparison operators */
+      void
+      checkArgumentComparison ()
+        {
+          ArgumentHolder<void()> one, two;
+          ASSERT (one == two);
+          
+          one.memento() = 5;
+          ASSERT (one != two);
+          
+          ArgumentHolder<void(int,int)> three, four;
+          ASSERT (three == four);
+          three.bind (1,2);
+          ASSERT (three != four);
+          ASSERT (four != three);
+          ASSERT (!isnil (three));
+          ASSERT ( isnil (four));
+
+          four.bind (3,4);
+          ASSERT (!isnil (four));
+          ASSERT (three != four);
+          ASSERT (four != three);
+          
+          three.bind (3,4);
+          ASSERT (!isnil (three));
+          ASSERT (three == four);
+          ASSERT (four == three);
+          four.memento() = 12345;
+          ASSERT (!isnil (four));
+          ASSERT (three != four);
+          ASSERT (four != three);
+        }
+      
+      
+      /** @test simulate a complete command lifecycle with regards to
+       *  the storage handling of the command parameters and state memento.
+       */
+      void
+      simulateCmdLifecycle()
+        {
+          typedef void SIG_do(Tracker<Time>, Tracker<string>, int);
+          typedef ArgumentHolder<SIG_do, Tracker<string> > Args;
+          typedef MementoTie<SIG_do, Tracker<string> > MemHolder;
+          
+          Args args;
+          ASSERT (isnil (args));
+          cout << showSizeof(args) << endl;
+          
+          args.bind (randTime(), "Lumiera rocks". rand() % 100);
+          ASSERT (!isnil (args));
+          cout << args << endl;
+          
+          ASSERT (!args.canUndo());
+          ASSERT (isnil (args.memento()));
+          MemHolder& memHolder = args.tie(undoIt,captureState);
+          ASSERT (!memHolder);   // no stored memento.... 
+          
+          function<SIG_do> doItFun = doIt;
+          function<SIG_do> undoFun = memHolder.tieUndoFunc();
+          function<SIG_do> captFun = memHolder.tieCaptureFunc();
+          
+          CmdFunctor bound_doItFun = args.bindArguments (CmdFunctor(doItFun));
+          CmdFunctor bound_undoFun = args.bindArguments (CmdFunctor(undoFun));
+          CmdFunctor bound_captFun = args.bindArguments (CmdFunctor(captFun));
+          
+          protocol.seekp(0);
+          protocol << "START...";
+          
+          bound_captFun();
+          cout << "captured state: " << args.memento() << endl;
+          ASSERT (memHolder);
+          ASSERT (!isnil (args.memento()));
+          ASSERT (args.canUndo());
+          
+          bound_doItFun();
+          cout << protocol.str() << endl;
+          bound_undoFun();
+          cout << protocol.str() << endl;
+          
+          Args argsCopy (args);
+          bound_captFun();
+          protocol.seekp(0);
+          protocol << "RESET...";
+          
+          args.bind (123456, "unbelievable", rand() %100);
+          cout << "original: " << args << endl;
+          cout << "copied  : " << argsCopy << endl;
+          
+          bound_undoFun();
+          cout << protocol.str() << endl;
         }
     };
   
   
+  
   /** Register this test class... */
   LAUNCHER (CommandArgument_test, "unit controller");
   
diff --git a/tests/lib/scoped-ptrvect-test.cpp b/tests/lib/scoped-ptrvect-test.cpp
index 23d68e31e..3bf539342 100644
--- a/tests/lib/scoped-ptrvect-test.cpp
+++ b/tests/lib/scoped-ptrvect-test.cpp
@@ -28,82 +28,74 @@
 #include "lib/scoped-ptrvect.hpp"
 #include "testdummy.hpp"
 
-#include <iostream>
-//#include <map>
-
 
 namespace lib {
-  namespace test {
-    
-    using ::Test;
-    using util::isnil;
-    
-//    using std::map;
-    using std::cout;
+namespace test{
+  
+  using ::Test;
+  using util::isnil;
+  
+  typedef ScopedPtrVect<Dummy> VectD;
+  
+  
+  /********************************************************************
+   *  @test ScopedPtrVect manages the lifecycle of a number of objects.
+   */
+  class ScopedPtrVect_test : public Test
+    {
       
-    typedef ScopedPtrVect<Dummy> VectD;
-    
-    
-    /********************************************************************
-     *  @test ScopedPtrVect manages the lifecycle of a number of objects.
-     */
-    class ScopedPtrVect_test : public Test
-      {
-        
-        virtual void 
-        run (Arg)
-          {
-            simpleUsage();
-//            iterating();
-//            detaching();            
-          }
-        
-        
-        
-        void
-        simpleUsage()
+      virtual void
+      run (Arg)
+        {
+          simpleUsage();
+//        iterating();
+//        detaching();
+        }
+      
+      
+      
+      void
+      simpleUsage()
+        {
+          ASSERT (0==checksum);
           {
+            VectD holder;
+            ASSERT (isnil (holder));
             ASSERT (0==checksum);
-            {
-              VectD holder;
-              ASSERT (isnil (holder));
-              ASSERT (0==checksum);
-              
-              Dummy* ptr = new Dummy();
-              Dummy& ref = holder.manage (ptr);
-              ASSERT (!isnil (holder));
-              ASSERT (0!=checksum);
-              ASSERT (&ref==ptr);
-              
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              ASSERT (3 == holder.size());
-
-              holder.clear();
-              ASSERT (0==checksum);
-              ASSERT (isnil (holder));
-              
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              holder.manage (new Dummy);
-              ASSERT (9 == holder.size());
-              ASSERT (0!=checksum);
-            }
+            
+            Dummy* ptr = new Dummy();
+            Dummy& ref = holder.manage (ptr);
+            ASSERT (!isnil (holder));
+            ASSERT (0!=checksum);
+            ASSERT (&ref==ptr);
+            
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            ASSERT (3 == holder.size());
+            
+            holder.clear();
             ASSERT (0==checksum);
+            ASSERT (isnil (holder));
+            
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            holder.manage (new Dummy);
+            ASSERT (9 == holder.size());
+            ASSERT (0!=checksum);
           }
-        
-      };
-    
-    LAUNCHER (ScopedPtrVect_test, "unit common");
-    
-    
-  }// namespace test
-
-} // namespace lib
+          ASSERT (0==checksum);
+        }
+      
+    };
+  
+  LAUNCHER (ScopedPtrVect_test, "unit common");
+  
+  
+}} // namespace lib::test
 

From accaba4904a93d5d31b99c279ce4c334c60bff4a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Jul 2009 18:55:33 +0200
Subject: [PATCH 185/368] WIP impl draft for ArgumentHolder

---
 src/proc/control/command-argument-holder.hpp  | 131 +++++++++++++++---
 src/proc/control/command-closure.hpp          |  27 ++--
 src/proc/control/command-mutation.hpp         |   1 -
 src/proc/control/command.cpp                  |   2 +-
 .../proc/control/command-argument-test.cpp    |   1 +
 5 files changed, 124 insertions(+), 38 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 4a981588e..351c5a7d5 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -45,6 +45,7 @@
 
 //#include "pre.hpp"
 //#include "lib/error.hpp"
+#include "proc/control/command-closure.hpp"
 
 //#include <tr1/memory>
 //#include <boost/scoped_ptr.hpp>
@@ -60,38 +61,128 @@ namespace control {
 //  using std::tr1::shared_ptr;
 //  using boost::scoped_ptr;
 //  using std::tr1::function;
-  using std::ostream;
+//  using std::ostream;
   using std::string;
   
+  namespace { // empty state marker objects for ArgumentHolder
+    
+    template<typename SIG>
+    struct MissingArguments
+      : Closure<SIG>
+      {
+        typedef typename Closure<SIG>::ArgTuple ArgTuple;
+        
+        MissingArguments ()
+          : Closure<SIG> (ArgTuple ())
+          { }
+        
+      private:
+        virtual bool isValid ()  const { return false; }
+      };
+    
+    
+    template<typename SIG, typename MEM>
+    struct UntiedMemento
+      : MementoTie<SIG,MEM>
+      {
+        typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
+        typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
+    
+        UntiedMemento()
+          : MementoTie<SIG,MEM> (function<SIG_undo>, function<SIG_cap>)
+          { }
+      };
+  
+  } // (END) impl details / empty state marker objects
+  
+  
   
   
   /**
-   * @todo Type-comment
+  /* Specifically typed CmdClosure, which serves for 
+   * actually allocating storage to hold the command arguments
+   * and the undo state (memento) for Proc-Layer commands.
    */
-  class CommandArgumentHolder
-    {
-      
-    public:
-      virtual ~CommandArgumentHolder() { };
-      virtual operator string()  const  =0;
-    };
-  
-  
-  inline ostream& operator<< (ostream& os, CommandArgumentHolder const& arg) { return os << string(arg); }
-  
-  
-  
-  
-  /** specifically typed subclass used for actual storage */
   template<typename SIG, typename MEM>
   class ArgumentHolder
-    : public CommandArgumentHolder
+    : public CmdClosure
     {
+      Closure<SIG> arguments_;
+      MementoTie<SIG,MEM> memento_;
       
-      operator string()  const { return "bääääh!"; } /////////////////TODO
+      typedef typename Closure<SIG>::ArgTuple ArgTuple;
+      
+      
+      /* === proxied CmdClosure interface === */
+      
+      virtual bool isValid ()  const
+        {
+          return bool(arguments_);
+        }
+      
+      
+      virtual CmdFunctor bindArguments (CmdFunctor& func)
+        {
+          if (!arguments_)
+            throw lumiera::error::State ("Lifecycle error: can't bind functor, "
+                                         "command arguments not yet provided",
+                                         LUMIERA_ERROR_UNBOUND_ARGUMENTS);
+          
+          return arguments_.bindArguments(func);
+        }
+      
+      
+      virtual operator string()  const
+        {
+          return "Command-State{ arguments="
+               + arguments_? arguments_ : "unbound"
+               + memento_  ? ", <memento> }" : "<no undo> }"
+               ;
+        }
+      
+      
+    public:
+      /** per default, all data within ArgumentHolder
+       *  is set up in \em empty state. Later on, the
+       *  command arguments are to be provided by #bind ,
+       *  whereas the undo functions will be wired by #tie
+       */
+      ArgumentHolder ()
+        : arguments_(MissingArguments<SIG>)
+        , memento_(UntiedMemento<SIG,MEM>)
+        { }
+      
+      /** has undo state capturing been invoked? */
+      bool
+      canUndo ()
+        {
+          return bool(memento_);
+        }
+      
+      
+      /** store a new argument tuple within this ArgumentHolder,
+       *  discarding and previously stored arguments */
+      void
+      bind (ArgTuple argTup)
+        {
+          this->arguments_ = Closure<SIG> (argTup);
+        }
+      
+      
+      typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
+      typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
+      
+      /** create a new memento storage wiring, discarding existing memento state.
+       *  @note any bound undo/capture functions based on the previously held MementoTie
+       *        are silently invalidated; using them will likely cause memory corruption! */
+      MementoTie<SIG,MEM>&
+      tie (function<SIG_undo> const& undoFunc,
+           function<SIG_cap> const& captureFunc)
+        {
+          return this->memento_ = MementoTie<SIG,MEM> (undoFunc,captureFunc);
+        }
       
     };
-  ////////////////TODO currently just fleshing  out the API....
   
     
   
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index c4ae309fc..34498fe18 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -36,6 +36,7 @@
 #define CONTROL_COMMAND_CLOSURE_H
 
 //#include "pre.hpp"
+#include "lib/bool-checkable.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/function-closure.hpp"
@@ -73,7 +74,11 @@ namespace control {
   using lumiera::typelist::StoreFunction;
   
   using lumiera::typelist::NullType;
-    
+  
+  
+  
+  LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Command functor not yet usable, because arguments aren't bound
+  
   
   /** 
    * A neutral container internally holding 
@@ -82,19 +87,17 @@ namespace control {
   typedef FunErasure<StoreFunction> CmdFunctor;
   
   
-  class CmdClosure;
-  typedef std::tr1::shared_ptr<CmdClosure> PClosure;  ///< smart-ptr type used for handling concrete closures
-  
   
   /** Interface */
   class CmdClosure
+    : public lib::BoolCheckable<CmdClosure>
     {
     public:
       virtual ~CmdClosure() {}
       
-      virtual PClosure clone()  const =0;
+      virtual operator string() const =0;
       
-      virtual operator string()  const =0;
+      virtual bool isValid ()   const { return true; }
       
       virtual CmdFunctor bindArguments (CmdFunctor&) =0;
     };
@@ -159,7 +162,6 @@ namespace control {
     {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       
-      typedef Tuple<Args> ArgTuple;
       
       typedef BuildTupleAccessor<Args,ParamAccessor> BuildAccessor;
       typedef typename BuildAccessor::Accessor ParamStorageTuple;
@@ -167,6 +169,8 @@ namespace control {
       ParamStorageTuple params_;
       
     public:
+      typedef Tuple<Args> ArgTuple;
+      
       Closure (ArgTuple const& args)
         : params_(BuildAccessor(args))
         { }
@@ -195,15 +199,6 @@ namespace control {
         }
       
       
-      /** create a clone copy of this concrete closure,
-       *  hidden behind the generic CmdClosure interface
-       *  and owned by a shared_ptr PClo.
-       */
-      PClosure
-      clone()  const
-        {
-          return PClosure (new Closure (this->params_));
-        }
       
       operator string()  const
         {
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index db3152785..25fa31bc5 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -73,7 +73,6 @@ namespace control {
   using std::string;
   
   
-  LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Mutation functor not yet usable, because arguments aren't bound
   
   
   /**
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 0b72a511e..2138ae18c 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -39,7 +39,7 @@
 
 namespace control {
   
-  LUMIERA_ERROR_DEFINE (UNBOUND_ARGUMENTS, "Mutation functor not yet usable, because arguments aren't bound");
+  LUMIERA_ERROR_DEFINE (UNBOUND_ARGUMENTS, "Command mutation functor not yet usable, because arguments aren't bound");
   LUMIERA_ERROR_DEFINE (MISSING_MEMENTO, "Undo functor not yet usable, because no undo state has been captured");
   
 
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index eb3702410..e8e8c485b 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -311,6 +311,7 @@ namespace test    {
           bound_undoFun();
           cout << protocol.str() << endl;
           
+          // Commands can serve as prototype to be copied....
           Args argsCopy (args);
           bound_captFun();
           protocol.seekp(0);

From b392d6bf841dd16c9c85f8dbaa3d36a4d51d0ead Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Jul 2009 19:30:55 +0200
Subject: [PATCH 186/368] WIP design a helper for accepting the arguments to
 bind

---
 src/proc/control/argument-tuple-accept.hpp    |  84 +++++++++
 .../control/argument-tuple-accept-test.cpp    | 161 ++++++++++++++++++
 2 files changed, 245 insertions(+)
 create mode 100644 src/proc/control/argument-tuple-accept.hpp
 create mode 100644 tests/components/proc/control/argument-tuple-accept-test.cpp

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
new file mode 100644
index 000000000..37434563b
--- /dev/null
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -0,0 +1,84 @@
+/*
+  ARGUMENT-TUPLE-ACCEPT.hpp  -  helper template providing a bind(...) member function
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file argument-tuple-accept.hpp
+ ** This template allows to mix in a \c bind(...) function.
+ ** Thereby, the correct number and types of arguments is derived
+ ** according to the function signature given as template parameter.
+ ** This helper template is used for the ArgumentHolder and generally
+ ** for binding arguments for Proc-Layer commands.
+ ** 
+ ** @see CommandDef
+ ** @see ArgumentHolder
+ ** @see argument-tuple-accept-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_ARGUMENT_TUPLE_ACCEPT_H
+#define CONTROL_ARGUMENT_TUPLE_ACCEPT_H
+
+//#include "pre.hpp"
+//#include "lib/error.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/tuple.hpp"
+
+//#include <tr1/memory>
+//#include <boost/scoped_ptr.hpp>
+//#include <tr1/functional>
+//#include <iostream>
+//#include <string>
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+//  using boost::scoped_ptr;
+//  using std::tr1::function;
+//  using std::ostream;
+//  using std::string;
+  
+  namespace { // ......................
+    
+  
+  } // (END) impl details
+  
+  
+  
+  
+  /**
+   */
+  template<typename SIG, class TAR, class BA>
+  class ArgumentTupleAccept
+    : BA
+    {
+    };
+  
+    
+  
+  
+} // namespace control
+#endif
diff --git a/tests/components/proc/control/argument-tuple-accept-test.cpp b/tests/components/proc/control/argument-tuple-accept-test.cpp
new file mode 100644
index 000000000..2155ef13c
--- /dev/null
+++ b/tests/components/proc/control/argument-tuple-accept-test.cpp
@@ -0,0 +1,161 @@
+/*
+  ArgumentTupleAccept(Test)  -  verify synthesising a bind(...) function
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/argument-tuple-accept.hpp"
+#include "lib/meta/function.hpp"
+#include "lib/meta/tuple.hpp"
+
+//#include "lib/scoped-ptrvect.hpp"
+//#include "lib/lumitime-fmt.hpp"
+//#include "lib/meta/typelist.hpp"
+//#include "lib/meta/tuple.hpp"
+//#include "lib/util.hpp"
+
+#include <tr1/functional>
+//#include <boost/format.hpp>
+#include <iostream>
+//#include <strstream>
+//#include <cstdlib>
+//#include <string>
+
+//using std::tr1::bind;
+//using std::tr1::placeholders::_1;
+//using std::tr1::placeholders::_2;
+using std::tr1::function;
+//using util::isnil;
+//using util::and_all;
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+//using std::string;
+//using std::rand;
+//using std::ostream;
+//using std::ostrstream;
+using std::cout;
+using std::endl;
+
+
+namespace control {
+namespace test    {
+  
+  using lib::test::showSizeof;
+  
+  using lumiera::typelist::FunctionSignature;
+  using lumiera::typelist::Tuple;
+//  using session::test::TestClip;
+//  using lumiera::P;
+//  using namespace lumiera::typelist;
+//  using lumiera::typelist::Tuple;
+  
+//  using control::CmdClosure;
+  
+  
+  
+  
+  
+  
+  namespace { // build a test dummy class....
+    
+    template<typename SIG>
+    struct Tup
+      {
+        typedef typename FunctionSignature< function<SIG> >::Args Args;
+        typedef Tuple<Args> Ty;
+      };
+    
+    
+    template<typename SIG>
+    class TestClass
+      : public ArgumentTupleAccept< SIG                     // to derive the desired signature
+                                  , TestClass               // the target class providing the implementation
+                                  , typename Tup<SIG>::Ty   // base class to inherit from
+                                  >
+      {
+        void
+        bind (typename Tup<SIG>::Ty const& tuple)
+          {
+            *this = tuple;
+          }
+      };
+    
+    
+    Time
+    randTime ()
+      {
+        UNIMPLEMENTED ("create a random but not insane Time value");
+      }
+    
+    
+  } // test-helper implementation
+  
+  
+  
+  
+  
+  typedef lib::ScopedPtrVect<CmdClosure> ArgTuples;
+  
+  /***************************************************************
+   * @test Build test object, which accepts a bind(...) call with 
+   *       specifically typed arguments.
+   *       
+   * @see  control::CommandArgumentHolder
+   */
+  class ArgumentTupleAccept_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          TestClass<void()> testVoid;
+          TestClass<int(Time,int)> testTime;
+          
+          testVoid.bind();
+          testTime.bind(randTime(),23);
+          
+          cout << showSizeof(testVoid) << endl;
+          cout << showSizeof(testITim) << endl;
+          
+          cout << testITim.getHead() << endl;
+          ASSERT (23 == testITim.getTail().getHead());
+        }
+      
+    };
+  
+  
+  
+  /** Register this test class... */
+  LAUNCHER (ArgumentTupleAccept_test, "unit controller");
+  
+  
+}} // namespace control::test

From 66f7b1be175948bef3b881a35a338a9e6ba31220 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Jul 2009 20:08:35 +0200
Subject: [PATCH 187/368] WIP impl.draft for the helper...

---
 src/proc/control/argument-tuple-accept.hpp | 106 ++++++++++++++++++++-
 1 file changed, 102 insertions(+), 4 deletions(-)

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 37434563b..043a6d6fb 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -42,6 +42,8 @@
 //#include "pre.hpp"
 //#include "lib/error.hpp"
 #include "lib/meta/typelist.hpp"
+#include "lib/meta/typelist-util.hpp"
+#include "lib/meta/function.hpp"
 #include "lib/meta/tuple.hpp"
 
 //#include <tr1/memory>
@@ -61,19 +63,115 @@ namespace control {
 //  using std::ostream;
 //  using std::string;
   
-  namespace { // ......................
+  namespace bind_arg {
     
+    using namespace lumiera::typelist;
+    
+    template< class TAR, class BA
+            , typename TYPES
+            >
+    struct AcceptArgs ;
+    
+    
+    /* specialisations for 0...9 Arguments.... */
+    
+    template< class TAR, class BA
+            >                                                                        //____________________________________
+    struct AcceptArgs<TAR,BA, Types<> >                                             ///< Accept dummy binding (0 Arguments)
+      : BA
+      {
+        void
+        bind ()
+          {
+            static_cast<TAR*> (this) -> bind (tuple::makeNullTuple() );
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            >                                                                        //_______________________________
+    struct AcceptArgs<TAR,BA, Types<T1> >                                           ///< Accept binding for 1 Argument
+      : BA
+      {
+        void
+        bind (T1 a1)
+          {
+            static_cast<TAR*> (this) -> bind (tuple::make (a1));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2> >                                        ///< Accept binding for 2 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2)
+          {
+            static_cast<TAR*> (this) -> bind (tuple::make (a1,a2));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3> >                                     ///< Accept binding for 3 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3)
+          {
+            static_cast<TAR*> (this) -> bind (tuple::make (a1,a2,a3));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4> >                                  ///< Accept binding for 4 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3, T4 a4)
+          {
+            static_cast<TAR*> (this) -> bind (tuple::make (a1,a2,a3,a4));
+          }
+      };
+    
+    
+    
+    template<typename SIG>
+    struct _Type
+      {
+        typedef typename FunctionSignature< function<SIG> >::Args Args;
+        enum { ARG_CNT = count<typename Args::List>::value };
+        typedef Tuple<Args> ArgTuple;
+      };
   
   } // (END) impl details
   
   
   
   
-  /**
+  /** Helper: mix in a \c bind(...) function
+   *  @param SIG function signature to mimic (regarding the arguments; return type will be void)
+   *  @param TAR the target class providing a function \c bind(Tuple<Types<T1...> >)
+   *  @param BASE the base class for inheritance chaining
    */
-  template<typename SIG, class TAR, class BA>
+  template<typename SIG, class TAR, class BASE>
   class ArgumentTupleAccept
-    : BA
+    : bind_arg::AcceptArgs<TAR,BASE, typename _Type<SIG>::Args>
     {
     };
   

From 30db042b161280eb6959e4f09c36aff01282d931 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Jul 2009 22:51:04 +0200
Subject: [PATCH 188/368] add component access to the time wrapper (quick'n
 dirty)

---
 src/lib/lumitime-fmt.hpp      |  2 +-
 src/lib/lumitime.cpp          | 38 +++++++++++++++++++++++++++++
 src/lib/lumitime.hpp          | 22 ++++++++++++++---
 src/lib/time.c                | 13 ++++++++++
 src/lib/time.h                |  7 ++++++
 tests/40components.tests      |  1 +
 tests/lib/timewrappertest.cpp | 46 +++++++++++++++++++++++++++++++++++
 7 files changed, 125 insertions(+), 4 deletions(-)

diff --git a/src/lib/lumitime-fmt.hpp b/src/lib/lumitime-fmt.hpp
index c7bab597b..bb8066ebe 100644
--- a/src/lib/lumitime-fmt.hpp
+++ b/src/lib/lumitime-fmt.hpp
@@ -58,7 +58,7 @@ namespace lumiera {
   /** writes time value, formatted as HH:MM:SS:mmm
    *  @see lumiera_tmpbuf_print_time  */
   inline std::ostream&
-  operator<< (ostream& os, Time const& t)
+  operator<< (std::ostream& os, Time const& t)
     {
       return os << lumiera_tmpbuf_print_time(t);
     }
diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index 0f9d993d5..29facef22 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -39,6 +39,44 @@ namespace lumiera {
   const Time Time::MIN ( -std::numeric_limits<int64_t>::max() );
   
   
+      
+  Time::Time ( long millis
+             , uint secs 
+             , uint mins
+             , uint hours
+             )
+    : t_(lumiera_build_time (millis,secs,mins,hours))
+  { }
+  
+  
+  int
+  Time::getMillis() const
+  {
+    return (t_ / (GAVL_TIME_SCALE / 1000)) % 1000; 
+  }
+  
+  
+  int
+  Time::getSecs()   const
+  {
+    return (t_ / (GAVL_TIME_SCALE / 1  )) % 60; 
+  }
+  
+  
+  int
+  Time::getMins()   const
+  {
+    return (t_ / (60 * GAVL_TIME_SCALE)) % 60; 
+  }
+  
+  
+  int
+  Time::getHours()  const
+  {
+    return (t_ / (60L * 60 * GAVL_TIME_SCALE)); 
+  }
+  
+  
   Time::operator string()  const
   {
     return string (lumiera_tmpbuf_print_time (t_));
diff --git a/src/lib/lumitime.hpp b/src/lib/lumitime.hpp
index f1503f848..6891ce064 100644
--- a/src/lib/lumitime.hpp
+++ b/src/lib/lumitime.hpp
@@ -25,6 +25,7 @@
 #define LUMIERA_LUMITIME_H
 
 #include <boost/operators.hpp>
+#include <string>
 
 extern "C" {
 #include <gavl/gavltime.h>
@@ -67,11 +68,26 @@ namespace lumiera {
       static const Time MAX ; 
       static const Time MIN ;
       
-      explicit Time (gavl_time_t val=0) : t_(val) {}
+      explicit 
+      Time (gavl_time_t val=0)
+        : t_(val)
+        { }
       
+      Time ( long millis
+           , uint secs 
+           , uint mins =0
+           , uint hours=0
+           );
+      
+      // component access
+      int getMillis () const; 
+      int getSecs   () const; 
+      int getMins   () const; 
+      int getHours  () const; 
+      
+      
+      operator std::string ()  const;
       operator gavl_time_t ()  const { return t_; }
-      operator string()  const;
-      
       
       // Supporting additive
       Time& operator+= (Time const& tx)  { t_ += tx.t_; return *this; }
diff --git a/src/lib/time.c b/src/lib/time.c
index 22340ee77..18f093fa2 100644
--- a/src/lib/time.c
+++ b/src/lib/time.c
@@ -53,3 +53,16 @@ lumiera_tmpbuf_print_time (gavl_time_t time)
   return buffer;
 }
 
+
+gavl_time_t
+lumiera_build_time (long millis, uint secs, uint mins, uint hours)
+{
+  gavl_time_t time = millis
+                   + 1000 * secs
+                   + 1000 * 60 * mins
+                   + 1000 * 60 * 60 * hours;
+  time *= GAVL_TIME_SCALE / 1000;
+  return time;
+}
+
+
diff --git a/src/lib/time.h b/src/lib/time.h
index 167571dd5..5a6034a20 100644
--- a/src/lib/time.h
+++ b/src/lib/time.h
@@ -34,5 +34,12 @@
 char*
 lumiera_tmpbuf_print_time (gavl_time_t time);
 
+
+/**
+ * Builds a time value by summing up the given components.
+ */
+gavl_time_t
+lumiera_build_time (long millis, uint secs, uint mins, uint hours);
+
 #endif
 
diff --git a/tests/40components.tests b/tests/40components.tests
index daca5bee5..379df32c1 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -423,6 +423,7 @@ END
 
 
 TEST "Time Wrapper" TimeWrapper_test <<END
+out: ..:..:..\....
 return: 0
 END
 
diff --git a/tests/lib/timewrappertest.cpp b/tests/lib/timewrappertest.cpp
index c27ed6f9b..ec426a274 100644
--- a/tests/lib/timewrappertest.cpp
+++ b/tests/lib/timewrappertest.cpp
@@ -25,12 +25,18 @@
 
 #include "lib/util.hpp"
 #include <boost/lexical_cast.hpp>
+#include <iostream>
+#include <cstdlib>
 
 using boost::lexical_cast;
 using util::isnil;
+using std::rand;
+using std::cout;
+using std::endl;
 
 
 #include "lib/lumitime.hpp"
+#include "lib/lumitime-fmt.hpp"
 
 
 
@@ -52,6 +58,7 @@ namespace lumiera {
             
             checkBasics (ref);
             checkComparisons (ref);
+            checkComponentAccess();
           } 
         
         
@@ -116,6 +123,45 @@ namespace lumiera {
             ASSERT (!(val <  gat) );
             ASSERT (!(val >  gat) );
           }
+        
+        
+        void
+        checkComponentAccess()
+          {
+            int millis = rand() % 1000;
+            int secs   = rand() % 60;
+            int mins   = rand() % 60;
+            int hours  = rand() % 100;
+            
+            Time time(millis,secs,mins,hours);
+            ASSERT (millis == time.getMillis());
+            ASSERT (secs   == time.getSecs());
+            ASSERT (mins   == time.getMins());
+            ASSERT (hours  == time.getHours());
+            cout << time << endl;
+            
+            Time t2(2008,0);
+            cout << t2 << endl;
+            ASSERT ( 8 == t2.getMillis());
+            ASSERT ( 2 == t2.getSecs());
+            ASSERT ( 0 == t2.getMins());
+            ASSERT ( 0 == t2.getHours());
+            
+            Time t3(2008,88);
+            cout << t3 << endl;
+            ASSERT ( 8 == t3.getMillis());
+            ASSERT (30 == t3.getSecs());
+            ASSERT ( 1 == t3.getMins());
+            ASSERT ( 0 == t3.getHours());
+            
+            Time t4(2008,118,58);
+            cout << t4 << endl;
+            ASSERT ( 8 == t4.getMillis());
+            ASSERT ( 0 == t4.getSecs());
+            ASSERT ( 0 == t4.getMins());
+            ASSERT ( 1 == t4.getHours());
+          }
+
       };
     
     

From fa3d596a5960bb98fa9e821d8e05da0191e2abd7 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Jul 2009 23:21:37 +0200
Subject: [PATCH 189/368] helper for accepting arguments passes unit test

---
 src/proc/control/argument-tuple-accept.hpp   | 51 ++++++++------------
 src/proc/control/command-argument-holder.hpp | 21 ++++----
 tests/45controller.tests                     |  8 +++
 tests/components/Makefile.am                 |  1 +
 4 files changed, 40 insertions(+), 41 deletions(-)

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 043a6d6fb..2c847d8d5 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -22,11 +22,11 @@
 
 
 /** @file argument-tuple-accept.hpp
- ** This template allows to mix in a \c bind(...) function.
- ** Thereby, the correct number and types of arguments is derived
- ** according to the function signature given as template parameter.
- ** This helper template is used for the ArgumentHolder and generally
- ** for binding arguments for Proc-Layer commands.
+ ** The ArgumentTupleAccept template allows to mix in a \c bind(...) function.
+ ** Thereby, the correct number and types of arguments is derived according to
+ ** the function signature given as template parameter. This helper template is
+ ** used for the ArgumentHolder and generally for binding the arguments when
+ ** defining Proc-Layer commands.
  ** 
  ** @see CommandDef
  ** @see ArgumentHolder
@@ -39,34 +39,22 @@
 #ifndef CONTROL_ARGUMENT_TUPLE_ACCEPT_H
 #define CONTROL_ARGUMENT_TUPLE_ACCEPT_H
 
-//#include "pre.hpp"
-//#include "lib/error.hpp"
 #include "lib/meta/typelist.hpp"
-#include "lib/meta/typelist-util.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/tuple.hpp"
 
-//#include <tr1/memory>
-//#include <boost/scoped_ptr.hpp>
-//#include <tr1/functional>
-//#include <iostream>
-//#include <string>
-
 
 
 namespace control {
   
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
-//  using boost::scoped_ptr;
-//  using std::tr1::function;
-//  using std::ostream;
-//  using std::string;
   
-  namespace bind_arg {
+  namespace bind_arg { // internals....
     
     using namespace lumiera::typelist;
     
+    
+    /** @internal mix in a \c bind() function
+     */
     template< class TAR, class BA
             , typename TYPES
             >
@@ -83,7 +71,7 @@ namespace control {
         void
         bind ()
           {
-            static_cast<TAR*> (this) -> bind (tuple::makeNullTuple() );
+            static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
           }
       };
     
@@ -97,7 +85,7 @@ namespace control {
         void
         bind (T1 a1)
           {
-            static_cast<TAR*> (this) -> bind (tuple::make (a1));
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
           }
       };
     
@@ -112,7 +100,7 @@ namespace control {
         void
         bind (T1 a1, T2 a2)
           {
-            static_cast<TAR*> (this) -> bind (tuple::make (a1,a2));
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
           }
       };
     
@@ -128,7 +116,7 @@ namespace control {
         void
         bind (T1 a1, T2 a2, T3 a3)
           {
-            static_cast<TAR*> (this) -> bind (tuple::make (a1,a2,a3));
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
           }
       };
     
@@ -145,7 +133,7 @@ namespace control {
         void
         bind (T1 a1, T2 a2, T3 a3, T4 a4)
           {
-            static_cast<TAR*> (this) -> bind (tuple::make (a1,a2,a3,a4));
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
           }
       };
     
@@ -155,7 +143,6 @@ namespace control {
     struct _Type
       {
         typedef typename FunctionSignature< function<SIG> >::Args Args;
-        enum { ARG_CNT = count<typename Args::List>::value };
         typedef Tuple<Args> ArgTuple;
       };
   
@@ -164,18 +151,18 @@ namespace control {
   
   
   
-  /** Helper: mix in a \c bind(...) function
-   *  @param SIG function signature to mimic (regarding the arguments; return type will be void)
-   *  @param TAR the target class providing a function \c bind(Tuple<Types<T1...> >)
+  /** Helper Template for Proc-Layer control::Command : mix in a \c bind(...) function
+   *  @param SIG  function signature to mimic (regarding the arguments; return type will be void)
+   *  @param TAR  the target class providing a function \c bindArg(Tuple<Types<T1...> >)
    *  @param BASE the base class for inheritance chaining
    */
   template<typename SIG, class TAR, class BASE>
   class ArgumentTupleAccept
-    : bind_arg::AcceptArgs<TAR,BASE, typename _Type<SIG>::Args>
+    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Args>
     {
     };
   
-    
+  
   
   
 } // namespace control
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 351c5a7d5..e196e4698 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -46,6 +46,7 @@
 //#include "pre.hpp"
 //#include "lib/error.hpp"
 #include "proc/control/command-closure.hpp"
+#include "proc/control/memento-tie.hpp"
 
 //#include <tr1/memory>
 //#include <boost/scoped_ptr.hpp>
@@ -89,7 +90,7 @@ namespace control {
         typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
     
         UntiedMemento()
-          : MementoTie<SIG,MEM> (function<SIG_undo>, function<SIG_cap>)
+          : MementoTie<SIG,MEM> (function<SIG_undo>(), function<SIG_cap>() )
           { }
       };
   
@@ -99,9 +100,14 @@ namespace control {
   
   
   /**
-  /* Specifically typed CmdClosure, which serves for 
+   * Specifically typed CmdClosure, which serves for 
    * actually allocating storage to hold the command arguments
    * and the undo state (memento) for Proc-Layer commands.
+   * Both the contained components within ArgumentHolder 
+   * can be in \em empty state; there is no distinct
+   * lifecycle limitations. ArgumentHolder is part
+   * of Proc-Layer command's implementation
+   * and should not be used standalone. 
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
@@ -148,16 +154,13 @@ namespace control {
        *  whereas the undo functions will be wired by #tie
        */
       ArgumentHolder ()
-        : arguments_(MissingArguments<SIG>)
-        , memento_(UntiedMemento<SIG,MEM>)
+        : arguments_(MissingArguments<SIG>() )
+        , memento_(UntiedMemento<SIG,MEM>() )
         { }
       
       /** has undo state capturing been invoked? */
-      bool
-      canUndo ()
-        {
-          return bool(memento_);
-        }
+      bool canUndo () { return bool(memento_); }
+      bool empty ()   { return !arguments_; }
       
       
       /** store a new argument tuple within this ArgumentHolder,
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 5f4cc95f2..908d1ea6c 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -19,6 +19,14 @@ out: saved state: 11
 END
 
 
+TEST "build argument accepting function" ArgumentTupleAccept_test <<END
+out: sizeof\( .+control.+TestClass.+ \) =   1
+out: sizeof\( .+control.+TestClass.+lumiera.Time.+ \) =  ( 8)|(16)
+out: 00:..:..\.000
+return: 0
+END
+
+
 TEST "Memento binding" MementoTie_test <<END
 return: 0
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 62c6f0155..04599d4f8 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -50,6 +50,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-argument-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
 	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\

From 60cf9e8c9e197be5277a645eaa396122411bdcd0 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 13 Jul 2009 01:16:30 +0200
Subject: [PATCH 190/368] trying to implement a simple iterator adapter working
 (oops, didn't expect this to be so difficult...)

---
 src/lib/error.hpp                             |   2 +
 src/lib/exception.cpp                         |   1 +
 src/lib/iter-adaptor.hpp                      | 150 +++++++++++++++-
 src/lib/scoped-ptrvect.hpp                    |  31 ++--
 src/lib/test/test-helper.hpp                  |  24 ++-
 .../control/argument-tuple-accept-test.cpp    |  72 ++------
 .../proc/control/command-argument-test.cpp    |  23 ++-
 .../proc/mobject/placement-basic-test.cpp     |   4 +-
 .../proc/mobject/placement-ref-test.cpp       |   6 +-
 tests/lib/iter-adaptor-test.cpp               | 161 +++++++++++++++++-
 10 files changed, 369 insertions(+), 105 deletions(-)

diff --git a/src/lib/error.hpp b/src/lib/error.hpp
index 2c5a14d72..ac089518c 100644
--- a/src/lib/error.hpp
+++ b/src/lib/error.hpp
@@ -123,6 +123,8 @@ namespace lumiera {
     
     /* generic error situations */
     LUMIERA_ERROR_DECLARE (WRONG_TYPE);   ///< runtime type mismatch 
+    LUMIERA_ERROR_DECLARE (ITER_EXHAUST); ///< end of sequence reached 
+
     
 /** Macro for creating derived exception classes properly 
  *  integrated into Lumiera's exception hierarchy. Using
diff --git a/src/lib/exception.cpp b/src/lib/exception.cpp
index 82b4a93f1..879862982 100644
--- a/src/lib/exception.cpp
+++ b/src/lib/exception.cpp
@@ -66,6 +66,7 @@ namespace lumiera {
 
     /* some further generic error situations */
     LUMIERA_ERROR_DEFINE (WRONG_TYPE, "runtime type mismatch"); 
+    LUMIERA_ERROR_DEFINE (ITER_EXHAUST, "end of sequence reached"); 
     
   } // namespace error
   
diff --git a/src/lib/iter-adaptor.hpp b/src/lib/iter-adaptor.hpp
index 5adc27f66..560b03eae 100644
--- a/src/lib/iter-adaptor.hpp
+++ b/src/lib/iter-adaptor.hpp
@@ -43,32 +43,172 @@
 
 
 //#include "include/logging.h"
-//#include "lib/error.hpp"
+#include "lib/error.hpp"
+#include "lib/bool-checkable.hpp"
 //#include "lib/util.hpp"
 
 //#include <vector>
 //#include <boost/noncopyable.hpp>
+#include <boost/type_traits/remove_pointer.hpp>
+
 
 
 namespace lib {
   
 //  using util::for_each;
+  using boost::remove_pointer;
   
   
   
   /**
+   * simple ptr-to-object based implementation of the lumiera forward iterator concept.
+   * Basically such an PtrIter behaves like the similar concept from STL, but
+   * - it is not just a disguised pointer (meaning, its more expensive)
+   * - it checks validity on every operation and may throw
+   * - it has a distinct back-link to the source container
+   * - the source container needs to implement iterStart() and iterInc()
+   * - we need friendship to and from the container class 
+   * - the end-of-iteration can be detected by bool check
+   * 
+   * @see scoped-ptrvect.hpp usage example
+   * @see iter-adaptor-test.cpp
    */
-  template<class T, class CON>
-  class PtrIter
+  template<class POS, class CON>
+  class IterAdapter
+    : public lib::BoolCheckable<IterAdapter<POS,CON> >
     {
+      const CON* source_;
+      POS pos_;
+      
+      /////////////////////////////////////////////////////////////////////////TODO: implement empty test      
+      /////////////////////////////////////////////////////////////////////////TODO: implement comparisons      
+      
+    public:
+      typedef typename POS::pointer pointer;                 //////////////////TODO: do we really need all those typedefs???
+      typedef typename POS::reference reference;
+      typedef typename POS::value_type value_type;
+      
+      IterAdapter (const CON* src, const POS& startpos)
+        : source_(src)
+        , pos_(startpos)
+        { }
+      
+      IterAdapter ()
+        : source_(0)
+        , pos_(0)
+        { }
+      
+      
+      /* === lumiera forward iterator concept === */
+      
+      reference
+      operator*() const
+        {
+          _maybe_throw();
+          return *pos_;
+        }
+
+      pointer
+      operator->() const
+        {
+          _maybe_throw();
+          return pos_;
+        }
+
+      IterAdapter&
+      operator++()
+        {
+          _maybe_throw();
+          CON::iterNext (source_,pos_);
+          return *this;
+        }
+
+      IterAdapter
+      operator++(int)
+        {
+          _maybe_throw();
+          IterAdapter oldPos(*this);
+          CON::iterNext (source_,pos_);
+          return oldPos;
+        }
+      
+      bool
+      isValid ()  const
+        {
+          return (source_ && CON::iterValid(source_,pos_));
+        }
+      
+    private:
+      
+      void
+      _maybe_throw()  const
+        {
+          if (!isValid())
+            throw lumiera::error::Invalid ("Can't iterate further", 
+                  lumiera::error::LUMIERA_ERROR_ITER_EXHAUST);
+        }
     };
   
   
-  /**
+    
+    
+    
+  
+  /** wrapper for an existing Iterator type,
+   *  automatically dereferencing the former's output.
+   *  For this to work, the "source" iterator is expected
+   *  to be declared on \em pointers rather than on values.
+   *  @note bool checkable if and only if source is...
    */
-  template<class T, class CON>
+  template<class IT>
   class PtrDerefIter
+    : public lib::BoolCheckable<PtrDerefIter<IT> >
     {
+      IT i_;
+      
+    public:
+      typedef typename IT::value_type pointer;
+      typedef typename remove_pointer<pointer>::type & reference; 
+      
+      
+      PtrDerefIter (IT srcIter)
+        : i_(srcIter)
+        { }
+      
+      
+      /* === lumiera forward iterator concept === */
+      
+      reference
+      operator*() const
+        {
+          return *(*i_);
+        }
+
+      pointer
+      operator->() const
+        {
+          return *i_;
+        }
+
+      PtrDerefIter&
+      operator++()
+        {
+          ++i_;
+          return *this;
+        }
+
+      PtrDerefIter
+      operator++(int)
+        {
+          return PtrDerefIter (i_++);
+        }
+      
+      bool
+      isValid ()  const
+        {
+          return bool(i_);
+        }
+      
     };
   
   
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index ca17b057f..5f68037d7 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -45,6 +45,7 @@
 
 
 #include "include/logging.h"
+#include "lib/iter-adaptor.hpp"
 #include "lib/error.hpp"
 #include "lib/util.hpp"
 
@@ -101,25 +102,25 @@ namespace lib {
       T&
       manage (T* obj)
         {
-          if (obj)
-            try 
-              {
-                push_back (obj);
-                return *obj;
-              }
-            catch(...)
-              {
-                delete obj;
-                throw;
-        }     }
+          REQUIRE (obj);
+          try 
+            {
+              push_back (obj);
+              return *obj;
+            }
+          catch(...)
+            {
+              delete obj;
+              throw;
+        }   }
       
       
       void
       clear()
         { 
           typedef typename _Vec::iterator VIter;
-          VIter e = this->end();
-          for (VIter i = this->begin(); i!=e; ++i)
+          VIter e = _Vec::end();
+          for (VIter i = _Vec::begin(); i!=e; ++i)
             {
               if (*i)
                 try
@@ -143,8 +144,8 @@ namespace lib {
           return *get(i);
         }
       
-      typedef PtrDerefIter<reference,       _Vec> iterator;
-      typedef PtrDerefIter<const_reference, _Vec> const_iterator;
+      typedef PtrDerefIter<typename _Vec::iterator> iterator;
+      typedef PtrDerefIter<typename _Vec::const_iterator> const_iterator;
       
       iterator       begin()        { return       iterator (_Vec::begin()); }
       const_iterator begin()  const { return const_iterator (_Vec::begin()); }
diff --git a/src/lib/test/test-helper.hpp b/src/lib/test/test-helper.hpp
index 91b13da96..268e15cbf 100644
--- a/src/lib/test/test-helper.hpp
+++ b/src/lib/test/test-helper.hpp
@@ -26,9 +26,11 @@
 
 
 #include "include/symbol.hpp"
+#include "lib/lumitime.hpp"
 
 #include <typeinfo>
 #include <string>
+#include <cstdlib>
 
 
 
@@ -36,7 +38,9 @@ namespace lib {
 namespace test{
   
   using lumiera::Symbol;
+  using lumiera::Time;
   using std::string;
+  using std::rand;
   
   
   
@@ -48,7 +52,7 @@ namespace test{
    *          type identification as implemented by the compiler.
    */
   template<typename T>
-  const char*
+  inline const char*
   showType (T const& obj, Symbol name=0)
   {
     return name? name : typeid(obj).name();
@@ -61,7 +65,7 @@ namespace test{
    *          type identification as implemented by the compiler.
    */
   template<typename T>
-  const char*
+  inline const char*
   showType (Symbol name=0)
   {
     return name? name : typeid(T).name();
@@ -75,21 +79,21 @@ namespace test{
   
   /** for printing sizeof(), trying to figure out the type name automatically */
   template<typename T>
-  string
+  inline string
   showSizeof(Symbol name=0)
   {
     return showSizeof (sizeof (T), showType<T> (name));
   }
   
   template<typename T>
-  string
+  inline string
   showSizeof(T const& obj, Symbol name=0)
   {
     return showSizeof (sizeof (obj), showType (obj,name));
   }
   
   template<typename T>
-  string
+  inline string
   showSizeof(T *obj, Symbol name=0)
   {
     return obj? showSizeof (*obj, name)
@@ -97,6 +101,16 @@ namespace test{
   }
   
   
+  
+    
+  /** create a random but not insane Time value */    
+  inline Time
+  randTime ()
+  {
+    return Time (500 * (rand() % 2), (rand() % 600));
+  }
+  
+  
 }} // namespace lib::test
 
 
diff --git a/tests/components/proc/control/argument-tuple-accept-test.cpp b/tests/components/proc/control/argument-tuple-accept-test.cpp
index 2155ef13c..7416b1998 100644
--- a/tests/components/proc/control/argument-tuple-accept-test.cpp
+++ b/tests/components/proc/control/argument-tuple-accept-test.cpp
@@ -23,45 +23,14 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/tuple.hpp"
-
-//#include "lib/scoped-ptrvect.hpp"
-//#include "lib/lumitime-fmt.hpp"
-//#include "lib/meta/typelist.hpp"
-//#include "lib/meta/tuple.hpp"
-//#include "lib/util.hpp"
+#include "lib/lumitime-fmt.hpp"
 
 #include <tr1/functional>
-//#include <boost/format.hpp>
 #include <iostream>
-//#include <strstream>
-//#include <cstdlib>
-//#include <string>
 
-//using std::tr1::bind;
-//using std::tr1::placeholders::_1;
-//using std::tr1::placeholders::_2;
-using std::tr1::function;
-//using util::isnil;
-//using util::and_all;
-//using boost::format;
-//using lumiera::Time;
-//using util::contains;
-//using std::string;
-//using std::rand;
-//using std::ostream;
-//using std::ostrstream;
 using std::cout;
 using std::endl;
 
@@ -70,15 +39,12 @@ namespace control {
 namespace test    {
   
   using lib::test::showSizeof;
+  using lib::test::randTime;
   
+  using lumiera::Time;
+  using std::tr1::function;
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::Tuple;
-//  using session::test::TestClip;
-//  using lumiera::P;
-//  using namespace lumiera::typelist;
-//  using lumiera::typelist::Tuple;
-  
-//  using control::CmdClosure;
   
   
   
@@ -98,36 +64,32 @@ namespace test    {
     template<typename SIG>
     class TestClass
       : public ArgumentTupleAccept< SIG                     // to derive the desired signature
-                                  , TestClass               // the target class providing the implementation
+                                  , TestClass<SIG>          // the target class providing the implementation
                                   , typename Tup<SIG>::Ty   // base class to inherit from
                                   >
       {
+        typedef typename Tup<SIG>::Ty ATuple;
+        
+      public:
+        
         void
-        bind (typename Tup<SIG>::Ty const& tuple)
+        bindArg (ATuple const& tuple)
           {
-            *this = tuple;
+            static_cast<ATuple&> (*this) = tuple;
           }
       };
     
     
-    Time
-    randTime ()
-      {
-        UNIMPLEMENTED ("create a random but not insane Time value");
-      }
-    
-    
   } // test-helper implementation
   
   
   
   
   
-  typedef lib::ScopedPtrVect<CmdClosure> ArgTuples;
   
-  /***************************************************************
-   * @test Build test object, which accepts a bind(...) call with 
-   *       specifically typed arguments.
+  /*************************************************************
+   * @test Build a test object, which accepts a bind(...) call
+   *       with specifically typed arguments.
    *       
    * @see  control::CommandArgumentHolder
    */
@@ -144,10 +106,10 @@ namespace test    {
           testTime.bind(randTime(),23);
           
           cout << showSizeof(testVoid) << endl;
-          cout << showSizeof(testITim) << endl;
+          cout << showSizeof(testTime) << endl;
           
-          cout << testITim.getHead() << endl;
-          ASSERT (23 == testITim.getTail().getHead());
+          cout << testTime.getHead() << endl;
+          ASSERT (23 == testTime.getTail().getHead());
         }
       
     };
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index e8e8c485b..3ff10cc23 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -42,7 +42,7 @@
 //#include <tr1/functional>
 #include <boost/format.hpp>
 #include <iostream>
-#include <strstream>
+#include <sstream>
 //#include <cstdlib>
 #include <string>
 
@@ -58,7 +58,7 @@ using lumiera::Time;
 using std::string;
 //using std::rand;
 using std::ostream;
-using std::ostrstream;
+using std::ostringstream;
 using std::cout;
 using std::endl;
 
@@ -67,6 +67,7 @@ namespace control {
 namespace test    {
   
   using lib::test::showSizeof;
+  using lib::test::randTime;
   
 //  using session::test::TestClip;
 //  using lumiera::P;
@@ -82,7 +83,7 @@ namespace test    {
   
   namespace { // test helpers
     
-    ostrstream protocol;     ///< used to verify the test function calls
+    ostringstream protocol;     ///< used to verify the test function calls
     
     
     template<typename TY>
@@ -103,7 +104,7 @@ namespace test    {
           }
        
        TY&
-       operator* () const
+       operator* ()
          {
            return element_;
          }
@@ -111,7 +112,7 @@ namespace test    {
        friend ostream&
        operator<< (ostream& out, const Tracker& tra)
          {
-           return out << element_;
+           return out << tra.element_;
          }
       };
     
@@ -128,13 +129,13 @@ namespace test    {
       }
     
     Tracker<string>
-    captureState (Tracker<Time> time, Tracker<string> str, int rand)
+    captureState (Tracker<Time>, Tracker<string>, int)
       {
         return protocol.str();
       }
     
     void
-    undoIt (Tracker<Time> time, Tracker<string> str, int rand, Tracker<string> memento)
+    undoIt (Tracker<Time> time, Tracker<string>, int, Tracker<string> memento)
       {
         protocol << "undoIt(time="<<time<<")---state-was-:"<< *memento;
       }
@@ -156,12 +157,6 @@ namespace test    {
         // serialise, then de-serialise into a new instance and compare both
       }
     
-    Time
-    randTime ()
-      {
-        UNIMPLEMENTED ("create a random but not insane Time value");
-      }
-    
     
   } // test-helper implementation
   
@@ -183,6 +178,7 @@ namespace test    {
       virtual void
       run (Arg) 
         {
+#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
           ArgTuples testTuples;
           Tracker<Time>::instanceCnt = 0;
           Tracker<string>::instanceCnt = 0;
@@ -323,6 +319,7 @@ namespace test    {
           
           bound_undoFun();
           cout << protocol.str() << endl;
+#endif ////////////////////////////////////////////////////////////////////////////TODO.....          
         }
     };
   
diff --git a/tests/components/proc/mobject/placement-basic-test.cpp b/tests/components/proc/mobject/placement-basic-test.cpp
index 637ee4f35..9725c4bee 100644
--- a/tests/components/proc/mobject/placement-basic-test.cpp
+++ b/tests/components/proc/mobject/placement-basic-test.cpp
@@ -77,14 +77,14 @@ namespace mobject {
               // TODO: how to handle insufficiently determinated Placement? Throw?
               FixedLocation & fixloc = pc.chain(Time(1)); // TODO: the track??
               ExplicitPlacement expla = pc.resolve();
-              ASSERT (expla.time == 1);
+              ASSERT (expla.time == Time(1));
               ASSERT (!expla.chain.isOverdetermined());
               //ASSERT (*expla == *pc);  ////////////////////////TODO: define equality on placements (Trac #119)
               
               // now overconstraining with another Placement
               pc.chain(Time(2));
               ExplicitPlacement expla2 = pc.resolve();
-              ASSERT (expla2.time == 2); // the latest addition wins
+              ASSERT (expla2.time == Time(2)); // the latest addition wins
               ASSERT (expla2.chain.isOverdetermined()); 
             } 
         };
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index b8e4a5001..37347f161 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -106,7 +106,7 @@ namespace test    {
           ASSERT (1 == ref1.use_count());
           ASSERT (1 == ref2.use_count());
           ExplicitPlacement exPla = refX.resolve();
-          ASSERT (exPla.time == 2);                // indeed get back the time we set on p2 above
+          ASSERT (exPla.time == Time(2));          // indeed get back the time we set on p2 above
           ASSERT (2 == ref2.use_count());          // exPla shares ownership with p2
           
           ASSERT (index->contains(ref1));          // ref can stand-in for a placement-ID 
@@ -144,9 +144,9 @@ namespace test    {
           ASSERT (ref2 != refX);
           
           // resolution is indeed "live", we see changes to the referred placement
-          ASSERT (refX.resolve().time == 0);
+          ASSERT (refX.resolve().time == Time(0));
           p1 = p2;
-          ASSERT (refX.resolve().time == 2);       // now we get the time tie we originally set on p2
+          ASSERT (refX.resolve().time == Time(2)); // now we get the time tie we originally set on p2
           ASSERT (3 == ref2.use_count());          // p1, p2 and exPla share ownership
 
           // actually, the assignment has invalidated ref1, because of the changed ID
diff --git a/tests/lib/iter-adaptor-test.cpp b/tests/lib/iter-adaptor-test.cpp
index 4bb6df4ba..be29b9aca 100644
--- a/tests/lib/iter-adaptor-test.cpp
+++ b/tests/lib/iter-adaptor-test.cpp
@@ -26,14 +26,93 @@
 #include "lib/util.hpp"
 
 //#include "lib/scoped-ptrvect.hpp"
+#include "lib/iter-adaptor.hpp"
 //#include "testdummy.hpp"
+#include <vector>
+#include <iostream>
+#include <boost/lexical_cast.hpp>
+
 
 
 namespace lib {
 namespace test{
   
   using ::Test;
-  using util::isnil;
+//  using util::isnil;
+  using boost::lexical_cast;
+  using util::for_each;
+  using std::vector;
+  using std::cout;
+  using std::endl;
+  
+  
+  namespace {
+  
+    uint NUM_ELMS = 10;
+  
+  
+    class TestContainer
+      {
+        typedef vector<int *> _Vec;
+        
+        _Vec numberz_;
+        
+        static void killIt (int *it) { delete it; }
+        
+      public:
+        TestContainer (uint count)
+          : numberz_(count)
+          {
+            for (uint i=0; i<count; ++i)
+              numberz_[i] = new int(i);
+          }
+        
+       ~TestContainer ()
+          {
+            for_each (numberz_, killIt);
+          }
+       
+        typedef int *  value_type;
+        typedef int ** pointer;
+        typedef int *& reference;
+       
+        typedef IterAdapter<_Vec::iterator,       TestContainer> iterator;
+        typedef IterAdapter<_Vec::const_iterator, TestContainer> const_iterator;
+        typedef PtrDerefIter<iterator      > ref_iterator;
+        typedef PtrDerefIter<const_iterator> const_ref_iter;
+       
+       
+        iterator       begin ()           { return iterator (this, numberz_.begin()); }
+        const_iterator begin ()     const { return const_iterator (this, numberz_.begin()); }
+        ref_iterator   begin_ref ()       { return ref_iterator (begin()); }
+        const_ref_iter begin_ref () const { return const_ref_iter (begin()); }
+       
+        iterator       end ()             { return iterator(); }
+        const_iterator end ()       const { return const_iterator(); }
+
+      protected:
+        
+        friend class IterAdapter<_Vec::iterator,      TestContainer>;
+        friend class IterAdapter<_Vec::const_iterator,TestContainer>;
+        
+        
+        template<class ITER>
+        static void
+        iterNext (const TestContainer* src, ITER& pos)
+          {
+            if (iterValid(src,pos))
+              ++pos;
+          }
+        
+        template<class ITER>
+        static bool
+        iterValid (const TestContainer* src, ITER& pos)
+          {
+            REQUIRE (src);
+            return pos != src->numberz_.end();
+          }
+      };
+  }
   
   
   
@@ -47,21 +126,89 @@ namespace test{
     {
       
       virtual void
-      run (Arg)
+      run (Arg arg)
         {
-          UNIMPLEMENTED ("build a simple lumiera forward iterator");
-          simpleUsage();
-//        iterating();
-//        detaching();
+          if (0 < arg.size()) NUM_ELMS = lexical_cast<uint> (arg[0]);          
+          
+          TestContainer testElms (NUM_ELMS);
+          simpleUsage (testElms);
+          iterTypeVariations (testElms);
         }
       
       
+      static void showIt (int* elm) { cout << "::" << *elm; }
+      
       
       void
-      simpleUsage()
+      simpleUsage (TestContainer& elms)
         {
+          for_each (elms, showIt);
+          cout << endl;
         }
       
+      
+      void
+      iterTypeVariations (TestContainer& elms)
+        {
+          TestContainer const& const_elms (elms);
+          
+          int i = 0;
+          for (TestContainer::iterator iter = elms.begin();
+               iter; ++iter, ++i
+              )
+            {
+              ASSERT (iter);
+              ASSERT (iter != elms.end());
+              ASSERT (**iter == i);
+              --(**iter);
+              ASSERT (**iter == i-1);
+            }
+          
+          i = 0;
+          for (TestContainer::const_iterator iter = const_elms.begin();
+               iter; ++iter, ++i
+              )
+            {
+              ASSERT (iter);
+//            ASSERT (iter != elms.end());                  ////////////////////////////TODO: implement comparison
+              ASSERT (**iter == i-1);
+              
+              // note: the previous run indeed modified
+              // the element within the container.
+              
+              // --(**iter);   // doesn't compile, because it's const
+            }
+          
+          i = 0;
+          for (TestContainer::ref_iterator iter = elms.begin_ref();
+               iter; ++iter, ++i
+              )
+            {
+              ASSERT (iter);
+              ASSERT ((*iter) == i-1);
+              ++(*iter);
+              ASSERT ((*iter) == i);
+            }
+          
+          i = 0;
+          for (TestContainer::const_ref_iter iter = const_elms.begin_ref();
+               iter; ++iter, ++i
+              )
+            {
+              ASSERT (iter);
+              ASSERT ((*iter) == i);
+            }
+          
+          ASSERT (TestContainer::iterator() == elms.end());
+          ASSERT (!(TestContainer::iterator()));
+          ASSERT (!(elms.end()));
+//        ASSERT (isnil (elms.end()));                  ////////////////////////////TODO: implement empty test
+          
+          ASSERT (elms.begin());
+//        ASSERT (!isnil (elms.begin()));                  ////////////////////////////TODO: implement empty test
+        }
+
+      
     };
   
   LAUNCHER (IterAdaptor_test, "unit common");

From 1a69026acb739259125276c405c50b3b177c701c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 13 Jul 2009 01:16:40 +0200
Subject: [PATCH 191/368] spelling fix

---
 src/lib/query.cpp                                      |  2 +-
 src/lib/query.hpp                                      |  2 +-
 src/proc/asset/struct.cpp                              |  6 +++---
 tests/42query.tests                                    | 10 +++++-----
 tests/components/proc/asset/basicpipetest.cpp          |  6 +++---
 .../proc/mobject/session/defsmanagerimpltest.cpp       |  2 +-
 .../proc/mobject/session/defsmanagertest.cpp           |  6 +++---
 tests/lib/query/queryutilstest.cpp                     |  8 ++++----
 8 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/src/lib/query.cpp b/src/lib/query.cpp
index 259207387..f47b9819a 100644
--- a/src/lib/query.cpp
+++ b/src/lib/query.cpp
@@ -52,7 +52,7 @@ namespace lumiera {
     
     
     void
-    normalizeID (string& id)
+    normaliseID (string& id)
     {
       id = util::sanitize(id);
       if (isnil(id) || !is_alpha (id[0]))
diff --git a/src/lib/query.hpp b/src/lib/query.hpp
index 8aafae6ff..783992ade 100644
--- a/src/lib/query.hpp
+++ b/src/lib/query.hpp
@@ -69,7 +69,7 @@ namespace lumiera {
      *  Trim, sanitize and ensure the first letter is lower case.
      *  @note modifies the given string ref in place
      */
-    void normalizeID (string& id);
+    void normaliseID (string& id);
     
 
     /** count the top-level predicates in the query string.
diff --git a/src/proc/asset/struct.cpp b/src/proc/asset/struct.cpp
index 4288e066a..9774f1786 100644
--- a/src/proc/asset/struct.cpp
+++ b/src/proc/asset/struct.cpp
@@ -38,7 +38,7 @@
 using boost::format;
 
 using lumiera::Symbol;
-using lumiera::query::normalizeID;
+using lumiera::query::normaliseID;
 using lumiera::query::QueryHandler;
 using lumiera::ConfigRules;
 
@@ -120,8 +120,8 @@ namespace asset
   P<Pipe> 
   StructFactory::operator() (string pipeID, string streamID)
   {
-    normalizeID (pipeID);
-    normalizeID (streamID);
+    normaliseID (pipeID);
+    normaliseID (streamID);
     static format descriptor("pipe(%s), stream(%s).");
     Pipe* pP = impl_->fabricate (Query<Pipe> (descriptor % pipeID % streamID));
     return AssetManager::instance().wrap (*pP);
diff --git a/tests/42query.tests b/tests/42query.tests
index fe7ee9b49..d05c27fcc 100644
--- a/tests/42query.tests
+++ b/tests/42query.tests
@@ -2,27 +2,27 @@ TESTING "Proc Layer config rules Test Suite" ./test-lib --group=query
 
 
 
-TEST "QueryUtils_test" QueryUtils_test  Query  <<END
+TEST "simple query" QueryUtils_test  Query  <<END
 out: N7lumiera5query4test5ThingE: I am writing a test sentence.
 END
 
 
-TEST "QueryUtils_test" QueryUtils_test  normalizeID  <<END
+TEST "normalise ID" QueryUtils_test  normaliseID  <<END
 out: ..original : a A AA dufte 1a _1 A_A BÄH    White  space  §&Ω%€GΩ%€ar  Ω  baäääääge!!!!!  : 
 out: normalised : a a aA dufte o1a o_1 a_A bH o white_space gar_bage :
 END
 
 
-TEST "QueryUtils_test" QueryUtils_test  extractID  <<END
+TEST "extract ID" QueryUtils_test  extractID  <<END
 return: 0
 END
 
 
-TEST "QueryUtils_test" QueryUtils_test  removeTerm  <<END
+TEST "remove term from query" QueryUtils_test  removeTerm  <<END
 return: 0
 END
 
 
-TEST "QueryUtils_test" QueryUtils_test  countPraed  <<END
+TEST "count predicates in query" QueryUtils_test  countPraed  <<END
 return: 0
 END
diff --git a/tests/components/proc/asset/basicpipetest.cpp b/tests/components/proc/asset/basicpipetest.cpp
index 9c5069a79..132502a42 100644
--- a/tests/components/proc/asset/basicpipetest.cpp
+++ b/tests/components/proc/asset/basicpipetest.cpp
@@ -49,7 +49,7 @@ namespace asset
     {
     using mobject::Session;
     using lumiera::Query;
-    using lumiera::query::normalizeID;
+    using lumiera::query::normaliseID;
     
     
     
@@ -81,7 +81,7 @@ namespace asset
         void createExplicit (string pID, string sID)
           { 
             string pID_sane (pID);
-            normalizeID (pID_sane);
+            normaliseID (pID_sane);
             ASSERT (pID_sane != pID);
             
             PPipe thePipe = asset::Struct::create (pID,sID);
@@ -106,7 +106,7 @@ namespace asset
         
         void create_or_ref(string pID)
           { 
-            normalizeID (pID);
+            normaliseID (pID);
             
             PPipe pipe1 = Pipe::query ("pipe("+pID+")");
             ASSERT (pipe1);
diff --git a/tests/components/proc/mobject/session/defsmanagerimpltest.cpp b/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
index a66250a3e..97741b5e9 100644
--- a/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
+++ b/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
@@ -46,7 +46,7 @@ namespace asset {
     using mobject::Session;
     using lumiera::Symbol;
     using lumiera::Query;
-    using lumiera::query::normalizeID;
+    using lumiera::query::normaliseID;
     
     using lumiera::ConfigRules;
     using lumiera::query::QueryHandler;
diff --git a/tests/components/proc/mobject/session/defsmanagertest.cpp b/tests/components/proc/mobject/session/defsmanagertest.cpp
index f59940074..0573859ab 100644
--- a/tests/components/proc/mobject/session/defsmanagertest.cpp
+++ b/tests/components/proc/mobject/session/defsmanagertest.cpp
@@ -47,7 +47,7 @@ namespace asset
     {
     using mobject::Session;
     using lumiera::Query;
-    using lumiera::query::normalizeID;
+    using lumiera::query::normaliseID;
     
     using lumiera::ConfigRules;               ////TODO just temp
     using lumiera::query::QueryHandler;      ////TODO just temp
@@ -82,8 +82,8 @@ namespace asset
             string pipeID   = isnil(arg)?  "Black Hole" : arg[1];
             string streamID = 2>arg.size()? "teststream" : arg[2] ;
             
-            normalizeID (pipeID);
-            normalizeID (streamID);
+            normaliseID (pipeID);
+            normaliseID (streamID);
             
             retrieveSimpleDefault (pipeID);
             retrieveConstrainedDefault (pipeID, streamID);
diff --git a/tests/lib/query/queryutilstest.cpp b/tests/lib/query/queryutilstest.cpp
index 36fdc9a2f..b46447b7c 100644
--- a/tests/lib/query/queryutilstest.cpp
+++ b/tests/lib/query/queryutilstest.cpp
@@ -66,10 +66,10 @@ namespace lumiera {
           virtual void
           run (Arg arg) 
             {
-              if (isnil(arg))  arg = Cmdline ("Query normalizeID extractID removeTerm countPraed");
+              if (isnil(arg))  arg = Cmdline ("Query normaliseID extractID removeTerm countPraed");
               
               if (contains (arg, "Query"      ))   check_Query ();
-              if (contains (arg, "normalizeID"))   check_normalizeID ();
+              if (contains (arg, "normaliseID"))   check_normaliseID ();
               if (contains (arg, "extractID"  ))   check_extractID ();
               if (contains (arg, "removeTerm" ))   check_removeTerm ();
               if (contains (arg, "countPraed" ))   check_countPraed ();
@@ -88,7 +88,7 @@ namespace lumiera {
           
           /** @test sanitising and normalising various tokens */
           void
-          check_normalizeID ()
+          check_normaliseID ()
             {
               Cmdline tokens ("a A AA dufte 1a _1 A_A BÄH");
               tokens.push_back ("");
@@ -97,7 +97,7 @@ namespace lumiera {
               
               cout << "..original : " << tokens << " :\n";
               
-              for_each (tokens, bind ( &normalizeID, _1 ));
+              for_each (tokens, bind ( &normaliseID, _1 ));
               
               cout << "normalised : " << tokens << " :\n";
             }

From e2cd4aba8a8a01bb245dfc72ba7f37ce2edd7937 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 13 Jul 2009 01:25:24 +0200
Subject: [PATCH 192/368] fix name, add test for postfix increment

---
 .../{iter-adaptor.hpp => iter-adapter.hpp}    | 12 ++++++-----
 src/lib/scoped-ptrvect.hpp                    |  2 +-
 tests/40components.tests                      |  3 ++-
 tests/lib/Makefile.am                         |  2 +-
 ...adaptor-test.cpp => iter-adapter-test.cpp} | 20 +++++++++++--------
 5 files changed, 23 insertions(+), 16 deletions(-)
 rename src/lib/{iter-adaptor.hpp => iter-adapter.hpp} (91%)
 rename tests/lib/{iter-adaptor-test.cpp => iter-adapter-test.cpp} (93%)

diff --git a/src/lib/iter-adaptor.hpp b/src/lib/iter-adapter.hpp
similarity index 91%
rename from src/lib/iter-adaptor.hpp
rename to src/lib/iter-adapter.hpp
index 560b03eae..1b8bbbc7b 100644
--- a/src/lib/iter-adaptor.hpp
+++ b/src/lib/iter-adapter.hpp
@@ -20,7 +20,7 @@
  
 */
 
-/** @file iter-adaptor.hpp
+/** @file iter-adapter.hpp
  ** Helper template(s) for creating <b>lumiera forward iterators</b>.
  ** This denotes a concept similar to STL's  "forward iterator", with
  ** the addition of an bool check to detect iteration end. The latter
@@ -61,13 +61,15 @@ namespace lib {
   
   
   /**
-   * simple ptr-to-object based implementation of the lumiera forward iterator concept.
-   * Basically such an PtrIter behaves like the similar concept from STL, but
-   * - it is not just a disguised pointer (meaning, its more expensive)
+   * Adapter for building an implementation of the lumiera forward iterator concept.
+   * The "current position" is represented as an opaque element (usually an nested iterator),
+   * with callbacks to the controlling container instance for managing this position. 
+   * Basically such an IterAdapter behaves like the similar concept from STL, but
+   * - it is not just a disguised pointer (meaning, it's more expensive)
    * - it checks validity on every operation and may throw
    * - it has a distinct back-link to the source container
    * - the source container needs to implement iterStart() and iterInc()
-   * - we need friendship to and from the container class 
+   * - we need friendship to access the callbacks on the container 
    * - the end-of-iteration can be detected by bool check
    * 
    * @see scoped-ptrvect.hpp usage example
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index 5f68037d7..932bcffb6 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -45,7 +45,7 @@
 
 
 #include "include/logging.h"
-#include "lib/iter-adaptor.hpp"
+#include "lib/iter-adapter.hpp"
 #include "lib/error.hpp"
 #include "lib/util.hpp"
 
diff --git a/tests/40components.tests b/tests/40components.tests
index 379df32c1..59e355116 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -281,7 +281,8 @@ return: 0
 END
 
 
-PLANNED "Lumiera Iterator Concept" IterAdaptor_test  <<END
+TEST "Lumiera Iterator Concept" IterAdapter_test 20 <<END
+out: ::0::1::2::3::4::5::6::7::8::9::10::11::12::13::14::15::16::17::18::19
 END
 
 
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 1679c19cf..c9c853dc0 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -46,7 +46,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
-	$(testlib_srcdir)/iter-adaptor-test.cpp			\
+	$(testlib_srcdir)/iter-adapter-test.cpp			\
 	$(testlib_srcdir)/mainsuite.cpp				\
 	$(testlib_srcdir)/meta/typelist-test.cpp         	\
 	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
diff --git a/tests/lib/iter-adaptor-test.cpp b/tests/lib/iter-adapter-test.cpp
similarity index 93%
rename from tests/lib/iter-adaptor-test.cpp
rename to tests/lib/iter-adapter-test.cpp
index be29b9aca..ca9684d06 100644
--- a/tests/lib/iter-adaptor-test.cpp
+++ b/tests/lib/iter-adapter-test.cpp
@@ -1,5 +1,5 @@
 /*
-  IterAdaptor(Test)  -  building simple iterators for a given container
+  IterAdapter(Test)  -  building various custom iterators for a given container
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -26,7 +26,7 @@
 #include "lib/util.hpp"
 
 //#include "lib/scoped-ptrvect.hpp"
-#include "lib/iter-adaptor.hpp"
+#include "lib/iter-adapter.hpp"
 //#include "testdummy.hpp"
 #include <vector>
 #include <iostream>
@@ -72,10 +72,7 @@ namespace test{
             for_each (numberz_, killIt);
           }
        
-        typedef int *  value_type;
-        typedef int ** pointer;
-        typedef int *& reference;
-       
+        
         typedef IterAdapter<_Vec::iterator,       TestContainer> iterator;
         typedef IterAdapter<_Vec::const_iterator, TestContainer> const_iterator;
         typedef PtrDerefIter<iterator      > ref_iterator;
@@ -122,7 +119,7 @@ namespace test{
    *        "lumiera forward iterator"
    * @todo see Ticket #182
    */
-  class IterAdaptor_test : public Test
+  class IterAdapter_test : public Test
     {
       
       virtual void
@@ -199,6 +196,13 @@ namespace test{
               ASSERT ((*iter) == i);
             }
           
+          TestContainer::ref_iterator rI (elms.begin_ref());
+          
+          ASSERT (0 == *rI );
+          ASSERT (0 == *rI++);
+          ASSERT (1 == *rI  );
+          ASSERT (2 == *++rI);
+          
           ASSERT (TestContainer::iterator() == elms.end());
           ASSERT (!(TestContainer::iterator()));
           ASSERT (!(elms.end()));
@@ -211,7 +215,7 @@ namespace test{
       
     };
   
-  LAUNCHER (IterAdaptor_test, "unit common");
+  LAUNCHER (IterAdapter_test, "unit common");
   
   
 }} // namespace lib::test

From b2f72ef0fc82d3b9cd3bfd777e6d466de0ead907 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 14 Jul 2009 06:29:04 +0200
Subject: [PATCH 193/368] IterAdapter now passes test, but is still rather
 uggly...

---
 src/lib/iter-adapter.hpp        | 76 +++++++++++++++++++++++----------
 tests/lib/iter-adapter-test.cpp | 56 +++++++++++++++---------
 2 files changed, 90 insertions(+), 42 deletions(-)

diff --git a/src/lib/iter-adapter.hpp b/src/lib/iter-adapter.hpp
index 1b8bbbc7b..1a6880963 100644
--- a/src/lib/iter-adapter.hpp
+++ b/src/lib/iter-adapter.hpp
@@ -42,20 +42,15 @@
 #define LIB_ITER_ADAPTOR_H
 
 
-//#include "include/logging.h"
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
-//#include "lib/util.hpp"
 
-//#include <vector>
-//#include <boost/noncopyable.hpp>
 #include <boost/type_traits/remove_pointer.hpp>
 
 
 
 namespace lib {
   
-//  using util::for_each;
   using boost::remove_pointer;
   
   
@@ -80,20 +75,19 @@ namespace lib {
     : public lib::BoolCheckable<IterAdapter<POS,CON> >
     {
       const CON* source_;
-      POS pos_;
-      
-      /////////////////////////////////////////////////////////////////////////TODO: implement empty test      
-      /////////////////////////////////////////////////////////////////////////TODO: implement comparisons      
+      mutable POS pos_;
       
     public:
-      typedef typename POS::pointer pointer;                 //////////////////TODO: do we really need all those typedefs???
+      typedef typename POS::pointer pointer;
       typedef typename POS::reference reference;
       typedef typename POS::value_type value_type;
       
       IterAdapter (const CON* src, const POS& startpos)
         : source_(src)
         , pos_(startpos)
-        { }
+        { 
+          CON::iterValid(source_,pos_);
+        }
       
       IterAdapter ()
         : source_(0)
@@ -109,14 +103,14 @@ namespace lib {
           _maybe_throw();
           return *pos_;
         }
-
+      
       pointer
       operator->() const
         {
           _maybe_throw();
           return pos_;
         }
-
+      
       IterAdapter&
       operator++()
         {
@@ -124,7 +118,7 @@ namespace lib {
           CON::iterNext (source_,pos_);
           return *this;
         }
-
+      
       IterAdapter
       operator++(int)
         {
@@ -140,24 +134,43 @@ namespace lib {
           return (source_ && CON::iterValid(source_,pos_));
         }
       
+      bool
+      empty ()    const
+        {
+          return !isValid();
+        }
+      
+      
     private:
       
       void
       _maybe_throw()  const
         {
           if (!isValid())
-            throw lumiera::error::Invalid ("Can't iterate further", 
+            throw lumiera::error::Invalid ("Can't iterate further",
                   lumiera::error::LUMIERA_ERROR_ITER_EXHAUST);
         }
+      
+      /// comparison is allowed to access impl iterator
+      template<class P1, class P2, class CX>
+      friend bool operator== (IterAdapter<P1,CX> const&, IterAdapter<P2,CX> const&);
     };
   
   
-    
-    
-    
+  /// Supporting equality comparisons...
+  template<class P1, class P2, class CON>
+  bool operator== (IterAdapter<P1,CON> const& il, IterAdapter<P2,CON> const& ir)  { return il.pos_ == ir.pos_; }
+  
+  template<class P1, class P2, class CON>
+  bool operator!= (IterAdapter<P1,CON> const& il, IterAdapter<P2,CON> const& ir)  { return !(il == ir); }
+  
+  
+  
+  
+  
   
   /** wrapper for an existing Iterator type,
-   *  automatically dereferencing the former's output.
+   *  automatically dereferencing the output of the former.
    *  For this to work, the "source" iterator is expected
    *  to be declared on \em pointers rather than on values.
    *  @note bool checkable if and only if source is...
@@ -170,7 +183,8 @@ namespace lib {
       
     public:
       typedef typename IT::value_type pointer;
-      typedef typename remove_pointer<pointer>::type & reference; 
+      typedef typename remove_pointer<pointer>::type value_type;
+      typedef value_type& reference; 
       
       
       PtrDerefIter (IT srcIter)
@@ -185,20 +199,20 @@ namespace lib {
         {
           return *(*i_);
         }
-
+      
       pointer
       operator->() const
         {
           return *i_;
         }
-
+      
       PtrDerefIter&
       operator++()
         {
           ++i_;
           return *this;
         }
-
+      
       PtrDerefIter
       operator++(int)
         {
@@ -211,9 +225,25 @@ namespace lib {
           return bool(i_);
         }
       
+      bool
+      empty ()    const
+        {
+          return !isValid();
+        }
+      
+      
+      /// comparison operator is allowed to access the underlying impl iterator
+      template<class I1, class I2>
+      friend bool operator== (PtrDerefIter<I1> const&, PtrDerefIter<I2> const&);
     };
   
   
+  /// Supporting equality comparisons...
+  template<class I1, class I2>
+  bool operator== (PtrDerefIter<I1> const& il, PtrDerefIter<I2> const& ir)  { return il.i_ == ir.i_; }
+    
+  template<class I1, class I2>
+  bool operator!= (PtrDerefIter<I1> const& il, PtrDerefIter<I2> const& ir)  { return !(il == ir); }
   
   
 } // namespace lib
diff --git a/tests/lib/iter-adapter-test.cpp b/tests/lib/iter-adapter-test.cpp
index ca9684d06..d7935dd33 100644
--- a/tests/lib/iter-adapter-test.cpp
+++ b/tests/lib/iter-adapter-test.cpp
@@ -25,12 +25,11 @@
 #include "lib/test/run.hpp"
 #include "lib/util.hpp"
 
-//#include "lib/scoped-ptrvect.hpp"
 #include "lib/iter-adapter.hpp"
-//#include "testdummy.hpp"
-#include <vector>
-#include <iostream>
+
 #include <boost/lexical_cast.hpp>
+#include <iostream>
+#include <vector>
 
 
 
@@ -38,9 +37,9 @@ namespace lib {
 namespace test{
   
   using ::Test;
-//  using util::isnil;
   using boost::lexical_cast;
   using util::for_each;
+  using util::isnil;
   using std::vector;
   using std::cout;
   using std::endl;
@@ -75,38 +74,57 @@ namespace test{
         
         typedef IterAdapter<_Vec::iterator,       TestContainer> iterator;
         typedef IterAdapter<_Vec::const_iterator, TestContainer> const_iterator;
-        typedef PtrDerefIter<iterator      > ref_iterator;
-        typedef PtrDerefIter<const_iterator> const_ref_iter;
+        typedef PtrDerefIter<iterator      >                     ref_iterator;
+        typedef PtrDerefIter<const_iterator>                     const_ref_iter;
        
        
-        iterator       begin ()           { return iterator (this, numberz_.begin()); }
+        iterator       begin ()           { return iterator       (this, numberz_.begin()); }
         const_iterator begin ()     const { return const_iterator (this, numberz_.begin()); }
-        ref_iterator   begin_ref ()       { return ref_iterator (begin()); }
+        ref_iterator   begin_ref ()       { return ref_iterator   (begin()); }
         const_ref_iter begin_ref () const { return const_ref_iter (begin()); }
        
-        iterator       end ()             { return iterator(); }
+        iterator       end ()             { return iterator();       }
         const_iterator end ()       const { return const_iterator(); }
-
-      protected:
+        
+        
+      protected: /* ==== API for the IterAdapter ==== */
         
         friend class IterAdapter<_Vec::iterator,      TestContainer>;
         friend class IterAdapter<_Vec::const_iterator,TestContainer>;
         
         
+        /** Implementation of Iteration-logic: pull next element.
+         *  Implicitly this includes a test for iteration end.  
+         */
         template<class ITER>
         static void
         iterNext (const TestContainer* src, ITER& pos)
           {
             if (iterValid(src,pos))
               ++pos;
+            iterValid(src,pos);
           }
         
+        /** Implementation of Iteration-logic: detect iteration end.
+         *  @note the problem here is that this implementation chooses
+         *        to use two representations of "bottom" (end, invalid).
+         *        The reason is, we want the default-constructed IterAdapter
+         *        also be the "bottom" value. Thus, when we detect the
+         *        iteration end by internal logic (\c numberz_.end() ), we
+         *        immediately transform this into the official "bottom"
+         */
         template<class ITER>
         static bool
         iterValid (const TestContainer* src, ITER& pos)
           {
             REQUIRE (src);
-            return pos != src->numberz_.end();
+            if ((pos != ITER(0)) && (pos != src->numberz_.end()))
+              return true;
+            else
+              {
+                pos = ITER(0);
+                return false;
+              }
           }
       };
   }
@@ -125,7 +143,7 @@ namespace test{
       virtual void
       run (Arg arg)
         {
-          if (0 < arg.size()) NUM_ELMS = lexical_cast<uint> (arg[0]);          
+          if (0 < arg.size()) NUM_ELMS = lexical_cast<uint> (arg[0]);
           
           TestContainer testElms (NUM_ELMS);
           simpleUsage (testElms);
@@ -167,13 +185,13 @@ namespace test{
               )
             {
               ASSERT (iter);
-//            ASSERT (iter != elms.end());                  ////////////////////////////TODO: implement comparison
+              ASSERT (iter != elms.end());
               ASSERT (**iter == i-1);
               
               // note: the previous run indeed modified
               // the element within the container.
               
-              // --(**iter);   // doesn't compile, because it's const
+              // --(**iter);   // doesn't compile, because it's const   ///////////////////////////////////TODO: duh! it *does* compile. why?
             }
           
           i = 0;
@@ -206,12 +224,12 @@ namespace test{
           ASSERT (TestContainer::iterator() == elms.end());
           ASSERT (!(TestContainer::iterator()));
           ASSERT (!(elms.end()));
-//        ASSERT (isnil (elms.end()));                  ////////////////////////////TODO: implement empty test
+          ASSERT (isnil (elms.end()));
           
           ASSERT (elms.begin());
-//        ASSERT (!isnil (elms.begin()));                  ////////////////////////////TODO: implement empty test
+          ASSERT (!isnil (elms.begin()));
         }
-
+      
       
     };
   

From a0187847dacd41b1e4c7bd90092b79ddf0bde2aa Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 15 Jul 2009 07:26:49 +0200
Subject: [PATCH 194/368] reworked IterAdapter, added RangeIter for STL ranges.
 Should do for now

---
 src/lib/iter-adapter.hpp        | 228 ++++++++++++++++++++++++++++----
 tests/lib/iter-adapter-test.cpp | 113 ++++++++++++----
 2 files changed, 295 insertions(+), 46 deletions(-)

diff --git a/src/lib/iter-adapter.hpp b/src/lib/iter-adapter.hpp
index 1a6880963..6744ed23c 100644
--- a/src/lib/iter-adapter.hpp
+++ b/src/lib/iter-adapter.hpp
@@ -22,14 +22,46 @@
 
 /** @file iter-adapter.hpp
  ** Helper template(s) for creating <b>lumiera forward iterators</b>.
- ** This denotes a concept similar to STL's  "forward iterator", with
- ** the addition of an bool check to detect iteration end. The latter
- ** is inspired by the \c hasNext() function found in many current
- ** languages supporting iterators. In a similar vein (inspired from
- ** functional programming), we deliberately don't support the various
- ** extended iterator concepts from STL and boost (random access iterators,
- ** output iterators and the like). According to this concept, <i>an iterator
- ** is a promise for pulling values</i> -- and nothing beyond that.
+ ** Usually, these templates will be created and provided by a custom
+ ** container type and accessed by the client through a typedef name
+ ** "iterator" (similar to the usage within the STL). For more advanced
+ ** usage, the providing container might want to subclass these iterators,
+ ** e.g. to provide an additional, specialised API.
+ ** 
+ ** Depending on the concrete situation, there are several flavours
+ ** - the IterAdapter retains an active callback connection to the
+ **   controlling container, thus allowing arbitrary complex behaviour.
+ ** - the RangeIter allows just to expose a range of elements defined
+ **   by a STL-like pair of "start" and "end" iterators
+ ** - often, objects are managed internally by pointers, while allowing
+ **   the clients to use direct references; to support this usage scenario,
+ **   PtrDerefIter wraps an existing iterator, while dereferencing any value
+ **   automatically on access.  
+ ** 
+ ** 
+ ** \par Lumiera forward iterator concept
+ ** 
+ ** Similar to the STL, instead of using a common "Iterator" base class,
+ ** instead we define a common set of functions and behaviour which can
+ ** be expected from any such iterator. These rules are similar to STL's
+ ** "forward iterator", with the addition of an bool check to detect
+ ** iteration end. The latter s inspired by the \c hasNext() function
+ ** found in many current languages supporting iterators. In a similar
+ ** vein (inspired from functional programming), we deliberately don't
+ ** support the various extended iterator concepts from STL and boost
+ ** (random access iterators, output iterators and the like). According
+ ** to this concept, <i>an iterator is a promise for pulling values,</i>
+ ** and nothing beyond that.
+ ** 
+ ** - Any Lumiera forward iterator can be in a "exhausted" (invalid) state,
+ **   which can be checked by the bool conversion. Especially, any instance
+ **   created by the default ctor is always fixed to that state. This
+ **   state is final and can't be reset, meaning that any iterator is
+ **   a disposable one-way-off object.
+ ** - iterators are copyable and comparable
+ ** - when an iterator is \em not in the exhausted state, it may be
+ **   \em dereferenced to yield the "current" value.
+ ** - moreover, iterators may be incremented until exhaustion.
  ** 
  ** @todo WIP WIP WIP
  ** @todo see Ticket #182
@@ -45,20 +77,17 @@
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
 
-#include <boost/type_traits/remove_pointer.hpp>
-
 
 
 namespace lib {
   
-  using boost::remove_pointer;
-  
   
   
   /**
    * Adapter for building an implementation of the lumiera forward iterator concept.
    * The "current position" is represented as an opaque element (usually an nested iterator),
-   * with callbacks to the controlling container instance for managing this position. 
+   * with callbacks to the controlling container instance for managing this position.
+   * This allows to influence and customise the iteration process to a large extent.
    * Basically such an IterAdapter behaves like the similar concept from STL, but
    * - it is not just a disguised pointer (meaning, it's more expensive)
    * - it checks validity on every operation and may throw
@@ -86,7 +115,7 @@ namespace lib {
         : source_(src)
         , pos_(startpos)
         { 
-          CON::iterValid(source_,pos_);
+          checkPos();
         }
       
       IterAdapter ()
@@ -115,7 +144,7 @@ namespace lib {
       operator++()
         {
           _maybe_throw();
-          CON::iterNext (source_,pos_);
+          iterate();
           return *this;
         }
       
@@ -124,14 +153,14 @@ namespace lib {
         {
           _maybe_throw();
           IterAdapter oldPos(*this);
-          CON::iterNext (source_,pos_);
+          iterate();
           return oldPos;
         }
       
       bool
       isValid ()  const
         {
-          return (source_ && CON::iterValid(source_,pos_));
+          return checkPos();
         }
       
       bool
@@ -141,6 +170,34 @@ namespace lib {
         }
       
       
+    protected: /* === iteration control interface === */
+      
+      /** ask the controlling container if this position is valid.
+       *  @note this function is called before any operation,
+       *        thus the container may adjust the position value,
+       *        for example setting it to a "stop iteration" mark.
+       */ 
+      bool
+      checkPos()  const
+      {
+        return source_ && CON::hasNext (source_,pos_);
+      }
+      
+      /** ask the controlling container to yield the next position.
+       *  The call is dispatched only if the current position is valid;
+       *  any new position returned is again validated, so to detect
+       *  the iteration end as soon as possible.
+       */
+      bool
+      iterate ()
+      {
+        if (!checkPos()) return false;
+        
+        CON::iterNext (source_,pos_);
+        return checkPos();
+      }
+      
+      
     private:
       
       void
@@ -169,11 +226,136 @@ namespace lib {
   
   
   
-  /** wrapper for an existing Iterator type,
-   *  automatically dereferencing the output of the former.
-   *  For this to work, the "source" iterator is expected
-   *  to be declared on \em pointers rather than on values.
-   *  @note bool checkable if and only if source is...
+  /** 
+   * Accessing a STL element range through a Lumiera forward iterator,
+   * An instance of this iterator adapter is completely self-contained
+   * and allows to iterate once over the range of elements, until 
+   * \c pos==end . Thus, a custom container may expose a range of
+   * elements of an embedded STL container, without controlling
+   * the details of the iteration (as is possible using the
+   * more generic IterAdapter).
+   */
+  template<class IT>
+  class RangeIter
+    : public lib::BoolCheckable<RangeIter<IT> >
+    {
+      IT p_;
+      IT e_;
+      
+    public:
+      typedef typename IT::pointer pointer;
+      typedef typename IT::reference reference;
+      typedef typename IT::value_type value_type;
+      
+      RangeIter (IT const& start, IT const& end)
+        : p_(start)
+        , e_(end)
+        { }
+      
+      RangeIter ()
+        : p_(0)
+        , e_(0)
+        { }
+      
+      
+      /* === lumiera forward iterator concept === */
+      
+      reference
+      operator*() const
+        {
+          _maybe_throw();
+          return *p_;
+        }
+      
+      pointer
+      operator->() const
+        {
+          _maybe_throw();
+          return &(*p_);
+        }
+      
+      RangeIter&
+      operator++()
+        {
+          ++p_;
+          return *this;
+        }
+      
+      RangeIter
+      operator++(int)
+        {
+          return RangeIter (p_++,e_);
+        }
+      
+      bool
+      isValid ()  const
+        {
+          return (p_!= IT(0)) && (p_ != e_);
+        }
+      
+      bool
+      empty ()    const
+        {
+          return !isValid();
+        }
+      
+    private:
+      
+      void
+      _maybe_throw()  const
+        {
+          if (!isValid())
+            throw lumiera::error::Invalid ("Can't iterate further",
+                  lumiera::error::LUMIERA_ERROR_ITER_EXHAUST);
+        }
+      
+      
+      /// comparison operator is allowed to access the underlying impl iterator
+      template<class I1, class I2>
+      friend bool operator== (RangeIter<I1> const&, RangeIter<I2> const&);
+    };
+  
+  
+  
+  /// Supporting equality comparisons...
+  template<class I1, class I2>
+  bool operator== (RangeIter<I1> const& il, RangeIter<I2> const& ir)  { return (!il && !ir) || (il.p_ == ir.p_); }
+    
+  template<class I1, class I2>
+  bool operator!= (RangeIter<I1> const& il, RangeIter<I2> const& ir)  { return !(il == ir); }
+  
+  
+  
+  
+  
+  namespace {
+    
+    /** helper to remove pointer,
+     *  while retaining const */
+    template<typename T>
+    struct RemovePtr  { typedef T Type; };
+    
+    template<typename T>
+    struct RemovePtr<T*> { typedef T Type; };
+    
+    template<typename T>
+    struct RemovePtr<const T*> { typedef const T Type; };
+    
+    template<typename T>
+    struct RemovePtr<T* const> { typedef const T Type; };
+    
+    template<typename T>
+    struct RemovePtr<const T* const> { typedef const T Type; };
+    
+  }
+  
+  
+  /** 
+   * wrapper for an existing Iterator type,
+   * automatically dereferencing the output of the former.
+   * For this to work, the "source" iterator is expected
+   * to be declared on \em pointers rather than on values.
+   * @note bool checkable if and only if source is...
    */
   template<class IT>
   class PtrDerefIter
@@ -183,7 +365,7 @@ namespace lib {
       
     public:
       typedef typename IT::value_type pointer;
-      typedef typename remove_pointer<pointer>::type value_type;
+      typedef typename RemovePtr<pointer>::Type value_type;
       typedef value_type& reference; 
       
       
diff --git a/tests/lib/iter-adapter-test.cpp b/tests/lib/iter-adapter-test.cpp
index d7935dd33..d49878f62 100644
--- a/tests/lib/iter-adapter-test.cpp
+++ b/tests/lib/iter-adapter-test.cpp
@@ -49,7 +49,14 @@ namespace test{
   
     uint NUM_ELMS = 10;
   
-  
+    /** 
+     * Example of a more elaborate custom container exposing an iteration API.
+     * While the demo implementation here is based on pointers within a vector,
+     * we hand out a IterAdapter, which will call back when used by the client,
+     * thus allowing us to control the iteration process. Moreover, we provide
+     * a variant of this iterator, which automatically dereferences the pointers,
+     * thus yielding direct references for the client code to use.
+     */
     class TestContainer
       {
         typedef vector<int *> _Vec;
@@ -58,6 +65,7 @@ namespace test{
         
         static void killIt (int *it) { delete it; }
         
+        
       public:
         TestContainer (uint count)
           : numberz_(count)
@@ -70,19 +78,21 @@ namespace test{
           {
             for_each (numberz_, killIt);
           }
-       
+        
+        
+        /* ==== Exposing Iterator interface(s) for the clients ====== */
         
         typedef IterAdapter<_Vec::iterator,       TestContainer> iterator;
         typedef IterAdapter<_Vec::const_iterator, TestContainer> const_iterator;
         typedef PtrDerefIter<iterator      >                     ref_iterator;
         typedef PtrDerefIter<const_iterator>                     const_ref_iter;
-       
-       
+        
+        
         iterator       begin ()           { return iterator       (this, numberz_.begin()); }
         const_iterator begin ()     const { return const_iterator (this, numberz_.begin()); }
         ref_iterator   begin_ref ()       { return ref_iterator   (begin()); }
         const_ref_iter begin_ref () const { return const_ref_iter (begin()); }
-       
+        
         iterator       end ()             { return iterator();       }
         const_iterator end ()       const { return const_iterator(); }
         
@@ -93,16 +103,12 @@ namespace test{
         friend class IterAdapter<_Vec::const_iterator,TestContainer>;
         
         
-        /** Implementation of Iteration-logic: pull next element.
-         *  Implicitly this includes a test for iteration end.  
-         */
+        /** Implementation of Iteration-logic: pull next element. */
         template<class ITER>
         static void
-        iterNext (const TestContainer* src, ITER& pos)
+        iterNext (const TestContainer*, ITER& pos)
           {
-            if (iterValid(src,pos))
-              ++pos;
-            iterValid(src,pos);
+            ++pos;
           }
         
         /** Implementation of Iteration-logic: detect iteration end.
@@ -115,7 +121,7 @@ namespace test{
          */
         template<class ITER>
         static bool
-        iterValid (const TestContainer* src, ITER& pos)
+        hasNext (const TestContainer* src, ITER& pos)
           {
             REQUIRE (src);
             if ((pos != ITER(0)) && (pos != src->numberz_.end()))
@@ -124,17 +130,22 @@ namespace test{
               {
                 pos = ITER(0);
                 return false;
-              }
-          }
+          }   }
       };
-  }
+    
+  } // (END) impl test dummy container
   
   
   
-  /********************************************************************
-   *  @test create an iterator element for a given container and
-   *        verify its behaviour in accordance to the concept
-   *        "lumiera forward iterator"
+  
+  
+  
+  
+  /*********************************************************************
+   *  @test set up example implementations based on the iterator-adapter
+   *        templates and verify the behaviour in accordance to the
+   *        concept "lumiera forward iterator"
+   *        
    * @todo see Ticket #182
    */
   class IterAdapter_test : public Test
@@ -145,15 +156,44 @@ namespace test{
         {
           if (0 < arg.size()) NUM_ELMS = lexical_cast<uint> (arg[0]);
           
+          wrapIterRange ();
+          
           TestContainer testElms (NUM_ELMS);
           simpleUsage (testElms);
           iterTypeVariations (testElms);
+          verifyComparisons (testElms);
         }
       
       
-      static void showIt (int* elm) { cout << "::" << *elm; }
+      /** @test usage scenario, where we allow the client to
+       *        access a range of elements given by STL iterators,
+       *        without any specific iteration behaviour.
+       */
+      void
+      wrapIterRange ()
+        {
+          vector<int> iVec (NUM_ELMS);
+          for (uint i=0; i < NUM_ELMS; ++i)
+            iVec[i] = i;
+          
+          typedef vector<int>::iterator I;
+          typedef RangeIter<I> Range;
+          
+          Range range (iVec.begin(), iVec.end());
+          ASSERT (!isnil (range) || !NUM_ELMS);
+          
+          // now for example the client could....
+          while ( range )
+            cout << "::" << *range++;
+          
+          cout << endl;
+          ASSERT (isnil (range));
+          ASSERT (range == Range());
+        }
       
       
+      
+      /** @test use the IterAdapter as if it was a STL iterator */
       void
       simpleUsage (TestContainer& elms)
         {
@@ -161,7 +201,12 @@ namespace test{
           cout << endl;
         }
       
+      static void showIt (int* elm) { cout << "::" << *elm; }
       
+      
+      
+      /** @test verify the const and dereferencing variants,
+       *        which can be created based on IterAdapter */
       void
       iterTypeVariations (TestContainer& elms)
         {
@@ -191,7 +236,7 @@ namespace test{
               // note: the previous run indeed modified
               // the element within the container.
               
-              // --(**iter);   // doesn't compile, because it's const   ///////////////////////////////////TODO: duh! it *does* compile. why?
+            // ++(*iter);   // doesn't compile, because it yields a "* const"
             }
           
           i = 0;
@@ -212,8 +257,17 @@ namespace test{
             {
               ASSERT (iter);
               ASSERT ((*iter) == i);
+              
+             // *iter = i+1;   ///////////TODO this should be const, but it isn't
             }
-          
+        }
+      
+      
+      
+      /** @test iterator comparison, predicates and operators */
+      void
+      verifyComparisons (TestContainer& elms)
+        {
           TestContainer::ref_iterator rI (elms.begin_ref());
           
           ASSERT (0 == *rI );
@@ -221,6 +275,19 @@ namespace test{
           ASSERT (1 == *rI  );
           ASSERT (2 == *++rI);
           
+          TestContainer const& const_elms (elms);
+          TestContainer::const_ref_iter rI2 (const_elms.begin_ref());
+          
+          ASSERT (rI2 != rI);
+          ASSERT (rI2 == elms.begin_ref());
+          ASSERT (rI2 == const_elms.begin_ref());
+          
+          ++++rI2;
+          
+          ASSERT (rI2 == rI);
+          ASSERT (rI2 != ++rI);
+          ASSERT (!isnil (rI2));
+          
           ASSERT (TestContainer::iterator() == elms.end());
           ASSERT (!(TestContainer::iterator()));
           ASSERT (!(elms.end()));

From 4f5fca6858a9b92bb41fe77c983c215bf993f16a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 16 Jul 2009 19:36:01 +0200
Subject: [PATCH 195/368] now able to implement ScopedPtrVect iteration
 properly

---
 src/lib/scoped-ptrvect.hpp        | 32 ++++++++++++++++++++++---------
 tests/lib/scoped-ptrvect-test.cpp | 25 +++++++++++++++++++++++-
 tests/lib/testdummy.hpp           | 23 +++++++++++++++-------
 3 files changed, 63 insertions(+), 17 deletions(-)

diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index 932bcffb6..d01992edc 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -25,13 +25,14 @@
  ** build and own a number of objects, including lifecycle management. 
  ** For example, a service provider may need to maintain a number of individual
  ** process handles. The solution here is deliberately kept simple, it is
- ** similar to using a stl container with shared_ptr(s), but behaves rather
+ ** similar to using a STL container with shared_ptr(s), but behaves rather
  ** like boost::scoped_ptr. It provides the same basic functionality as
  ** boost::ptr_vector, but doesn't require us to depend on boost-serialisation.
  ** 
  ** Some details to note:
  ** - contained objects accessed by reference, never NULL.
- ** - TODO: iterators, detaching of objects...
+ ** - the exposed iterator automatically dereferences
+ ** - TODO: detaching of objects...
  ** - TODO: retro-fit with refarray interface (--> builder branch)
  ** 
  ** @see scoped-ptrvect-test.cpp
@@ -70,6 +71,12 @@ namespace lib {
       boost::noncopyable
     {
       typedef std::vector<T*> _Vec;
+      typedef typename _Vec::iterator VIter;
+      typedef typename _Vec::const_iterator VcIter;
+      
+      typedef RangeIter<VIter> RIter;
+      typedef RangeIter<VcIter> RcIter;
+      
       
     public:
       typedef size_t   size_type;
@@ -118,7 +125,6 @@ namespace lib {
       void
       clear()
         { 
-          typedef typename _Vec::iterator VIter;
           VIter e = _Vec::end();
           for (VIter i = _Vec::begin(); i!=e; ++i)
             {
@@ -144,11 +150,11 @@ namespace lib {
           return *get(i);
         }
       
-      typedef PtrDerefIter<typename _Vec::iterator> iterator;
-      typedef PtrDerefIter<typename _Vec::const_iterator> const_iterator;
+      typedef PtrDerefIter<RIter> iterator;
+      typedef PtrDerefIter<RcIter> const_iterator;
       
-      iterator       begin()        { return       iterator (_Vec::begin()); }
-      const_iterator begin()  const { return const_iterator (_Vec::begin()); }
+      iterator       begin()        { return       iterator (allPtrs()); }
+      const_iterator begin()  const { return const_iterator (allPtrs()); }
       iterator       end()          { return       iterator (); }
       const_iterator end()    const { return const_iterator (); }
       
@@ -164,8 +170,9 @@ namespace lib {
       
       
     private:
-      /** internal element access, including null check */
-      T* get(size_type i)
+      /** @internal element access, including null check */
+      T*
+      get (size_type i)
         {
           T* p (_Vec::at (i));
           if (!p)
@@ -173,6 +180,13 @@ namespace lib {
           else
             return p;
         }
+      
+      /** @internal access sequence of all managed pointers */
+      RIter
+      allPtrs ()
+        {
+          return RIter (_Vec::begin(), _Vec::end());
+        }
     };
   
   
diff --git a/tests/lib/scoped-ptrvect-test.cpp b/tests/lib/scoped-ptrvect-test.cpp
index 3bf539342..d718ddc31 100644
--- a/tests/lib/scoped-ptrvect-test.cpp
+++ b/tests/lib/scoped-ptrvect-test.cpp
@@ -40,6 +40,7 @@ namespace test{
   
   /********************************************************************
    *  @test ScopedPtrVect manages the lifecycle of a number of objects.
+   *  @todo cover the const iterator and implement detaching of objects
    */
   class ScopedPtrVect_test : public Test
     {
@@ -48,7 +49,7 @@ namespace test{
       run (Arg)
         {
           simpleUsage();
-//        iterating();
+          iterating();
 //        detaching();
         }
       
@@ -92,6 +93,28 @@ namespace test{
           ASSERT (0==checksum);
         }
       
+      
+      void
+      iterating()
+        {
+          ASSERT (0==checksum);
+          {
+            VectD holder;
+            for (int i=0; i<16; ++i)
+              holder.manage(new Dummy(i));
+            
+            int check=0;
+            VectD::iterator ii = holder.begin();
+            while (ii)
+              {
+                ASSERT (check == ii->getVal());
+                ++check;
+                ++ii;
+              }
+          }
+          ASSERT (0==checksum);
+        }
+      
     };
   
   LAUNCHER (ScopedPtrVect_test, "unit common");
diff --git a/tests/lib/testdummy.hpp b/tests/lib/testdummy.hpp
index 99a5ee3c1..afa810f79 100644
--- a/tests/lib/testdummy.hpp
+++ b/tests/lib/testdummy.hpp
@@ -41,20 +41,19 @@ namespace test{
       public:
         Dummy ()
           : val_(1 + (rand() % 100000000))
-          {
-            checksum += val_;
-            if (throw_in_ctor)
-              throw val_;
-          }
+          { init(); }
+        
+        Dummy (int v)
+          : val_(v)
+          { init(); }
         
         ~Dummy()
           {
             checksum -= val_;
           }
         
-        long add (int i)  { return val_+i; }
+        long add (int i)    { return val_+i; }
         
-      protected:
         int getVal()  const { return val_; }
         
         void
@@ -63,6 +62,16 @@ namespace test{
             checksum += newVal - val_;
             val_ = newVal;
           }
+        
+      private:
+        void
+        init()
+          {
+            checksum += val_;
+            if (throw_in_ctor)
+              throw val_;
+          }
+
       };
       
   }  // anonymous test dummy

From 165cfc7fcdcf8a818160dc47e5317368b04a8daa Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 17 Jul 2009 04:13:14 +0200
Subject: [PATCH 196/368] WIP allow some conversions, attempt to define the
 const_iterator properly

---
 src/lib/iter-adapter.hpp          | 65 ++++++++++++++++++++++++++-----
 src/lib/scoped-ptrvect.hpp        | 10 +++--
 tests/lib/scoped-ptrvect-test.cpp | 20 ++++++++++
 3 files changed, 82 insertions(+), 13 deletions(-)

diff --git a/src/lib/iter-adapter.hpp b/src/lib/iter-adapter.hpp
index 6744ed23c..4de2c994a 100644
--- a/src/lib/iter-adapter.hpp
+++ b/src/lib/iter-adapter.hpp
@@ -258,6 +258,16 @@ namespace lib {
         { }
       
       
+      /** allow copy,
+       *  when the underlying iterators
+       *  are compatible or convertible */
+      template<class I2>
+      RangeIter (I2 const& oIter)
+        : p_(oIter.getPos())
+        , e_(oIter.getEnd())
+        { }
+      
+      
       /* === lumiera forward iterator concept === */
       
       reference
@@ -299,6 +309,12 @@ namespace lib {
           return !isValid();
         }
       
+      
+      /** access wrapped STL iterator */
+      const IT&  getPos()  const { return p_; }
+      const IT&  getEnd()  const { return e_; }
+      
+      
     private:
       
       void
@@ -308,18 +324,13 @@ namespace lib {
             throw lumiera::error::Invalid ("Can't iterate further",
                   lumiera::error::LUMIERA_ERROR_ITER_EXHAUST);
         }
-      
-      
-      /// comparison operator is allowed to access the underlying impl iterator
-      template<class I1, class I2>
-      friend bool operator== (RangeIter<I1> const&, RangeIter<I2> const&);
     };
   
   
   
   /// Supporting equality comparisons...
   template<class I1, class I2>
-  bool operator== (RangeIter<I1> const& il, RangeIter<I2> const& ir)  { return (!il && !ir) || (il.p_ == ir.p_); }
+  bool operator== (RangeIter<I1> const& il, RangeIter<I2> const& ir)  { return (!il && !ir) || (il.getPos() == ir.getPos()); }
     
   template<class I1, class I2>
   bool operator!= (RangeIter<I1> const& il, RangeIter<I2> const& ir)  { return !(il == ir); }
@@ -374,6 +385,14 @@ namespace lib {
         { }
       
       
+      /** allow copy initialisation also
+       *  when the base iter types are convertible */
+      template<class I2>
+      PtrDerefIter (I2 const& oIter)
+        : i_(reinterpret_cast<IT const&> (oIter.getBase()))  /////////////////////////////TODO: properly guard this dangerous conversion by a traits template; the idea is to allow this conversion only for the initialisation of a "const iterator" from its sister type
+        { }
+      
+      
       /* === lumiera forward iterator concept === */
       
       reference
@@ -414,19 +433,45 @@ namespace lib {
         }
       
       
-      /// comparison operator is allowed to access the underlying impl iterator
-      template<class I1, class I2>
-      friend bool operator== (PtrDerefIter<I1> const&, PtrDerefIter<I2> const&);
+      /** access the wrapped implementation iterator */
+      IT const&
+      getBase()  const
+        {
+          return i_;
+        }
     };
   
   
   /// Supporting equality comparisons...
   template<class I1, class I2>
-  bool operator== (PtrDerefIter<I1> const& il, PtrDerefIter<I2> const& ir)  { return il.i_ == ir.i_; }
+  bool operator== (PtrDerefIter<I1> const& il, PtrDerefIter<I2> const& ir)  { return il.getBase() == ir.getBase(); }
     
   template<class I1, class I2>
   bool operator!= (PtrDerefIter<I1> const& il, PtrDerefIter<I2> const& ir)  { return !(il == ir); }
   
   
+  
+  /** 
+   * Helper for type rewritings:
+   * get the element type for an iterator like entity
+   */
+  template<class TY>
+  struct IterType;
+  
+  template<template<class,class> class Iter, class TY, class CON>
+  struct IterType<Iter<TY,CON> >
+    {
+      typedef CON Container;
+      typedef TY  ElemType;
+      
+      typedef typename RemovePtr<TY>::Type Type;
+      
+      template<class T2>
+      struct SimilarIter
+        {
+          typedef Iter<T2,CON> Type;
+        };
+    };
+  
 } // namespace lib
 #endif
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index d01992edc..e10704679 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -72,7 +72,8 @@ namespace lib {
     {
       typedef std::vector<T*> _Vec;
       typedef typename _Vec::iterator VIter;
-      typedef typename _Vec::const_iterator VcIter;
+//      typedef typename _Vec::const_iterator VcIter;
+      typedef typename IterType<VIter>::template SimilarIter<const T**>::Type VcIter;
       
       typedef RangeIter<VIter> RIter;
       typedef RangeIter<VcIter> RcIter;
@@ -83,6 +84,9 @@ namespace lib {
       typedef T &      reference;
       typedef T const& const_reference;
       
+      typedef typename IterType<VIter>::Type Tupe;
+            
+      
       
       ScopedPtrVect ()
         : _Vec()
@@ -155,8 +159,8 @@ namespace lib {
       
       iterator       begin()        { return       iterator (allPtrs()); }
       const_iterator begin()  const { return const_iterator (allPtrs()); }
-      iterator       end()          { return       iterator (); }
-      const_iterator end()    const { return const_iterator (); }
+      iterator       end()          { return       iterator ( RIter() ); }
+      const_iterator end()    const { return const_iterator (RcIter() ); }
       
       
       
diff --git a/tests/lib/scoped-ptrvect-test.cpp b/tests/lib/scoped-ptrvect-test.cpp
index d718ddc31..d8d051727 100644
--- a/tests/lib/scoped-ptrvect-test.cpp
+++ b/tests/lib/scoped-ptrvect-test.cpp
@@ -28,6 +28,13 @@
 #include "lib/scoped-ptrvect.hpp"
 #include "testdummy.hpp"
 
+//////////////////////////////////////////////TODO test code
+#include "lib/test/test-helper.hpp"
+using lib::test::showSizeof;
+#include <iostream>
+using std::cout;
+using std::endl;
+//////////////////////////////////////////////TODO test code
 
 namespace lib {
 namespace test{
@@ -111,6 +118,19 @@ namespace test{
                 ++check;
                 ++ii;
               }
+            check = 0;
+            
+///////////////////////////////////////////////////////////////////TODO test code
+            cout << showSizeof<VectD::Tupe> () << endl;
+///////////////////////////////////////////////////////////////////TODO test code
+            
+            VectD::const_iterator cii = holder.begin();
+            while (cii)
+              {
+                ASSERT (check == cii->getVal());
+                ++check;
+                ++cii;
+              }
           }
           ASSERT (0==checksum);
         }

From 3f8d82a13f34a168993ef9dce8fa94474b3952f1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 17 Jul 2009 20:22:48 +0200
Subject: [PATCH 197/368] Victory! bashed the iter-adapters and the
 ScopedPtrVect into submission, finally.

---
 src/lib/iter-adapter.hpp          | 152 ++++++++++++++++++++++--------
 src/lib/scoped-ptrvect.hpp        |  23 ++---
 tests/lib/scoped-ptrvect-test.cpp |  34 ++++---
 3 files changed, 146 insertions(+), 63 deletions(-)

diff --git a/src/lib/iter-adapter.hpp b/src/lib/iter-adapter.hpp
index 4de2c994a..6280e60f8 100644
--- a/src/lib/iter-adapter.hpp
+++ b/src/lib/iter-adapter.hpp
@@ -77,11 +77,44 @@
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
 
+#include <boost/type_traits/remove_const.hpp>
+
 
 
 namespace lib {
   
   
+  namespace {
+    /** 
+     * Helper for creating nested typedefs
+     * within the iterator adaptor, similar to what the STL does.
+     */
+    template<typename TY>
+    struct IterTraits
+      {
+        typedef typename TY::pointer pointer;
+        typedef typename TY::reference reference;
+        typedef typename TY::value_type value_type;
+      };
+    
+    template<typename TY>
+    struct IterTraits<TY *>
+      {
+        typedef TY value_type;
+        typedef TY& reference;
+        typedef TY* pointer;
+      };
+    
+    template<typename TY>
+    struct IterTraits<const TY *>
+      {
+        typedef TY value_type;
+        typedef const TY& reference;
+        typedef const TY* pointer;
+      };
+    
+  }
+  
   
   /**
    * Adapter for building an implementation of the lumiera forward iterator concept.
@@ -107,9 +140,9 @@ namespace lib {
       mutable POS pos_;
       
     public:
-      typedef typename POS::pointer pointer;
-      typedef typename POS::reference reference;
-      typedef typename POS::value_type value_type;
+      typedef typename IterTraits<POS>::pointer pointer;
+      typedef typename IterTraits<POS>::reference reference;
+      typedef typename IterTraits<POS>::value_type value_type;
       
       IterAdapter (const CON* src, const POS& startpos)
         : source_(src)
@@ -243,9 +276,9 @@ namespace lib {
       IT e_;
       
     public:
-      typedef typename IT::pointer pointer;
-      typedef typename IT::reference reference;
-      typedef typename IT::value_type value_type;
+      typedef typename IterTraits<IT>::pointer pointer;
+      typedef typename IterTraits<IT>::reference reference;
+      typedef typename IterTraits<IT>::value_type value_type;
       
       RangeIter (IT const& start, IT const& end)
         : p_(start)
@@ -287,6 +320,7 @@ namespace lib {
       RangeIter&
       operator++()
         {
+          _maybe_throw();
           ++p_;
           return *this;
         }
@@ -294,6 +328,7 @@ namespace lib {
       RangeIter
       operator++(int)
         {
+          _maybe_throw();
           return RangeIter (p_++,e_);
         }
       
@@ -361,6 +396,42 @@ namespace lib {
   }
   
   
+  /** 
+   * Helper for type rewritings:
+   * get the element type for an iterator like entity
+   */
+  template<class TY>
+  struct IterType;
+  
+  template<template<class,class> class Iter, class TY, class CON>
+  struct IterType<Iter<TY,CON> >
+    {
+      typedef CON Container;
+      typedef TY  ElemType;
+      
+      typedef typename RemovePtr<TY>::Type ValueType;
+      
+      template<class T2>
+      struct SimilarIter
+        {
+          typedef Iter<T2,CON> Type;
+        };
+    };
+  
+  template<class IT>
+  struct IterType<RangeIter<IT> >
+    : IterType<IT>
+    {
+      template<class T2>
+      struct SimilarIter  ///< rebind to rewritten Iterator wrapped into RangeIter
+        {
+          typedef typename IterType<IT>::template SimilarIter<T2>::Type WrappedIter;
+          typedef RangeIter<WrappedIter> Type;
+        };
+    };
+  
+  
+  
   /** 
    * wrapper for an existing Iterator type,
    * automatically dereferencing the output of the former.
@@ -372,26 +443,56 @@ namespace lib {
   class PtrDerefIter
     : public lib::BoolCheckable<PtrDerefIter<IT> >
     {
-      IT i_;
+      IT i_;  ///< nested source iterator
+      
       
     public:
-      typedef typename IT::value_type pointer;
+      typedef typename IT::value_type           pointer;
       typedef typename RemovePtr<pointer>::Type value_type;
-      typedef value_type& reference; 
+      typedef value_type&                       reference; 
+      
+      // the purpose of the following typedefs is to ease building a correct "const iterator"
+      
+      typedef typename boost::remove_const<value_type>::type ValueTypeBase; // value_type without const
+      
+      typedef typename IterType<IT>::template SimilarIter<      ValueTypeBase* * >::Type WrappedIterType;
+      typedef typename IterType<IT>::template SimilarIter<const ValueTypeBase* * >::Type WrappedConstIterType;
+      
+      typedef PtrDerefIter<WrappedIterType>      IterType;
+      typedef PtrDerefIter<WrappedConstIterType> ConstIterType;
       
       
+      
+      /** PtrDerefIter is always created 
+       *  by wrapping an existing iterator.
+       */
       PtrDerefIter (IT srcIter)
         : i_(srcIter)
         { }
       
       
-      /** allow copy initialisation also
-       *  when the base iter types are convertible */
-      template<class I2>
-      PtrDerefIter (I2 const& oIter)
-        : i_(reinterpret_cast<IT const&> (oIter.getBase()))  /////////////////////////////TODO: properly guard this dangerous conversion by a traits template; the idea is to allow this conversion only for the initialisation of a "const iterator" from its sister type
+      /** allow copy initialisation also when
+       *  the wrapped iterator is based on some variation of a pointer.
+       *  Especially, this includes initialisation of the "const variant"
+       *  from the "normal variant" of PtrDerefIter. Actually, we need to convert
+       *  in this case by brute force, because indeed (const TY *)* is not assignable
+       *  from (TY *)* -- just we know that our intention is to dereference both levels
+       *  of pointers, and then the resulting conversion is correct.
+       *  @note in case IT == WrappedIterType, this is just a redefinition of the
+       *        default copy ctor. In all other cases, this is an <i>additional
+       *        ctor besides the default copy ctor</i> */
+      PtrDerefIter (PtrDerefIter<WrappedIterType> const& oIter)
+        : i_(reinterpret_cast<IT const&> (oIter.getBase()))
         { }
       
+      PtrDerefIter&
+      operator= (PtrDerefIter<WrappedIterType> const& ref)
+        {
+          i_ = reinterpret_cast<IT const&> (ref.getBase());
+        }
+      
+      
+      
       
       /* === lumiera forward iterator concept === */
       
@@ -450,28 +551,5 @@ namespace lib {
   bool operator!= (PtrDerefIter<I1> const& il, PtrDerefIter<I2> const& ir)  { return !(il == ir); }
   
   
-  
-  /** 
-   * Helper for type rewritings:
-   * get the element type for an iterator like entity
-   */
-  template<class TY>
-  struct IterType;
-  
-  template<template<class,class> class Iter, class TY, class CON>
-  struct IterType<Iter<TY,CON> >
-    {
-      typedef CON Container;
-      typedef TY  ElemType;
-      
-      typedef typename RemovePtr<TY>::Type Type;
-      
-      template<class T2>
-      struct SimilarIter
-        {
-          typedef Iter<T2,CON> Type;
-        };
-    };
-  
 } // namespace lib
 #endif
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index e10704679..eff0a2b0d 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -48,7 +48,6 @@
 #include "include/logging.h"
 #include "lib/iter-adapter.hpp"
 #include "lib/error.hpp"
-#include "lib/util.hpp"
 
 #include <vector>
 #include <boost/noncopyable.hpp>
@@ -56,14 +55,13 @@
 
 namespace lib {
   
-  using util::for_each;
-  
   
   
   /**
-   * Simple vector based collection of pointers, noncopyable and managing
-   * lifecycle of the pointed-to objects. Implemented by a vector of
-   * bare pointers (private inheritance)
+   * Simple vector based collection of pointers,
+   * managing lifecycle of the pointed-to objects.
+   * Implemented as a non-copyable object, based on a
+   * vector of bare pointers (private inheritance)
    */
   template<class T>
   class ScopedPtrVect
@@ -72,11 +70,12 @@ namespace lib {
     {
       typedef std::vector<T*> _Vec;
       typedef typename _Vec::iterator VIter;
-//      typedef typename _Vec::const_iterator VcIter;
-      typedef typename IterType<VIter>::template SimilarIter<const T**>::Type VcIter;
       
       typedef RangeIter<VIter> RIter;
-      typedef RangeIter<VcIter> RcIter;
+      typedef PtrDerefIter<RIter> IterType;
+      
+      typedef typename IterType::ConstIterType ConstIterType;
+      typedef typename IterType::WrappedConstIterType RcIter;
       
       
     public:
@@ -84,8 +83,6 @@ namespace lib {
       typedef T &      reference;
       typedef T const& const_reference;
       
-      typedef typename IterType<VIter>::Type Tupe;
-            
       
       
       ScopedPtrVect ()
@@ -154,8 +151,8 @@ namespace lib {
           return *get(i);
         }
       
-      typedef PtrDerefIter<RIter> iterator;
-      typedef PtrDerefIter<RcIter> const_iterator;
+      typedef IterType      iterator;
+      typedef ConstIterType const_iterator;
       
       iterator       begin()        { return       iterator (allPtrs()); }
       const_iterator begin()  const { return const_iterator (allPtrs()); }
diff --git a/tests/lib/scoped-ptrvect-test.cpp b/tests/lib/scoped-ptrvect-test.cpp
index d8d051727..ed414aee2 100644
--- a/tests/lib/scoped-ptrvect-test.cpp
+++ b/tests/lib/scoped-ptrvect-test.cpp
@@ -23,31 +23,27 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 #include "lib/util.hpp"
 
 #include "lib/scoped-ptrvect.hpp"
 #include "testdummy.hpp"
 
-//////////////////////////////////////////////TODO test code
-#include "lib/test/test-helper.hpp"
-using lib::test::showSizeof;
-#include <iostream>
-using std::cout;
-using std::endl;
-//////////////////////////////////////////////TODO test code
 
 namespace lib {
 namespace test{
   
   using ::Test;
   using util::isnil;
+  using lumiera::error::LUMIERA_ERROR_ITER_EXHAUST;
+  
   
   typedef ScopedPtrVect<Dummy> VectD;
   
   
   /********************************************************************
    *  @test ScopedPtrVect manages the lifecycle of a number of objects.
-   *  @todo cover the const iterator and implement detaching of objects
+   *  @todo implement detaching of objects
    */
   class ScopedPtrVect_test : public Test
     {
@@ -118,12 +114,10 @@ namespace test{
                 ++check;
                 ++ii;
               }
+            
+            
+            // Test the const iterator
             check = 0;
-            
-///////////////////////////////////////////////////////////////////TODO test code
-            cout << showSizeof<VectD::Tupe> () << endl;
-///////////////////////////////////////////////////////////////////TODO test code
-            
             VectD::const_iterator cii = holder.begin();
             while (cii)
               {
@@ -131,6 +125,20 @@ namespace test{
                 ++check;
                 ++cii;
               }
+            
+            
+            // Verify correct behaviour of iteration end
+            ASSERT (! (holder.end()));
+            ASSERT (isnil (holder.end()));
+            
+            VERIFY_ERROR (ITER_EXHAUST, *holder.end() );
+            VERIFY_ERROR (ITER_EXHAUST, ++holder.end() );
+            
+            ASSERT (ii == holder.end());
+            ASSERT (cii == holder.end());
+            VERIFY_ERROR (ITER_EXHAUST, ++ii );
+            VERIFY_ERROR (ITER_EXHAUST, ++cii );
+            
           }
           ASSERT (0==checksum);
         }

From 6510155e7669f9d3e20171b873867425f0efd1de Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 18 Jul 2009 19:36:32 +0200
Subject: [PATCH 198/368] back on route: trying to get the ArgumentHolder to
 fly...

---
 src/proc/control/command-argument-holder.hpp  |  27 +-
 src/proc/control/command-closure.hpp          |   5 +-
 .../proc/control/command-argument-test.cpp    |  53 +--
 tests/lib/opaque-unchecked-buffer-test.cpp    | 302 ++++++++++++++++++
 4 files changed, 360 insertions(+), 27 deletions(-)
 create mode 100644 tests/lib/opaque-unchecked-buffer-test.cpp

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index e196e4698..11480695c 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -45,6 +45,7 @@
 
 //#include "pre.hpp"
 //#include "lib/error.hpp"
+#include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 
@@ -104,14 +105,17 @@ namespace control {
    * actually allocating storage to hold the command arguments
    * and the undo state (memento) for Proc-Layer commands.
    * Both the contained components within ArgumentHolder 
-   * can be in \em empty state; there is no distinct
+   * can be in \em empty state; there are no distinct
    * lifecycle limitations. ArgumentHolder is part
    * of Proc-Layer command's implementation
    * and should not be used standalone. 
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
-    : public CmdClosure
+    : public ArgumentTupleAccept< SIG                      // to derive the desired bind(..) signature
+                                , ArgumentHolder<SIG,MEM>  // target class providing the implementation
+                                , CmdClosure               // base class to inherit from
+                                >    
     {
       Closure<SIG> arguments_;
       MementoTie<SIG,MEM> memento_;
@@ -141,8 +145,8 @@ namespace control {
       virtual operator string()  const
         {
           return "Command-State{ arguments="
-               + arguments_? arguments_ : "unbound"
-               + memento_  ? ", <memento> }" : "<no undo> }"
+               + (arguments_? string(arguments_) : "unbound")
+               + (memento_  ?    ", <memento> }" : "<no undo> }")
                ;
         }
       
@@ -159,14 +163,14 @@ namespace control {
         { }
       
       /** has undo state capturing been invoked? */
-      bool canUndo () { return bool(memento_); }
-      bool empty ()   { return !arguments_; }
+      bool canUndo () const { return bool(memento_); }
+      bool empty ()   const { return !arguments_; }
       
       
       /** store a new argument tuple within this ArgumentHolder,
        *  discarding and previously stored arguments */
       void
-      bind (ArgTuple argTup)
+      bindArg (ArgTuple argTup)
         {
           this->arguments_ = Closure<SIG> (argTup);
         }
@@ -185,6 +189,15 @@ namespace control {
           return this->memento_ = MementoTie<SIG,MEM> (undoFunc,captureFunc);
         }
       
+      
+      /** direct "backdoor" access to stored memento value.
+       *  @note you might access a placeholder when called prior to \c tie(..) */
+      MEM&
+      memento ()
+        {
+          return memento_.getState();
+        }
+      
     };
   
     
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 34498fe18..71dbe7384 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -97,7 +97,7 @@ namespace control {
       
       virtual operator string() const =0;
       
-      virtual bool isValid ()   const { return true; }
+      virtual bool isValid ()   const =0;
       
       virtual CmdFunctor bindArguments (CmdFunctor&) =0;
     };
@@ -212,6 +212,9 @@ namespace control {
           else
             return dumped+")";
         }
+      
+      
+      bool isValid ()  const { return true; }
     };
     
     
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index 3ff10cc23..e796d9646 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -51,7 +51,8 @@
 //using std::tr1::placeholders::_2;
 //using std::tr1::function;
 using util::isnil;
-using util::and_all;
+//using util::and_all;
+using util::for_each;
 using boost::format;
 using lumiera::Time;
 //using util::contains;
@@ -178,46 +179,60 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
           ArgTuples testTuples;
           Tracker<Time>::instanceCnt = 0;
           Tracker<string>::instanceCnt = 0;
           
-          createArgTuples (testTuples);
-          checkArgumentComparison ();
-          serialiseArgTuples (testTuples);
+          createTuples (testTuples);
+//        checkArgumentComparison ();
+//        serialiseArgTuples (testTuples);
           
-          simulateCmdLifecycle();
+//        simulateCmdLifecycle();
           
           ASSERT (0 == Tracker<Time>::instanceCnt);
           ASSERT (0 == Tracker<string>::instanceCnt);
         }
       
+      typedef struct{ int i[5]; } Sint5;
+          
       
       /** @test create various argument tuples and re-access their contents */
       void
       createTuples (ArgTuples& tup)
         {
-          tup.manage (new ArgumentHolder<void()>);
-          tup.manage (new ArgumentHolder<void(int)>);
-          tup.manage (new ArgumentHolder<void(int,Time)>);
-          tup.manage (new ArgumentHolder<void(int,Time), Time>);
-          tup.manage (new ArgumentHolder<void(int,Time), int[5]>);
+          typedef ArgumentHolder<void(),         bool>  A1;
+          typedef ArgumentHolder<void(int),      void*> A2;
+          typedef ArgumentHolder<void(int,Time), int>   A3;
+          typedef ArgumentHolder<void(int,Time), Time>  A4;
+          typedef ArgumentHolder<void(int,Time), Sint5> A5;
           
-          ASSERT (and_all (tup, isnil));
+          A1* arg1 = new A1(); tup.manage (arg1);
+          A2* arg2 = new A2(); tup.manage (arg2);
+          A3* arg3 = new A3(); tup.manage (arg3);
+          A4* arg4 = new A4(); tup.manage (arg4);
+          A5* arg5 = new A5(); tup.manage (arg5);
+          
+          ASSERT (isnil (*arg1));
+          ASSERT (isnil (*arg2));
+          ASSERT (isnil (*arg3));
+          ASSERT (isnil (*arg4));
+          ASSERT (isnil (*arg5));
           
           for_each (tup, showIt);
           
-          tup[1].bind (rand() % 20);
-          tup[2].bind (rand() % 20, randTime());
-          tup[3].bind (rand() % 20, randTime());
-          tup[4].bind (rand() % 20, randTime());
+          arg2->bind (rand() % 20);
+          arg3->bind (rand() % 20, randTime());
+          arg4->bind (rand() % 20, randTime());
+          arg5->bind (rand() % 20, randTime());
           
-          tup[1].memento() = 42;
-          tup[4].memento()[3] = 513;
+          arg3->memento() = 42;
+          arg5->memento().i[3] = 513;
+          
+          for_each (tup, showIt);
         }
       
       
+#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
       /** @test serialise and de-serialise each tuple and check validity
        *  @todo unimplemented, waiting on Serialiser
        */
@@ -319,8 +334,8 @@ namespace test    {
           
           bound_undoFun();
           cout << protocol.str() << endl;
-#endif ////////////////////////////////////////////////////////////////////////////TODO.....          
         }
+#endif ////////////////////////////////////////////////////////////////////////////TODO.....          
     };
   
   
diff --git a/tests/lib/opaque-unchecked-buffer-test.cpp b/tests/lib/opaque-unchecked-buffer-test.cpp
new file mode 100644
index 000000000..b7be45f8a
--- /dev/null
+++ b/tests/lib/opaque-unchecked-buffer-test.cpp
@@ -0,0 +1,302 @@
+/*
+  OpaqueHolder(Test)  -  check the inline type erasure helper
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+#include "lib/util.hpp"
+
+#include "lib/opaque-holder.hpp"
+#include "lib/bool-checkable.hpp"
+
+#include <iostream>
+#include <vector>
+
+
+namespace lib {
+namespace test{
+  
+  using ::Test;
+  using util::isnil;
+  using util::for_each;
+  using util::isSameObject;
+  using lumiera::error::LUMIERA_ERROR_INVALID;
+  using lumiera::error::LUMIERA_ERROR_ASSERTION;
+  
+  using std::vector;
+  using std::cout;
+  using std::endl;
+  
+  namespace { // test dummy hierarchy
+             //  Note: common storage but no vtable 
+    
+    long _checksum = 0;
+    uint _create_count = 0;
+    
+    
+    struct Base   
+      {
+        uint id_;
+        
+        Base(uint i=0)      : id_(i)     { _checksum +=id_; ++_create_count; }
+        Base(Base const& o) : id_(o.id_) { _checksum +=id_; ++_create_count; }
+        
+        uint getIt() { return id_; }
+      };
+    
+    
+    template<uint ii>
+    struct DD : Base
+      {
+        DD() : Base(ii)       { }
+       ~DD() { _checksum -= ii; }  // doing the decrement here
+      };                          //  verifies the correct dtor is called
+    
+    
+    struct Special
+      : DD<7>
+      , BoolCheckable<Special>
+      {
+        ulong myVal_;
+        
+        Special (uint val)
+          : myVal_(val)
+          { }
+        
+        bool
+        isValid ()  const ///< custom boolean "validity" check
+          {
+            return myVal_ % 2;
+          }
+      };
+    
+    
+    /** maximum additional storage maybe wasted
+     *  due to alignment of the contained object
+     *  within OpaqueHolder's buffer
+     */
+    const size_t _ALIGN_ = sizeof(size_t);
+    
+  }
+  
+  typedef OpaqueHolder<Base> Opaque;
+  typedef vector<Opaque> TestList;
+  
+  
+  
+  /**********************************************************************************
+   *  @test use the OpaqueHolder inline buffer to handle objects of a family of types
+   *        through a common interface, without being forced to use heap storage
+   *        or a custom allocator.
+   *
+   *  @todo this test doesn't cover automatic conversions and conversions using RTTI
+   *        from the target objects, while \code OpaqueHolder.template get() \endcode
+   *        would allow for such conversions. This is similar to Ticket #141, and
+   *        actually based on the same code as variant.hpp (access-casted.hpp)
+   */
+  class OpaqueHolder_test : public Test
+    {
+      
+      virtual void
+      run (Arg)
+        {
+          _checksum = 0;
+          _create_count = 0;
+          {
+            TestList objs = createDummies ();
+            for_each (objs, reAccess);
+            checkHandling (objs);
+            checkSpecialSubclass ();
+          }
+          ASSERT (0 == _checksum); // all dead
+        }
+      
+      
+      TestList
+      createDummies ()
+        {
+          TestList list;
+          list.push_back (DD<1>());
+          list.push_back (DD<3>());
+          list.push_back (DD<5>());
+          list.push_back (DD<7>());
+          return list;
+        } //note: copy
+      
+      
+      static void
+      reAccess (Opaque& elm)
+        {
+          cout << elm->getIt() << endl;
+        }
+      
+      
+      /** @test cover the basic situations of object handling,
+       *        especially copy operations and re-assignments
+       */
+      void
+      checkHandling (TestList& objs)
+        {
+          Opaque oo;
+          ASSERT (!oo);
+          ASSERT (isnil(oo));
+          
+          oo = objs[1];
+          ASSERT (oo);
+          ASSERT (!isnil(oo));
+          
+          typedef DD<3> D3;
+          typedef DD<5> D5;
+          D3 d3 (oo.get<D3>() );
+          ASSERT (3 == oo->getIt());    // re-access through Base interface
+          ASSERT (!isSameObject (d3, *oo));
+          VERIFY_ERROR (WRONG_TYPE, oo.get<D5>() );
+          
+          // direct assignment of target into Buffer
+          oo = D5();
+          ASSERT (oo);
+          ASSERT (5 == oo->getIt());
+          VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
+          
+          // can get a direct reference to contained object
+          D5 &rd5 (oo.get<D5>()); 
+          ASSERT (isSameObject (rd5, *oo));
+          
+          ASSERT (!isnil(oo));
+          oo = objs[3];     // copy construction also works on non-empty object
+          ASSERT (7 == oo->getIt());
+          
+          // WARNING: direct ref has been messed up through the backdoor!
+          ASSERT (7 == rd5.getIt());
+          ASSERT (isSameObject (rd5, *oo));
+          
+          uint cnt_before = _create_count;
+          
+          oo.clear();
+          ASSERT (!oo);
+          oo = D5();        // direct assignment also works on empty object
+          ASSERT (oo);
+          ASSERT (5 == oo->getIt());
+          ASSERT (_create_count == 2 + cnt_before);
+          // one within buff and one for the anonymous temporary D5()
+          
+          
+          // verify that self-assignment is properly detected...
+          cnt_before = _create_count;
+          oo = oo;
+          ASSERT (oo);
+          ASSERT (_create_count == cnt_before);
+          oo = oo.get<D5>();
+          ASSERT (_create_count == cnt_before);
+          oo = *oo;
+          ASSERT (_create_count == cnt_before);
+          ASSERT (oo);
+          
+          oo.clear();
+          ASSERT (!oo);
+          ASSERT (isnil(oo));
+          VERIFY_ERROR (INVALID, oo.get<D5>() );
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          VERIFY_ERROR (ASSERTION, oo->getIt() );
+#endif////////////////////////////////////////////////////////////
+          // can't access empty holder...
+          
+          Opaque o1 (oo);
+          ASSERT (!o1);
+          
+          Opaque o2 (d3);
+          ASSERT (!isSameObject (d3, *o2));
+          ASSERT (3 == o2->getIt());
+          
+          ASSERT (sizeof(Opaque) <= sizeof(Base) + sizeof(void*) + _ALIGN_);
+        }
+      
+      
+      /** @test OpaqueHolder with additional storage for subclass.
+       *        When a subclass requires more storage than the base class or
+       *        Interface, we need to create a custom OpaqueHolder, specifying the
+       *        actually necessary storage. Such a custom OpaqueHolder behaves exactly
+       *        like the standard variant, but there is protection against accidentally
+       *        using a standard variant to hold an instance of the larger subclass.
+       *        
+       *  @test Moreover, if the concrete class has a custom operator bool(), it
+       *        will be invoked automatically from OpaqueHolder's operator bool()
+       * 
+       */ 
+      void
+      checkSpecialSubclass ()
+        {
+          typedef OpaqueHolder<Base, sizeof(Special)> SpecialOpaque;
+          
+          cout << showSizeof<Base>() << endl;
+          cout << showSizeof<Special>() << endl;
+          cout << showSizeof<Opaque>() << endl;
+          cout << showSizeof<SpecialOpaque>() << endl;
+          
+          ASSERT (sizeof(Special) > sizeof(Base));
+          ASSERT (sizeof(SpecialOpaque) > sizeof(Opaque));
+          ASSERT (sizeof(SpecialOpaque) <= sizeof(Special) + sizeof(void*) + _ALIGN_);
+          
+          Special s1 (6);
+          Special s2 (3);
+          ASSERT (!s1);               // even value
+          ASSERT (s2);                // odd value
+          ASSERT (7 == s1.getIt());   // indeed subclass of DD<7>
+          ASSERT (7 == s2.getIt());
+          
+          SpecialOpaque ospe0;
+          SpecialOpaque ospe1 (s1);
+          SpecialOpaque ospe2 (s2);
+          
+          ASSERT (!ospe0);            // note: bool test (isValid)
+          ASSERT (!ospe1);            // also forwarded to contained object (myVal_==6 is even)
+          ASSERT ( ospe2);
+          ASSERT ( isnil(ospe0));     // while isnil just checks the empty state
+          ASSERT (!isnil(ospe1));
+          ASSERT (!isnil(ospe2));
+          
+          ASSERT (7 == ospe1->getIt());
+          ASSERT (6 == ospe1.get<Special>().myVal_);
+          ASSERT (3 == ospe2.get<Special>().myVal_);
+          
+          ospe1 = DD<5>();            // but can be reassigned like any normal Opaque
+          ASSERT (ospe1);
+          ASSERT (5 == ospe1->getIt());
+          VERIFY_ERROR (WRONG_TYPE, ospe1.get<Special>() );
+          
+          Opaque normal = DD<5>();
+          ASSERT (normal);
+          ASSERT (5 == normal->getIt());
+#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
+          // Assertion protects against SEGV
+          VERIFY_ERROR (ASSERTION, normal = s1 );
+#endif////////////////////////////////////////////////////////////
+        }
+    };
+  
+  
+  LAUNCHER (OpaqueHolder_test, "unit common");
+  
+  
+}} // namespace lib::test
+

From 584878e0f874a5b5ddba39b68f7ac39733efe1cc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 18 Jul 2009 22:07:46 +0200
Subject: [PATCH 199/368] yet another variation of managing an object in-place

---
 src/lib/opaque-holder.hpp                    | 168 ++++++++++-
 src/lib/util.hpp                             |  16 +-
 src/proc/control/command-argument-holder.hpp |   5 +-
 tests/40components.tests                     |   9 +
 tests/lib/Makefile.am                        |   1 +
 tests/lib/opaque-unchecked-buffer-test.cpp   | 291 ++++++-------------
 6 files changed, 277 insertions(+), 213 deletions(-)

diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index 2fab78582..de2bcae7b 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -68,6 +68,8 @@
 #include "lib/access-casted.hpp"
 #include "lib/util.hpp"
 
+#include <boost/noncopyable.hpp>
+
 
 namespace lib {
   
@@ -540,7 +542,7 @@ namespace lib {
           return *this;
         }
       
-      // note: using standard copy operations 
+      // note: using standard copy operations
       
       
       
@@ -566,5 +568,169 @@ namespace lib {
   
   
   
+  
+  /**
+   * Variation of the concept realised by OpaqueHolder, but implemented here
+   * with reduced security and lesser overhead. InPlaceBuffer is just a chunk of
+   * storage, which can be accessed through a common base class interface and
+   * allows to place new objects there. It has no way to keep track of the
+   * actual object living currently in the buffer. Thus, using InPlaceBuffer
+   * requires the placed class(es) themselves to maintain their lifecycle,
+   * and especially it is mandatory for the base class to provide a 
+   * virtual dtor. On the other hand, just the (alignment rounded)
+   * storage for the object(s) placed into the buffer is required.
+   */
+  template
+    < class BA                   ///< the nominal Base/Interface class for a family of types
+    , size_t siz = sizeof(BA)    ///< maximum storage required for the targets to be held inline
+    , class DEFAULT = BA         ///< the default instance to place initially
+    >
+  class InPlaceBuffer
+    : boost::noncopyable
+    {
+      
+      mutable char buf_[siz];
+      
+      
+      BA&
+      getObj()  const
+        {
+          return reinterpret_cast<BA&> (buf_);
+        }
+      
+      void
+      placeDefault()
+        {
+          new(&buf_) DEFAULT();
+        }
+      
+      void
+      destroy()
+        {
+          getObj().~BA();
+        }
+      
+      
+    public:
+      InPlaceBuffer ()
+        {
+          placeDefault();
+        }
+      
+     ~InPlaceBuffer ()
+        {
+          destroy();
+        }
+      
+      
+      /** Abbreviation for placement new */ 
+#define LIB_InPlaceBuffer_CTOR(_CTOR_CALL_) \
+          destroy();                         \
+          try                                 \
+            {                                  \
+              return *new(&buf_) _CTOR_CALL_;   \
+            }                                    \
+          catch (...)                             \
+            {                                      \
+              placeDefault();                       \
+              throw;                                 \
+            }
+      
+      
+      template<class TY>
+      TY&
+      create ()
+        {
+          LIB_InPlaceBuffer_CTOR ( TY() )
+        }
+      
+      
+      template<class TY, typename A1>
+      TY&                                               //___________________________________________
+      create (A1& a1)                                  ///< place object of type TY, using 1-arg ctor
+        {
+          LIB_InPlaceBuffer_CTOR ( TY(a1) )
+        }
+      
+      
+      template< class TY
+              , typename A1
+              , typename A2
+              >
+      TY&                                               //___________________________________________
+      create (A1& a1, A2& a2)                          ///< place object of type TY, using 2-arg ctor
+        {
+          LIB_InPlaceBuffer_CTOR ( TY(a1,a2) )
+        }
+      
+      
+      template< class TY
+              , typename A1
+              , typename A2
+              , typename A3
+              >
+      TY&                                               //___________________________________________
+      create (A1& a1, A2& a2, A3& a3)                  ///< place object of type TY, using 3-arg ctor
+        {
+          LIB_InPlaceBuffer_CTOR ( TY(a1,a2,a3) )
+        }
+      
+      
+      template< class TY
+              , typename A1
+              , typename A2
+              , typename A3
+              , typename A4
+              >
+      TY&                                               //___________________________________________
+      create (A1& a1, A2& a2, A3& a3, A4& a4)          ///< place object of type TY, using 4-arg ctor
+        {
+          LIB_InPlaceBuffer_CTOR ( TY(a1,a2,a3,a4) )
+        }
+      
+      
+      template< class TY
+              , typename A1
+              , typename A2
+              , typename A3
+              , typename A4
+              , typename A5
+              >
+      TY&                                               //___________________________________________
+      create (A1& a1, A2& a2, A3& a3, A4& a4, A5& a5)  ///< place object of type TY, using 5-arg ctor
+        {
+          LIB_InPlaceBuffer_CTOR ( TY(a1,a2,a3,a4,a5) )
+        }
+      
+      
+      
+      /* === smart-ptr style access === */
+      
+      BA&
+      operator* ()  const
+        {
+          return getObj();
+        }
+      
+      BA* 
+      operator-> ()  const
+        {
+          return &getObj();
+        }
+      
+      
+      template<class SUB>
+      static SUB*
+      access ()
+        {
+          BA * asBase = &getObj();
+          SUB* content = util::AccessCasted<SUB*>::access (asBase);
+          return content;
+        }     // NOTE: might be null.
+    };
+  
+  
+  
+  
 } // namespace lib
 #endif
diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index 1893dda10..595d945c7 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -43,6 +43,20 @@ namespace util {
     return (n==0)? 0 :((n<0)? -1:+1 );
   }
   
+  template <class N1, class N2>
+  inline N1
+  min (N1 n1, N2 n2)
+  {
+    return n2 < n1? N1(n2) : n1;
+  }
+  
+  template <class N1, class N2>
+  inline N1
+  max (N1 n1, N2 n2)
+  {
+    return n1 < n2? N1(n2) : n1;
+  }
+  
   
   /** a family of util functions providing a "no value whatsoever" test.
       Works on strings and all STL containers, includes NULL test for pointers */
@@ -237,7 +251,7 @@ namespace util {
   
   
   
-  /** convienience shortcut: conversion to c-String via string.
+  /** convenience shortcut: conversion to c-String via string.
    *  usable for printf with objects providing to-string conversion.
    */
   inline const char* 
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 11480695c..d3c37860e 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -52,6 +52,7 @@
 //#include <tr1/memory>
 //#include <boost/scoped_ptr.hpp>
 //#include <tr1/functional>
+#include <boost/noncopyable.hpp>
 #include <iostream>
 #include <string>
 
@@ -64,6 +65,7 @@ namespace control {
 //  using boost::scoped_ptr;
 //  using std::tr1::function;
 //  using std::ostream;
+  using boost::noncopyable;
   using std::string;
   
   namespace { // empty state marker objects for ArgumentHolder
@@ -115,7 +117,8 @@ namespace control {
     : public ArgumentTupleAccept< SIG                      // to derive the desired bind(..) signature
                                 , ArgumentHolder<SIG,MEM>  // target class providing the implementation
                                 , CmdClosure               // base class to inherit from
-                                >    
+                                > 
+    , noncopyable
     {
       Closure<SIG> arguments_;
       MementoTie<SIG,MEM> memento_;
diff --git a/tests/40components.tests b/tests/40components.tests
index 59e355116..2dc20a375 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -281,6 +281,15 @@ return: 0
 END
 
 
+TEST "inline unchecked buffer" OpaqueUncheckedBuffer_test  <<END
+out: DD<0>: 
+out: DD<5>: \*\*\*\*\*
+out: DD<9>: I'm fine\*
+out: I'm special, what the f\*\* is going on here\?\*\*\*\*\*\*\*\*\*\*\*\*
+return: 0
+END
+
+
 TEST "Lumiera Iterator Concept" IterAdapter_test 20 <<END
 out: ::0::1::2::3::4::5::6::7::8::9::10::11::12::13::14::15::16::17::18::19
 END
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index c9c853dc0..25e794d0f 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -60,6 +60,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/query/queryutilstest.cpp		\
 	$(testlib_srcdir)/removefromsettest.cpp			\
 	$(testlib_srcdir)/sanitizedidentifiertest.cpp		\
+	$(testlib_srcdir)/opaque-unchecked-buffer-test.cpp	\
 	$(testlib_srcdir)/opaque-holder-test.cpp		\
 	$(testlib_srcdir)/scoped-holder-test.cpp		\
 	$(testlib_srcdir)/scopedholdertransfertest.cpp		\
diff --git a/tests/lib/opaque-unchecked-buffer-test.cpp b/tests/lib/opaque-unchecked-buffer-test.cpp
index b7be45f8a..d905ddfde 100644
--- a/tests/lib/opaque-unchecked-buffer-test.cpp
+++ b/tests/lib/opaque-unchecked-buffer-test.cpp
@@ -1,5 +1,5 @@
 /*
-  OpaqueHolder(Test)  -  check the inline type erasure helper
+  OpaqueUncheckedBuffer(Test)  -  passive inline buffer test
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -27,70 +27,92 @@
 #include "lib/util.hpp"
 
 #include "lib/opaque-holder.hpp"
-#include "lib/bool-checkable.hpp"
 
+#include <boost/noncopyable.hpp>
 #include <iostream>
-#include <vector>
-
+#include <cstring>
 
 namespace lib {
 namespace test{
   
   using ::Test;
-  using util::isnil;
-  using util::for_each;
-  using util::isSameObject;
-  using lumiera::error::LUMIERA_ERROR_INVALID;
-  using lumiera::error::LUMIERA_ERROR_ASSERTION;
+  using util::min;
+  using lumiera::error::LUMIERA_ERROR_FATAL;
   
-  using std::vector;
+  using boost::noncopyable;
+  using std::strlen;
   using std::cout;
   using std::endl;
   
+  
+  
   namespace { // test dummy hierarchy
-             //  Note: common storage but no vtable 
+             //  Note: vtable (and virtual dtor), but varying storage requirements 
     
     long _checksum = 0;
     uint _create_count = 0;
     
     
-    struct Base   
+    struct Base
+      : noncopyable
       {
         uint id_;
+          
+        Base(uint i) : id_(i)     { ++_create_count; _checksum += id_; }
         
-        Base(uint i=0)      : id_(i)     { _checksum +=id_; ++_create_count; }
-        Base(Base const& o) : id_(o.id_) { _checksum +=id_; ++_create_count; }
+        virtual ~Base()           { }
         
-        uint getIt() { return id_; }
+        virtual void confess()  =0;
       };
     
     
     template<uint ii>
     struct DD : Base
       {
-        DD() : Base(ii)       { }
-       ~DD() { _checksum -= ii; }  // doing the decrement here
-      };                          //  verifies the correct dtor is called
-    
-    
-    struct Special
-      : DD<7>
-      , BoolCheckable<Special>
-      {
-        ulong myVal_;
+        char buff_[ii+1];
+      
+       ~DD() { _checksum -= ii; }  // verify the correct dtor is called...
+       
+        DD(Symbol sym = 0)
+          : Base(ii)
+          {
+            memset (&buff_, '*', ii);
+            if (sym)
+              memcpy (&buff_, sym, min (ii, strlen (sym)));
+            buff_[ii] = 0;
+          }
         
-        Special (uint val)
-          : myVal_(val)
+        void
+        confess ()
+          {
+            cout << "DD<" << ii << ">: " << buff_ << endl;
+          }
+      };  
+    
+    
+    struct D42Sub
+      : DD<42>
+      {
+        D42Sub (string s1, string s2)
+          : DD<42> ((s1+' '+s2).c_str())
           { }
         
-        bool
-        isValid ()  const ///< custom boolean "validity" check
+        void
+        confess ()
           {
-            return myVal_ % 2;
+            cout << "I'm special, " << buff_ << endl;
           }
       };
     
     
+    struct Killer
+      : DD<23>
+      {
+        Killer () { throw lumiera::error::Fatal ("crisscross"); }
+      };
+    
+    
+    
     /** maximum additional storage maybe wasted
      *  due to alignment of the contained object
      *  within OpaqueHolder's buffer
@@ -99,22 +121,14 @@ namespace test{
     
   }
   
-  typedef OpaqueHolder<Base> Opaque;
-  typedef vector<Opaque> TestList;
-  
   
   
   /**********************************************************************************
-   *  @test use the OpaqueHolder inline buffer to handle objects of a family of types
-   *        through a common interface, without being forced to use heap storage
-   *        or a custom allocator.
-   *
-   *  @todo this test doesn't cover automatic conversions and conversions using RTTI
-   *        from the target objects, while \code OpaqueHolder.template get() \endcode
-   *        would allow for such conversions. This is similar to Ticket #141, and
-   *        actually based on the same code as variant.hpp (access-casted.hpp)
+   *  @test use an inline buffer to place objects of a subclass, without any checks.
+   *        InPlaceBuffer only provides minimal service, to be covered here, 
+   *        including automatic dtor invocation and smart-ptr style access.
    */
-  class OpaqueHolder_test : public Test
+  class OpaqueUncheckedBuffer_test : public Test
     {
       
       virtual void
@@ -123,179 +137,36 @@ namespace test{
           _checksum = 0;
           _create_count = 0;
           {
-            TestList objs = createDummies ();
-            for_each (objs, reAccess);
-            checkHandling (objs);
-            checkSpecialSubclass ();
+            typedef InPlaceBuffer<Base, sizeof(DD<42>), DD<0> > Buffer;
+            
+            Buffer buff;
+            ASSERT (sizeof(buff) <= sizeof(DD<42>) + _ALIGN_);
+            ASSERT (1 == _create_count);
+            ASSERT (0 == _checksum);
+            buff->confess();          // one default object of type DD<0> has been created
+            
+            buff.create<DD<5> > ();
+            buff->confess();
+            
+            buff.create<DD<9> > ("I'm fine");
+            buff->confess();
+            
+            VERIFY_ERROR( FATAL, buff.create<Killer> () );
+            
+            ASSERT(0 == buff->id_);   // default object was created, due to exception...
+            
+            buff.create<D42Sub> ("what the f**","is going on here?");
+            buff->confess();
+            
+            ASSERT (6 == _create_count);
+            ASSERT (42 == _checksum); // No.42 is alive
           }
-          ASSERT (0 == _checksum); // all dead
-        }
-      
-      
-      TestList
-      createDummies ()
-        {
-          TestList list;
-          list.push_back (DD<1>());
-          list.push_back (DD<3>());
-          list.push_back (DD<5>());
-          list.push_back (DD<7>());
-          return list;
-        } //note: copy
-      
-      
-      static void
-      reAccess (Opaque& elm)
-        {
-          cout << elm->getIt() << endl;
-        }
-      
-      
-      /** @test cover the basic situations of object handling,
-       *        especially copy operations and re-assignments
-       */
-      void
-      checkHandling (TestList& objs)
-        {
-          Opaque oo;
-          ASSERT (!oo);
-          ASSERT (isnil(oo));
-          
-          oo = objs[1];
-          ASSERT (oo);
-          ASSERT (!isnil(oo));
-          
-          typedef DD<3> D3;
-          typedef DD<5> D5;
-          D3 d3 (oo.get<D3>() );
-          ASSERT (3 == oo->getIt());    // re-access through Base interface
-          ASSERT (!isSameObject (d3, *oo));
-          VERIFY_ERROR (WRONG_TYPE, oo.get<D5>() );
-          
-          // direct assignment of target into Buffer
-          oo = D5();
-          ASSERT (oo);
-          ASSERT (5 == oo->getIt());
-          VERIFY_ERROR (WRONG_TYPE, oo.get<D3>() );
-          
-          // can get a direct reference to contained object
-          D5 &rd5 (oo.get<D5>()); 
-          ASSERT (isSameObject (rd5, *oo));
-          
-          ASSERT (!isnil(oo));
-          oo = objs[3];     // copy construction also works on non-empty object
-          ASSERT (7 == oo->getIt());
-          
-          // WARNING: direct ref has been messed up through the backdoor!
-          ASSERT (7 == rd5.getIt());
-          ASSERT (isSameObject (rd5, *oo));
-          
-          uint cnt_before = _create_count;
-          
-          oo.clear();
-          ASSERT (!oo);
-          oo = D5();        // direct assignment also works on empty object
-          ASSERT (oo);
-          ASSERT (5 == oo->getIt());
-          ASSERT (_create_count == 2 + cnt_before);
-          // one within buff and one for the anonymous temporary D5()
-          
-          
-          // verify that self-assignment is properly detected...
-          cnt_before = _create_count;
-          oo = oo;
-          ASSERT (oo);
-          ASSERT (_create_count == cnt_before);
-          oo = oo.get<D5>();
-          ASSERT (_create_count == cnt_before);
-          oo = *oo;
-          ASSERT (_create_count == cnt_before);
-          ASSERT (oo);
-          
-          oo.clear();
-          ASSERT (!oo);
-          ASSERT (isnil(oo));
-          VERIFY_ERROR (INVALID, oo.get<D5>() );
-#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
-          VERIFY_ERROR (ASSERTION, oo->getIt() );
-#endif////////////////////////////////////////////////////////////
-          // can't access empty holder...
-          
-          Opaque o1 (oo);
-          ASSERT (!o1);
-          
-          Opaque o2 (d3);
-          ASSERT (!isSameObject (d3, *o2));
-          ASSERT (3 == o2->getIt());
-          
-          ASSERT (sizeof(Opaque) <= sizeof(Base) + sizeof(void*) + _ALIGN_);
-        }
-      
-      
-      /** @test OpaqueHolder with additional storage for subclass.
-       *        When a subclass requires more storage than the base class or
-       *        Interface, we need to create a custom OpaqueHolder, specifying the
-       *        actually necessary storage. Such a custom OpaqueHolder behaves exactly
-       *        like the standard variant, but there is protection against accidentally
-       *        using a standard variant to hold an instance of the larger subclass.
-       *        
-       *  @test Moreover, if the concrete class has a custom operator bool(), it
-       *        will be invoked automatically from OpaqueHolder's operator bool()
-       * 
-       */ 
-      void
-      checkSpecialSubclass ()
-        {
-          typedef OpaqueHolder<Base, sizeof(Special)> SpecialOpaque;
-          
-          cout << showSizeof<Base>() << endl;
-          cout << showSizeof<Special>() << endl;
-          cout << showSizeof<Opaque>() << endl;
-          cout << showSizeof<SpecialOpaque>() << endl;
-          
-          ASSERT (sizeof(Special) > sizeof(Base));
-          ASSERT (sizeof(SpecialOpaque) > sizeof(Opaque));
-          ASSERT (sizeof(SpecialOpaque) <= sizeof(Special) + sizeof(void*) + _ALIGN_);
-          
-          Special s1 (6);
-          Special s2 (3);
-          ASSERT (!s1);               // even value
-          ASSERT (s2);                // odd value
-          ASSERT (7 == s1.getIt());   // indeed subclass of DD<7>
-          ASSERT (7 == s2.getIt());
-          
-          SpecialOpaque ospe0;
-          SpecialOpaque ospe1 (s1);
-          SpecialOpaque ospe2 (s2);
-          
-          ASSERT (!ospe0);            // note: bool test (isValid)
-          ASSERT (!ospe1);            // also forwarded to contained object (myVal_==6 is even)
-          ASSERT ( ospe2);
-          ASSERT ( isnil(ospe0));     // while isnil just checks the empty state
-          ASSERT (!isnil(ospe1));
-          ASSERT (!isnil(ospe2));
-          
-          ASSERT (7 == ospe1->getIt());
-          ASSERT (6 == ospe1.get<Special>().myVal_);
-          ASSERT (3 == ospe2.get<Special>().myVal_);
-          
-          ospe1 = DD<5>();            // but can be reassigned like any normal Opaque
-          ASSERT (ospe1);
-          ASSERT (5 == ospe1->getIt());
-          VERIFY_ERROR (WRONG_TYPE, ospe1.get<Special>() );
-          
-          Opaque normal = DD<5>();
-          ASSERT (normal);
-          ASSERT (5 == normal->getIt());
-#if false ////////////////////////////////////////////////////////TODO: restore throwing ASSERT
-          // Assertion protects against SEGV
-          VERIFY_ERROR (ASSERTION, normal = s1 );
-#endif////////////////////////////////////////////////////////////
+          ASSERT (0 == _checksum);  // all dead
         }
     };
   
   
-  LAUNCHER (OpaqueHolder_test, "unit common");
+  LAUNCHER (OpaqueUncheckedBuffer_test, "unit common");
   
   
 }} // namespace lib::test

From 3ecd8047dfc08d69cd8229e8d9a5256972f5ed88 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 19 Jul 2009 00:41:37 +0200
Subject: [PATCH 200/368] assertion to guard buffer size limit

---
 src/lib/opaque-holder.hpp | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index de2bcae7b..f91cf9265 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -628,12 +628,13 @@ namespace lib {
           destroy();                         \
           try                                 \
             {                                  \
-              return *new(&buf_) _CTOR_CALL_;   \
-            }                                    \
-          catch (...)                             \
-            {                                      \
-              placeDefault();                       \
-              throw;                                 \
+              REQUIRE (siz >= sizeof(TY));      \
+              return *new(&buf_) _CTOR_CALL_;    \
+            }                                     \
+          catch (...)                              \
+            {                                       \
+              placeDefault();                        \
+              throw;                                  \
             }
       
       

From 5f0c9e209e9f0309c785e4beb899fde25e9cc147 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 19 Jul 2009 05:47:36 +0200
Subject: [PATCH 201/368] remove any use of boost::function in favour of
 <tr1/functional> this resolves some long standing problems with ambiguous
 placeholders closes Ticket #161

---
 src/include/lifecycle.h                       |   2 +-
 src/lib/Makefile.am                           |   1 -
 src/lib/lifecycle.cpp                         |   2 +-
 src/lib/lifecycleregistry.hpp                 |   2 +-
 src/lib/query.cpp                             |   2 +-
 src/lib/query.hpp                             |   2 +-
 src/lib/test/run.hpp                          |   2 +-
 src/lib/test/suite.cpp                        |  38 +--
 src/lib/test/suite.hpp                        |   4 +-
 src/lib/util.cpp                              |  17 +-
 src/lib/util.hpp                              |   3 +-
 src/lib/visitor-dispatcher.hpp                | 217 ++++++++++++++
 ...sitorpolicies.hpp => visitor-policies.hpp} |  81 +++--
 src/lib/visitor.cpp                           |  35 ---
 src/lib/visitor.hpp                           | 282 +++++++++---------
 src/lib/visitordispatcher.hpp                 | 219 --------------
 src/pre.hpp                                   |   3 +-
 src/pre_a.hpp                                 |   3 +-
 src/proc/asset.cpp                            |  18 +-
 src/proc/asset/clip.cpp                       |   2 +-
 src/proc/asset/media.cpp                      |   4 +-
 src/proc/asset/preview.cpp                    |   2 +-
 src/proc/assetmanager.cpp                     |   8 +-
 src/proc/control/command-argument-holder.hpp  |  60 ++--
 src/proc/engine/nodewiringconfig.hpp          |  14 +-
 ...tdiagnostics.hpp => asset-diagnostics.hpp} |  15 +-
 tests/components/proc/asset/basicpipetest.cpp |   2 +-
 .../proc/asset/compoundmediatest.cpp          |   2 +-
 .../components/proc/asset/createassettest.cpp |   2 +-
 .../proc/asset/dependent-assets-test.cpp      |   2 +-
 .../proc/asset/identityofassetstest.cpp       |   2 +-
 tests/components/proc/asset/makecliptest.cpp  |   2 +-
 .../proc/asset/mediastructurequerytest.cpp    |   2 +-
 .../proc/asset/orderingofassetstest.cpp       |   2 +-
 .../mobject/session/rebuildfixturetest.cpp    |   4 +-
 tests/lib/Makefile.am                         |   6 +-
 tests/lib/meta/function-erasure-test.cpp      |   2 +
 tests/lib/query/queryutilstest.cpp            |   5 +-
 ...test.cpp => sanitised-identifier-test.cpp} |  56 ++--
 tests/lib/singleton-subclass-test.cpp         | 162 ++++++++++
 tests/lib/singleton-test.cpp                  | 137 +++++++++
 tests/lib/singletonsubclasstest.cpp           | 166 -----------
 tests/lib/singletontest.cpp                   | 139 ---------
 tests/lib/streamtypelifecycletest.cpp         |   2 +-
 tests/lib/visitingtoolconcept.cpp             |   4 +-
 45 files changed, 854 insertions(+), 883 deletions(-)
 create mode 100644 src/lib/visitor-dispatcher.hpp
 rename src/lib/{visitorpolicies.hpp => visitor-policies.hpp} (51%)
 delete mode 100644 src/lib/visitor.cpp
 delete mode 100644 src/lib/visitordispatcher.hpp
 rename tests/components/proc/asset/{assetdiagnostics.hpp => asset-diagnostics.hpp} (85%)
 rename tests/lib/{sanitizedidentifiertest.cpp => sanitised-identifier-test.cpp} (54%)
 create mode 100644 tests/lib/singleton-subclass-test.cpp
 create mode 100644 tests/lib/singleton-test.cpp
 delete mode 100644 tests/lib/singletonsubclasstest.cpp
 delete mode 100644 tests/lib/singletontest.cpp

diff --git a/src/include/lifecycle.h b/src/include/lifecycle.h
index b91ce5619..40634bc95 100644
--- a/src/include/lifecycle.h
+++ b/src/include/lifecycle.h
@@ -61,7 +61,7 @@ namespace lumiera {
    *  define and register a callback for a specific lifecycle event.
    *  The purpose of this class is to be defined as a static variable in the implementation
    *  of some subsystem (i.e. in the cpp file), providing the ctor with the pointer to a 
-   *  callback function. Thus the callback gets enrolled when the corresponding object file
+   *  callback function. Thus the callback gets enroled when the corresponding object file
    *  is loaded. The event ON_BASIC_INIT is handled specifically, firing off the referred 
    *  callback function as soon as possible. All other labels are just arbitrary (string)
    *  constants and it is necessary that "someone" cares to fire off the lifecycle events
diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index 4fa99136d..7a371da5a 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -41,7 +41,6 @@ liblumiera_la_SOURCES =						\
 	$(liblumiera_la_srcdir)/lifecycle.cpp			\
 	$(liblumiera_la_srcdir)/nobug-init.cpp			\
 	$(liblumiera_la_srcdir)/util.cpp			\
-	$(liblumiera_la_srcdir)/visitor.cpp			\
 	$(liblumiera_la_srcdir)/query.cpp			\
 	$(liblumiera_la_srcdir)/streamtype.cpp			\
 	$(liblumiera_la_srcdir)/test/testoption.cpp 		\
diff --git a/src/lib/lifecycle.cpp b/src/lib/lifecycle.cpp
index 2a0a5f099..553a9fc32 100644
--- a/src/lib/lifecycle.cpp
+++ b/src/lib/lifecycle.cpp
@@ -46,7 +46,7 @@ namespace lumiera {
   void
   LifecycleHook::add (Symbol eventLabel, Callback callbackFun)
   {
-    bool isNew = LifecycleRegistry::instance().enroll (eventLabel,callbackFun);
+    bool isNew = LifecycleRegistry::instance().enrol (eventLabel,callbackFun);
     
     if (isNew && !strcmp(ON_BASIC_INIT, eventLabel))
       callbackFun();  // when this code executes,
diff --git a/src/lib/lifecycleregistry.hpp b/src/lib/lifecycleregistry.hpp
index 4e1bcef7c..3d14e2209 100644
--- a/src/lib/lifecycleregistry.hpp
+++ b/src/lib/lifecycleregistry.hpp
@@ -74,7 +74,7 @@ namespace lumiera {
       
       
       /** @note only one copy of each distinct callback remembered */ 
-      bool enroll (const string label, Hook toCall)
+      bool enrol (const string label, Hook toCall)
         {
           return table_[label]
                         .insert(toCall)
diff --git a/src/lib/query.cpp b/src/lib/query.cpp
index f47b9819a..59be860a3 100644
--- a/src/lib/query.cpp
+++ b/src/lib/query.cpp
@@ -54,7 +54,7 @@ namespace lumiera {
     void
     normaliseID (string& id)
     {
-      id = util::sanitize(id);
+      id = util::sanitise(id);
       if (isnil(id) || !is_alpha (id[0]))
         id.insert(0, "o");
       
diff --git a/src/lib/query.hpp b/src/lib/query.hpp
index 783992ade..911acaabf 100644
--- a/src/lib/query.hpp
+++ b/src/lib/query.hpp
@@ -66,7 +66,7 @@ namespace lumiera {
     {
     
     /** ensure standard format for a given id string.
-     *  Trim, sanitize and ensure the first letter is lower case.
+     *  Trim, sanitise and ensure the first letter is lower case.
      *  @note modifies the given string ref in place
      */
     void normaliseID (string& id);
diff --git a/src/lib/test/run.hpp b/src/lib/test/run.hpp
index 930e3592f..cd7621c89 100644
--- a/src/lib/test/run.hpp
+++ b/src/lib/test/run.hpp
@@ -84,7 +84,7 @@ namespace test
   class Launch : public Launcher
     {
     public:
-      Launch (string testID, string groups)  { Suite::enroll (this,testID,groups); };
+      Launch (string testID, string groups)  { Suite::enrol (this,testID,groups); };
       virtual auto_ptr<Test> operator() ()   { return auto_ptr<Test> (new TEST ); };
     };   
     
diff --git a/src/lib/test/suite.cpp b/src/lib/test/suite.cpp
index f6107fafc..d1d383d71 100644
--- a/src/lib/test/suite.cpp
+++ b/src/lib/test/suite.cpp
@@ -39,30 +39,30 @@
 
 
 
-namespace test
-  {
+namespace test {
+  
   using std::map;
   using std::vector;
   using std::auto_ptr;
   using std::tr1::shared_ptr;
   using boost::algorithm::trim;
-
+  
   using util::isnil;
   using util::contains;
   
   typedef map<string, Launcher*> TestMap;
   typedef shared_ptr<TestMap>  PTestMap;
   typedef map<string,PTestMap> GroupMap;
-
+  
   
   
   /** helper to collect and manage the test cases.
    *  Every testcase class should create a Launch instance
-   *  which causes a call to Suite::enroll(), so we can add a
+   *  which causes a call to Suite::enrol(), so we can add a
    *  pointer to this Launcher into a map indexed by the
    *  provided testIDs and groupIDs.
    *  This enables us to build a Suite instance for any 
-   *  requested group and then instantiiate and invoke
+   *  requested group and then instantiate and invoke
    *  individual testcases accordingly.
    */ 
   class Registry
@@ -93,16 +93,16 @@ namespace test
   
   
   /** register the given test-launcher, so it can be later accessed
-   *  either as a member of one of the specified groups, or direcly
+   *  either as a member of one of the specified groups, or directly
    *  by its testID. Any test is automatically added to the groupID
    *  #ALLGROUP
    *  @param test the Launcher object used to run this test
-   *  @param testID unique ID to refere to this test (will be used as std::map key)
+   *  @param testID unique ID to refer to this test (will be used as std::map key)
    *  @param groups List of group-IDs selected by whitespace
    * 
    */
   void 
-  Suite::enroll (Launcher* test, string testID, string groups)
+  Suite::enrol (Launcher* test, string testID, string groups)
   {
     REQUIRE( test );
     REQUIRE( !isnil(testID) );
@@ -112,7 +112,7 @@ namespace test
     while (ss >> group )
       testcases.add2group(test, testID, group);
     
-    // Magic: allways add any testcas to groupID="ALL"
+    // Magic: always add any testcase to groupID="ALL"
     testcases.add2group(test,testID, ALLGROUP);
   }
   
@@ -122,7 +122,7 @@ namespace test
   
   
   /** create a suite comprised of all the testcases 
-   *  previously @link #enroll() registered @endlink with this
+   *  previously @link #enrol() registered @endlink with this
    *  this group. 
    *  @see #run() running tests in a Suite 
    */
@@ -138,14 +138,14 @@ namespace test
   }
     
 #define VALID(test,testID) \
-  ASSERT ((test), "NULL testcase laucher for test '%s' found in testsuite '%s'", groupID_.c_str(),testID.c_str());
+  ASSERT ((test), "NULL testcase launcher for test '%s' found in testsuite '%s'", groupID_.c_str(),testID.c_str());
   
   
   /** run all testcases contained in this Suite.
    *  The first argument in the commandline, if present, 
    *  will select one single testcase with a matching ID.
    *  In case of invoking a single testcase, the given cmdline
-   *  will be forwarded to the testcase, after removind the
+   *  will be forwarded to the testcase, after removing the
    *  testcaseID from cmdline[0]. Otherwise, every testcase 
    *  in this suite is invoked with a empty cmdline vector.
    *  @param cmdline ref to the vector of commandline tokens  
@@ -173,7 +173,7 @@ namespace test
       }   }
     
     // no test-ID was specified.
-    // instantiiate all tests cases and execute them.
+    // Instantiate all tests cases and execute them.
     for ( TestMap::iterator i=tests->begin(); i!=tests->end(); ++i )
       {
         std::cout << "\n  ----------"<< i->first<< "----------\n";
@@ -184,7 +184,7 @@ namespace test
   }
   
   
-  /** print to stdout an ennumeration of all testcases in this suite,
+  /** print to stdout an enumeration of all testcases in this suite,
    *  in a format suitable for use with Cehteh's ./test.sh 
    */
   void
@@ -195,7 +195,7 @@ namespace test
     ASSERT (tests);
     
     std::cout << "TESTING \"Component Test Suite: " << groupID_ << "\" ./test-components\n\n";
-
+    
     for ( TestMap::iterator i=tests->begin(); i!=tests->end(); ++i )
       {
         string key (i->first);
@@ -214,7 +214,7 @@ namespace test
         std::cout << "END\n";
       }
   }
-
-
-
+  
+  
+  
 } // namespace test
diff --git a/src/lib/test/suite.hpp b/src/lib/test/suite.hpp
index afdb9e3d6..ad378b54a 100644
--- a/src/lib/test/suite.hpp
+++ b/src/lib/test/suite.hpp
@@ -42,7 +42,7 @@ namespace test
   
   /**
    * Enables running a collection of tests.
-   * An internal registration service #enroll() is provided
+   * An internal registration service #enrol() is provided
    * for the individual Test - inscances to be recognized as 
    * testcases. The groupID passed to the constructor selects
    * all testcases declared as belonging to this Group.
@@ -55,7 +55,7 @@ namespace test
       Suite (string groupID);
       void run (Arg cmdline);
       void describe ();
-      static void enroll (Launcher *test, string testID, string groups);
+      static void enrol (Launcher *test, string testID, string groups);
       
       static const string ALLGROUP;
     };
diff --git a/src/lib/util.cpp b/src/lib/util.cpp
index aa2871c17..5c52cf6ad 100644
--- a/src/lib/util.cpp
+++ b/src/lib/util.cpp
@@ -24,8 +24,7 @@
 #include "lib/util.hpp"
 
 #include <boost/algorithm/string.hpp>
-#include <boost/function.hpp>
-#include <boost/bind.hpp>
+#include <tr1/functional>
 
 using boost::algorithm::trim_right_copy_if;
 using boost::algorithm::is_any_of;
@@ -33,19 +32,21 @@ using boost::algorithm::is_alnum;
 using boost::algorithm::is_space;
 
 
-namespace util
-  {
+namespace util {
 
-  typedef boost::function<bool(string::value_type)> ChPredicate;
-  ChPredicate operator! (ChPredicate p) { return ! boost::bind(p,_1); }
+  using std::tr1::function;
+  using std::tr1::placeholders::_1;
+  
+  typedef function<bool(string::value_type)> ChPredicate;
+  ChPredicate operator! (ChPredicate p) { return ! bind(p,_1); }
 
-  // character classes used for sanitizing a string
+  // character classes used for sanitising a string
   ChPredicate isValid (is_alnum() || is_any_of("-_.:+$'()@"));           ///< characters to be retained
   ChPredicate isPunct (is_space() || is_any_of(",;#*~´`?\\=/&%![]{}")); ///<  punctuation to be replaced by '_'
 
   
   string
-  sanitize (const string& org)
+  sanitise (const string& org)
   {
     string res (trim_right_copy_if(org, !isValid ));
     string::iterator       j = res.begin();
diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index 595d945c7..bdee6ea5d 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -245,8 +245,9 @@ namespace util {
    "mixed    Ω   garbage"             --> 'mixed_garbage'
    "Bääääh!!"                         --> 'Bh'
 \endverbatim
+   * @see sanitised-identifier-test.cpp
    */
-  string sanitize (const string& org);
+  string sanitise (const string& org);
   
   
   
diff --git a/src/lib/visitor-dispatcher.hpp b/src/lib/visitor-dispatcher.hpp
new file mode 100644
index 000000000..4ec682ea4
--- /dev/null
+++ b/src/lib/visitor-dispatcher.hpp
@@ -0,0 +1,217 @@
+/*
+  VISITOR-DISPATCHER.hpp  -  visitor implementation details
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+
+#ifndef LUMIERA_VISITOR_DISPATCHER_H
+#define LUMIERA_VISITOR_DISPATCHER_H
+
+#include "lib/error.hpp"
+#include "lib/util.hpp"
+#include "lib/sync-classlock.hpp"
+#include "lib/singleton.hpp"
+#include "lib/util.hpp"
+
+#include <vector>
+
+
+namespace lumiera {
+namespace visitor {
+  
+  using lib::ClassLock;
+  
+  
+  template<class TOOL> class Tag;
+  
+  
+  template<class TOOL, class TOOLImpl>
+  struct TagTypeRegistry 
+    {
+      static Tag<TOOL> tag;
+    };
+    
+  /**
+   * Type tag for concrete visiting tool classes.
+   * Used to access the previously registered dispatcher 
+   * trampoline function when handling a visitor invocation.
+   */
+  template<class TOOL>
+  class Tag
+  {
+    size_t tagID; ///< tag value
+    static size_t lastRegisteredID;
+    
+  private:
+    static void
+    generateID (size_t& id)
+      {
+        ClassLock<Tag> guard();
+        if (!id)
+          id = ++lastRegisteredID;
+      }
+    
+  public:
+    Tag() : tagID(0) { }
+    operator size_t()  const { return tagID; }
+    
+    
+    template<class TOOLImpl>
+    static Tag&
+    get (TOOLImpl* const =0)
+      {
+        Tag& t = TagTypeRegistry<TOOL,TOOLImpl>::tag;
+        if (!t) generateID (t.tagID);
+        return t;
+      }
+  
+  };
+  
+  
+  
+  /** storage for the Tag registry for each concrete tool */
+  template<class TOOL, class TOOLImpl>
+  Tag<TOOL> TagTypeRegistry<TOOL,TOOLImpl>::tag; 
+  
+  template<class TOOL>
+  size_t Tag<TOOL>::lastRegisteredID (0);
+  
+  
+  
+  
+  
+  
+  
+  
+  /**
+   * For each possible call entry point via some subclass of the visitable hierarchy,
+   * we maintain a dispatcher table to keep track of all concrete tool implementations
+   * able to receive and process calls on objects of this subclass.
+   * @param TAR the concrete target (subclass) type within the visitable hierarchy
+   * @param TOOL the overall tool family (base class of all concrete tools)
+   */
+  template<class TAR, class TOOL>
+  class Dispatcher
+    {
+      typedef typename TOOL::ReturnType ReturnType;
+      
+      /** generator for Trampoline functions,
+       *  used to dispatch calls down to the 
+       *  right "treat"-Function on the correct
+       *  concrete tool implementation class
+       */
+      template<class TOOLImpl>
+      static ReturnType 
+      callTrampoline (TAR& obj, TOOL& tool)
+        {
+          // cast down to real implementation type
+          REQUIRE (INSTANCEOF (TOOLImpl, &tool));  
+          TOOLImpl& toolObj = static_cast<TOOLImpl&> (tool);
+          
+          // trigger (compile time) overload resolution
+          // based on concrete type, then dispatch the call.
+          // Note this may cause obj to be upcasted.
+          return toolObj.treat (obj);
+        }
+      
+      typedef ReturnType (*Trampoline) (TAR&, TOOL& );
+      
+      
+      /** VTable for storing the Trampoline pointers */
+      std::vector<Trampoline> table_;
+      
+      
+      void
+      accomodate (size_t index)
+        {
+          ClassLock<Dispatcher> guard();  // note: this lock is also used for the singleton!
+          if (index > table_.size())
+            table_.resize (index);      // performance bottleneck?? TODO: measure the real impact!
+        }
+      
+      inline bool
+      is_known (size_t id)
+        { 
+          return id<=table_.size() && table_[id-1]; 
+        }
+      
+      inline void 
+      storePtr (size_t id, Trampoline func)
+        {
+          REQUIRE (func);
+          REQUIRE (0 < id);
+          if (id>table_.size())
+            accomodate (id);
+          table_[id-1] = func;
+        }
+      
+      inline Trampoline 
+      storedTrampoline (size_t id)
+        {
+          if (id<=table_.size() && table_[id-1])
+            return table_[id-1];
+          else
+            return &errorHandler;
+        }
+      
+      static ReturnType
+      errorHandler (TAR& target, TOOL& tool)
+        {
+          return tool.onUnknown (target);
+        }
+      
+      
+    public:
+      static Singleton<Dispatcher<TAR,TOOL> > instance;
+      
+      inline ReturnType 
+      forwardCall (TAR& target, TOOL& tool)
+        {
+          // get concrete type via tool's VTable 
+          Tag<TOOL> index = tool.getTag();
+          return (*storedTrampoline(index)) (target, tool);
+        }
+      
+      template<class TOOLImpl>
+      inline void 
+      enrol(TOOLImpl* typeref)
+        {
+          Tag<TOOL>& index = Tag<TOOL>::get (typeref);
+          if (is_known (index))
+            return;
+          else
+            {
+              Trampoline func = &callTrampoline<TOOLImpl>;
+              storePtr (index, func);
+            }
+            
+        }
+    };
+  
+  /** storage for the dispatcher table(s) */
+  template<class TAR, class TOOL>
+  Singleton<Dispatcher<TAR,TOOL> > Dispatcher<TAR,TOOL>::instance;
+  
+  
+  
+  
+}} // namespace lumiera::visitor
+#endif
diff --git a/src/lib/visitorpolicies.hpp b/src/lib/visitor-policies.hpp
similarity index 51%
rename from src/lib/visitorpolicies.hpp
rename to src/lib/visitor-policies.hpp
index 04034df4e..63e6324cf 100644
--- a/src/lib/visitorpolicies.hpp
+++ b/src/lib/visitor-policies.hpp
@@ -1,5 +1,5 @@
 /*
-  VISITOR.hpp  -  Acyclic Visitor library
+  VISITOR-POLICIES.hpp  -  Acyclic Visitor library
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,7 +21,7 @@
 */
 
 
-/** @file visitorpolicies.hpp
+/** @file visitor-policies.hpp
  ** Policies usable for configuring the lumiera::visitor::Tool for different kinds of error handling. 
  ** @see buildertool.hpp for another flavour (calling an catch-all-function there)
  **
@@ -29,49 +29,46 @@
 
 
 
-#ifndef LUMIERA_VISITORPOLICIES_H
-#define LUMIERA_VISITORPOLICIES_H
+#ifndef LUMIERA_VISITOR_POLICIES_H
+#define LUMIERA_VISITOR_POLICIES_H
 
 #include "lib/error.hpp"
 
 
-namespace lumiera
-  {
-  namespace visitor
+namespace lumiera {
+namespace visitor {
+  
+  /** 
+   * Policy returning just the default return value in case
+   * of encountering an unknown Visitor (typically caused by
+   * adding a new class to the visitable hierarchy)
+   */
+  template<class RET>
+  struct UseDefault
     {
-    /** 
-     * Policy returning just the default return value in case
-     * of encountering an unknown Visitor (typically caused by
-     * adding a new class to the visitable hierarchy)
-     */
-    template<class RET>
-    struct UseDefault
-      {
-        template<class TAR>
-        RET 
-        onUnknown (TAR&)
-          {
-            return RET();
-          }
-      };
-      
-    /** 
-     * Policy to throw when encountering an unknown visiting tool
-     */
-    template<class RET>
-    struct ThrowException
-      {
-        template<class TAR>
-        RET 
-        onUnknown (TAR&)
-          {
-            throw lumiera::error::Config("unable to decide what tool operation to call");
-          }
-      };
-      
-      
-    
-  } // namespace visitor
-
-} // namespace lumiera
+      template<class TAR>
+      RET 
+      onUnknown (TAR&)
+        {
+          return RET();
+        }
+    };
+  
+  /** 
+   * Policy to throw when encountering an unknown visiting tool
+   */
+  template<class RET>
+  struct ThrowException
+    {
+      template<class TAR>
+      RET 
+      onUnknown (TAR&)
+        {
+          throw lumiera::error::Config("unable to decide what tool operation to call");
+        }
+    };
+  
+  
+  
+}} // namespace lumiera::visitor
 #endif
diff --git a/src/lib/visitor.cpp b/src/lib/visitor.cpp
deleted file mode 100644
index 996d22c16..000000000
--- a/src/lib/visitor.cpp
+++ /dev/null
@@ -1,35 +0,0 @@
-/*
-  Vistitable,Tool,Applicable  -  Acyclic Visitor library
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "lib/visitor.hpp"
-
-namespace lumiera
-  {
-  namespace visitor
-    {
-
-
-  
-  } // namespace visitor
-
-} // namespace lumiera
diff --git a/src/lib/visitor.hpp b/src/lib/visitor.hpp
index 52fdc4f7d..a36ca00e1 100644
--- a/src/lib/visitor.hpp
+++ b/src/lib/visitor.hpp
@@ -36,11 +36,11 @@ Credits for many further implementation ideas go to
 
 
 /** @file visitor.hpp
- ** A library implementation of the <b>Visitor Pattern</b> taylored specifically
+ ** A library implementation of the <b>Visitor Pattern</b> tailored specifically
  ** to Lumiera's needs within the Proc Layer. Visitor enables <b>double dispatch</b>
  ** calls, based both on the concrete type of some target object and the concrete type of
  ** a tool object being applied to this target. The code carrying out this tool application
- ** (and thus triggering the double dispatch) need not know any of these concret types and is
+ ** (and thus triggering the double dispatch) need not know any of these concrete types and is
  ** thus completely decoupled form implementation details encapsulated within the visiting tool.
  ** The visiting tool implementation class provides specific "treat(ConcreteVisitable&)" functions,
  ** and this visitor lib will dispatch the call to the* correct "treat"-function based on the 
@@ -60,13 +60,13 @@ Credits for many further implementation ideas go to
  **     <li>any concrete Visitable subclass wanting to be treated by some concrete tool
  **         needs to use the DECLARE_PROCESSABLE_BY(TOOLBASE) macro. By this, it gets an
  **         virtual \code apply(TOOLBASE&) function. Otherwise, it will be treated by the
- **         interface of the next base clas using this macro.</li>
+ **         interface of the next base class using this macro.</li>
  ** </ul>
  ** For design questions and more detailed implementation notes, see the Proc Layer Tiddly Wiki.  
  **
  ** @see visitingtooltest.cpp test cases using our lib implementation
- ** @see BuilderTool one especially important instantiiation
- ** @see visitordispatcher.hpp
+ ** @see BuilderTool one especially important instantiation
+ ** @see visitor-dispatcher.hpp
  ** @see typelist.hpp
  **
  */
@@ -76,158 +76,154 @@ Credits for many further implementation ideas go to
 #ifndef LUMIERA_VISITOR_H
 #define LUMIERA_VISITOR_H
 
-#include "lib/visitorpolicies.hpp"
-#include "lib/visitordispatcher.hpp"
+#include "lib/visitor-policies.hpp"
+#include "lib/visitor-dispatcher.hpp"
 
 #include "lib/meta/typelist.hpp"
 
 
-namespace lumiera
-  {
-  namespace visitor
+namespace lumiera {
+namespace visitor {
+  
+  
+  /** 
+   * Marker interface / base class for all "visiting tools".
+   * When applying such a tool to some concrete instance
+   * derived from Visitable, a special function treating
+   * this concrete subclass will be selected on the 
+   * concrete visiting tool instance.
+   */
+  template
+    < typename RET = void
+    , template <class> class ERR = UseDefault
+    >
+  class Tool : public ERR<RET>
     {
+    public:
+      typedef RET ReturnType;      ///< Tool function invocation return type
+      typedef Tool ToolBase;      ///<  for templating the Tag and Dispatcher
+      
+      virtual ~Tool ()  { };    ///< use RTTI for all visiting tools
+      
+      /** allows discovery of the concrete Tool type when dispatching a
+       *  visitor call. Can be implemented by inheriting from ToolTag */
+      virtual Tag<ToolBase> getTag() = 0; 
+    };
   
   
-    /** 
-     * Marker interface / base class for all "visiting tools".
-     * When applying such a tool to some concrete instance
-     * derived from Visitable, a special function treating
-     * this concrete subclass will be selected on the 
-     * concrete visiting tool instance.
-     */
-    template
-      < typename RET = void,                
-        template <class> class ERR = UseDefault
-      >        
-    class Tool : public ERR<RET>
-      {
-      public:
-        typedef RET ReturnType;      ///< Tool function invocation return type
-        typedef Tool ToolBase;      ///<  for templating the Tag and Dispatcher
-        
-        virtual ~Tool ()  { };    ///< use RTTI for all visiting tools
-        
-        /** allows discovery of the concrete Tool type when dispatching a
-         *  visitor call. Can be implemented by inheriting from ToolTag */
-        virtual Tag<ToolBase> getTag() = 0; 
-      };
-    
-    
-    
-    
-    /** 
-     * Marker template to declare that some "visiting tool" 
-     * wants to treat a set of concrete Visitable classes.
-     * 
-     * Each "first class" concrete visiting tool implementation has
-     * to inherit from an instance of this template parametrized with
-     * the desired types; for each of the mentioned types, calls will 
-     * be dispatched to the tool implementation. (To make it clear:
-     * Calls to all other types not marked by such an "Applicable"
-     * won't ever be dispatched to this tool class.).
-     * A Sideeffect of inheriting from such an "Applicable" is that 
-     * the tool gets an unique Tag entry, which is used internally
-     * as index in the dispatcher tables. And the automatic ctor call
-     * allows us to record the type information and preregister the
-     * dispatcher entry.
-     */
-    template
-      < class TOOLImpl,      // concrete tool implementation type
-        class TYPES,        // List of applicable Types goes here...
-        class BASE=Tool<>  // "visiting tool" base class 
-      >
-    class Applicable;
-    
-    template           // recursion end: inherit from BASE
-      < class TOOLImpl,
-        class BASE 
-      >
-    class Applicable<TOOLImpl, typelist::NullType, BASE> 
-      : public BASE
-    { }
-    ;
-    
-    template
-      < class TOOLImpl,
-        class TAR, class TYPES,
-        class BASE 
-      >
-    class Applicable<TOOLImpl, typelist::Node<TAR, TYPES>, BASE>
-      : public Applicable<TOOLImpl, TYPES, BASE>
-      {
-        
-        typedef typename BASE::ToolBase ToolBase;
-        
-      protected:
-        virtual ~Applicable () {}
-        Applicable ()
-          {
-            TOOLImpl* typeref = 0;
-            Dispatcher<TAR,ToolBase>::instance().enroll (typeref);
-          }
-        
-      public:
-        virtual Tag<ToolBase> 
-        getTag ()
-          {
-            TOOLImpl* typeref = 0;
-            return Tag<ToolBase>::get (typeref); 
-          }
-      };
-    
-    using typelist::Types;  // convienience for the user of "Applicable"
-    
-    
+  
+  
+  /** 
+   * Marker template to declare that some "visiting tool" 
+   * wants to treat a set of concrete Visitable classes.
+   * 
+   * Each "first class" concrete visiting tool implementation has
+   * to inherit from an instance of this template parametrised with
+   * the desired types; for each of the mentioned types, calls will 
+   * be dispatched to the tool implementation. (To make it clear:
+   * Calls to all other types not marked by such an "Applicable"
+   * won't ever be dispatched to this tool class.).
+   * A Sideeffect of inheriting from such an "Applicable" is that 
+   * the tool gets an unique Tag entry, which is used internally
+   * as index in the dispatcher tables. And the automatic ctor call
+   * allows us to record the type information and pre-register the
+   * dispatcher entry.
+   */
+  template
+    < class TOOLImpl,      // concrete tool implementation type
+      class TYPES,        // List of applicable Types goes here...
+      class BASE=Tool<>  // "visiting tool" base class 
+    >
+  class Applicable;
+  
+  template           // recursion end: inherit from BASE
+    < class TOOLImpl,
+      class BASE 
+    >
+  class Applicable<TOOLImpl, typelist::NullType, BASE>
+    : public BASE
+  { }
+  ;
+  
+  template
+    < class TOOLImpl,
+      class TAR, class TYPES,
+      class BASE 
+    >
+  class Applicable<TOOLImpl, typelist::Node<TAR, TYPES>, BASE>
+    : public Applicable<TOOLImpl, TYPES, BASE>
+    {
       
-    /** 
-     * Marker interface or base class for all "Visitables". 
-     * Concrete types to be treated by a "visiting tool" derive from
-     * this interface and need to implement an #apply(Tool&), forwarding
-     * to the (internal, static, templated) #dispatchOp. This is done
-     * best by using the #DEFINE_PROCESSABLE_BY macro.
-     */
-    template 
-      < class TOOL = Tool<> 
-      >
-    class Visitable
-      {
-      protected:
-        virtual ~Visitable () { };
-        
-        /// @note may differ from TOOL
-        typedef typename TOOL::ToolBase ToolBase;
-        typedef typename TOOL::ReturnType ReturnType;
-
-        /** @internal used by the #DEFINE_PROCESSABLE_BY macro.
-         *            Dispatches to the actual operation on the 
-         *            "visiting tool" (visitor implementation)
-         *            Note: creates a context templated on concrete TAR.
-         */
-        template <class TAR>
-        static inline ReturnType
-        dispatchOp (TAR& target, TOOL& tool)
-          {
-            return Dispatcher<TAR,ToolBase>::instance().forwardCall (target,tool);
-          }
-        
-      public:
-        /** to be defined by the DEFINE_PROCESSABLE_BY macro
-         *  in all classes wanting to be treated by some tool */
-        virtual ReturnType apply (TOOL&) = 0;
-      };
+      typedef typename BASE::ToolBase ToolBase;
       
+    protected:
+      virtual ~Applicable () {}
+      Applicable ()
+        {
+          TOOLImpl* typeref = 0;
+          Dispatcher<TAR,ToolBase>::instance().enrol (typeref);
+        }
+      
+    public:
+      virtual Tag<ToolBase> 
+      getTag ()
+        {
+          TOOLImpl* typeref = 0;
+          return Tag<ToolBase>::get (typeref);
+        }
+    };
+  
+  using typelist::Types;  // convenience for the user of "Applicable"
+  
+  
+  
+  /** 
+   * Marker interface or base class for all "Visitables". 
+   * Concrete types to be treated by a "visiting tool" derive from
+   * this interface and need to implement an #apply(Tool&), forwarding
+   * to the (internal, static, templated) #dispatchOp. This is done
+   * best by using the #DEFINE_PROCESSABLE_BY macro.
+   */
+  template 
+    < class TOOL = Tool<> 
+    >
+  class Visitable
+    {
+    protected:
+      virtual ~Visitable () { };
+      
+      /// @note may differ from TOOL
+      typedef typename TOOL::ToolBase ToolBase;
+      typedef typename TOOL::ReturnType ReturnType;
+      
+      /** @internal used by the #DEFINE_PROCESSABLE_BY macro.
+       *            Dispatches to the actual operation on the 
+       *            "visiting tool" (visitor implementation)
+       *            Note: creates a context templated on concrete TAR.
+       */
+      template <class TAR>
+      static inline ReturnType
+      dispatchOp (TAR& target, TOOL& tool)
+        {
+          return Dispatcher<TAR,ToolBase>::instance().forwardCall (target,tool);
+        }
+      
+    public:
+      /** to be defined by the DEFINE_PROCESSABLE_BY macro
+       *  in all classes wanting to be treated by some tool */
+      virtual ReturnType apply (TOOL&) = 0;
+    };
+    
 
-/** mark a Visitable subclass as actually treatable by some
+/** mark a Visitable subclass as actually treat-able by some
  * "visiting tool" base interface. Defines the apply-function,
  *  which is the actual access point to invoke the visiting
  */
 #define DEFINE_PROCESSABLE_BY(TOOL) \
         virtual ReturnType  apply (TOOL& tool) \
         { return dispatchOp (*this, tool); }
-    
-    
-    
-  } // namespace visitor
-
-} // namespace lumiera
+  
+  
+  
+}} // namespace lumiera::visitor
 #endif
diff --git a/src/lib/visitordispatcher.hpp b/src/lib/visitordispatcher.hpp
deleted file mode 100644
index 0eae85168..000000000
--- a/src/lib/visitordispatcher.hpp
+++ /dev/null
@@ -1,219 +0,0 @@
-/*
-  VISITORDISPATCHER.hpp  -  visitor implementation details
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-*/
-
-
-
-#ifndef LUMIERA_VISITORDISPATCHER_H
-#define LUMIERA_VISITORDISPATCHER_H
-
-#include "lib/error.hpp"
-#include "lib/util.hpp"
-#include "lib/sync-classlock.hpp"
-#include "lib/singleton.hpp"
-#include "lib/util.hpp"
-
-#include <vector>
-
-
-namespace lumiera {
-  namespace visitor {
-    
-    using lib::ClassLock;
-    
-    
-    template<class TOOL> class Tag;
-    
-    
-    template<class TOOL, class TOOLImpl>
-    struct TagTypeRegistry 
-      {
-        static Tag<TOOL> tag;
-      };
-      
-    /**
-     * Type tag for concrete visiting tool classes.
-     * Used to access the previously registered dispatcher 
-     * trampoline function when handling a visitor invocation.
-     */
-    template<class TOOL>
-    class Tag
-    {
-      size_t tagID; ///< tag value
-      static size_t lastRegisteredID;
-      
-    private:
-      static void
-      generateID (size_t& id)
-        {
-          ClassLock<Tag> guard();
-          if (!id)
-            id = ++lastRegisteredID;
-        }
-      
-    public:
-      Tag() : tagID(0) { }
-      operator size_t()  const { return tagID; }
-      
-      
-      template<class TOOLImpl>
-      static Tag&
-      get (TOOLImpl* const =0)
-        {
-          Tag& t = TagTypeRegistry<TOOL,TOOLImpl>::tag;
-          if (!t) generateID (t.tagID);
-          return t;
-        }
-    
-    };
-    
-    
-    
-    /** storage for the Tag registry for each concrete tool */
-    template<class TOOL, class TOOLImpl>
-    Tag<TOOL> TagTypeRegistry<TOOL,TOOLImpl>::tag; 
-    
-    template<class TOOL>
-    size_t Tag<TOOL>::lastRegisteredID (0);
-    
-    
-    
-    
-    
-    
-    
-    
-    /**
-     * For each possible call entry point via some subclass of the visitable hierarchy,
-     * we maintain a dispatcher table to keep track of all concrete tool implementations
-     * able to receive and process calls on objects of this subclass.
-     * @param TAR the concrete target (subclass) type within the visitable hierarchy
-     * @param TOOL the overall tool family (base class of all concrete tools)
-     */
-    template<class TAR, class TOOL>
-    class Dispatcher
-      {
-        typedef typename TOOL::ReturnType ReturnType;
-        
-        /** generator for Trampoline functions,
-         *  used to dispatch calls down to the 
-         *  right "treat"-Function on the correct
-         *  concrete tool implementation class
-         */
-        template<class TOOLImpl>
-        static ReturnType 
-        callTrampoline (TAR& obj, TOOL& tool)
-          {
-            // cast down to real implementation type
-            REQUIRE (INSTANCEOF (TOOLImpl, &tool));  
-            TOOLImpl& toolObj = static_cast<TOOLImpl&> (tool);
-            
-            // trigger (compile time) overload resolution
-            // based on concrete type, then dispatch the call.
-            // Note this may cause obj to be upcasted.
-            return toolObj.treat (obj);
-          }
-        
-        typedef ReturnType (*Trampoline) (TAR&, TOOL& );
-        
-        
-        /** VTable for storing the Trampoline pointers */
-        std::vector<Trampoline> table_;
-        
-        
-        void
-        accomodate (size_t index)
-          {
-            ClassLock<Dispatcher> guard();  // note: this lock is also used for the singleton!
-            if (index > table_.size())
-              table_.resize (index);      // performance bottleneck?? TODO: measure the real impact!
-          }
-        
-        inline bool
-        is_known (size_t id)
-          { 
-            return id<=table_.size() && table_[id-1]; 
-          }
-        
-        inline void 
-        storePtr (size_t id, Trampoline func)
-          {
-            REQUIRE (func);
-            REQUIRE (0 < id);
-            if (id>table_.size())
-              accomodate (id);
-            table_[id-1] = func;
-          }
-        
-        inline Trampoline 
-        storedTrampoline (size_t id)
-          {
-            if (id<=table_.size() && table_[id-1])
-              return table_[id-1];
-            else
-              return &errorHandler;
-          }
-        
-        static ReturnType
-        errorHandler (TAR& target, TOOL& tool)
-          {
-            return tool.onUnknown (target);
-          }
-        
-        
-      public:
-        static Singleton<Dispatcher<TAR,TOOL> > instance;
-        
-        inline ReturnType 
-        forwardCall (TAR& target, TOOL& tool)
-          {
-            // get concrete type via tool's VTable 
-            Tag<TOOL> index = tool.getTag();
-            return (*storedTrampoline(index)) (target, tool);
-          }
-        
-        template<class TOOLImpl>
-        inline void 
-        enroll(TOOLImpl* typeref)
-          {
-            Tag<TOOL>& index = Tag<TOOL>::get (typeref);
-            if (is_known (index))
-              return;
-            else
-              {
-                Trampoline func = &callTrampoline<TOOLImpl>;
-                storePtr (index, func);
-              }
-              
-          }
-      };
-    
-    /** storage for the dispatcher table(s) */
-    template<class TAR, class TOOL>
-    Singleton<Dispatcher<TAR,TOOL> > Dispatcher<TAR,TOOL>::instance;
-    
-    
-    
-    
-  } // namespace visitor
-
-} // namespace lumiera
-#endif
diff --git a/src/pre.hpp b/src/pre.hpp
index d1495d952..6b12ea67f 100644
--- a/src/pre.hpp
+++ b/src/pre.hpp
@@ -41,9 +41,8 @@
 #include <vector>
 #include <map>
 #include <tr1/memory>
-#include <boost/function.hpp>
+#include <tr1/functional>
 #include <boost/format.hpp>
-#include <boost/bind.hpp>
 
 #include "proc/common.hpp"
 
diff --git a/src/pre_a.hpp b/src/pre_a.hpp
index 2d032c03c..1bac10969 100644
--- a/src/pre_a.hpp
+++ b/src/pre_a.hpp
@@ -38,9 +38,8 @@
 #include <vector>
 #include <map>
 #include <tr1/memory>
-#include <boost/function.hpp>
+#include <tr1/functional>
 #include <boost/format.hpp>
-#include <boost/bind.hpp>
 
 #include "proc/common.hpp"
 #include "proc/asset.hpp"
diff --git a/src/proc/asset.cpp b/src/proc/asset.cpp
index 8da1f0eb8..77fe6ace6 100644
--- a/src/proc/asset.cpp
+++ b/src/proc/asset.cpp
@@ -25,14 +25,14 @@
 #include "proc/assetmanager.hpp"
 #include "lib/util.hpp"
 
-#include <boost/function.hpp>
 #include <boost/format.hpp>
-#include <boost/bind.hpp>
+#include <tr1/functional>
 
 
-using boost::bind;
+using std::tr1::function;
+using std::tr1::placeholders::_1;
+using std::tr1::bind;
 using boost::format;
-using boost::function;
 using util::contains;
 using util::removeall;
 using util::for_each;
@@ -44,13 +44,13 @@ namespace asset {
   
   using ::NOBUG_FLAG(memory);
   NOBUG_CPP_DEFINE_FLAG_PARENT(assetmem,  memory);
-
-
+  
+  
   Asset::Ident::Ident(const string& n, const Category& cat, const string& o, const uint ver) 
-    :   name(util::sanitize (n)), 
+    :   name(util::sanitise (n)), 
         category(cat), org(o), version(ver)
   { }
-
+  
   
   /** Asset is a Interface class; usually, objects of 
    *  concrete subclasses are created via specialized Factories
@@ -147,7 +147,7 @@ namespace asset {
   void 
   Asset::unlink ()
   {
-    function<void(PAsset&)> forget_me = bind(&Asset::unregister, this,_1);
+    function<void(PAsset&)> forget_me = bind(&Asset::unregister, this, _1);
     
     for_each (parents, forget_me);
     dependants.clear();
diff --git a/src/proc/asset/clip.cpp b/src/proc/asset/clip.cpp
index ddaa5a22a..b5052a718 100644
--- a/src/proc/asset/clip.cpp
+++ b/src/proc/asset/clip.cpp
@@ -41,7 +41,7 @@ namespace asset
       const Asset::Ident
       createClipIdent (const Media& mediaref)
         {
-          string name (mediaref.ident.name + "-clip");  // TODO something sensible here; append number, sanitize etc.
+          string name (mediaref.ident.name + "-clip");  // TODO something sensible here; append number, sanitise etc.
           Category category (mediaref.ident.category);
           category.setPath(CLIP_SUBFOLDER);
           return Asset::Ident (name, category, 
diff --git a/src/proc/asset/media.cpp b/src/proc/asset/media.cpp
index e8c6ac12b..198e8ed2e 100644
--- a/src/proc/asset/media.cpp
+++ b/src/proc/asset/media.cpp
@@ -50,7 +50,7 @@ namespace asset
   namespace // Implementation details
   {
     /** helper: extract a name token out of a given path/filename
-     *  @return sanitized token based on the name (minus extension),
+     *  @return sanitised token based on the name (minus extension),
      *          empty string if not the common filename pattern.
      */
     string extractName (const string& path)
@@ -59,7 +59,7 @@ namespace asset
       smatch match;
       
       if (regex_search (path, match, pathname_pattern))
-        return util::sanitize (string (match[1]));
+        return util::sanitise (string (match[1]));
       else
         return "";
     }
diff --git a/src/proc/asset/preview.cpp b/src/proc/asset/preview.cpp
index 2753f8cc9..82247149e 100644
--- a/src/proc/asset/preview.cpp
+++ b/src/proc/asset/preview.cpp
@@ -37,7 +37,7 @@ namespace asset
       const Asset::Ident
       createProxyIdent (const Asset::Ident& mediaref)
         {
-          string name (mediaref.name + "-proxy");  // TODO something sensible here; append number, sanitize etc.
+          string name (mediaref.name + "-proxy");  // TODO something sensible here; append number, sanitise etc.
           Category category (mediaref.category);
           TODO ("put it in another subfolder within the same category??");
           return Asset::Ident (name, category, 
diff --git a/src/proc/assetmanager.cpp b/src/proc/assetmanager.cpp
index 6c46e9b6a..e8fd45352 100644
--- a/src/proc/assetmanager.cpp
+++ b/src/proc/assetmanager.cpp
@@ -27,15 +27,13 @@
 #include "lib/sync.hpp"
 #include "lib/util.hpp"
 
-#include <boost/function.hpp>
-
+#include <tr1/functional>
 #include <boost/format.hpp>
-#include <boost/bind.hpp>
 
 using std::tr1::static_pointer_cast;
-using boost::function;
+using std::tr1::function;
+using std::tr1::placeholders::_1;
 using boost::format;
-using boost::bind;
 using util::for_each;
 
 using lumiera::Singleton;
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index d3c37860e..7f3fb056a 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -48,6 +48,7 @@
 #include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
+#include "lib/opaque-holder.hpp"
 
 //#include <tr1/memory>
 //#include <boost/scoped_ptr.hpp>
@@ -67,6 +68,8 @@ namespace control {
 //  using std::ostream;
   using boost::noncopyable;
   using std::string;
+  using lib::InPlaceBuffer;
+  
   
   namespace { // empty state marker objects for ArgumentHolder
     
@@ -118,38 +121,49 @@ namespace control {
                                 , ArgumentHolder<SIG,MEM>  // target class providing the implementation
                                 , CmdClosure               // base class to inherit from
                                 > 
-    , noncopyable
+    , private noncopyable
     {
-      Closure<SIG> arguments_;
-      MementoTie<SIG,MEM> memento_;
       
-      typedef typename Closure<SIG>::ArgTuple ArgTuple;
+      typedef Closure<SIG>        ArgHolder;
+      typedef MementoTie<SIG,MEM> MemHolder;
+      
+      typedef InPlaceBuffer<ArgHolder, sizeof(ArgHolder), MissingArguments<SIG> > ArgumentBuff;
+      typedef InPlaceBuffer<MemHolder, sizeof(MemHolder), UntiedMemento<SIG,MEM> > MementoBuff;
+      
+      typedef typename ArgHolder::ArgTuple ArgTuple;
       
       
-      /* === proxied CmdClosure interface === */
+      /* ====== in-place storage buffers ====== */
+      
+      ArgumentBuff arguments_;
+      MementoBuff  memento_;
+      
+      
+      
+      /* ==== proxied CmdClosure interface ==== */
       
       virtual bool isValid ()  const
         {
-          return bool(arguments_);
+          return arguments_->isValid();
         }
       
       
       virtual CmdFunctor bindArguments (CmdFunctor& func)
         {
-          if (!arguments_)
+          if (!isValid())
             throw lumiera::error::State ("Lifecycle error: can't bind functor, "
                                          "command arguments not yet provided",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          return arguments_.bindArguments(func);
+          return arguments_->bindArguments(func);
         }
       
       
       virtual operator string()  const
         {
           return "Command-State{ arguments="
-               + (arguments_? string(arguments_) : "unbound")
-               + (memento_  ?    ", <memento> }" : "<no undo> }")
+               + (*arguments_? string(*arguments_) : "unbound")
+               + (*memento_  ?     ", <memento> }" : "·noUNDO·}")
                ;
         }
       
@@ -161,13 +175,13 @@ namespace control {
        *  whereas the undo functions will be wired by #tie
        */
       ArgumentHolder ()
-        : arguments_(MissingArguments<SIG>() )
-        , memento_(UntiedMemento<SIG,MEM>() )
+        : arguments_()
+        , memento_()
         { }
       
       /** has undo state capturing been invoked? */
-      bool canUndo () const { return bool(memento_); }
-      bool empty ()   const { return !arguments_; }
+      bool canUndo () const { return memento_->isValid();   }
+      bool empty ()   const { return !arguments_->isValid(); }
       
       
       /** store a new argument tuple within this ArgumentHolder,
@@ -175,7 +189,7 @@ namespace control {
       void
       bindArg (ArgTuple argTup)
         {
-          this->arguments_ = Closure<SIG> (argTup);
+          arguments_.template create<ArgHolder> (argTup);
         }
       
       
@@ -186,11 +200,21 @@ namespace control {
        *  @note any bound undo/capture functions based on the previously held MementoTie
        *        are silently invalidated; using them will likely cause memory corruption! */
       MementoTie<SIG,MEM>&
-      tie (function<SIG_undo> const& undoFunc,
+      tiesi (function<SIG_undo> const& undoFunc,
            function<SIG_cap> const& captureFunc)
         {
-          return this->memento_ = MementoTie<SIG,MEM> (undoFunc,captureFunc);
+          return memento_.template create<MemHolder> (undoFunc,captureFunc);
         }
+
+      /** @may be called directly referencing an function */
+      MementoTie<SIG,MEM>&
+      tie (SIG_undo& undoFunc, SIG_cap& captureFunc)
+        {
+          return tiesi ( function<SIG_undo>(undoFunc)
+                     , function<SIG_cap>(captureFunc)
+                     );
+        }
+           
       
       
       /** direct "backdoor" access to stored memento value.
@@ -198,7 +222,7 @@ namespace control {
       MEM&
       memento ()
         {
-          return memento_.getState();
+          return memento_->getState();
         }
       
     };
diff --git a/src/proc/engine/nodewiringconfig.hpp b/src/proc/engine/nodewiringconfig.hpp
index 29bb9504a..56a7d1618 100644
--- a/src/proc/engine/nodewiringconfig.hpp
+++ b/src/proc/engine/nodewiringconfig.hpp
@@ -21,7 +21,7 @@
 */
 
 /** @file nodewiringconfig.hpp
- ** Sometimes we need to coose a different implementation for dealing with
+ ** Sometimes we need to choose a different implementation for dealing with
  ** some special cases. While for simple cases, just testing a flag or using a
  ** switch statement will do the job, matters get more difficult when we have to
  ** employ a completely different execution path for each of the different cases,
@@ -29,14 +29,14 @@
  ** \par
  ** In the Lumiera render engine, right on the critical path, we need some glue code
  ** for invoking the predecessor nodes when pulling a given processing node. The actual
- ** sequence is quite dependant on the specific situation each node is wired up, regarding
+ ** sequence is quite dependent on the specific situation each node is wired up, regarding
  ** buffer allocation, cache querying and the possible support for GPU processing and 
  ** render farms. The solution is to define specialisations of a Strategy template
  ** using the specific configuration as template argument. Based on these, we can 
  ** create a collection of factories, which in turn will build the internal wiring
  ** for the individual ProcNode instances in accordance to the situation determined
  ** for this node, expressed as a set of flags. As a net result, each node has an 
- ** indivudual configuration (as opposed to creating a lot of hand-written individual
+ ** individual configuration (as opposed to creating a lot of hand-written individual
  ** ProcNode subclasses), but parts of this configuration assembly is done already at
  ** compile time, allowing for additional checks by typing and for possible optimisation.
  ** 
@@ -54,7 +54,7 @@
 #include "lib/util.hpp"
 #include "lib/meta/configflags.hpp"
 
-#include <boost/function.hpp>
+#include <tr1/functional>
 #include <bitset>
 #include <map>
 
@@ -95,9 +95,9 @@ namespace engine {
      * configuration. The intention is to to drive this selection by
      * the use of template metaprogramming for extracting all
      * currently defined StateProxy object configurations.
-     * @todo as the facories live only within the enclosed table (map)
+     * @todo as the factories live only within the enclosed table (map)
      *       we could allocate them in-place. Unfortunately this is 
-     *       non-trivial, because the stl containers employ
+     *       non-trivial, because the STL containers employ
      *       value semantics and thus do a copy even on insert.
      *       Thus, for now we use a shared_ptr to hold the factory
      *       heap allocated.
@@ -108,7 +108,7 @@ namespace engine {
             >
     class ConfigSelector
       {
-        typedef boost::function<FUNC> FacFunction;
+        typedef std::tr1::function<FUNC> FacFunction;
         
         template<class FAC>
         struct FactoryHolder 
diff --git a/tests/components/proc/asset/assetdiagnostics.hpp b/tests/components/proc/asset/asset-diagnostics.hpp
similarity index 85%
rename from tests/components/proc/asset/assetdiagnostics.hpp
rename to tests/components/proc/asset/asset-diagnostics.hpp
index 326da5e8d..ef135f560 100644
--- a/tests/components/proc/asset/assetdiagnostics.hpp
+++ b/tests/components/proc/asset/asset-diagnostics.hpp
@@ -1,5 +1,5 @@
 /*
-  ASSETDIAGNOSTICS.hpp  -  collection of test and debug helpers
+  ASSET-DIAGNOSTICS.hpp  -  collection of test and debug helpers
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -20,8 +20,8 @@
  
 */
 
-/** @file assetdiagnostics.hpp
- ** Small helper and diagnosic functions related to Asset and AssetManager
+/** @file asset-diagnostics.hpp
+ ** Small helper and diagnostic functions related to Asset and AssetManager
  ** 
  ** @see assetmanager.hpp
  ** @see CreateAsset_test
@@ -29,21 +29,22 @@
  */
 
 
-#ifndef ASSET_ASSETDIAGNOSTICS_H
-#define ASSET_ASSETDIAGNOSTICS_H
+#ifndef ASSET_ASSET_DIAGNOSTICS_H
+#define ASSET_ASSET_DIAGNOSTICS_H
 
 
 #include "proc/assetmanager.hpp"
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
-#include <boost/bind.hpp>
+#include <tr1/functional>
 #include <iostream>
 
 using util::contains;
 using util::for_each;
+using std::tr1::placeholders::_1;
+using std::tr1::bind;
 using boost::format;
-using boost::bind;
 using std::string;
 using std::cout;
 
diff --git a/tests/components/proc/asset/basicpipetest.cpp b/tests/components/proc/asset/basicpipetest.cpp
index 132502a42..616d100e1 100644
--- a/tests/components/proc/asset/basicpipetest.cpp
+++ b/tests/components/proc/asset/basicpipetest.cpp
@@ -30,7 +30,7 @@
 #include "lib/query.hpp"
 #include "proc/assetmanager.hpp"
 #include "proc/mobject/session.hpp"
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 #include <boost/format.hpp>
 #include <iostream>
diff --git a/tests/components/proc/asset/compoundmediatest.cpp b/tests/components/proc/asset/compoundmediatest.cpp
index e6e045895..d3a2324f8 100644
--- a/tests/components/proc/asset/compoundmediatest.cpp
+++ b/tests/components/proc/asset/compoundmediatest.cpp
@@ -29,7 +29,7 @@
 #include "proc/asset/media.hpp"
 #include "proc/asset/proc.hpp"
 
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 using util::isnil;
 using std::string;
diff --git a/tests/components/proc/asset/createassettest.cpp b/tests/components/proc/asset/createassettest.cpp
index c2eb633f8..70b0fa808 100644
--- a/tests/components/proc/asset/createassettest.cpp
+++ b/tests/components/proc/asset/createassettest.cpp
@@ -29,7 +29,7 @@
 #include "proc/asset/media.hpp"
 #include "proc/asset/proc.hpp"
 
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 using util::isnil;
 using std::string;
diff --git a/tests/components/proc/asset/dependent-assets-test.cpp b/tests/components/proc/asset/dependent-assets-test.cpp
index 8900592cf..e2234602d 100644
--- a/tests/components/proc/asset/dependent-assets-test.cpp
+++ b/tests/components/proc/asset/dependent-assets-test.cpp
@@ -23,7 +23,7 @@
 
 #include "lib/test/run.hpp"
 #include "proc/asset/testasset.hpp"
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 #include "proc/asset/media.hpp"
 #include "proc/asset/clip.hpp"
 #include "lib/util.hpp"
diff --git a/tests/components/proc/asset/identityofassetstest.cpp b/tests/components/proc/asset/identityofassetstest.cpp
index 98ba41e84..d2fb11911 100644
--- a/tests/components/proc/asset/identityofassetstest.cpp
+++ b/tests/components/proc/asset/identityofassetstest.cpp
@@ -29,7 +29,7 @@
 #include "proc/asset/media.hpp"
 #include "proc/asset/proc.hpp"
 
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 using util::isnil;
 using std::string;
diff --git a/tests/components/proc/asset/makecliptest.cpp b/tests/components/proc/asset/makecliptest.cpp
index 0da91b126..7f9d0581c 100644
--- a/tests/components/proc/asset/makecliptest.cpp
+++ b/tests/components/proc/asset/makecliptest.cpp
@@ -28,7 +28,7 @@
 #include "proc/assetmanager.hpp"
 #include "proc/asset/media.hpp"
 #include "proc/mobject/session/clip.hpp"
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 using util::contains;
 using util::isnil;
diff --git a/tests/components/proc/asset/mediastructurequerytest.cpp b/tests/components/proc/asset/mediastructurequerytest.cpp
index c19ff7a91..2f5a58c53 100644
--- a/tests/components/proc/asset/mediastructurequerytest.cpp
+++ b/tests/components/proc/asset/mediastructurequerytest.cpp
@@ -28,7 +28,7 @@
 #include "proc/asset/media.hpp"
 #include "proc/asset/proc.hpp"
 
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 using util::isnil;
 using std::string;
diff --git a/tests/components/proc/asset/orderingofassetstest.cpp b/tests/components/proc/asset/orderingofassetstest.cpp
index b3c9a726f..d87b00d3b 100644
--- a/tests/components/proc/asset/orderingofassetstest.cpp
+++ b/tests/components/proc/asset/orderingofassetstest.cpp
@@ -28,7 +28,7 @@
 #include "proc/asset/media.hpp"
 #include "proc/asset/proc.hpp"
 
-#include "proc/asset/assetdiagnostics.hpp"
+#include "proc/asset/asset-diagnostics.hpp"
 
 using util::isnil;
 using std::string;
diff --git a/tests/components/proc/mobject/session/rebuildfixturetest.cpp b/tests/components/proc/mobject/session/rebuildfixturetest.cpp
index 8a0612a0b..ae287786c 100644
--- a/tests/components/proc/mobject/session/rebuildfixturetest.cpp
+++ b/tests/components/proc/mobject/session/rebuildfixturetest.cpp
@@ -28,11 +28,11 @@
 #include "lib/util.hpp"
 
 //#include <boost/format.hpp>
-#include <boost/bind.hpp>
+#include <tr1/functional>
 #include <iostream>
 
 //using boost::format;
-using boost::bind;
+using std::tr1::bind;
 using util::contains; 
 using util::for_each; 
 using std::string;
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 25e794d0f..429abef00 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -59,14 +59,14 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/meta/config-flags-test.cpp      	\
 	$(testlib_srcdir)/query/queryutilstest.cpp		\
 	$(testlib_srcdir)/removefromsettest.cpp			\
-	$(testlib_srcdir)/sanitizedidentifiertest.cpp		\
+	$(testlib_srcdir)/sanitised-identifier-test.cpp		\
 	$(testlib_srcdir)/opaque-unchecked-buffer-test.cpp	\
 	$(testlib_srcdir)/opaque-holder-test.cpp		\
 	$(testlib_srcdir)/scoped-holder-test.cpp		\
 	$(testlib_srcdir)/scopedholdertransfertest.cpp		\
 	$(testlib_srcdir)/scoped-ptrvect-test.cpp		\
-	$(testlib_srcdir)/singletonsubclasstest.cpp		\
-	$(testlib_srcdir)/singletontest.cpp			\
+	$(testlib_srcdir)/singleton-subclass-test.cpp		\
+	$(testlib_srcdir)/singleton-test.cpp			\
 	$(testlib_srcdir)/singletontestmocktest.cpp		\
 	$(testlib_srcdir)/streamtypebasicstest.cpp		\
 	$(testlib_srcdir)/streamtypelifecycletest.cpp		\
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 4c0922e2e..3320dcc72 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -39,6 +39,8 @@ namespace typelist{
 namespace test {
   
   using std::tr1::function;
+  using std::tr1::placeholders::_1;
+  using std::tr1::placeholders::_2;
   using std::tr1::bind;
   
   
diff --git a/tests/lib/query/queryutilstest.cpp b/tests/lib/query/queryutilstest.cpp
index b46447b7c..f7691edf0 100644
--- a/tests/lib/query/queryutilstest.cpp
+++ b/tests/lib/query/queryutilstest.cpp
@@ -28,7 +28,7 @@
 #include "lib/query.hpp"
 #include "query/querydiagnostics.hpp"
 
-#include <boost/bind.hpp>
+#include <tr1/functional>
 #include <iostream>
 #include <cstdlib>
 
@@ -38,7 +38,8 @@ using util::isnil;
 using util::contains;
 using util::for_each;
 
-using boost::bind;
+using std::tr1::placeholders::_1;
+using std::tr1::bind;
 using std::string;
 using std::cout;
 
diff --git a/tests/lib/sanitizedidentifiertest.cpp b/tests/lib/sanitised-identifier-test.cpp
similarity index 54%
rename from tests/lib/sanitizedidentifiertest.cpp
rename to tests/lib/sanitised-identifier-test.cpp
index 058807661..7913795f1 100644
--- a/tests/lib/sanitizedidentifiertest.cpp
+++ b/tests/lib/sanitised-identifier-test.cpp
@@ -30,38 +30,34 @@ using std::cout;
 
 
 
-namespace util
-  {
-  namespace test
-    {
-    
+namespace util {
+namespace test {
   
-    class SanitizedIdentifier_test : public Test
-      {
-        virtual void run (Arg)
-          {
-            print_clean ("Word");
-            print_clean ("a Sentence");
-            print_clean ("trailing Withespace\n       \t");
-            print_clean ("with    a  \t lot\n  of Whitespace");
-            print_clean ("with\"much (punctuation)[]!");
-            print_clean ("§&Ω%€  leading garbage");
-            print_clean ("mixed    Ω   garbage");
-            print_clean ("Bääääh!!");
-            print_clean ("§&Ω%€");
-          }
-        
-        /** @test print the original and the sanitized string */
-        void print_clean (const string org)
+  
+  class SanitizedIdentifier_test : public Test
+    {
+      virtual void run (Arg)
         {
-          cout << "'" << org << "' --> '" << sanitize(org) << "'\n";
+          print_clean ("Word");
+          print_clean ("a Sentence");
+          print_clean ("trailing Withespace\n       \t");
+          print_clean ("with    a  \t lot\n  of Whitespace");
+          print_clean ("with\"much (punctuation)[]!");
+          print_clean ("§&Ω%€  leading garbage");
+          print_clean ("mixed    Ω   garbage");
+          print_clean ("Bääääh!!");
+          print_clean ("§&Ω%€");
         }
-      };
-    
-      LAUNCHER (SanitizedIdentifier_test, "unit common");
-
       
-  } // namespace test
-    
-} // namespace util
+      /** @test print the original and the sanitised string */
+      void print_clean (const string org)
+      {
+        cout << "'" << org << "' --> '" << sanitise(org) << "'\n";
+      }
+    };
+  
+  LAUNCHER (SanitizedIdentifier_test, "unit common");
+  
+  
+}} // namespace util::test
 
diff --git a/tests/lib/singleton-subclass-test.cpp b/tests/lib/singleton-subclass-test.cpp
new file mode 100644
index 000000000..3a925b70e
--- /dev/null
+++ b/tests/lib/singleton-subclass-test.cpp
@@ -0,0 +1,162 @@
+/*
+  SingletonSubclass(Test)  -  actually creating a subclass of the Singleton Type
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+
+#include "testtargetobj.hpp"
+#include "lib/singletonsubclass.hpp"
+
+#include <boost/lexical_cast.hpp>
+#include <boost/format.hpp>
+#include <iostream>
+
+using boost::lexical_cast;
+using boost::format;
+using util::isnil;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace test    {
+  
+  
+  /**
+   * Target object to be instantiated as Singleton
+   * Allocates a variable amount of additional heap memory
+   * and prints diagnostic messages.
+   */
+  class Interface : public TestTargetObj
+    {
+    public:
+      static int cnt;
+      static void setCountParam (uint c) { Interface::cnt = c; }
+      
+      virtual string identify()          { return "Interface"; }
+      
+    protected:
+      Interface () : TestTargetObj(cnt) {}
+      virtual ~Interface() {}
+      
+      friend class singleton::StaticCreate<Interface>;
+      friend class singleton::HeapCreate<Interface>;
+    };
+  
+  int Interface::cnt = 0;
+  
+  
+  class Impl : public Interface
+    {
+    public:
+      virtual string identify() { return "Implementation"; }
+    };
+  
+  
+  // for checking the safety.....
+  class Impl_XXX : public Impl { };
+  class Unrelated { };
+  
+  
+  
+  
+  /*******************************************************************
+   * @test specialised variant of the Singleton Factory, for creating
+   *       subclasses (implementation classes) without coupling the 
+   *       caller to the concrete class type.
+   * Expected results: an instance of the subclass is created.
+   * @see  lumiera::Singleton
+   * @see  lumiera::SingletonSubclassFactory
+   * @see  lumiera::singleton::Adapter
+   */
+  class SingletonSubclass_test : public Test
+    {
+      
+      virtual void run(Arg arg) 
+        {
+          uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
+          
+          cout << format("using the Singleton should create TargetObj(%d)...\n") % num;
+          
+          Interface::setCountParam(num);
+          
+          // marker to declare the concrete type to be created
+          singleton::UseSubclass<Impl> typeinfo;                       
+          
+          // define an instance of the Singleton factory,
+          // Specialised to create the concrete Type passed in
+          SingletonSubclassFactory<Interface> instance (typeinfo);
+          
+          // Now use the Singleton factory...
+          // Note: we get the Base type
+          Interface& t1 = instance();
+          Interface& t2 = instance();
+          
+          ASSERT ( &t1 == &t2, "not a Singleton, got two different instances." ); 
+          
+          cout << "calling a non-static method on the Singleton-" 
+               << t1.identify() << "\n"
+               << string (t1)   << "\n";
+          
+///////////////////////////////////////////////////////////////////////////////TODO: find a way to configure NoBug to throw in case of assertion
+///////////////////////////////////////////////////////////////////////////////TODO: just for the proc tests. Also find a better way to configure
+///////////////////////////////////////////////////////////////////////////////TODO: the non-release check. Then re-enable these checks...
+//#ifdef DEBUG
+//        verify_error_detection ();
+//#endif
+        } 
+      
+      
+      
+      void verify_error_detection ()
+        {
+          
+          singleton::UseSubclass<Impl_XXX> more_special_type;                       
+          
+          try
+            {
+              SingletonSubclassFactory<Interface> instance (more_special_type);
+              cout << "was able to re-configure the SingletonSubclassFactory "
+                      "with another type. This should be detected in debug mode\n";
+            }
+          catch (...)
+            {
+              ASSERT (lumiera_error () == error::LUMIERA_ERROR_ASSERTION);
+            }
+          
+          
+          // Note: the following won't compile, because the "subclass" isn't a subclass...
+          //
+          // singleton::UseSubclass<Unrelated> yet_another_type;                       
+          // SingletonSubclassFactory<Interface> instance (yet_another_type);
+        }
+    };
+  
+  
+  
+  /** Register this test class... */
+  LAUNCHER (SingletonSubclass_test, "unit common");
+  
+  
+  
+}} // namespace lumiera::test
diff --git a/tests/lib/singleton-test.cpp b/tests/lib/singleton-test.cpp
new file mode 100644
index 000000000..a5a6fdd3f
--- /dev/null
+++ b/tests/lib/singleton-test.cpp
@@ -0,0 +1,137 @@
+/*
+  Singleton(Test)  -  unittest for our Singleton template
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+
+#include "testtargetobj.hpp"
+#include "lib/singleton.hpp"
+
+#include <tr1/functional>
+#include <boost/lexical_cast.hpp>
+#include <boost/format.hpp>
+#include <iostream>
+
+using std::tr1::function;
+using boost::lexical_cast;
+using boost::format;
+using util::isnil;
+using std::string;
+using std::cout;
+
+
+namespace lumiera {
+namespace test    {
+  
+  
+  /**
+   * Target object to be instantiated as Singleton
+   * Allocates a variable amount of additional heap memory
+   * and prints diagnostic messages.
+   */
+  class TargetObj : public TestTargetObj
+    {
+    public:
+      static int cnt;
+      static void setCountParam (uint c) { TargetObj::cnt = c; }
+    protected:
+      TargetObj () : TestTargetObj(cnt) {}
+      
+      friend class singleton::StaticCreate<TargetObj>;
+      friend class singleton::HeapCreate<TargetObj>;
+    };
+  
+  int TargetObj::cnt = 0;
+  
+  
+  
+  
+  
+  
+  
+  /*******************************************************************
+   * @test implement a Singleton class using our Singleton Template.
+   * Expected results: no memory leaks.
+   * @see  lumiera::Singleton
+   * @see  lumiera::singleton::StaticCreate
+   * @see  lumiera::singleton::HeapCreate
+   */
+  class Singleton_test : public Test
+    {
+      typedef function<TargetObj& ()> InstanceAccessFunc;
+      InstanceAccessFunc instance;
+      
+      virtual void run(Arg arg)
+        {
+          uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
+          
+          testStaticallyAllocatedSingleton (num++);
+          testHeapAllocatedSingleton (num++);
+        }
+      
+      
+      /** @test parametrize the Singleton creation such as to create
+       *        the single TargetObj instance as a static variable.
+       */
+      void testStaticallyAllocatedSingleton (uint num)
+        {
+          SingletonFactory<TargetObj> single;
+          instance = single;
+          useInstance (num, "statically allocated");
+        }
+      
+      /** @test parametrize the Singleton creation such as to create
+       *        the single TargetObj instance allocated on the Heap
+       *        and deleted automatically at application shutdown.
+       */
+      void testHeapAllocatedSingleton (uint num)
+        {
+          SingletonFactory<TargetObj,singleton::HeapCreate> single;
+          instance = single;
+          useInstance (num, "heap allocated");
+        }
+      
+      
+      
+      void useInstance (uint num, string kind)
+        {
+          cout << format("testing TargetObj(%d) as Singleton(%s)\n") % num % kind;
+          TargetObj::setCountParam(num);
+          TargetObj& t1 = instance();
+          TargetObj& t2 = instance();
+          
+          ASSERT ( &t1 == &t2, "not a Singleton, got two different instances." );
+          
+          cout << "calling a non-static method on the Singleton instance\n"
+               << string (t1) << "\n";
+        }
+    };
+  
+  
+  
+  /** Register this test class... */
+  LAUNCHER (Singleton_test, "unit common");
+  
+  
+  
+}} // namespace lumiera::test
diff --git a/tests/lib/singletonsubclasstest.cpp b/tests/lib/singletonsubclasstest.cpp
deleted file mode 100644
index 318ed76e1..000000000
--- a/tests/lib/singletonsubclasstest.cpp
+++ /dev/null
@@ -1,166 +0,0 @@
-/*
-  SingletonSubclass(Test)  -  actually creating a subclass of the Singleton Type
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "lib/test/run.hpp"
-#include "lib/util.hpp"
-
-#include "testtargetobj.hpp"
-#include "lib/singletonsubclass.hpp"
-
-#include <boost/lexical_cast.hpp>
-#include <boost/format.hpp>
-#include <iostream>
-
-using boost::lexical_cast;
-using boost::format;
-using util::isnil;
-using std::string;
-using std::cout;
-
-
-namespace lumiera
-  {
-  namespace test
-    {
-    
-
-    /**
-     * Target object to be instantiated as Singleton
-     * Allocates a variable amount of additional heap memory
-     * and prints diagnostic messages.
-     */
-    class Interface : public TestTargetObj
-      {
-      public:
-        static int cnt;
-        static void setCountParam (uint c) { Interface::cnt = c; }
-        
-        virtual string identify()          { return "Interface"; }
-        
-      protected:
-        Interface () : TestTargetObj(cnt) {}
-        virtual ~Interface() {}
-        
-        friend class singleton::StaticCreate<Interface>;
-        friend class singleton::HeapCreate<Interface>;
-      };
-    
-    int Interface::cnt = 0;
-    
-    
-    class Impl : public Interface
-      {
-      public:
-        virtual string identify() { return "Implementation"; }
-      };
-    
-
-    // for checking the safety.....
-    class Impl_XXX : public Impl { };
-    class Unrelated { };
-    
-    
-    
-    
-    /*******************************************************************
-     * @test specialised variant of the Singleton Factory, for creating
-     *       subclasses (implementation classes) without coupling the 
-     *       caller to the concrete class type.
-     * Expected results: an instance of the subclass is created.
-     * @see  lumiera::Singleton
-     * @see  lumiera::SingletonSubclassFactory
-     * @see  lumiera::singleton::Adapter
-     */
-    class SingletonSubclass_test : public Test
-      {
-        
-        virtual void run(Arg arg) 
-          {
-            uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
-            
-            cout << format("using the Singleton should create TargetObj(%d)...\n") % num;
-            
-            Interface::setCountParam(num);
-            
-            // marker to declare the concrete type to be created
-            singleton::UseSubclass<Impl> typeinfo;                       
-            
-            // define an instance of the Singleton factory,
-            // Specialised to create the concrete Type passed in
-            SingletonSubclassFactory<Interface> instance (typeinfo);
-            
-            // Now use the Singleton factory...
-            // Note: we get the Base type
-            Interface& t1 = instance();
-            Interface& t2 = instance();
-            
-            ASSERT ( &t1 == &t2, "not a Singleton, got two different instances." ); 
-            
-            cout << "calling a non-static method on the Singleton-" 
-                 << t1.identify() << "\n"
-                 << string (t1)   << "\n";
-  
-///////////////////////////////////////////////////////////////////////////////TODO: find a way to configure NoBug to throw in case of assertion            
-///////////////////////////////////////////////////////////////////////////////TODO: just for the proc tests. Also find a better way to configure
-///////////////////////////////////////////////////////////////////////////////TODO: the non-release check. Then re-enable these checks...            
-//#ifdef DEBUG
-//            verify_error_detection ();
-//#endif
-          } 
-        
-        
-        
-        void verify_error_detection ()
-          {
-            
-            singleton::UseSubclass<Impl_XXX> more_special_type;                       
-            
-            try
-              {
-                SingletonSubclassFactory<Interface> instance (more_special_type);
-                cout << "was able to re-configure the SingletonSubclassFactory "
-                        "with another type. This should be detected in debug mode\n";
-              }
-            catch (...)
-              {
-                ASSERT (lumiera_error () == error::LUMIERA_ERROR_ASSERTION);
-              }
-
-            
-            // Note: the following won't compile, because the "subclass" isn't a subclass...
-            //
-            // singleton::UseSubclass<Unrelated> yet_another_type;                       
-            // SingletonSubclassFactory<Interface> instance (yet_another_type);
-          }
-      };
-    
-      
-    
-    /** Register this test class... */
-    LAUNCHER (SingletonSubclass_test, "unit common");
-    
-    
-    
-  } // namespace test
-
-} // namespace lumiera
diff --git a/tests/lib/singletontest.cpp b/tests/lib/singletontest.cpp
deleted file mode 100644
index 88fc923d7..000000000
--- a/tests/lib/singletontest.cpp
+++ /dev/null
@@ -1,139 +0,0 @@
-/*
-  Singleton(Test)  -  unittest for our Singleton template
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "lib/test/run.hpp"
-#include "lib/util.hpp"
-
-#include "testtargetobj.hpp"
-#include "lib/singleton.hpp"
-
-#include <boost/lexical_cast.hpp>
-#include <boost/format.hpp>
-#include <iostream>
-
-using boost::lexical_cast;
-using boost::format;
-using util::isnil;
-using std::string;
-using std::cout;
-
-
-namespace lumiera
-  {
-  namespace test
-    {
-    
-
-    /**
-     * Target object to be instantiated as Singleton
-     * Allocates a variable amount of additional heap memory
-     * and prints diagnostic messages.
-     */
-    class TargetObj : public TestTargetObj
-      {
-      public:
-        static int cnt;
-        static void setCountParam (uint c) { TargetObj::cnt = c; }
-      protected:
-        TargetObj () : TestTargetObj(cnt) {}
-        
-        friend class singleton::StaticCreate<TargetObj>;
-        friend class singleton::HeapCreate<TargetObj>;
-      };
-    
-    int TargetObj::cnt = 0;
-    
-    
-    
-    
-    
-    
-    
-    /*******************************************************************
-     * @test implement a Singleton class using our Singleton Template.
-     * Expected results: no memory leaks.
-     * @see  lumiera::Singleton
-     * @see  lumiera::singleton::StaticCreate
-     * @see  lumiera::singleton::HeapCreate
-     */
-    class Singleton_test : public Test
-      {
-        typedef boost::function<TargetObj& ()> InstanceAccessFunc;
-        InstanceAccessFunc instance;
-        
-        virtual void run(Arg arg) 
-          {
-            uint num= isnil(arg)? 1 : lexical_cast<uint>(arg[1]);
-            
-            testStaticallyAllocatedSingleton (num++);
-            testHeapAllocatedSingleton (num++);
-          }
-
-        
-        /** @test parametrize the Singleton creation such as to create 
-         *        the single TargetObj instance as a static variable. 
-         */
-        void testStaticallyAllocatedSingleton (uint num)
-          {
-            SingletonFactory<TargetObj> single;
-            instance = single;
-            useInstance (num, "statically allocated");
-          }
-        
-        /** @test parametrize the Singleton creation such as to create 
-         *        the single TargetObj instance allocated on the Heap
-         *        and deleted automatically at application shutdown.
-         */
-        void testHeapAllocatedSingleton (uint num)
-          {
-            SingletonFactory<TargetObj,singleton::HeapCreate> single;
-            instance = single;
-            useInstance (num, "heap allocated");
-          }
-        
-        
-        
-        void useInstance (uint num, string kind)
-          {
-            cout << format("testing TargetObj(%d) as Singleton(%s)\n") % num % kind;
-            TargetObj::setCountParam(num);
-            TargetObj& t1 = instance();
-            TargetObj& t2 = instance();
-            
-            ASSERT ( &t1 == &t2, "not a Singleton, got two different instances." ); 
-            
-            cout << "calling a non-static method on the Singleton instance\n" 
-                 << string (t1) << "\n";
-          } 
-      };
-    
-      
-    
-    /** Register this test class... */
-    LAUNCHER (Singleton_test, "unit common");
-    
-    
-    
-  } // namespace test
-
-} // namespace lumiera
diff --git a/tests/lib/streamtypelifecycletest.cpp b/tests/lib/streamtypelifecycletest.cpp
index af646bf1c..9ef328d3d 100644
--- a/tests/lib/streamtypelifecycletest.cpp
+++ b/tests/lib/streamtypelifecycletest.cpp
@@ -50,7 +50,7 @@ namespace lumiera {
         UNIMPLEMENTED ("setup basic dummy-type-info"); 
       }
     
-    namespace // enroll this basic setup to be triggered when the type system is reset 
+    namespace // enrol this basic setup to be triggered when the type system is reset 
       {
         LifecycleHook _schedule_at_reset (ON_STREAMTYPES_RESET, &setup_basicDummyTypeInfo);         
       }
diff --git a/tests/lib/visitingtoolconcept.cpp b/tests/lib/visitingtoolconcept.cpp
index 8508cdb0d..056a103df 100644
--- a/tests/lib/visitingtoolconcept.cpp
+++ b/tests/lib/visitingtoolconcept.cpp
@@ -235,7 +235,7 @@ namespace lumiera
         
         template<class TOOLImpl>
         inline void 
-        enroll(TOOLImpl* typeref)
+        enrol(TOOLImpl* typeref)
           {
             Tag<TOOL>& index = Tag<TOOL>::get (typeref);
             if (is_known (index))
@@ -272,7 +272,7 @@ namespace lumiera
         Applicable ()
           {
             TOOLImpl* typeref = 0;
-            Dispatcher<TAR,ToolBase>::instance().enroll (typeref);
+            Dispatcher<TAR,ToolBase>::instance().enrol (typeref);
           }
         
         virtual ~Applicable () {}

From 5784bd2819604b78a1f7aad868579473b425ce78 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 19 Jul 2009 06:24:36 +0200
Subject: [PATCH 202/368] Fix: use boost::operator! for binding expr. to avoid
 infinite recursion

---
 src/lib/util.cpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/lib/util.cpp b/src/lib/util.cpp
index 5c52cf6ad..f5229fc86 100644
--- a/src/lib/util.cpp
+++ b/src/lib/util.cpp
@@ -25,6 +25,7 @@
 
 #include <boost/algorithm/string.hpp>
 #include <tr1/functional>
+#include <boost/bind.hpp>          // we need operator! for bind-expressions
 
 using boost::algorithm::trim_right_copy_if;
 using boost::algorithm::is_any_of;
@@ -35,7 +36,6 @@ using boost::algorithm::is_space;
 namespace util {
 
   using std::tr1::function;
-  using std::tr1::placeholders::_1;
   
   typedef function<bool(string::value_type)> ChPredicate;
   ChPredicate operator! (ChPredicate p) { return ! bind(p,_1); }

From 7f44de24d7aa1356007cba70930b43062e12a77b Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 19 Jul 2009 08:03:54 +0200
Subject: [PATCH 203/368] collecting some formatting & diagnostics utils
 here...

---
 src/lib/format.hpp               | 96 ++++++++++++++++++++++++++++++++
 src/lib/meta/trait.hpp           | 51 +++++++++++++++++
 tests/40components.tests         | 10 ++++
 tests/lib/Makefile.am            |  1 +
 tests/lib/format-helper-test.cpp | 88 +++++++++++++++++++++++++++++
 5 files changed, 246 insertions(+)
 create mode 100644 src/lib/format.hpp
 create mode 100644 src/lib/meta/trait.hpp
 create mode 100644 tests/lib/format-helper-test.cpp

diff --git a/src/lib/format.hpp b/src/lib/format.hpp
new file mode 100644
index 000000000..db53affcd
--- /dev/null
+++ b/src/lib/format.hpp
@@ -0,0 +1,96 @@
+/*
+  FORMAT.hpp  -  helpers for formatting and diagnostics
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file format.hpp
+ ** Collection of small helpers and convenience shortcuts for diagnostics & formatting.
+ ** 
+ ** @todo we could add a facade to boost::format here, see Ticket #166
+ ** 
+ */
+
+
+#ifndef UTIL_FORMAT_H
+#define UTIL_FORMAT_H
+
+//#include "lib/util.hpp"
+#include "lib/meta/trait.hpp"
+#include "include/symbol.hpp"
+
+#include <string>
+#include <cstring>
+#include <typeinfo>
+#include <boost/utility/enable_if.hpp>
+
+
+
+namespace util {
+  
+  using lumiera::typelist::can_ToString;
+  using lumiera::Symbol;
+  using boost::enable_if;
+  using boost::disable_if;
+  using std::string;
+  
+  
+  namespace { // we need to guard the string conversion
+             //  to avoid a compiler error in case the type isn't convertible....
+    
+    template<typename X>
+    inline string
+    invoke_2string (     typename enable_if< can_ToString<X>,
+                    X >::type const& val)
+    {
+      return string(val);
+    }
+    
+    template<typename X>
+    inline string
+    invoke_2string (     typename disable_if< can_ToString<X>,
+                    X >::type const&)
+    {
+      return "";
+    }
+  }
+  
+  
+  
+  /** try to get an object converted to string */
+  template<typename TY>
+  inline string
+  str ( TY const& val
+      , Symbol prefix=""      ///< prefix to prepend in case conversion is possible
+      , Symbol fallback =0   /// < replacement text to show if string conversion fails
+      )
+    {
+      if (can_ToString<TY>::value)
+        return string(prefix) + invoke_2string<TY>(val);
+      
+      else
+        return fallback? fallback
+                       : string("«")+typeid(val).name()+"»";
+    }
+  
+  
+} // namespace util
+
+#endif /*UTIL_FORMAT_H*/
diff --git a/src/lib/meta/trait.hpp b/src/lib/meta/trait.hpp
new file mode 100644
index 000000000..8e0348e9b
--- /dev/null
+++ b/src/lib/meta/trait.hpp
@@ -0,0 +1,51 @@
+/*
+  TRAIT.hpp  -  type handling and type detection helpers
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef LUMIERA_META_TRAIT_H
+#define LUMIERA_META_TRAIT_H
+
+
+#include "lib/meta/util.hpp"
+
+#include <boost/type_traits/is_convertible.hpp>
+#include <string>
+
+  
+namespace lumiera {
+namespace typelist {
+  
+  /** Trait template for detecting if a type can be converted to string.
+   *  For example, this allows to write specialisations with the help of
+   *  boost::enable_if
+   */
+  template <typename TY>
+  struct can_ToString
+    {
+      enum { value = boost::is_convertible<TY, std::string>::value
+           };
+    };
+  
+  
+  
+}} // namespace lumiera::typelist
+#endif
diff --git a/tests/40components.tests b/tests/40components.tests
index 2dc20a375..2a76eae74 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -234,6 +234,16 @@ out: dtor ~TargetObj\(12\) successful
 END
 
 
+TEST "formatting/diagnostics helpers" FormatHelper_test <<END
+out: Displaying some types....
+out: «..util.test.Reticent.»
+out: <no comment>
+out: ^hey Joe!
+out: ^he says: hey Joe!
+return: 0
+END
+
+
 TEST "functional closure" FunctionClosure_test <<END
 out: List1	:-<1>-<2>-<3>-
 out: List2	:-<5>-<6>-<7>-
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 429abef00..1dae992cf 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -43,6 +43,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/exceptionerrortest.cpp		\
 	$(testlib_srcdir)/factory-special-test.cpp		\
 	$(testlib_srcdir)/factorytest.cpp			\
+	$(testlib_srcdir)/format-helper-test.cpp		\
 	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
diff --git a/tests/lib/format-helper-test.cpp b/tests/lib/format-helper-test.cpp
new file mode 100644
index 000000000..7b35d420a
--- /dev/null
+++ b/tests/lib/format-helper-test.cpp
@@ -0,0 +1,88 @@
+/*
+  FormatHelper(Test)  -  validate formatting and diagnostics helpers
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/format.hpp"
+#include "lib/error.hpp"
+
+#include <iostream>
+
+using std::cout;
+using std::endl;
+
+
+namespace util {
+namespace test {
+  
+  class Reticent 
+    {
+    };
+  
+  class UnReticent
+    : public Reticent 
+    {
+    public:
+      operator string()  const { return "hey Joe!"; }
+    };
+  
+  
+  
+  /*************************************************
+   * verifies the proper working of helper functions
+   * frequently used within the Lumiera testsuite.
+   * @see test-helper.hpp
+   */
+  class FormatHelper_test : public Test
+    {
+      void
+      run (Arg)
+        {
+          check2String();
+        }
+      
+      
+      /** @test verify the maybe-to-string conversion. */
+      void
+      check2String ()
+        {
+          std::cout << "Displaying some types....\n";
+          
+          Reticent closeLipped;
+          UnReticent chatterer;
+          
+          cout << str (closeLipped) << endl;
+          cout << str (closeLipped, "he says: ", "<no comment>") << endl;
+          
+          cout << str (chatterer) << endl;
+          cout << str (chatterer, "he says: ", "<no comment>") << endl;
+        }
+      
+      
+      
+    };
+  
+  LAUNCHER (FormatHelper_test, "unit common");
+  
+  
+}} // namespace util::test
+

From f73c9388504f52d4914e1e91046ef849b78daf4f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 19 Jul 2009 08:32:49 +0200
Subject: [PATCH 204/368] ArgumentHolder reworked to use InPlaceBuffer; now
 passes basic tests

---
 src/lib/meta/function-closure.hpp             |  1 +
 src/proc/control/command-argument-holder.hpp  | 15 +----
 src/proc/control/memento-tie.hpp              | 17 ++++++
 .../proc/control/command-argument-test.cpp    | 60 +++++++++++--------
 4 files changed, 56 insertions(+), 37 deletions(-)

diff --git a/src/lib/meta/function-closure.hpp b/src/lib/meta/function-closure.hpp
index 80173ad74..936534af9 100644
--- a/src/lib/meta/function-closure.hpp
+++ b/src/lib/meta/function-closure.hpp
@@ -587,6 +587,7 @@ namespace func    {
   
   namespace _composed { // repetitive impl.code for function composition
     using std::tr1::bind;
+    using std::tr1::function;
     using std::tr1::placeholders::_1;
     using std::tr1::placeholders::_2;
     using std::tr1::placeholders::_3;
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 7f3fb056a..d148223bb 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -163,7 +163,7 @@ namespace control {
         {
           return "Command-State{ arguments="
                + (*arguments_? string(*arguments_) : "unbound")
-               + (*memento_  ?     ", <memento> }" : "·noUNDO·}")
+               + ", "+string(*memento_)+"}"
                ;
         }
       
@@ -200,21 +200,12 @@ namespace control {
        *  @note any bound undo/capture functions based on the previously held MementoTie
        *        are silently invalidated; using them will likely cause memory corruption! */
       MementoTie<SIG,MEM>&
-      tiesi (function<SIG_undo> const& undoFunc,
+      tie (function<SIG_undo> const& undoFunc,
            function<SIG_cap> const& captureFunc)
         {
           return memento_.template create<MemHolder> (undoFunc,captureFunc);
         }
-
-      /** @may be called directly referencing an function */
-      MementoTie<SIG,MEM>&
-      tie (SIG_undo& undoFunc, SIG_cap& captureFunc)
-        {
-          return tiesi ( function<SIG_undo>(undoFunc)
-                     , function<SIG_cap>(captureFunc)
-                     );
-        }
-           
+      
       
       
       /** direct "backdoor" access to stored memento value.
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index ed4a44380..530c45054 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -43,9 +43,11 @@
 #include "lib/bool-checkable.hpp"
 #include "lib/meta/function-closure.hpp"
 #include "proc/control/command-signature.hpp"
+#include "lib/format.hpp"
 #include "lib/util.hpp"
 
 #include <tr1/functional>
+#include <string>
 
 
 namespace control {
@@ -165,6 +167,21 @@ namespace control {
         {
           return undo_ && capture_ && isCaptured_;
         }
+      
+      
+      operator std::string()  const
+        {
+          if (!undo_ || !capture_)
+            return "·noUNDO·";
+          
+          if (!isCaptured_)
+            return "<mem:missing>";
+          
+          return "<" 
+               + util::str(memento_, "mem: ", "·memento·") 
+               + ">";
+        }
+      
     };
   
   
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index e796d9646..10f54923e 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -43,7 +43,7 @@
 #include <boost/format.hpp>
 #include <iostream>
 #include <sstream>
-//#include <cstdlib>
+#include <cstdlib>
 #include <string>
 
 //using std::tr1::bind;
@@ -57,7 +57,7 @@ using boost::format;
 using lumiera::Time;
 //using util::contains;
 using std::string;
-//using std::rand;
+using std::rand;
 using std::ostream;
 using std::ostringstream;
 using std::cout;
@@ -93,16 +93,9 @@ namespace test    {
         TY element_;
         static int instanceCnt;
         
-        Tracker (TY init = TY())
-          : element_(init)
-          {
-            ++instanceCnt;
-          }
-        
-       ~Tracker()
-          {
-            --instanceCnt; 
-          }
+        Tracker (TY init = TY())     : element_(init)         { ++instanceCnt; }
+        Tracker (Tracker const& otr) : element_(otr.element_) { ++instanceCnt; }
+       ~Tracker()                                             { --instanceCnt; }
        
        TY&
        operator* ()
@@ -115,6 +108,8 @@ namespace test    {
          {
            return out << tra.element_;
          }
+       
+       operator string()  const { return element_; }
       };
     
     template<typename TY>
@@ -130,9 +125,9 @@ namespace test    {
       }
     
     Tracker<string>
-    captureState (Tracker<Time>, Tracker<string>, int)
+    captureState (Tracker<Time>, Tracker<string> xstr, int)
       {
-        return protocol.str();
+        return protocol.str() + *xstr;
       }
     
     void
@@ -153,7 +148,7 @@ namespace test    {
     checkSerialisation (CmdClosure& clo)
       {
         TODO ("implement serialisation/de-serialisation-Check");
-        cout << "would be serialised....." << clo;
+        cout << "would be serialised....." << clo << endl;
         
         // serialise, then de-serialise into a new instance and compare both
       }
@@ -185,7 +180,8 @@ namespace test    {
           
           createTuples (testTuples);
 //        checkArgumentComparison ();
-//        serialiseArgTuples (testTuples);
+          serialiseArgTuples (testTuples);
+          testTuples.clear();
           
 //        simulateCmdLifecycle();
           
@@ -193,6 +189,8 @@ namespace test    {
           ASSERT (0 == Tracker<string>::instanceCnt);
         }
       
+      typedef Tracker<Time> TTime;
+      typedef Tracker<string> Tstr;
       typedef struct{ int i[5]; } Sint5;
           
       
@@ -203,8 +201,10 @@ namespace test    {
           typedef ArgumentHolder<void(),         bool>  A1;
           typedef ArgumentHolder<void(int),      void*> A2;
           typedef ArgumentHolder<void(int,Time), int>   A3;
-          typedef ArgumentHolder<void(int,Time), Time>  A4;
-          typedef ArgumentHolder<void(int,Time), Sint5> A5;
+          typedef ArgumentHolder<void(int,Time), Sint5> A4;
+          
+          typedef ArgumentHolder<void(TTime,Tstr,int), Tstr>  A5;
+          
           
           A1* arg1 = new A1(); tup.manage (arg1);
           A2* arg2 = new A2(); tup.manage (arg2);
@@ -220,19 +220,28 @@ namespace test    {
           
           for_each (tup, showIt);
           
-          arg2->bind (rand() % 20);
-          arg3->bind (rand() % 20, randTime());
-          arg4->bind (rand() % 20, randTime());
-          arg5->bind (rand() % 20, randTime());
+          arg1->bind ();
+          arg2->bind (rand() % 10);
+          arg3->bind (rand() % 10, randTime());
+          arg4->bind (rand() % 10, randTime());
           
-          arg3->memento() = 42;
-          arg5->memento().i[3] = 513;
+          arg5->bind (TTime (randTime()), Tstr("glorious"), rand() % 25);
+          
+          ASSERT (!arg5->canUndo());
+          
+          arg5->tie(undoIt, captureState)
+                .tieCaptureFunc()                         // bind capturing function to memento storage,
+                  (TTime(), Tstr("destruction"), 11);    //  then invoke the bound capturing mechanism 
+          
+          ASSERT (arg5->canUndo());
+          ASSERT (*arg5->memento() == "destruction");
+          
+          VERIFY_ERROR(MISSING_MEMENTO, arg4->memento().i[3] = 513 );
           
           for_each (tup, showIt);
         }
       
       
-#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
       /** @test serialise and de-serialise each tuple and check validity
        *  @todo unimplemented, waiting on Serialiser
        */
@@ -243,6 +252,7 @@ namespace test    {
         }
       
       
+#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
       /** @test verify the comparison operators */
       void
       checkArgumentComparison ()

From e879e0c81ba49fad999b8bc4cfedb6758addc9ef Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 19 Jul 2009 19:13:25 +0200
Subject: [PATCH 205/368] implemented argument and memento comparisons (doesn't
 pass test yet)

---
 src/lib/functorutil.hpp                       | 26 +++++++++
 src/proc/control/command-argument-holder.hpp  | 17 +++++-
 src/proc/control/command-closure.hpp          | 38 +++++++++----
 src/proc/control/memento-tie.hpp              | 18 ++++++-
 .../proc/control/command-argument-test.cpp    |  8 +--
 .../proc/control/memento-tie-test.cpp         | 53 +++++++++++++++++--
 6 files changed, 142 insertions(+), 18 deletions(-)

diff --git a/src/lib/functorutil.hpp b/src/lib/functorutil.hpp
index ccbb69988..d8eb07132 100644
--- a/src/lib/functorutil.hpp
+++ b/src/lib/functorutil.hpp
@@ -83,6 +83,32 @@ namespace util { ////////////TODO: refactor it. But probably not directly into n
   }
   
   
+  /** temporary workaround: tr1/functional should define
+   *  public comparison operators for functor objects, but
+   *  in the implementation provided by boost 1.34 it doesn't.
+   *  To get at least \em some comparison capability, we do a
+   *  brute force comparison of the functors internal data */
+  template<typename SIG>
+  bool
+  rawComparison (function<SIG> const& f1,
+                 function<SIG> const& f2)
+  {
+    typedef char C8c[sizeof(f1)];  
+    
+    return reinterpret_cast<C8c const&> (f1)
+        == reinterpret_cast<C8c const&> (f2);   
+  }
+  
+  
+  template<typename SIG1, typename SIG2>
+  bool
+  rawComparison (function<SIG1> const&,
+                 function<SIG2> const&)
+  {
+    return false;
+  }
+  
+  
 } // namespace util
 
 #endif /*UTIL_HPP_*/
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index d148223bb..ba61c0314 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -216,8 +216,23 @@ namespace control {
           return memento_->getState();
         }
       
+      /// Supporting equality comparisons...
+      friend bool
+      operator== (ArgumentHolder const& a1, ArgumentHolder const& a2)
+        {
+          return (a1.arguments_->isValid() == a2.arguments_->isValid())
+              && (*a1.arguments_ == *a2.arguments_)
+              && (a1.memento_->isValid() == a2.memento_->isValid())
+              && (*a1.memento_ == *a2.memento_)
+               ;
+        }
+      
+      friend bool
+      operator!= (ArgumentHolder const& a1, ArgumentHolder const& a2)
+        {
+          return ! (a1 == a2);
+        }
     };
-  
     
   
   
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 71dbe7384..47cf48d07 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -44,7 +44,7 @@
 #include "lib/meta/tuple.hpp"
 #include "lib/util.hpp"
 
-#include <tr1/memory>
+//#include <tr1/memory>
 #include <tr1/functional>
 #include <iostream>
 #include <sstream>
@@ -62,18 +62,19 @@ namespace control {
   
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
-  using util::unConst;
-  using std::string;
-  using std::ostream;
-  using std::tr1::function;
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::Tuple;
   using lumiera::typelist::BuildTupleAccessor;
   using lumiera::typelist::func::TupleApplicator;
   using lumiera::typelist::FunErasure;
   using lumiera::typelist::StoreFunction;
-  
   using lumiera::typelist::NullType;
+
+  using util::unConst;
+
+  using std::tr1::function;
+  using std::ostream;
+  using std::string;
   
   
   
@@ -125,18 +126,27 @@ namespace control {
         : BASE(tuple)
         { }
       
+      
+      ////////////////////TODO the real access operations (e.g. for serialising) go here
+      
+      
       ostream&
       dump (ostream& output)  const
         {
           return BASE::dump (output << element() << ',');
         }
       
-      
-      ////////////////////TODO the real access operations (e.g. for serialising) go here
+      friend bool
+      compare (ParamAccessor const& p1, ParamAccessor const& p2)
+        {
+          return (p1.element() == p2.element())
+              && compare ( static_cast<BASE>(p1)
+                         , static_cast<BASE>(p2) );
+        }
     };
     
   template<class TUP>
-  class ParamAccessor<NullType, TUP, TUP, 0>
+  class ParamAccessor<NullType, TUP, TUP, 0>   ///< used for recursion end of implementation functions
     : public TUP
     {
     public:
@@ -152,6 +162,11 @@ namespace control {
           return output;
         }
       
+      friend bool
+      compare (ParamAccessor const&, ParamAccessor const&)
+        {
+          return true;;
+        }
     };
   
   
@@ -215,6 +230,11 @@ namespace control {
       
       
       bool isValid ()  const { return true; }
+      
+      
+      /// Supporting equality comparisons...
+      friend bool operator== (Closure const& c1, Closure const& c2)  { return compare (c1.params_, c2.params_); }
+      friend bool operator!= (Closure const& c1, Closure const& c2)  { return ! (c1 == c2); }
     };
     
     
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index 530c45054..7ccac9322 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -43,15 +43,18 @@
 #include "lib/bool-checkable.hpp"
 #include "lib/meta/function-closure.hpp"
 #include "proc/control/command-signature.hpp"
+#include "lib/functorutil.hpp"
 #include "lib/format.hpp"
 #include "lib/util.hpp"
 
+#include <boost/operators.hpp>
 #include <tr1/functional>
 #include <string>
 
 
 namespace control {
   
+  using boost::equality_comparable;
   using lumiera::typelist::func::bindLast;
   using lumiera::typelist::func::chained;
     
@@ -76,7 +79,9 @@ namespace control {
    */
   template<typename SIG, typename MEM>
   class MementoTie
-    : public lib::BoolCheckable<MementoTie<SIG,MEM> >
+    : public lib::BoolCheckable<MementoTie<SIG,MEM>,
+             equality_comparable<MementoTie<SIG,MEM> 
+                               > >
     {
       typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
       typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
@@ -182,6 +187,17 @@ namespace control {
                + ">";
         }
       
+      
+      /// Supporting equality comparisons...
+      friend bool
+      operator== (MementoTie const& m1, MementoTie const& m2)
+        {
+          return util::rawComparison(m1.undo_,   m2.undo_    )
+              && util::rawComparison(m1.capture_,m2.capture_ )
+              && (m1.isCaptured_  == m2.isCaptured_)
+              && (!m1.isCaptured_ 
+                  || (m1.memento_ == m2.memento_));
+        }
     };
   
   
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index 10f54923e..4b62380e6 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -179,7 +179,7 @@ namespace test    {
           Tracker<string>::instanceCnt = 0;
           
           createTuples (testTuples);
-//        checkArgumentComparison ();
+          checkArgumentComparison ();
           serialiseArgTuples (testTuples);
           testTuples.clear();
           
@@ -252,18 +252,17 @@ namespace test    {
         }
       
       
-#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
       /** @test verify the comparison operators */
       void
       checkArgumentComparison ()
         {
-          ArgumentHolder<void()> one, two;
+          ArgumentHolder<void(), int> one, two;
           ASSERT (one == two);
           
           one.memento() = 5;
           ASSERT (one != two);
           
-          ArgumentHolder<void(int,int)> three, four;
+          ArgumentHolder<void(int,int), int> three, four;
           ASSERT (three == four);
           three.bind (1,2);
           ASSERT (three != four);
@@ -287,6 +286,7 @@ namespace test    {
         }
       
       
+#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
       /** @test simulate a complete command lifecycle with regards to
        *  the storage handling of the command parameters and state memento.
        */
diff --git a/tests/components/proc/control/memento-tie-test.cpp b/tests/components/proc/control/memento-tie-test.cpp
index 18e1bfab2..0785e8ba5 100644
--- a/tests/components/proc/control/memento-tie-test.cpp
+++ b/tests/components/proc/control/memento-tie-test.cpp
@@ -82,18 +82,21 @@ namespace test    {
       run (Arg) 
         {
           checkStateCapturingMechanism();
+          verifyComparisons();
         }
       
       
+      /// assumed signature of the Command "Operation"
+      typedef void OpSIG(short);
+      typedef MementoTie<OpSIG,int> MemHolder;
+      
+      
       void
       checkStateCapturingMechanism ()
         {
-          typedef void OpSIG(short); // assumed signature of the Command "Operation"
-          
           function<void(short,int)> undo_func  = undo;
           function< int(short)>     cap_func   = capture;
           
-          typedef MementoTie<OpSIG,int> MemHolder;
           MemHolder mementoHolder (undo_func,cap_func);
           
           ASSERT (sizeof(MemHolder) <= sizeof(int)                   // storage for the memento
@@ -126,6 +129,50 @@ namespace test    {
           bound_undo_func(3*rr);
           ASSERT (testVal == -20 + 3*rr - (5+rr));
         }
+      
+      
+      void
+      verifyComparisons()
+        {
+          function<void(short,int)> u1_fun;             // deliberately unbound
+          function<void(short,int)> u2_fun  = undo;
+          function< int(short)>     c1_fun;
+          function< int(short)>     c2_fun  = capture;
+          
+          MemHolder m11 (u1_fun, c1_fun);
+          MemHolder m12 (u1_fun, c2_fun);
+          MemHolder m21 (u2_fun, c1_fun);
+          MemHolder m22 (u2_fun, c2_fun);
+          
+          ASSERT (!m11 && !m12 && !m21 && !m22);
+          ASSERT ( (m11 == m11));
+          ASSERT (!(m11 != m11));
+          
+          ASSERT (m11 != m12);
+          ASSERT (m11 != m21);
+          ASSERT (m11 != m22);
+          ASSERT (m12 != m11);
+          ASSERT (m12 != m21);
+          ASSERT (m12 != m22);
+          ASSERT (m21 != m11);
+          ASSERT (m21 != m12);
+          ASSERT (m21 != m22);
+          ASSERT (m22 != m11);
+          ASSERT (m22 != m12);
+          ASSERT (m22 != m21);
+         
+          MemHolder m22x (m22); // clone copy
+          ASSERT (!m22x);
+          ASSERT (m22 == m22x);
+          
+          testVal = 0;
+          m22x.tieCaptureFunc() (1 + (rand() % 9)); // produce a random memento value != 0
+          ASSERT (0 < m22x.getState());
+          
+          ASSERT (m22 != m22x);
+          m22.tieCaptureFunc() (0); // now get the same value into the memento within m22
+          ASSERT (m22 == m22x);
+        }
     };
   
   

From 33757bbac33daeccd5ea0f0630478ce0723e44f1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 20 Jul 2009 04:21:24 +0200
Subject: [PATCH 206/368] why the hell doesn't boost provide functor comparison
 operators.. (yes I know why: it can't be implemented 100% correctly)

---
 src/common/guifacade.cpp                      |   2 +-
 src/lib/{functorutil.hpp => functor-util.hpp} |  80 +++++++++--
 src/proc/control/memento-tie.hpp              |   2 +-
 tests/lib/functor-util-test.cpp               | 135 ++++++++++++++++++
 4 files changed, 209 insertions(+), 10 deletions(-)
 rename src/lib/{functorutil.hpp => functor-util.hpp} (52%)
 create mode 100644 tests/lib/functor-util-test.cpp

diff --git a/src/common/guifacade.cpp b/src/common/guifacade.cpp
index 8d6f3fb98..670aa00b5 100644
--- a/src/common/guifacade.cpp
+++ b/src/common/guifacade.cpp
@@ -26,7 +26,7 @@
 #include "lib/sync.hpp"
 #include "lib/error.hpp"
 #include "lib/singleton.hpp"
-#include "lib/functorutil.hpp"
+#include "lib/functor-util.hpp"
 #include "common/instancehandle.hpp"
 
 #include <boost/scoped_ptr.hpp>
diff --git a/src/lib/functorutil.hpp b/src/lib/functor-util.hpp
similarity index 52%
rename from src/lib/functorutil.hpp
rename to src/lib/functor-util.hpp
index d8eb07132..473a17dc7 100644
--- a/src/lib/functorutil.hpp
+++ b/src/lib/functor-util.hpp
@@ -1,5 +1,5 @@
 /*
-  FUNCTORUTIL.hpp  -  collection of helpers for dealing with functors and signals
+  FUNCTOR-UTIL.hpp  -  collection of helpers for dealing with functors and signals
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,10 +21,24 @@
 */
 
 
-#ifndef FUNCTORUTIL_H_
-#define FUNCTORUTIL_H_
+/** @file functor-util.hpp
+ ** Collection of small helpers and utilities related to function objects.
+ ** 
+ ** @todo combine with meta/function-closure.hpp and reorganise
+ **  
+ ** @see GuiSubsysDescriptor#start (guifacade.cpp)
+ ** @see MementoTie
+ ** @see functor-util-test.cpp
+ **
+ */
+
+
+
+#ifndef FUNCTOR_UTIL_H_
+#define FUNCTOR_UTIL_H_
 
 #include <tr1/functional>
+#include <cstring>
 
 
 
@@ -83,23 +97,73 @@ namespace util { ////////////TODO: refactor it. But probably not directly into n
   }
   
   
+  
+  namespace { // hiding some nasty details...
+  
+    /**
+     * This Class is used to surpass the access protection
+     * and break into the tr1::function implementation.
+     * Thus we can implement a raw comparison function,
+     * as a replacement for the missing functor comparison
+     * facility. (TR1 requires an operator==, but boost
+     * seemingly doesn't provide it, because it can't
+     * be done correctly/properly in all cases. See
+     * the section "FAQ" in the documentation of 
+     * the boost/function library)
+     * 
+     * The layout of this class is chosen to mimic that
+     * of the boost function implementation, without all
+     * the generic type decoration. For the comparison
+     * we use a conservative approach, by requiring
+     * the concrete invoker, the storage manager and
+     * the actual function and argument data pointers
+     * to be the same. 
+     */
+    class HijackedFunction 
+      : std::tr1::_Function_base
+      {
+        typedef void (*DummyInvoker) (void);
+        DummyInvoker invoker_;
+        
+      public:
+        
+        friend bool
+        operator== (HijackedFunction const& f1,
+                    HijackedFunction const& f2)
+          {
+            return (f1.invoker_ == f2.invoker_)
+                && (f1._M_manager == f2._M_manager)
+                && (f1._M_functor._M_unused._M_const_object ==
+                    f2._M_functor._M_unused._M_const_object );
+          }                      // note: we don't cover any member pointer offset
+      };
+    
+  }
+  
+  
   /** temporary workaround: tr1/functional should define
    *  public comparison operators for functor objects, but
    *  in the implementation provided by boost 1.34 it doesn't.
    *  To get at least \em some comparison capability, we do a
-   *  brute force comparison of the functors internal data */
+   *  brute force comparison of the functor's internal data.
+   *  @note use with caution. This implementation relies on
+   *        internal details of boost/function; but it is
+   *        rather conservative and might deem functors
+   *        "different" erroneously, due to garbage in 
+   *        the internal functor data's storage */
   template<typename SIG>
   bool
   rawComparison (function<SIG> const& f1,
                  function<SIG> const& f2)
   {
-    typedef char C8c[sizeof(f1)];  
+    typedef HijackedFunction const& Hij;
     
-    return reinterpret_cast<C8c const&> (f1)
-        == reinterpret_cast<C8c const&> (f2);   
+    return reinterpret_cast<Hij> (f1)
+        == reinterpret_cast<Hij> (f2);
   }
   
-  
+  /** catch-all for the comparison: functors with
+   *  different base type are always "different" */
   template<typename SIG1, typename SIG2>
   bool
   rawComparison (function<SIG1> const&,
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index 7ccac9322..3ad17c0fc 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -43,7 +43,7 @@
 #include "lib/bool-checkable.hpp"
 #include "lib/meta/function-closure.hpp"
 #include "proc/control/command-signature.hpp"
-#include "lib/functorutil.hpp"
+#include "lib/functor-util.hpp"
 #include "lib/format.hpp"
 #include "lib/util.hpp"
 
diff --git a/tests/lib/functor-util-test.cpp b/tests/lib/functor-util-test.cpp
new file mode 100644
index 000000000..8072eecc3
--- /dev/null
+++ b/tests/lib/functor-util-test.cpp
@@ -0,0 +1,135 @@
+/*
+  FunctorUtil(Test)  -  verifying function object and signal utilities
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "lib/test/run.hpp"
+//#include "lib/util.hpp"
+#include "lib/functor-util.hpp"
+
+//#include <boost/lexical_cast.hpp>
+#include <tr1/functional>
+#include <iostream>
+
+//using boost::lexical_cast;
+//using util::isnil;
+//using std::string;
+using std::cout;
+using std::tr1::function;
+
+
+namespace util {
+namespace test {
+  
+  
+  namespace {
+    
+    void fun1 (int i) { cout << "fun1 (" << i << ")\n"; }
+    void fun2 (int i) { cout << "fun2 (" << i << ")\n"; }
+    
+    struct Dummy
+      {
+        void gummi (int i) { cout << "gummi (" << i << ")\n"; }
+      };
+  }
+  
+  
+  
+  
+  
+  /*********************************************************************
+   * @test verify some aspects of the functor-util's behaviour.
+   *       Often, this is just a scrapbook for new ideas....
+   */
+  class FunctorUtil_test : public Test
+    {
+      virtual void
+      run (Arg) 
+        {
+          verifyBruteForceComparison();
+        }
+      
+      
+      /** @test workaround for the missing functor comparison operator */
+      void
+      verifyBruteForceComparison()
+        {
+          typedef function<void(int)> Fvi;
+          typedef function<int(void)> Fiv;
+          
+          typedef function<void(void)> Fvv;
+          
+          Fvi f0;
+          Fvi f1 (fun1);
+          Fvi f2 (fun2);
+          
+          ASSERT (!rawComparison(f0, f1));
+          ASSERT (!rawComparison(f1, f2));
+          ASSERT (!rawComparison(f0, f2));
+          
+          Fvi f22 (f2);
+          ASSERT ( rawComparison(f2, f22));
+          
+          f1 = f2;
+          ASSERT ( rawComparison(f1, f2));
+
+          ASSERT (!rawComparison(f0, Fvi()));   // note: can't detect they are equivalent
+          ASSERT (!rawComparison(f0, Fiv()));
+          
+          f1 = bind (fun2, _1);
+          ASSERT (!rawComparison(f1, f2));
+          
+          Dummy dum1, dum2;
+          Fvi fm1 = bind (&Dummy::gummi, dum1, _1);
+          Fvi fm2 = bind (&Dummy::gummi, dum2, _1);
+          Fvv fm3 = bind (&Dummy::gummi, dum1, 23);
+          Fvv fm4 = bind (&Dummy::gummi, dum1, 24);
+          Fvv fm5 = bind (&Dummy::gummi, dum2, 24);
+          Fvv fm6 = bind (&Dummy::gummi, dum2, 24);
+          
+          ASSERT (!rawComparison(f1, fm1));
+          
+          ASSERT (!rawComparison(fm1, fm2));
+          ASSERT (!rawComparison(fm1, fm3));
+          ASSERT (!rawComparison(fm1, fm4));
+          ASSERT (!rawComparison(fm1, fm5));
+          ASSERT (!rawComparison(fm1, fm6));
+          ASSERT (!rawComparison(fm2, fm3));
+          ASSERT (!rawComparison(fm2, fm4));
+          ASSERT (!rawComparison(fm2, fm5));
+          ASSERT (!rawComparison(fm2, fm6));
+          ASSERT (!rawComparison(fm3, fm4));
+          ASSERT (!rawComparison(fm3, fm5));
+          ASSERT (!rawComparison(fm3, fm6));
+          ASSERT (!rawComparison(fm4, fm5));
+          ASSERT (!rawComparison(fm4, fm6));
+          ASSERT (!rawComparison(fm5, fm6));   // again: can't detect they are equivalent
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (FunctorUtil_test, "unit common");
+  
+  
+  
+}} // namespace util::test

From 63bad834c1497db541671795204ab955cf0d9676 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 20 Jul 2009 05:09:46 +0200
Subject: [PATCH 207/368] comparisons and state detection now working as
 expected

---
 src/proc/control/command-argument-holder.hpp  | 17 ++----
 src/proc/control/memento-tie.hpp              | 11 ++--
 .../proc/control/command-argument-test.cpp    | 58 +++++++++++--------
 .../proc/control/memento-tie-test.cpp         |  6 +-
 4 files changed, 49 insertions(+), 43 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index ba61c0314..72ce6a013 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -44,31 +44,21 @@
 #define CONTROL_COMMAND_ARGUMENT_HOLDER_H
 
 //#include "pre.hpp"
-//#include "lib/error.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/opaque-holder.hpp"
 
-//#include <tr1/memory>
-//#include <boost/scoped_ptr.hpp>
-//#include <tr1/functional>
 #include <boost/noncopyable.hpp>
-#include <iostream>
 #include <string>
 
 
 
 namespace control {
   
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
-//  using boost::scoped_ptr;
-//  using std::tr1::function;
-//  using std::ostream;
   using boost::noncopyable;
-  using std::string;
   using lib::InPlaceBuffer;
+  using std::string;
   
   
   namespace { // empty state marker objects for ArgumentHolder
@@ -94,7 +84,7 @@ namespace control {
       {
         typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
         typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
-    
+        
         UntiedMemento()
           : MementoTie<SIG,MEM> (function<SIG_undo>(), function<SIG_cap>() )
           { }
@@ -209,7 +199,8 @@ namespace control {
       
       
       /** direct "backdoor" access to stored memento value.
-       *  @note you might access a placeholder when called prior to \c tie(..) */
+       *  @throw LUMIERA_ERROR_MISSING_MEMENTO when invoked
+       *         prior to \c tie(..) and capturing any state */
       MEM&
       memento ()
         {
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index 3ad17c0fc..dff7467f3 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -192,10 +192,13 @@ namespace control {
       friend bool
       operator== (MementoTie const& m1, MementoTie const& m2)
         {
-          return util::rawComparison(m1.undo_,   m2.undo_    )
-              && util::rawComparison(m1.capture_,m2.capture_ )
-              && (m1.isCaptured_  == m2.isCaptured_)
-              && (!m1.isCaptured_ 
+          return ((!m1.undo_ && !m2.undo_ && !m1.capture_ && !m2.capture_) // either no valid functions 
+                  || ( util::rawComparison(m1.undo_,   m2.undo_    )      //  or identical functions
+                    && util::rawComparison(m1.capture_,m2.capture_ )
+                     )
+                 )
+              && (m1.isCaptured_  == m2.isCaptured_)  // either both not captured or identical state
+              && (!m1.isCaptured_
                   || (m1.memento_ == m2.memento_));
         }
     };
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index 4b62380e6..f5e3f3bde 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -136,6 +136,9 @@ namespace test    {
         protocol << "undoIt(time="<<time<<")---state-was-:"<< *memento;
       }
     
+    void dummyU (int,int,int) { }
+    int  dummyC (int u,int o) { return u + rand() % (o-u+1); }
+    
     
     
     void
@@ -256,33 +259,42 @@ namespace test    {
       void
       checkArgumentComparison ()
         {
-          ArgumentHolder<void(), int> one, two;
-          ASSERT (one == two);
+          ArgumentHolder<void(int,int), int> one, two;
+          ASSERT (one == two);               // empty, identically typed argument holders -->equal
           
-          one.memento() = 5;
+          one.tie(dummyU,dummyC)
+              .tieCaptureFunc()(1,9);
+          ASSERT (one != two);               // now one contains captured UNDO state
+          
+          two.tie(dummyU,dummyC)
+              .tieCaptureFunc()(1,9);
+          two.memento() = one.memento();     // put the same UNDO state in both
+          ASSERT (one == two);               // ...makes them equal again 
+          
+          one.bind (1,2);                    // verify argument tuple comparison
           ASSERT (one != two);
+          ASSERT (two != one);
+          ASSERT (!isnil (one));
+          ASSERT ( isnil (two));
           
-          ArgumentHolder<void(int,int), int> three, four;
-          ASSERT (three == four);
-          three.bind (1,2);
-          ASSERT (three != four);
-          ASSERT (four != three);
-          ASSERT (!isnil (three));
-          ASSERT ( isnil (four));
-
-          four.bind (3,4);
-          ASSERT (!isnil (four));
-          ASSERT (three != four);
-          ASSERT (four != three);
+          two.bind (3,4);
+          ASSERT (!isnil (two));
+          ASSERT (one != two);
+          ASSERT (two != one);
           
-          three.bind (3,4);
-          ASSERT (!isnil (three));
-          ASSERT (three == four);
-          ASSERT (four == three);
-          four.memento() = 12345;
-          ASSERT (!isnil (four));
-          ASSERT (three != four);
-          ASSERT (four != three);
+          one.bind (1,4);
+          ASSERT (!isnil (one));
+          ASSERT (one != two);
+          ASSERT (two != one);
+          
+          one.bind (3,4);
+          ASSERT (!isnil (one));
+          ASSERT (one == two);
+          ASSERT (two == one);
+          two.memento() = 12345;
+          ASSERT (!isnil (two));
+          ASSERT (one != two);
+          ASSERT (two != one);
         }
       
       
diff --git a/tests/components/proc/control/memento-tie-test.cpp b/tests/components/proc/control/memento-tie-test.cpp
index 0785e8ba5..20a40e1fa 100644
--- a/tests/components/proc/control/memento-tie-test.cpp
+++ b/tests/components/proc/control/memento-tie-test.cpp
@@ -163,14 +163,14 @@ namespace test    {
          
           MemHolder m22x (m22); // clone copy
           ASSERT (!m22x);
-          ASSERT (m22 == m22x);
+          ASSERT (m22 == m22x); // same functions, no state --> equal
           
           testVal = 0;
-          m22x.tieCaptureFunc() (1 + (rand() % 9)); // produce a random memento value != 0
+          m22x.tieCaptureFunc() (1 + (rand() % 9));   // produce a random memento value != 0
           ASSERT (0 < m22x.getState());
           
           ASSERT (m22 != m22x);
-          m22.tieCaptureFunc() (0); // now get the same value into the memento within m22
+          m22.tieCaptureFunc() (m22x.getState()); // get the same value into the memento within m22
           ASSERT (m22 == m22x);
         }
     };

From c85d1d3cd806ed0b4c7bd3d31ad56d23b1ab51b7 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 20 Jul 2009 07:03:18 +0200
Subject: [PATCH 208/368] ArgumentHolder finished, low-level integration test
 pass

---
 src/lib/meta/function-erasure.hpp             |  4 +-
 src/proc/control/command-argument-holder.hpp  | 43 +++++----
 src/proc/control/command-closure.hpp          |  6 +-
 tests/45controller.tests                      | 30 +++++-
 .../proc/control/command-argument-test.cpp    | 93 +++++++++----------
 tests/lib/Makefile.am                         |  1 +
 tests/lib/functor-util-test.cpp               |  4 +-
 7 files changed, 106 insertions(+), 75 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index eaca137d0..c267be175 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -128,7 +128,7 @@ namespace typelist{
       
       template<typename SIG>
       function<SIG>&
-      getFun ()
+      getFun ()  const
         {
           return get<function<SIG> >();
         }
@@ -157,7 +157,7 @@ namespace typelist{
       
       template<typename SIG>
       SIG&
-      getFun ()
+      getFun ()  const
         {
           SIG *fun = get<SIG*>();
           REQUIRE (fun);
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 72ce6a013..ef82f7fc6 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -22,18 +22,17 @@
 
 
 /** @file command-argument-holder.hpp
- ** A simple container record holding the actual command arguments. 
+ ** A passive container record holding the actual command arguments & UNDO state. 
  ** While all command objects themselves have a common type (type erasure),
- ** the actual argument tuple and the state memento for undo can't. Especially,
+ ** the actual argument tuple and the state memento for UNDO can't. Especially,
  ** the size of arguments and memento will depend on their respective types.
  ** Thus, to manage somehow the storage of this data, we create a common holder,
- ** to be managed by a custom allocator.
+ ** which can than be managed by a custom allocator / object pool.
  ** 
- ** @todo doing just plain heap allocation for now :-P
- **  
  ** @see Command
- ** @see UndoMutation
- ** @see MementoTie
+ ** @see CmdClosure    storage of command arguments
+ ** @see MementoTie    wiring of UNDO functions & memento
+ ** @see UndoMutation  execution of UNDO
  ** @see command-argument-test.cpp
  **
  */
@@ -43,20 +42,17 @@
 #ifndef CONTROL_COMMAND_ARGUMENT_HOLDER_H
 #define CONTROL_COMMAND_ARGUMENT_HOLDER_H
 
-//#include "pre.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/opaque-holder.hpp"
 
-#include <boost/noncopyable.hpp>
 #include <string>
 
 
 
 namespace control {
   
-  using boost::noncopyable;
   using lib::InPlaceBuffer;
   using std::string;
   
@@ -96,14 +92,14 @@ namespace control {
   
   
   /**
-   * Specifically typed CmdClosure, which serves for 
+   * Specifically typed CmdClosure, which serves for
    * actually allocating storage to hold the command arguments
-   * and the undo state (memento) for Proc-Layer commands.
-   * Both the contained components within ArgumentHolder 
+   * and the UNDO state (memento) for Proc-Layer commands.
+   * Both the contained components within ArgumentHolder
    * can be in \em empty state; there are no distinct
    * lifecycle limitations. ArgumentHolder is part
    * of Proc-Layer command's implementation
-   * and should not be used standalone. 
+   * and should not be used standalone.
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
@@ -111,8 +107,10 @@ namespace control {
                                 , ArgumentHolder<SIG,MEM>  // target class providing the implementation
                                 , CmdClosure               // base class to inherit from
                                 > 
-    , private noncopyable
     {
+      /** copy construction allowed(but no assignment)*/
+      ArgumentHolder& operator= (ArgumentHolder const&);
+      
       
       typedef Closure<SIG>        ArgHolder;
       typedef MementoTie<SIG,MEM> MemHolder;
@@ -132,13 +130,14 @@ namespace control {
       
       /* ==== proxied CmdClosure interface ==== */
       
+    public:
       virtual bool isValid ()  const
         {
           return arguments_->isValid();
         }
       
       
-      virtual CmdFunctor bindArguments (CmdFunctor& func)
+      virtual CmdFunctor bindArguments (CmdFunctor const& func)
         {
           if (!isValid())
             throw lumiera::error::State ("Lifecycle error: can't bind functor, "
@@ -158,7 +157,7 @@ namespace control {
         }
       
       
-    public:
+      
       /** per default, all data within ArgumentHolder
        *  is set up in \em empty state. Later on, the
        *  command arguments are to be provided by #bind ,
@@ -169,6 +168,16 @@ namespace control {
         , memento_()
         { }
       
+      /** copy construction allowed(but no assignment) */
+      ArgumentHolder (ArgumentHolder const& oAh)
+        : arguments_()
+        , memento_()
+        {
+          arguments_.template create<ArgHolder> (*oAh.arguments_);
+          memento_.template  create<MemHolder> (*oAh.memento_);
+        }
+      
+      
       /** has undo state capturing been invoked? */
       bool canUndo () const { return memento_->isValid();   }
       bool empty ()   const { return !arguments_->isValid(); }
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 47cf48d07..d18aefbf1 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -100,7 +100,7 @@ namespace control {
       
       virtual bool isValid ()   const =0;
       
-      virtual CmdFunctor bindArguments (CmdFunctor&) =0;
+      virtual CmdFunctor bindArguments (CmdFunctor const&) =0;
     };
   
   
@@ -207,7 +207,7 @@ namespace control {
        *         can't be const.
        */
       CmdFunctor
-      bindArguments (CmdFunctor& unboundFunctor)
+      bindArguments (CmdFunctor const& unboundFunctor)
         {
           return CmdFunctor (TupleApplicator<SIG> (params_)
                                .bind ( unboundFunctor.getFun<SIG>()) );
@@ -221,7 +221,7 @@ namespace control {
           params_.dump (buff << "Closure(" );
           
           string dumped (buff.str());
-          if (1 < dumped.length())
+          if (8 < dumped.length())
             // remove trailing comma...
             return dumped.substr (0, dumped.length()-1) +")";
           else
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 908d1ea6c..d93c7f5a0 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -7,11 +7,35 @@ PLANNED "CommandBasic_test" CommandBasic_test <<END
 END
 
 
-PLANNED "CommandArgument_test" CommandArgument_test <<END
+TEST "Argument & Memento handling" CommandArgument_test <<END
+out: Command-State. arguments=unbound, ·noUNDO·.
+out: capture state...
+out: Command-State. arguments=Closure\(\), ·noUNDO·.
+out: Command-State. arguments=Closure\(.\), ·noUNDO·.
+out: Command-State. arguments=Closure\(.,00:..:....00\), ·noUNDO·.
+out: Command-State. arguments=Closure\(00:..:....00,glorious,..\), <mem: destruction>.
+out: would be serialised.....Command-State. arguments=Closure\(\), ·noUNDO·.
+out: would be serialised.....Command-State. arguments=Closure\(.\), ·noUNDO·.
+out: would be serialised.....Command-State. arguments=Closure\(.,00:..:....00\), ·noUNDO·.
+out: would be serialised.....Command-State. arguments=Closure\(00:..:....00,glorious,..\), <mem: destruction>.
+out: sizeof\( .+control1.ArgumentHolder.+ \) = .+
+out: Command-State. arguments=Closure\(00:..:....00,Lumiera rocks,..\), ·noUNDO·.
+out: capture state...
+out: captured state: START...Lumiera rocks
+out: Command-State. arguments=Closure\(00:..:....00,Lumiera rocks,..\), <mem: START...Lumiera rocks>.
+out: invoke operation...
+out: START...doIt\( Time=00:..:....00 "Lumiera rocks" rand=.. \)
+out: undo... memento=START...Lumiera rocks
+out: START...doIt\( Time=00:..:....00 "Lumiera rocks" rand=.. \)undoIt\(time=00:..:....00\)----memento-:START...Lumiera rocks
+out: capture state...
+out: modified: Command-State. arguments=Closure\(00:00:00.123,unbelievable,..\), <mem: START...doIt\( Time=00:..:....00 "Lumiera rocks" rand=.. \)undoIt\(time=00:..:....00\)----memento-:START...Lumiera rocksLumiera rocks>.
+out: copied  : Command-State. arguments=Closure\(00:..:....00,Lumiera rocks,..\), <mem: START...Lumiera rocks>.
+out: undo... memento=START...doIt\( Time=00:..:....00 "Lumiera rocks" rand=.. \)undoIt\(time=00:..:....00\)----memento-:START...Lumiera rocksLumiera rocks
+out: RESET...undoIt\(time=00:..:....00\)----memento-:START...doIt\( Time=00:..:....00 "Lumiera rocks" rand=.. \)undoIt\(time=00:..:....00\)----memento-:START...Lumiera rocksLumiera rocks
 END
 
 
-TEST "Command functor" CommandMutation_test <<END
+TEST "Command functor and UNDO functor" CommandMutation_test <<END
 out: Mutation\(untied\)
 out: param values: Closure\(23\)
 out: Mutation\(Closure\(23\)\)
@@ -27,6 +51,6 @@ return: 0
 END
 
 
-TEST "Memento binding" MementoTie_test <<END
+TEST "Memento wiring and storage" MementoTie_test <<END
 return: 0
 END
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index f5e3f3bde..e50751b77 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -23,43 +23,25 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-argument-holder.hpp"
 #include "lib/scoped-ptrvect.hpp"
 #include "lib/lumitime-fmt.hpp"
-//#include "lib/meta/typelist.hpp"
-//#include "lib/meta/tuple.hpp"
 #include "lib/util.hpp"
 
-//#include <tr1/functional>
 #include <boost/format.hpp>
 #include <iostream>
 #include <sstream>
 #include <cstdlib>
 #include <string>
 
-//using std::tr1::bind;
-//using std::tr1::placeholders::_1;
-//using std::tr1::placeholders::_2;
-//using std::tr1::function;
 using util::isnil;
-//using util::and_all;
 using util::for_each;
-using boost::format;
 using lumiera::Time;
-//using util::contains;
+using boost::format;
 using std::string;
-using std::rand;
 using std::ostream;
 using std::ostringstream;
+using std::rand;
 using std::cout;
 using std::endl;
 
@@ -70,13 +52,6 @@ namespace test    {
   using lib::test::showSizeof;
   using lib::test::randTime;
   
-//  using session::test::TestClip;
-//  using lumiera::P;
-//  using namespace lumiera::typelist;
-//  using lumiera::typelist::Tuple;
-  
-//  using control::CmdClosure;
-  
   
   
   
@@ -87,6 +62,10 @@ namespace test    {
     ostringstream protocol;     ///< used to verify the test function calls
     
     
+    /** 
+     * watching the instance creation
+     * of some parameter values 
+     */
     template<typename TY>
     struct Tracker
       {
@@ -116,26 +95,32 @@ namespace test    {
     int Tracker<TY>::instanceCnt (0);
     
     
+    /* === functions to implement test-"operation" & UNDO === */
     
     void
     doIt (Tracker<Time> time, Tracker<string> str, int rand)
       {
         static format fmt ("doIt( Time=%s \"%s\" rand=%2d )");
+        cout << "invoke operation..." << endl;
         protocol << fmt % *time % *str % rand;
       }
     
     Tracker<string>
     captureState (Tracker<Time>, Tracker<string> xstr, int)
       {
+        cout << "capture state..." << endl;
         return protocol.str() + *xstr;
       }
     
     void
     undoIt (Tracker<Time> time, Tracker<string>, int, Tracker<string> memento)
       {
-        protocol << "undoIt(time="<<time<<")---state-was-:"<< *memento;
+        cout << "undo... memento=" << memento << endl;
+        protocol << "undoIt(time="<<time<<")----memento-:"<< *memento;
       }
     
+    
+    ///  another dummy-UNDO function
     void dummyU (int,int,int) { }
     int  dummyC (int u,int o) { return u + rand() % (o-u+1); }
     
@@ -163,11 +148,12 @@ namespace test    {
   
   
   
+  
   typedef lib::ScopedPtrVect<CmdClosure> ArgTuples;
   
   /***************************************************************************
    * @test Check storage handling of the command parameters and state memento.
-   *       
+   * 
    * @see  control::CommandArgumentHolder
    * @see  command-basic-test.hpp
    */
@@ -186,16 +172,20 @@ namespace test    {
           serialiseArgTuples (testTuples);
           testTuples.clear();
           
-//        simulateCmdLifecycle();
+          simulateCmdLifecycle();
           
+          // verify all dtors properly called... 
           ASSERT (0 == Tracker<Time>::instanceCnt);
           ASSERT (0 == Tracker<string>::instanceCnt);
         }
       
+      
       typedef Tracker<Time> TTime;
       typedef Tracker<string> Tstr;
       typedef struct{ int i[5]; } Sint5;
-          
+      
+      
+      
       
       /** @test create various argument tuples and re-access their contents */
       void
@@ -234,7 +224,7 @@ namespace test    {
           
           arg5->tie(undoIt, captureState)
                 .tieCaptureFunc()                         // bind capturing function to memento storage,
-                  (TTime(), Tstr("destruction"), 11);    //  then invoke the bound capturing mechanism 
+                  (TTime(), Tstr("destruction"), 11);    //  then invoke the bound capturing mechanism
           
           ASSERT (arg5->canUndo());
           ASSERT (*arg5->memento() == "destruction");
@@ -245,6 +235,7 @@ namespace test    {
         }
       
       
+      
       /** @test serialise and de-serialise each tuple and check validity
        *  @todo unimplemented, waiting on Serialiser
        */
@@ -255,6 +246,7 @@ namespace test    {
         }
       
       
+      
       /** @test verify the comparison operators */
       void
       checkArgumentComparison ()
@@ -298,37 +290,43 @@ namespace test    {
         }
       
       
-#if false ////////////////////////////////////////////////////////////////////////////TODO.....          
-      /** @test simulate a complete command lifecycle with regards to
-       *  the storage handling of the command parameters and state memento.
+      
+      /** @test simulate a complete command lifecycle with regards to the
+       *        storage handling of the command parameters and state memento.
        */
       void
       simulateCmdLifecycle()
         {
           typedef void SIG_do(Tracker<Time>, Tracker<string>, int);
-          typedef ArgumentHolder<SIG_do, Tracker<string> > Args;
-          typedef MementoTie<SIG_do, Tracker<string> > MemHolder;
+          typedef ArgumentHolder<SIG_do, Tracker<string> >   Args;
+          typedef MementoTie<SIG_do, Tracker<string> >  MemHolder;
           
           Args args;
           ASSERT (isnil (args));
           cout << showSizeof(args) << endl;
           
-          args.bind (randTime(), "Lumiera rocks". rand() % 100);
+          // store a set of parameter values, later to be used on invocation
+          args.bind (TTime(randTime()), Tstr("Lumiera rocks"), rand() % 100);
           ASSERT (!isnil (args));
           cout << args << endl;
           
           ASSERT (!args.canUndo());
-          ASSERT (isnil (args.memento()));
+          VERIFY_ERROR(MISSING_MEMENTO,  args.memento() );
+          
           MemHolder& memHolder = args.tie(undoIt,captureState);
           ASSERT (!memHolder);   // no stored memento.... 
+          ASSERT (!args.canUndo());
           
           function<SIG_do> doItFun = doIt;
           function<SIG_do> undoFun = memHolder.tieUndoFunc();
           function<SIG_do> captFun = memHolder.tieCaptureFunc();
           
-          CmdFunctor bound_doItFun = args.bindArguments (CmdFunctor(doItFun));
-          CmdFunctor bound_undoFun = args.bindArguments (CmdFunctor(undoFun));
-          CmdFunctor bound_captFun = args.bindArguments (CmdFunctor(captFun));
+          typedef function<void()> OpFun;
+          
+          // now close all the functions with the stored parameter values... 
+          OpFun bound_doItFun = args.bindArguments (CmdFunctor(doItFun)).getFun<void()>();
+          OpFun bound_undoFun = args.bindArguments (CmdFunctor(undoFun)).getFun<void()>();
+          OpFun bound_captFun = args.bindArguments (CmdFunctor(captFun)).getFun<void()>();
           
           protocol.seekp(0);
           protocol << "START...";
@@ -336,8 +334,9 @@ namespace test    {
           bound_captFun();
           cout << "captured state: " << args.memento() << endl;
           ASSERT (memHolder);
-          ASSERT (!isnil (args.memento()));
+          ASSERT (!isnil (*args.memento()));
           ASSERT (args.canUndo());
+          cout << args << endl;
           
           bound_doItFun();
           cout << protocol.str() << endl;
@@ -350,14 +349,14 @@ namespace test    {
           protocol.seekp(0);
           protocol << "RESET...";
           
-          args.bind (123456, "unbelievable", rand() %100);
-          cout << "original: " << args << endl;
-          cout << "copied  : " << argsCopy << endl;
+          args.bind (TTime(Time(123456)), Tstr("unbelievable"), rand() %100);
+          cout << "modified: " << args     << endl;
+          cout << "copied  : " << argsCopy << endl;    // holds still the old params & memento
           
           bound_undoFun();
           cout << protocol.str() << endl;
         }
-#endif ////////////////////////////////////////////////////////////////////////////TODO.....          
+      
     };
   
   
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 1dae992cf..ab9a73ecf 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -44,6 +44,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/factory-special-test.cpp		\
 	$(testlib_srcdir)/factorytest.cpp			\
 	$(testlib_srcdir)/format-helper-test.cpp		\
+	$(testlib_srcdir)/functor-util-test.cpp			\
 	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
diff --git a/tests/lib/functor-util-test.cpp b/tests/lib/functor-util-test.cpp
index 8072eecc3..4d7d8ad53 100644
--- a/tests/lib/functor-util-test.cpp
+++ b/tests/lib/functor-util-test.cpp
@@ -26,11 +26,9 @@
 //#include "lib/util.hpp"
 #include "lib/functor-util.hpp"
 
-//#include <boost/lexical_cast.hpp>
 #include <tr1/functional>
 #include <iostream>
 
-//using boost::lexical_cast;
 //using util::isnil;
 //using std::string;
 using std::cout;
@@ -91,7 +89,7 @@ namespace test {
           
           f1 = f2;
           ASSERT ( rawComparison(f1, f2));
-
+          
           ASSERT (!rawComparison(f0, Fvi()));   // note: can't detect they are equivalent
           ASSERT (!rawComparison(f0, Fiv()));
           

From d122a326627cba5143bd514d421c4b535d59dd49 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 21 Jul 2009 04:13:12 +0200
Subject: [PATCH 209/368] Documentation & planning the parts to implement next

---
 doc/devel/uml/class148997.html   |   7 +-
 doc/devel/uml/class149637.html   |   6 +-
 doc/devel/uml/class150789.html   |  24 +++
 doc/devel/uml/class150917.html   |  24 +++
 doc/devel/uml/classes.html       |   4 +-
 doc/devel/uml/classes_list.html  |   4 +-
 doc/devel/uml/fig134021.png      | Bin 23301 -> 24839 bytes
 doc/devel/uml/fig135173.png      | Bin 0 -> 11554 bytes
 doc/devel/uml/index.html         | 102 +++++++++++-
 doc/devel/uml/index_60.html      |  24 ++-
 doc/devel/uml/index_65.html      |   4 +-
 doc/devel/uml/index_66.html      |   2 +-
 doc/devel/uml/index_67.html      |  37 +++--
 doc/devel/uml/index_68.html      |   3 +-
 doc/devel/uml/index_69.html      |   2 +-
 doc/devel/uml/index_70.html      |   2 +
 doc/devel/uml/index_72.html      |   2 +-
 doc/devel/uml/index_73.html      |   3 +-
 doc/devel/uml/index_76.html      |   1 +
 doc/devel/uml/index_79.html      |   2 +-
 doc/devel/uml/index_80.html      |   3 +-
 doc/devel/uml/index_83.html      |  14 +-
 doc/devel/uml/index_84.html      |   8 +-
 doc/devel/uml/index_85.html      |   1 +
 doc/devel/uml/index_86.html      |  18 +--
 doc/devel/uml/navig.html         |   2 +-
 doc/devel/uml/statediagrams.html |  22 +++
 doc/devel/uml/states.html        |  26 +++
 uml/lumiera/128261               |   2 +-
 uml/lumiera/129029               | 268 ++++++++++++++++++++++++++++---
 uml/lumiera/134021.diagram       |  85 ++++++----
 uml/lumiera/135173.diagram       | 161 +++++++++++++++++++
 uml/lumiera/5.session            |  13 +-
 uml/lumiera/lumiera.prj          |   2 +-
 wiki/renderengine.html           |  22 ++-
 35 files changed, 782 insertions(+), 118 deletions(-)
 create mode 100644 doc/devel/uml/class150789.html
 create mode 100644 doc/devel/uml/class150917.html
 create mode 100644 doc/devel/uml/fig135173.png
 create mode 100644 doc/devel/uml/statediagrams.html
 create mode 100644 doc/devel/uml/states.html
 create mode 100644 uml/lumiera/135173.diagram

diff --git a/doc/devel/uml/class148997.html b/doc/devel/uml/class148997.html
index 85ab6a55d..b5af009ca 100644
--- a/doc/devel/uml/class148997.html
+++ b/doc/devel/uml/class148997.html
@@ -16,11 +16,6 @@
 <!-- ============================================================= -->
 
 <a name="refclass148997"></a>
-<p>Declaration :</p><ul><li>C++ : class CmdClosure </li></ul><div class="sub">
-<a name="refrelation172549"></a>
-<table><tr><td><div class="element">Relation <b>targets (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # targets : <a href="class149637.html#refclass149637"><b>Target</b></a></li><li>C++ : protected: <a href="class149637.html#refclass149637"><b>Target</b></a> targets</li></ul><p>Stereotype: list</p>
-<a name="refrelation172677"></a>
-<table><tr><td><div class="element">Relation <b>params (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # params : <a href="class134533.html#refclass134533"><b>Parameter</b></a></li><li>C++ : protected: <a href="class134533.html#refclass134533"><b>Parameter</b></a> params</li></ul><p>Stereotype: list</p>
-</div>
+<p>Declaration :</p><ul><li>C++ : class CmdClosure </li></ul><p>Directly inherited by : <a href="class150917.html#refclass150917"><b>ArgumentHolder</b></a> <a href="class150789.html#refclass150789"><b>Closure</b></a> </p>
 </body>
 </html>
diff --git a/doc/devel/uml/class149637.html b/doc/devel/uml/class149637.html
index da4da6a27..21f30ad43 100644
--- a/doc/devel/uml/class149637.html
+++ b/doc/devel/uml/class149637.html
@@ -4,17 +4,17 @@
 <html xmlns="http://www.w3.org/1999/xhtml">
 
 <head>
-<title>Class Target</title>
+<title>Class ParamAccessor</title>
 <link rel="stylesheet" href="style.css" type="text/css" />
 </head>
 
 <body bgcolor="#ffffff">
 
-<div class = "title">Class Target</div>
+<div class = "title">Class ParamAccessor</div>
 <p></p>
 
 <!-- ============================================================= -->
 
 <a name="refclass149637"></a>
-<p>Declaration :</p><ul><li>C++ : class Target </li></ul></body>
+<p>Declaration :</p><ul><li>C++ : template&lt;class TY&gt; class ParamAccessor </li></ul></body>
 </html>
diff --git a/doc/devel/uml/class150789.html b/doc/devel/uml/class150789.html
new file mode 100644
index 000000000..f6e0b20ae
--- /dev/null
+++ b/doc/devel/uml/class150789.html
@@ -0,0 +1,24 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class Closure</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class Closure</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass150789"></a>
+<p>Declaration :</p><ul><li>C++ : template&lt;class SIG&gt; class Closure : public <a href="class148997.html#refclass148997"><b>CmdClosure</b></a> </li></ul><div class="sub">
+<a name="refrelation175109"></a>
+<table><tr><td><div class="element">Relation <b>params (&lt;directional composition&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # params : <a href="class149637.html#refclass149637"><b>ParamAccessor</b></a></li><li>C++ : protected: <a href="class149637.html#refclass149637"><b>ParamAccessor</b></a> params</li></ul><p>Stereotype: tuple</p>
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/class150917.html b/doc/devel/uml/class150917.html
new file mode 100644
index 000000000..2332f06df
--- /dev/null
+++ b/doc/devel/uml/class150917.html
@@ -0,0 +1,24 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>Class ArgumentHolder</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">Class ArgumentHolder</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<a name="refclass150917"></a>
+<p>Declaration :</p><ul><li>C++ : template&lt;class SIG&gt; class ArgumentHolder : public <a href="class148997.html#refclass148997"><b>CmdClosure</b></a> </li></ul><div class="sub">
+<a name="refrelation175493"></a>
+<table><tr><td><div class="element">Relation <b>arguments (&lt;unidirectional association&gt;)</b></div></td></tr></table><p>Declaration :</p><ul><li>Uml : # arguments : <a href="class150789.html#refclass150789"><b>Closure</b></a>, multiplicity : 1</li><li>C++ : protected: <a href="class150789.html#refclass150789"><b>Closure</b></a>* arguments</li></ul><p>Stereotype: manages</p>
+</div>
+</body>
+</html>
diff --git a/doc/devel/uml/classes.html b/doc/devel/uml/classes.html
index 8c54eb58f..ebec4c117 100644
--- a/doc/devel/uml/classes.html
+++ b/doc/devel/uml/classes.html
@@ -21,6 +21,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class129541.html#refclass129541" target = "projectFrame"><b>Allocation</b></a></td><td></td><td>a directive to place a MObject in a specific way</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135429.html#refclass135429" target = "projectFrame"><b>Appconfig</b></a></td><td>singleton</td><td>Singleton to hold inevitable global flags and constants and for performing erarly (static) global initialization tasks.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140293.html#refclass140293" target = "projectFrame"><b>Applicable</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class150917.html#refclass150917" target = "projectFrame"><b>ArgumentHolder</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131077.html#refclass131077" target = "projectFrame"><b>Assembler</b></a></td><td></td><td>This is the actual building facility: provided the correct tools and associations, it serves to build and connect the individual ProcNode objects</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refclass136453" target = "projectFrame"><b>Asset</b></a></td><td>interface</td><td>Superinterface describing especially the bookeeping properties of Assets</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136581.html#refclass136581" target = "projectFrame"><b>AssetManager</b></a></td><td>boundary</td><td>Facade for the Asset subsystem</td></tr>
@@ -38,6 +39,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class137221.html#refclass137221" target = "projectFrame"><b>Category</b></a></td><td></td><td>tree like classification of Assets</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a></td><td></td><td>bookkeeping (asset) view of a media clip.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class150789.html#refclass150789" target = "projectFrame"><b>Closure</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class148997.html#refclass148997" target = "projectFrame"><b>CmdClosure</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a></td><td></td><td>description of some media data decoder or encoder facility</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135045.html#refclass135045" target = "projectFrame"><b>CodecAdapter</b></a></td><td></td><td></td></tr>
@@ -107,6 +109,7 @@
 <tr bgcolor=#f0f0f0><td><a href="class134405.html#refclass134405" target = "projectFrame"><b>NodeCreatorTool</b></a></td><td></td><td>This Tool implementation plays the central role in the buld process: given a MObject from Session, it is able to attach ProcNodes to the render engine under construction such as to reflect the properties of the MObject in the actual render.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143365.html#refclass143365" target = "projectFrame"><b>NodeWiring</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143493.html#refclass143493" target = "projectFrame"><b>OperationBase</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149637.html#refclass149637" target = "projectFrame"><b>ParamAccessor</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134533.html#refclass134533" target = "projectFrame"><b>Parameter</b></a></td><td></td><td>Descriptor and access object for a plugin parameter. Parameters may be provided with values from the session, and this values may be automated.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134661.html#refclass134661" target = "projectFrame"><b>ParamProvider</b></a></td><td>interface</td><td>A facility to get the actual value of a plugin/effect parameter</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130437.html#refclass130437" target = "projectFrame"><b>PathManager</b></a></td><td></td><td>While building a render engine, this Strategy class decides on the actual render strategy in accordance to the current controller settings (system state)</td></tr>
@@ -164,7 +167,6 @@
 <tr bgcolor=#f0f0f0><td><a href="class145157.html#refclass145157" target = "projectFrame"><b>StreamTypeID</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136965.html#refclass136965" target = "projectFrame"><b>Struct</b></a></td><td></td><td>key abstraction: structural asset</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145413.html#refclass145413" target = "projectFrame"><b>STypeManager</b></a></td><td></td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class149637.html#refclass149637" target = "projectFrame"><b>Target</b></a></td><td></td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128138.html#refclass128138" target = "projectFrame"><b>Thread</b></a></td><td></td><td>We can basically reuse the Thread class design from Cinelerra2, Thread becomes a baseclass for all Threads </td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134917.html#refclass134917" target = "projectFrame"><b>Time</b></a></td><td></td><td>denotes a temporal position (time point), based on timeline start.<br /><br />investigate posix.4 realtime timers, wrap these here</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145541.html#refclass145541" target = "projectFrame"><b>Timeline</b></a></td><td></td><td></td></tr>
diff --git a/doc/devel/uml/classes_list.html b/doc/devel/uml/classes_list.html
index c9f7a4cd0..173ec52e4 100644
--- a/doc/devel/uml/classes_list.html
+++ b/doc/devel/uml/classes_list.html
@@ -22,6 +22,7 @@
 <a href="class129541.html#refclass129541" target = "projectFrame"><b>Allocation</b></a><br />
 <a href="class135429.html#refclass135429" target = "projectFrame"><b>Appconfig</b></a><br />
 <a href="class140293.html#refclass140293" target = "projectFrame"><b>Applicable</b></a><br />
+<a href="class150917.html#refclass150917" target = "projectFrame"><b>ArgumentHolder</b></a><br />
 <a href="class131077.html#refclass131077" target = "projectFrame"><b>Assembler</b></a><br />
 <a href="class136453.html#refclass136453" target = "projectFrame"><b>Asset</b></a><br />
 <a href="class136581.html#refclass136581" target = "projectFrame"><b>AssetManager</b></a><br />
@@ -39,6 +40,7 @@
 <a href="class137221.html#refclass137221" target = "projectFrame"><b>Category</b></a><br />
 <a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a><br />
 <a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a><br />
+<a href="class150789.html#refclass150789" target = "projectFrame"><b>Closure</b></a><br />
 <a href="class148997.html#refclass148997" target = "projectFrame"><b>CmdClosure</b></a><br />
 <a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a><br />
 <a href="class135045.html#refclass135045" target = "projectFrame"><b>CodecAdapter</b></a><br />
@@ -108,6 +110,7 @@
 <a href="class134405.html#refclass134405" target = "projectFrame"><b>NodeCreatorTool</b></a><br />
 <a href="class143365.html#refclass143365" target = "projectFrame"><b>NodeWiring</b></a><br />
 <a href="class143493.html#refclass143493" target = "projectFrame"><b>OperationBase</b></a><br />
+<a href="class149637.html#refclass149637" target = "projectFrame"><b>ParamAccessor</b></a><br />
 <a href="class134533.html#refclass134533" target = "projectFrame"><b>Parameter</b></a><br />
 <a href="class134661.html#refclass134661" target = "projectFrame"><b>ParamProvider</b></a><br />
 <a href="class130437.html#refclass130437" target = "projectFrame"><b>PathManager</b></a><br />
@@ -165,7 +168,6 @@
 <a href="class145157.html#refclass145157" target = "projectFrame"><b>StreamTypeID</b></a><br />
 <a href="class136965.html#refclass136965" target = "projectFrame"><b>Struct</b></a><br />
 <a href="class145413.html#refclass145413" target = "projectFrame"><b>STypeManager</b></a><br />
-<a href="class149637.html#refclass149637" target = "projectFrame"><b>Target</b></a><br />
 <a href="class128138.html#refclass128138" target = "projectFrame"><b>Thread</b></a><br />
 <a href="class134917.html#refclass134917" target = "projectFrame"><b>Time</b></a><br />
 <a href="class145541.html#refclass145541" target = "projectFrame"><b>Timeline</b></a><br />
diff --git a/doc/devel/uml/fig134021.png b/doc/devel/uml/fig134021.png
index c3acb367712339244e02e7d4a2162a58d493ae2c..edd5445309c667b0a405a52bc64987340ca07910 100644
GIT binary patch
literal 24839
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
IDw;p}ALuGWtN;K2

literal 23301
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
TkwY+I8gWM3P%BTv=8yjYlT|l%

diff --git a/doc/devel/uml/fig135173.png b/doc/devel/uml/fig135173.png
new file mode 100644
index 0000000000000000000000000000000000000000..4097c8a391ff01932f03b27271a3d96bb8c64428
GIT binary patch
literal 11554
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

literal 0
HcmV?d00001

diff --git a/doc/devel/uml/index.html b/doc/devel/uml/index.html
index 2e6e4c680..4cbf83614 100644
--- a/doc/devel/uml/index.html
+++ b/doc/devel/uml/index.html
@@ -147,7 +147,7 @@ Documentation</title>
 <table><tr><td><div class="element">Artifact <b>Lumiera</b></div></td></tr></table>
 <p>the main executable to be built<br /></p>
 <p>Depends on <a href="index.html#refpackage129413"><b>common</b></a></p><p>Depends on <a href="index.html#refpackage129797"><b>gui</b></a></p><p>Depends on <a href="index.html#refpackage129669"><b>proc</b></a></p><p>Depends on <a href="index.html#refpackage129541"><b>backend</b></a></p><p>Stereotype: executable</p>
-<p><i>executable</i> associated with : <a href="index.html#refartifact129029"><b>placement</b></a>, <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, <a href="index.html#refartifact130437"><b>builderfacade</b></a>, <a href="index.html#refartifact133893"><b>aframe</b></a>, <a href="index.html#refartifact130821"><b>assembler</b></a>, <a href="index.html#refartifact132485"><b>trafo</b></a>, <a href="index.html#refartifact130053"><b>allocation</b></a>, <a href="index.html#refartifact134021"><b>vframe</b></a>, <a href="index.html#refartifact130565"><b>toolfactory</b></a>, <a href="index.html#refartifact132741"><b>hub</b></a>, <a href="index.html#refartifact131077"><b>buildable</b></a>, <a href="index.html#refartifact129285"><b>abstractmo</b></a>, <a href="index.html#refartifact132229"><b>exitnode</b></a>, <a href="index.html#refartifact131717"><b>pathmanager</b></a>, <a href="index.html#refartifact128901"><b>track</b></a>, <a href="index.html#refartifact129669"><b>meta</b></a>, <a href="index.html#refartifact129797"><b>fixedlocation</b></a>, <a href="index.html#refartifact129925"><b>relativelocation</b></a>, <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, <a href="index.html#refartifact132101"><b>rendergraph</b></a>, <a href="index.html#refartifact133125"><b>pluginadapter</b></a>, <a href="index.html#refartifact129157"><b>explicitplacement</b></a>, <a href="index.html#refartifact130309"><b>auto</b></a>, <a href="index.html#refartifact133637"><b>glrender</b></a>, <a href="index.html#refartifact133381"><b>arender</b></a>, <a href="index.html#refartifact131845"><b>renderstate</b></a>, <a href="index.html#refartifact130181"><b>label</b></a>, <a href="index.html#refartifact131461"><b>nodecreatertool</b></a>, <a href="index.html#refartifact132869"><b>projector</b></a>, <a href="index.html#refartifact134661"><b>interpolator</b></a>, <a href="index.html#refartifact134533"><b>paramprovider</b></a>, <a href="index.html#refartifact132997"><b>mask</b></a>, <a href="index.html#refartifact128261"><b>mobject</b></a>, <a href="index.html#refartifact134277"><b>source</b></a>, <a href="index.html#refartifact133765"><b>frame</b></a>, <a href="index.html#refartifact129541"><b>effect</b></a>, <a href="index.html#refartifact131205"><b>buildertool</b></a>, <a href="index.html#refartifact131333"><b>segmentationtool</b></a>, <a href="index.html#refartifact132613"><b>link</b></a>, <a href="index.html#refartifact134405"><b>parameter</b></a>, <a href="index.html#refartifact131973"><b>renderengine</b></a>, <a href="index.html#refartifact134149"><b>glbuf</b></a>, <a href="index.html#refartifact132357"><b>procnode</b></a>, <a href="index.html#refartifact130949"><b>stateproxy</b></a>, <a href="index.html#refartifact128645"><b>edl</b></a>, <a href="index.html#refartifact128773"><b>fixture</b></a>, <a href="index.html#refartifact133253"><b>glpipe</b></a>, <a href="index.html#refartifact128133"><b>main</b></a>, <a href="index.html#refartifact130693"><b>conmanager</b></a>, <a href="index.html#refartifact129413"><b>clip</b></a>, <a href="index.html#refartifact133509"><b>vrender</b></a></p>
+<p><i>executable</i> associated with : <a href="index.html#refartifact130053"><b>allocation</b></a>, <a href="index.html#refartifact134021"><b>vframe</b></a>, <a href="index.html#refartifact130565"><b>toolfactory</b></a>, <a href="index.html#refartifact132741"><b>hub</b></a>, <a href="index.html#refartifact131077"><b>buildable</b></a>, <a href="index.html#refartifact129285"><b>abstractmo</b></a>, <a href="index.html#refartifact132229"><b>exitnode</b></a>, <a href="index.html#refartifact131717"><b>pathmanager</b></a>, <a href="index.html#refartifact128901"><b>track</b></a>, <a href="index.html#refartifact129669"><b>meta</b></a>, <a href="index.html#refartifact129797"><b>fixedlocation</b></a>, <a href="index.html#refartifact129925"><b>relativelocation</b></a>, <a href="index.html#refartifact131589"><b>controllerfacade</b></a>, <a href="index.html#refartifact132101"><b>rendergraph</b></a>, <a href="index.html#refartifact133125"><b>pluginadapter</b></a>, <a href="index.html#refartifact129157"><b>explicitplacement</b></a>, <a href="index.html#refartifact130309"><b>auto</b></a>, <a href="index.html#refartifact133637"><b>glrender</b></a>, <a href="index.html#refartifact133381"><b>arender</b></a>, <a href="index.html#refartifact131845"><b>renderstate</b></a>, <a href="index.html#refartifact130181"><b>label</b></a>, <a href="index.html#refartifact131461"><b>nodecreatertool</b></a>, <a href="index.html#refartifact132869"><b>projector</b></a>, <a href="index.html#refartifact134661"><b>interpolator</b></a>, <a href="index.html#refartifact134533"><b>paramprovider</b></a>, <a href="index.html#refartifact132997"><b>mask</b></a>, <a href="index.html#refartifact128261"><b>mobject</b></a>, <a href="index.html#refartifact134277"><b>source</b></a>, <a href="index.html#refartifact133765"><b>frame</b></a>, <a href="index.html#refartifact129541"><b>effect</b></a>, <a href="index.html#refartifact131205"><b>buildertool</b></a>, <a href="index.html#refartifact131333"><b>segmentationtool</b></a>, <a href="index.html#refartifact132613"><b>link</b></a>, <a href="index.html#refartifact134405"><b>parameter</b></a>, <a href="index.html#refartifact131973"><b>renderengine</b></a>, <a href="index.html#refartifact134149"><b>glbuf</b></a>, <a href="index.html#refartifact132357"><b>procnode</b></a>, <a href="index.html#refartifact130949"><b>stateproxy</b></a>, <a href="index.html#refartifact128645"><b>edl</b></a>, <a href="index.html#refartifact128773"><b>fixture</b></a>, <a href="index.html#refartifact133253"><b>glpipe</b></a>, <a href="index.html#refartifact128133"><b>main</b></a>, <a href="index.html#refartifact130693"><b>conmanager</b></a>, <a href="index.html#refartifact129413"><b>clip</b></a>, <a href="index.html#refartifact133509"><b>vrender</b></a>, <a href="index.html#refartifact129029"><b>placement</b></a>, <a href="index.html#refartifact128517"><b>sessionimpl</b></a>, <a href="index.html#refartifact130437"><b>builderfacade</b></a>, <a href="index.html#refartifact133893"><b>aframe</b></a>, <a href="index.html#refartifact130821"><b>assembler</b></a>, <a href="index.html#refartifact132485"><b>trafo</b></a></p>
 <a name="refartifact128133"></a>
 <table><tr><td><div class="element">Artifact <b>main</b></div></td></tr></table>
 <p>Stereotype: source</p>
@@ -844,8 +844,106 @@ reuse exiting Engine</pre></li></ul><p>Selection :</p><ul></ul><p>Transformation
 <table><tr><td><div class="element">Class <b><a href="class149253.html#refclass149253"><b>DoAsync</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class149381.html#refclass149381"><b>UndoSync</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class149509.html#refclass149509"><b>RedoLast</b></a></b></div></td></tr></table>
-<table><tr><td><div class="element">Class <b><a href="class149637.html#refclass149637"><b>Target</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class149637.html#refclass149637"><b>ParamAccessor</b></a></b></div></td></tr></table>
 <table><tr><td><div class="element">Class <b><a href="class141957.html#refclass141957"><b>ProcDispatcher</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class150789.html#refclass150789"><b>Closure</b></a></b></div></td></tr></table>
+<table><tr><td><div class="element">Class <b><a href="class150917.html#refclass150917"><b>ArgumentHolder</b></a></b></div></td></tr></table>
+<a name="refstate machine128005"></a>
+<h4 class ="state">2.2.2.1 StateMachine Lifecycle</h4>
+<p>Entry Behavior :</p><ul></ul><p>Exit Behavior :</p><ul></ul><p>Do activity :</p><ul></ul><p>Stereotype: machine</p>
+<div class="sub">
+<a name="refstate diagram135173"></a>
+<p align="center"><img src="fig135173.png" alt="" /></p>
+ <p align="center"><b>Command lifecycle</b></p><p><br /></p><p><br /></p>
+<a name="refentry point pseudo state128005"></a>
+<a name="refentry point pseudo state128005"></a>
+<table><tr><td><div class="element">Entry point pseudo state <b>ID</b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refentry point pseudo state128005"><b>ID</b></a> To <a href="index.html#refstate action128005"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128005"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>try to fetch existing definition<br /></p>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+fetch def</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128005"><b>state action</b></a> To <a href="index.html#refchoice pseudo state128133"><b>choice pseudo state</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate128133"></a>
+<h4 class ="state">2.2.2.1.1 State scratch</h4>
+<p>Entry Behavior :</p><ul></ul><p>Exit Behavior :</p><ul></ul><p>Do activity :</p><ul></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate128133"><b>scratch</b></a> To <a href="index.html#refstate action128133"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128133"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+def DO</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128133"><b>state action</b></a> To <a href="index.html#reffork pseudo state128261"><b>fork pseudo state</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul><table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128133"><b>state action</b></a> To <a href="index.html#refstate action128261"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul><table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128133"><b>state action</b></a> To <a href="index.html#refstate action128517"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128261"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+def CAP</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128261"><b>state action</b></a> To <a href="index.html#refstate action128389"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128389"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+def UNDO</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128389"><b>state action</b></a> To <a href="index.html#refstate128261"><b>CmdDef</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128517"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+def UNDO</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128517"><b>state action</b></a> To <a href="index.html#refstate action128645"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128645"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+def CAP</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128645"><b>state action</b></a> To <a href="index.html#refstate128261"><b>CmdDef</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate128261"></a>
+<h4 class ="state">2.2.2.1.2 State CmdDef</h4>
+<p>Entry Behavior :</p><ul></ul><p>Exit Behavior :</p><ul></ul><p>Do activity :</p><ul></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate128261"><b>CmdDef</b></a> To <a href="index.html#refstate action128773"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action128773"></a>
+<table><tr><td><div class="element">State action <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+bind</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action128773"><b>state action</b></a> To <a href="index.html#refstate128389"><b>Command</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate128389"></a>
+<h4 class ="state">2.2.2.1.3 State Command</h4>
+<p>Entry Behavior :</p><ul></ul><p>Exit Behavior :</p><ul></ul><p>Do activity :</p><ul></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate128389"><b>Command</b></a> To <a href="index.html#refstate action129029"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate action129029"></a>
+<table><tr><td><div class="element">State action send-signal <b></b></div></td></tr></table>
+<p>Stereotype: send-signal</p>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+exec pattern</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action129029"><b>state action</b></a> To <a href="index.html#refstate128517"><b>undo-able</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refstate128517"></a>
+<h4 class ="state">2.2.2.1.4 State undo-able</h4>
+<p>Entry Behavior :</p><ul></ul><p>Exit Behavior :</p><ul></ul><p>Do activity :</p><ul></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate128517"><b>undo-able</b></a> To <a href="index.html#refexit point pseudo state128517"><b>done</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul><table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate128517"><b>undo-able</b></a> To <a href="index.html#refstate action129157"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul><table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate128517"><b>undo-able</b></a> To <a href="index.html#refstate action129029"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="refchoice pseudo state128133"></a>
+<a name="refchoice pseudo state128133"></a>
+<table><tr><td><div class="element">Choice pseudo state <b></b></div></td></tr></table>
+<p>Stereotype: try</p>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refchoice pseudo state128133"><b>choice pseudo state</b></a> To <a href="index.html#refstate128133"><b>scratch</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul><li>OCL : <pre>
+not found</pre></li></ul><table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refchoice pseudo state128133"><b>choice pseudo state</b></a> To <a href="index.html#refstate128261"><b>CmdDef</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul><li>OCL : <pre>
+found</pre></li></ul></div>
+<a name="reffork pseudo state128261"></a>
+<a name="reffork pseudo state128261"></a>
+<table><tr><td><div class="element">Fork pseudo state <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#reffork pseudo state128261"><b>fork pseudo state</b></a> To <a href="index.html#refstate action128261"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul><table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#reffork pseudo state128261"><b>fork pseudo state</b></a> To <a href="index.html#refstate action128517"><b>state action</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+<a name="reffork pseudo state128389"></a>
+<a name="reffork pseudo state128389"></a>
+<table><tr><td><div class="element">Fork pseudo state <b></b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><a name="refexit point pseudo state128517"></a>
+<a name="refexit point pseudo state128517"></a>
+<table><tr><td><div class="element">Exit point pseudo state <b>done</b></div></td></tr></table>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><a name="refstate action129157"></a>
+<table><tr><td><div class="element">State action send-signal <b></b></div></td></tr></table>
+<p>Stereotype: send-signal</p>
+<p>Defined in <a href="index.html#refstate machine128005"><b>Lifecycle</b></a></p><p>Expression :</p><ul><li>OCL : <pre>
+undo</pre></li></ul><div class="sub">
+<table><tr><td><div class="element">Transition  <b>&lt;transition&gt;</div></td></tr></table><p>From <a href="index.html#refstate action129157"><b>state action</b></a> To <a href="index.html#refstate128517"><b>undo-able</b></a></p><p>Trigger :</p><ul></ul><p>Guard :</p><ul></ul><p>Activity :</p><ul></ul></div>
+</div>
 </div>
 </div>
 <a name="refpackage128261"></a>
diff --git a/doc/devel/uml/index_60.html b/doc/devel/uml/index_60.html
index 8712d7074..ab6befaf1 100644
--- a/doc/devel/uml/index_60.html
+++ b/doc/devel/uml/index_60.html
@@ -28,8 +28,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131461" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130693" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129029" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131717" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130181" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131717" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130949" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131077" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130053" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
@@ -37,6 +37,28 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130565" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition131333" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129157" target = "projectFrame"><b>&lt;flow&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128133" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128005" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129797" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130053" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128517" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128645" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128901" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128261" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128389" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129925" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129285" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition128773" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130565" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129413" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130181" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129029" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129541" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129669" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition129157" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130693" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130437" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reftransition130309" target = "projectFrame"><b>&lt;transition&gt;</b></a></td><td>transition</td><td></td></tr>
 </table>
 </body>
 </html>
diff --git a/doc/devel/uml/index_65.html b/doc/devel/uml/index_65.html
index da137cab0..38dfaced6 100644
--- a/doc/devel/uml/index_65.html
+++ b/doc/devel/uml/index_65.html
@@ -41,6 +41,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134789" target = "projectFrame"><b>apply</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent view128005" target = "projectFrame"><b>Architecture</b></a></td><td>component view</td><td>The various Components comprising the Lumiera Video editing Application</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact133381" target = "projectFrame"><b>arender</b></a></td><td>artifact</td><td>Representation of a Audio Render process</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class150917.html#refclass150917" target = "projectFrame"><b>ArgumentHolder</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation175493" target = "projectFrame"><b>arguments</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131077.html#refclass131077" target = "projectFrame"><b>Assembler</b></a></td><td>class</td><td>This is the actual building facility: provided the correct tools and associations, it serves to build and connect the individual ProcNode objects</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact130821" target = "projectFrame"><b>assembler</b></a></td><td>artifact</td><td>building facility (implementation of the build process)</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class136453.html#refclass136453" target = "projectFrame"><b>Asset</b></a></td><td>class</td><td>Superinterface describing especially the bookeeping properties of Assets</td></tr>
@@ -58,8 +60,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131845" target = "projectFrame"><b>aud_a</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128773" target = "projectFrame"><b>aud_A</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131205" target = "projectFrame"><b>audio</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128901" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128389" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128901" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130821" target = "projectFrame"><b>audio1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact130309" target = "projectFrame"><b>auto</b></a></td><td>artifact</td><td>Media Object holding automation data</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129925.html#refclass129925" target = "projectFrame"><b>Auto</b></a></td><td>class</td><td>Automation data for some parameter (i.e. a time varying function)</td></tr>
diff --git a/doc/devel/uml/index_66.html b/doc/devel/uml/index_66.html
index 5a4df3c38..2788567d7 100644
--- a/doc/devel/uml/index_66.html
+++ b/doc/devel/uml/index_66.html
@@ -37,8 +37,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact131077" target = "projectFrame"><b>buildable</b></a></td><td>artifact</td><td>marker interface denoting any MObject able to be treated by Tools</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation128517" target = "projectFrame"><b>buildEngine</b></a></td><td>operation</td><td>Main Operation of the Builder: create a render engine for a given part of the timeline</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128005" target = "projectFrame"><b>Builder</b></a></td><td>component</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128901" target = "projectFrame"><b>Builder</b></a></td><td>package</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130565" target = "projectFrame"><b>builder</b></a></td><td>package</td><td>sourcecode package<br /><br />The Builder creating the Render Engine,<br />located within the MObject Subsystem</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128901" target = "projectFrame"><b>Builder</b></a></td><td>package</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132868" target = "projectFrame"><b>Builder Entities</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram129285" target = "projectFrame"><b>Builder Tool (Visitor)</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128261" target = "projectFrame"><b>Builder Workings</b></a></td><td>class view</td><td></td></tr>
diff --git a/doc/devel/uml/index_67.html b/doc/devel/uml/index_67.html
index 128becdac..a8a98a5d6 100644
--- a/doc/devel/uml/index_67.html
+++ b/doc/devel/uml/index_67.html
@@ -33,34 +33,35 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation145413" target = "projectFrame"><b>chain</b></a></td><td>relation</td><td>Chain of additional Placements further constraining the position of this MObject</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation129633" target = "projectFrame"><b>checked_in</b></a></td><td>relation</td><td>checked_in objects are subject of cache aging and must be not in use</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation129290" target = "projectFrame"><b>checked_out</b></a></td><td>relation</td><td>this list keeps all mappings which are in use, and thus prevents them from Cache aging</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135813" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refchoice pseudo state128133" target = "projectFrame"><b>choice pseudo state</b></a></td><td>choice pseudo state</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135301" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135557" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135685" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134661" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135429" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135173" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134789" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134917" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135045" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135173" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135301" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135685" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135429" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132485" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132229" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130053" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129797" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance135813" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128005" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131589" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132357" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128133" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128261" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130693" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133509" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130565" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130693" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129029" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130437" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130309" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130181" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129541" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132357" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129285" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131589" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128261" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129541" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130437" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132485" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130053" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132229" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133509" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129797" target = "projectFrame"><b>class instance</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation133765" target = "projectFrame"><b>clear</b></a></td><td>operation</td><td>clear current session contents <br />without resetting overall session config.<br />Afterwards, the session will contain only one <br />empty EDL, while all Assets are retained.<br /></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent131077" target = "projectFrame"><b>client code</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137349.html#refclass137349" target = "projectFrame"><b>Clip</b></a></td><td>class</td><td>bookkeeping (asset) view of a media clip.</td></tr>
@@ -69,14 +70,18 @@
 <tr bgcolor=#f0f0f0><td><a href="class128901.html#refclass128901" target = "projectFrame"><b>Clip</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128901" target = "projectFrame"><b>clips</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute133125" target = "projectFrame"><b>closure</b></a></td><td>attribute</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class150789.html#refclass150789" target = "projectFrame"><b>Closure</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class148997.html#refclass148997" target = "projectFrame"><b>CmdClosure</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128261" target = "projectFrame"><b>CmdDef</b></a></td><td>state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137861.html#refclass137861" target = "projectFrame"><b>Codec</b></a></td><td>class</td><td>description of some media data decoder or encoder facility</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137349" target = "projectFrame"><b>codec</b></a></td><td>artifact</td><td>description of some media data decoder or encoder facility</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135045.html#refclass135045" target = "projectFrame"><b>CodecAdapter</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134917" target = "projectFrame"><b>codecadapter</b></a></td><td>artifact</td><td>Processing Node for (de)coding media data</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128645" target = "projectFrame"><b>codegen</b></a></td><td>package</td><td>This package is used to organize code generation by BOUML. It is considered useless after having generated the initial code skeleton.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class148485.html#refclass148485" target = "projectFrame"><b>Command</b></a></td><td>class</td><td>Key abstraction for all proc/edit operations and UNDO management</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128389" target = "projectFrame"><b>Command</b></a></td><td>state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view130693" target = "projectFrame"><b>Command Handling</b></a></td><td>class view</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate diagram135173" target = "projectFrame"><b>Command lifecycle</b></a></td><td>state diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram134021" target = "projectFrame"><b>Command structure</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage129413" target = "projectFrame"><b>common</b></a></td><td>package</td><td>sourcecode package<br /><br />Common library and helper classes</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent129925" target = "projectFrame"><b>CommonLib</b></a></td><td>component</td><td></td></tr>
diff --git a/doc/devel/uml/index_68.html b/doc/devel/uml/index_68.html
index 40b7b291d..580695e3a 100644
--- a/doc/devel/uml/index_68.html
+++ b/doc/devel/uml/index_68.html
@@ -32,14 +32,15 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128138" target = "projectFrame"><b>design</b></a></td><td>package</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage128005" target = "projectFrame"><b>design</b></a></td><td>package</td><td>All things concering the big picture.<br />Not a real code package, rather a container for design drafts, specifications, decisions.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refuse case128261" target = "projectFrame"><b>detect Channels</b></a></td><td>use case</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refexpansion region128005" target = "projectFrame"><b>determine Render Params</b></a></td><td>expansion region</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refopaque activity action128389" target = "projectFrame"><b>determine Render Params</b></a></td><td>opaque activity action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refexpansion region128005" target = "projectFrame"><b>determine Render Params</b></a></td><td>expansion region</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132613" target = "projectFrame"><b>devnull</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128773" target = "projectFrame"><b>Dispatcher</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134917" target = "projectFrame"><b>dispatchOp</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132869" target = "projectFrame"><b>do</b></a></td><td>attribute</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class149253.html#refclass149253" target = "projectFrame"><b>DoAsync</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139141.html#refclass139141" target = "projectFrame"><b>DoAttach</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refexit point pseudo state128517" target = "projectFrame"><b>done</b></a></td><td>exit point pseudo state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139269.html#refclass139269" target = "projectFrame"><b>DoRecurse</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class149125.html#refclass149125" target = "projectFrame"><b>DoSync</b></a></td><td>class</td><td></td></tr>
 </table>
diff --git a/doc/devel/uml/index_69.html b/doc/devel/uml/index_69.html
index 0c6f365e7..3c4e4f7af 100644
--- a/doc/devel/uml/index_69.html
+++ b/doc/devel/uml/index_69.html
@@ -23,8 +23,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refobject diagram128901" target = "projectFrame"><b>EDL Example2</b></a></td><td>object diagram</td><td>More complex example showing the Object graph in the EDL and how it is linked into the Fixture to yield the actual locations. In this example, an HUE Effect is applied on a part of the Clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128005" target = "projectFrame"><b>edls</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class137733.html#refclass137733" target = "projectFrame"><b>Effect</b></a></td><td>class</td><td>Effect or media processing component</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137221" target = "projectFrame"><b>effect</b></a></td><td>artifact</td><td>Effect or media processing component</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact129541" target = "projectFrame"><b>effect</b></a></td><td>artifact</td><td>EDL representation of a pluggable and automatable effect.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refartifact137221" target = "projectFrame"><b>effect</b></a></td><td>artifact</td><td>Effect or media processing component</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129029.html#refclass129029" target = "projectFrame"><b>Effect</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refnode128005" target = "projectFrame"><b>effective timeline (Fixture)</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation131717" target = "projectFrame"><b>effectiveTimeline</b></a></td><td>relation</td><td></td></tr>
diff --git a/doc/devel/uml/index_70.html b/doc/devel/uml/index_70.html
index 777bf389c..93fe59aa1 100644
--- a/doc/devel/uml/index_70.html
+++ b/doc/devel/uml/index_70.html
@@ -40,6 +40,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128517" target = "projectFrame"><b>Fixture</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128261.html#refclass128261" target = "projectFrame"><b>Fixture</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#reffork activity node129029" target = "projectFrame"><b>fork activity node</b></a></td><td>fork activity node</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reffork pseudo state128261" target = "projectFrame"><b>fork pseudo state</b></a></td><td>fork pseudo state</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#reffork pseudo state128389" target = "projectFrame"><b>fork pseudo state</b></a></td><td>fork pseudo state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128821.html#refclass128821" target = "projectFrame"><b>Frame</b></a></td><td>class</td><td>Frames are just a low level lump of continous memory, most parts are opaque. Frames are memory sensitive, they will be small constant sized structures which can be efficently managed in a pool.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refnode128645" target = "projectFrame"><b>Frame</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133253.html#refclass133253" target = "projectFrame"><b>Frame</b></a></td><td>class</td><td>TODO: how to relate to Cehteh's Frame entity in the Backend?<br />The latter is the fundamental Frame entity, wheras this Object rather represents a buffer set containing frame date</td></tr>
diff --git a/doc/devel/uml/index_72.html b/doc/devel/uml/index_72.html
index 90532e3e5..7356cb17f 100644
--- a/doc/devel/uml/index_72.html
+++ b/doc/devel/uml/index_72.html
@@ -24,8 +24,8 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram130181" target = "projectFrame"><b>Hierarchy</b></a></td><td>class diagram</td><td>Lumiera Exception hierarchy</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation133381" target = "projectFrame"><b>howtoProc</b></a></td><td>operation</td><td>@return descriptor how to build a render pipeline corresponding to this media</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132741" target = "projectFrame"><b>hub</b></a></td><td>artifact</td><td>special ProcNode used to build data distributing connections</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133893" target = "projectFrame"><b>HUE</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133253" target = "projectFrame"><b>HUE</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133893" target = "projectFrame"><b>HUE</b></a></td><td>class instance</td><td></td></tr>
 </table>
 </body>
 </html>
diff --git a/doc/devel/uml/index_73.html b/doc/devel/uml/index_73.html
index 8dc64d64b..1e264158e 100644
--- a/doc/devel/uml/index_73.html
+++ b/doc/devel/uml/index_73.html
@@ -19,12 +19,13 @@
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130437" target = "projectFrame"><b>id</b></a></td><td>attribute</td><td>Asset primary key.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132613" target = "projectFrame"><b>ID</b></a></td><td>attribute</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refentry point pseudo state128005" target = "projectFrame"><b>ID</b></a></td><td>entry point pseudo state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class145029.html#refclass145029" target = "projectFrame"><b>ImplFacade</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128309" target = "projectFrame"><b>In Memory Database</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity action pin128133" target = "projectFrame"><b>inFixture</b></a></td><td>activity action pin</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131461" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132869" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134149" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131461" target = "projectFrame"><b>input</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation131461" target = "projectFrame"><b>instance</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class147205.html#refclass147205" target = "projectFrame"><b>InstanceHandle</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation143621" target = "projectFrame"><b>instructions</b></a></td><td>relation</td><td></td></tr>
diff --git a/doc/devel/uml/index_76.html b/doc/devel/uml/index_76.html
index 0689ba659..bdd59ab29 100644
--- a/doc/devel/uml/index_76.html
+++ b/doc/devel/uml/index_76.html
@@ -22,6 +22,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132869" target = "projectFrame"><b>Layer Separation Interface</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute128517" target = "projectFrame"><b>length</b></a></td><td>attribute</td><td>TODO: how to represent time intervals?</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130053" target = "projectFrame"><b>length</b></a></td><td>attribute</td><td>duration (span) of this timeline segment.</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate machine128005" target = "projectFrame"><b>Lifecycle</b></a></td><td>state machine</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class131973.html#refclass131973" target = "projectFrame"><b>Link</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132613" target = "projectFrame"><b>link</b></a></td><td>artifact</td><td>forwarding, adapting or connecting ProcNode</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134021" target = "projectFrame"><b>load</b></a></td><td>operation</td><td>replace the current session by a new<br />session loaded from serialized state.</td></tr>
diff --git a/doc/devel/uml/index_79.html b/doc/devel/uml/index_79.html
index d7e2263c6..0f0da521d 100644
--- a/doc/devel/uml/index_79.html
+++ b/doc/devel/uml/index_79.html
@@ -20,9 +20,9 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute129029" target = "projectFrame"><b>offset</b></a></td><td>attribute</td><td>Offset the actual position by this (time) value relative to the anchor point. TODO: Representation?</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class143493.html#refclass143493" target = "projectFrame"><b>OperationBase</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130821" target = "projectFrame"><b>org</b></a></td><td>attribute</td><td>origin or authorship id. Can be a project abbreviation, a package id or just the authors nickname or UID. This allows for the compnent name to be more generic (e.g. "blur"). Default for all assets provided by the core Lumiera codebase is "lumi".</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131333" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134405" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133125" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131333" target = "projectFrame"><b>ouput</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation147973" target = "projectFrame"><b>outPort</b></a></td><td>relation</td><td>the Port this MObject wants to be conected to</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent diagram128005" target = "projectFrame"><b>Overview</b></a></td><td>component diagram</td><td>This drawing shows the top level compoents and relations</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refdeployment diagram128261" target = "projectFrame"><b>Overview Render Engine</b></a></td><td>deployment diagram</td><td></td></tr>
diff --git a/doc/devel/uml/index_80.html b/doc/devel/uml/index_80.html
index a9a67427a..fc2fcf572 100644
--- a/doc/devel/uml/index_80.html
+++ b/doc/devel/uml/index_80.html
@@ -18,11 +18,12 @@
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation137989" target = "projectFrame"><b>param</b></a></td><td>relation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="class149637.html#refclass149637" target = "projectFrame"><b>ParamAccessor</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134405" target = "projectFrame"><b>parameter</b></a></td><td>artifact</td><td>representation of an automatable effect/plugin parameter</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134533.html#refclass134533" target = "projectFrame"><b>Parameter</b></a></td><td>class</td><td>Descriptor and access object for a plugin parameter. Parameters may be provided with values from the session, and this values may be automated.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134533" target = "projectFrame"><b>paramprovider</b></a></td><td>artifact</td><td>interface denoting a source for actual Parameter values</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class134661.html#refclass134661" target = "projectFrame"><b>ParamProvider</b></a></td><td>class</td><td>A facility to get the actual value of a plugin/effect parameter</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation172677" target = "projectFrame"><b>params</b></a></td><td>relation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation175109" target = "projectFrame"><b>params</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation137861" target = "projectFrame"><b>params</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class130437.html#refclass130437" target = "projectFrame"><b>PathManager</b></a></td><td>class</td><td>While building a render engine, this Strategy class decides on the actual render strategy in accordance to the current controller settings (system state)</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact131717" target = "projectFrame"><b>pathmanager</b></a></td><td>artifact</td><td>Manager for deciding the actual render strategy</td></tr>
diff --git a/doc/devel/uml/index_83.html b/doc/devel/uml/index_83.html
index ceab40c4a..fa8dc7579 100644
--- a/doc/devel/uml/index_83.html
+++ b/doc/devel/uml/index_83.html
@@ -20,6 +20,7 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute129157" target = "projectFrame"><b>SAMETIME</b></a></td><td>attribute</td><td>place subject at the sime time as the anchor</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134149" target = "projectFrame"><b>save</b></a></td><td>operation</td><td>create a complete, serialized representation<br />of the current session config and contents.<br />@todo how to serialize, prameters, return value?</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class129205.html#refclass129205" target = "projectFrame"><b>Scheduler</b></a></td><td>class</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128133" target = "projectFrame"><b>scratch</b></a></td><td>state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact135045" target = "projectFrame"><b>segment</b></a></td><td>artifact</td><td>Segment of the Timeline.<br />Used at the moment (7/07) for partitioning the timeline/fixture into segments<br />to be rendered by a specialized render node network for each, without the need<br />to change any connections within a given segment. <br />Note this concept may be superfluos alltogether; is a draft and the real<br />use still needs to be worked out...</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135173.html#refclass135173" target = "projectFrame"><b>Segment</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity object128005" target = "projectFrame"><b>segment Tool</b></a></td><td>activity object</td><td></td></tr>
@@ -36,8 +37,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class146821.html#refclass146821" target = "projectFrame"><b>ServiceImpl</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refcomponent128133" target = "projectFrame"><b>Session</b></a></td><td>component</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact138757" target = "projectFrame"><b>session</b></a></td><td>artifact</td><td>Interface: the session edited by the user</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130437" target = "projectFrame"><b>session</b></a></td><td>package</td><td>sourcecode package<br /><br />Everything concerning the EDL and Session, within the MObject Subsystem</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128005" target = "projectFrame"><b>Session</b></a></td><td>class view</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130437" target = "projectFrame"><b>session</b></a></td><td>package</td><td>sourcecode package<br /><br />Everything concerning the EDL and Session, within the MObject Subsystem</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class139653.html#refclass139653" target = "projectFrame"><b>Session</b></a></td><td>class</td><td>Primary Interface for all editing tasks.<br />The session contains defaults, all the assets being edited, and a set of EDL with the individual MObjects to be manipulated and rendered.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram128133" target = "projectFrame"><b>Session structure</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact128517" target = "projectFrame"><b>sessionimpl</b></a></td><td>artifact</td><td>holds the complete session data to be edited by the user</td></tr>
@@ -51,8 +52,8 @@
 <tr bgcolor=#f0f0f0><td><a href="class138885.html#refclass138885" target = "projectFrame"><b>SimpleClip</b></a></td><td>class</td><td>Elementary clip consisting of only one media stream</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class128906.html#refclass128906" target = "projectFrame"><b>SmartPointer</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass view128266" target = "projectFrame"><b>SmartPointers</b></a></td><td>class view</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation141957" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>media source of this clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation142469" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>the media source this clip referes to</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation141957" target = "projectFrame"><b>source</b></a></td><td>relation</td><td>media source of this clip</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class133765.html#refclass133765" target = "projectFrame"><b>Source</b></a></td><td>class</td><td>Source Node: represents a media source to pull data from.</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134277" target = "projectFrame"><b>source</b></a></td><td>artifact</td><td>Representation of a Media source</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refdeployment diagram129797" target = "projectFrame"><b>Source Overview</b></a></td><td>deployment diagram</td><td></td></tr>
@@ -62,6 +63,15 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refnode128773" target = "projectFrame"><b>State</b></a></td><td>node</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class135941.html#refclass135941" target = "projectFrame"><b>State</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation152709" target = "projectFrame"><b>state</b></a></td><td>relation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action129157" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128133" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128773" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128261" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128005" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td>try to fetch existing definition</td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action129029" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128389" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128517" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate action128645" target = "projectFrame"><b>state action</b></a></td><td>state action</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class142597.html#refclass142597" target = "projectFrame"><b>StateAdapter</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass diagram132357" target = "projectFrame"><b>StateAdapter composition</b></a></td><td>class diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class142469.html#refclass142469" target = "projectFrame"><b>StateProxy</b></a></td><td>class</td><td></td></tr>
diff --git a/doc/devel/uml/index_84.html b/doc/devel/uml/index_84.html
index 58b8a6bf5..ea6b9d69e 100644
--- a/doc/devel/uml/index_84.html
+++ b/doc/devel/uml/index_84.html
@@ -17,8 +17,6 @@
 
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="class149637.html#refclass149637" target = "projectFrame"><b>Target</b></a></td><td>class</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refrelation172549" target = "projectFrame"><b>targets</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refactivity diagram129541" target = "projectFrame"><b>the render configuration flow</b></a></td><td>activity diagram</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute130181" target = "projectFrame"><b>theApp_</b></a></td><td>attribute</td><td>holds the single instance and triggers initialization</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation128261" target = "projectFrame"><b>theFixture</b></a></td><td>relation</td><td></td></tr>
@@ -46,12 +44,12 @@
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact132485" target = "projectFrame"><b>trafo</b></a></td><td>artifact</td><td>transforming processing Node </td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation134405" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129797" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td>This operation is to be overloaded for the specific MObject subclasses to be treated.</td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130693" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130437" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130565" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130309" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130437" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129925" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130693" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130181" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refoperation129925" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refoperation130053" target = "projectFrame"><b>treat</b></a></td><td>operation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140805.html#refclass140805" target = "projectFrame"><b>TypeHandler</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class141317.html#refclass141317" target = "projectFrame"><b>TypeHandler&lt;Pipe&gt;</b></a></td><td>class</td><td></td></tr>
diff --git a/doc/devel/uml/index_85.html b/doc/devel/uml/index_85.html
index ce1f36dc0..982764b59 100644
--- a/doc/devel/uml/index_85.html
+++ b/doc/devel/uml/index_85.html
@@ -18,6 +18,7 @@
 <table>
 <tr bgcolor=#f0f0f0><td align=center><b>Name</b></td><td align=center><b>Kind</b></td><td align=center><b>Description</b></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refattribute132997" target = "projectFrame"><b>undo</b></a></td><td>attribute</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128517" target = "projectFrame"><b>undo-able</b></a></td><td>state</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class148869.html#refclass148869" target = "projectFrame"><b>UndoMutation</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refrelation173061" target = "projectFrame"><b>undoOp</b></a></td><td>relation</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class149381.html#refclass149381" target = "projectFrame"><b>UndoSync</b></a></td><td>class</td><td></td></tr>
diff --git a/doc/devel/uml/index_86.html b/doc/devel/uml/index_86.html
index 1ab403ad8..85cc3a896 100644
--- a/doc/devel/uml/index_86.html
+++ b/doc/devel/uml/index_86.html
@@ -21,21 +21,21 @@
 <tr bgcolor=#f0f0f0><td><a href="class133509.html#refclass133509" target = "projectFrame"><b>VFrame</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact134021" target = "projectFrame"><b>vframe</b></a></td><td>artifact</td><td>a buffer and render process holding a Video frame</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance137093" target = "projectFrame"><b>vid1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129925" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134021" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128645" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131717" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129413" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134533" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133765" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131077" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131717" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134021" target = "projectFrame"><b>vid_a</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129925" target = "projectFrame"><b>vid_A</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132741" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance131077" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133765" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134533" target = "projectFrame"><b>video</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance132997" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130949" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129157" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
-<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128517" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance133637" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance129157" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance134277" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance128517" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refclass instance130949" target = "projectFrame"><b>video1</b></a></td><td>class instance</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="class140165.html#refclass140165" target = "projectFrame"><b>Visitable</b></a></td><td>class</td><td></td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refpackage130949" target = "projectFrame"><b>visitor</b></a></td><td>package</td><td>sub-namespace for visitor library implementation</td></tr>
 <tr bgcolor=#f0f0f0><td><a href="index.html#refartifact139141" target = "projectFrame"><b>visitor</b></a></td><td>artifact</td><td>Acyclic Visitor library</td></tr>
diff --git a/doc/devel/uml/navig.html b/doc/devel/uml/navig.html
index fd08b1b7d..a9391da5f 100644
--- a/doc/devel/uml/navig.html
+++ b/doc/devel/uml/navig.html
@@ -9,7 +9,7 @@
 </head>
 <body bgcolor="#ffffff">
 <p><hr noshade></p>
-<p><a href="index.html" target = "projectFrame"><b> -Top- </b></a><a href="classes.html" target = "projectFrame"><b> -Classes- </b></a><a href="public_operations.html" target = "projectFrame"><b> -Public Operations- </b></a><a href="public_properties.html" target = "projectFrame"><b> -Public properties- </b></a><a href="packages.html" target = "projectFrame"><b> -Packages- </b></a><a href="usecases.html" target = "projectFrame"><b> -Use Cases- </b></a><a href="activities.html" target = "projectFrame"><b> -Activities- </b></a><a href="classdiagrams.html" target = "projectFrame"><b> -Class Diagrams- </b></a><a href="objectdiagrams.html" target = "projectFrame"><b> -Object Diagrams- </b></a><a href="activitydiagrams.html" target = "projectFrame"><b> -Activity Diagrams- </b></a><a href="usecasediagrams.html" target = "projectFrame"><b> -Use Case Diagrams- </b></a><a href="collaborationdiagrams.html" target = "projectFrame"><b> -Collaboration Diagrams- </b></a><a href="componentdiagrams.html" target = "projectFrame"><b> -Component Diagrams- </b></a><a href="deploymentdiagrams.html" target = "projectFrame"><b> -Deployment Diagrams- </b></a></p>
+<p><a href="index.html" target = "projectFrame"><b> -Top- </b></a><a href="classes.html" target = "projectFrame"><b> -Classes- </b></a><a href="public_operations.html" target = "projectFrame"><b> -Public Operations- </b></a><a href="public_properties.html" target = "projectFrame"><b> -Public properties- </b></a><a href="packages.html" target = "projectFrame"><b> -Packages- </b></a><a href="usecases.html" target = "projectFrame"><b> -Use Cases- </b></a><a href="activities.html" target = "projectFrame"><b> -Activities- </b></a><a href="states.html" target = "projectFrame"><b> -States- </b></a><a href="classdiagrams.html" target = "projectFrame"><b> -Class Diagrams- </b></a><a href="objectdiagrams.html" target = "projectFrame"><b> -Object Diagrams- </b></a><a href="activitydiagrams.html" target = "projectFrame"><b> -Activity Diagrams- </b></a><a href="statediagrams.html" target = "projectFrame"><b> -State Diagrams- </b></a><a href="usecasediagrams.html" target = "projectFrame"><b> -Use Case Diagrams- </b></a><a href="collaborationdiagrams.html" target = "projectFrame"><b> -Collaboration Diagrams- </b></a><a href="componentdiagrams.html" target = "projectFrame"><b> -Component Diagrams- </b></a><a href="deploymentdiagrams.html" target = "projectFrame"><b> -Deployment Diagrams- </b></a></p>
 <p>
 </p>
 <p><a href="index_34.html" target = "projectFrame"><b> " </b></a><a href="index_60.html" target = "projectFrame"><b> &lt; </b></a><a href="index_65.html" target = "projectFrame"><b> A </b></a><a href="index_66.html" target = "projectFrame"><b> B </b></a><a href="index_67.html" target = "projectFrame"><b> C </b></a><a href="index_68.html" target = "projectFrame"><b> D </b></a><a href="index_69.html" target = "projectFrame"><b> E </b></a><a href="index_70.html" target = "projectFrame"><b> F </b></a><a href="index_71.html" target = "projectFrame"><b> G </b></a><a href="index_72.html" target = "projectFrame"><b> H </b></a><a href="index_73.html" target = "projectFrame"><b> I </b></a><a href="index_75.html" target = "projectFrame"><b> K </b></a><a href="index_76.html" target = "projectFrame"><b> L </b></a><a href="index_77.html" target = "projectFrame"><b> M </b></a><a href="index_78.html" target = "projectFrame"><b> N </b></a><a href="index_79.html" target = "projectFrame"><b> O </b></a><a href="index_80.html" target = "projectFrame"><b> P </b></a><a href="index_81.html" target = "projectFrame"><b> Q </b></a><a href="index_82.html" target = "projectFrame"><b> R </b></a><a href="index_83.html" target = "projectFrame"><b> S </b></a><a href="index_84.html" target = "projectFrame"><b> T </b></a><a href="index_85.html" target = "projectFrame"><b> U </b></a><a href="index_86.html" target = "projectFrame"><b> V </b></a><a href="index_87.html" target = "projectFrame"><b> W </b></a><a href="index_89.html" target = "projectFrame"><b> Y </b></a><a href="index_126.html" target = "projectFrame"><b> ~ </b></a></p>
diff --git a/doc/devel/uml/statediagrams.html b/doc/devel/uml/statediagrams.html
new file mode 100644
index 000000000..db5a38a93
--- /dev/null
+++ b/doc/devel/uml/statediagrams.html
@@ -0,0 +1,22 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>State Diagram Index</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">State Diagram Index</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<table>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate diagram135173" target = "projectFrame"><b>Command lifecycle</b></a></td><td></td><td></td></tr>
+</table>
+</body>
+</html>
diff --git a/doc/devel/uml/states.html b/doc/devel/uml/states.html
new file mode 100644
index 000000000..bfb3aa192
--- /dev/null
+++ b/doc/devel/uml/states.html
@@ -0,0 +1,26 @@
+<!-- Documentation produced by the Html generator of Bouml (http://bouml.free.fr) -->
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+
+<head>
+<title>States Index</title>
+<link rel="stylesheet" href="style.css" type="text/css" />
+</head>
+
+<body bgcolor="#ffffff">
+
+<div class = "title">States Index</div>
+<p></p>
+
+<!-- ============================================================= -->
+
+<table>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128261" target = "projectFrame"><b>CmdDef</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128389" target = "projectFrame"><b>Command</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate machine128005" target = "projectFrame"><b>Lifecycle</b></a></td><td>machine</td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128133" target = "projectFrame"><b>scratch</b></a></td><td></td><td></td></tr>
+<tr bgcolor=#f0f0f0><td><a href="index.html#refstate128517" target = "projectFrame"><b>undo-able</b></a></td><td></td><td></td></tr>
+</table>
+</body>
+</html>
diff --git a/uml/lumiera/128261 b/uml/lumiera/128261
index a6af8fb25..87b5544e9 100644
--- a/uml/lumiera/128261
+++ b/uml/lumiera/128261
@@ -1,6 +1,6 @@
 format 58
 "MObject" // ProcessingLayer::MObject
-  revision 36
+  revision 37
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
diff --git a/uml/lumiera/129029 b/uml/lumiera/129029
index ffbb809fb..aca9b3dd3 100644
--- a/uml/lumiera/129029
+++ b/uml/lumiera/129029
@@ -1,6 +1,6 @@
 format 58
 "Control" // ProcessingLayer::Control
-  revision 8
+  revision 9
   modified_by 5 "hiv"
   // class settings
   //class diagram settings
@@ -452,25 +452,6 @@ ${inlines}
       idl_decl ""
       explicit_switch_type ""
       
-      classrelation 172549 // targets (<directional composition>)
-	relation 162565 *-->
-	  stereotype "list"
-	  a role_name "targets" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
-"
-	    classrelation_ref 172549 // targets (<directional composition>)
-	  b multiplicity "*" parent class_ref 149637 // Target
-      end
-
-      classrelation 172677 // params (<directional composition>)
-	relation 162693 *-->
-	  stereotype "list"
-	  a role_name "params" protected
-	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
-"
-	    classrelation_ref 172677 // params (<directional composition>)
-	  b multiplicity "*" parent class_ref 134533 // Parameter
-      end
     end
 
     class 149125 "DoSync"
@@ -561,8 +542,11 @@ ${inlines}
       end
     end
 
-    class 149637 "Target"
+    class 149637 "ParamAccessor"
       visibility package 
+      nformals 1
+      formal name "TY" type "class" explicit_default_value ""
+        explicit_extends ""
       cpp_decl "${comment}${template}class ${name}${inherit}
   {
 ${members}  };
@@ -590,5 +574,247 @@ ${inlines}
       explicit_switch_type ""
       
     end
+
+    class 150789 "Closure"
+      visibility package 
+      nformals 1
+      formal name "SIG" type "class" explicit_default_value ""
+        explicit_extends ""
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 174853 // <generalisation>
+	relation 164869 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 174853 // <generalisation>
+	  b parent class_ref 148997 // CmdClosure
+      end
+
+      classrelation 175109 // params (<directional composition>)
+	relation 165125 *-->
+	  stereotype "tuple"
+	  a role_name "params" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type} ${name}${value};
+"
+	    classrelation_ref 175109 // params (<directional composition>)
+	  b multiplicity "*" parent class_ref 149637 // ParamAccessor
+      end
+    end
+
+    class 150917 "ArgumentHolder"
+      visibility package 
+      nformals 1
+      formal name "SIG" type "class" explicit_default_value ""
+        explicit_extends ""
+      cpp_decl "${comment}${template}class ${name}${inherit}
+  {
+${members}  };
+${inlines}
+"
+      java_decl ""
+      php_decl ""
+      python_2_2 python_decl ""
+      idl_decl ""
+      explicit_switch_type ""
+      
+      classrelation 175237 // <generalisation>
+	relation 165253 ---|>
+	  a public
+	    cpp default "${type}"
+	    classrelation_ref 175237 // <generalisation>
+	  b parent class_ref 148997 // CmdClosure
+      end
+
+      classrelation 175493 // arguments (<unidirectional association>)
+	relation 165509 --->
+	  stereotype "manages"
+	  a role_name "arguments" multiplicity "1" protected
+	    cpp default "    ${comment}${static}${mutable}${volatile}${const}${type}* ${name}${value};
+"
+	    classrelation_ref 175493 // arguments (<unidirectional association>)
+	  b multiplicity "1" parent class_ref 150789 // Closure
+      end
+    end
+
+    state 128005 "Lifecycle"
+      stereotype "machine"
+      statediagram 135173 "Command lifecycle"
+	package_name_in_tab default show_context default auto_label_position default write_trans_label_horizontally default show_trans_definition yes draw_all_relations default shadow default
+	show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+	size A4
+      end
+
+      pseudostate 128005 entry_point "ID"
+	transition 128901 "<transition>"
+	  on stateaction_ref 128005
+	  external 
+	end
+      end
+
+      stateaction 128005
+	uml "fetch def"
+	comment "try to fetch existing definition"
+	transition 128773 "<transition>"
+	  on pseudostate_ref 128133 // choice
+	  external 
+	end
+      end
+
+      state 128133 "scratch"
+	transition 128261 "<transition>"
+	  on stateaction_ref 128133
+	  external 
+	end
+      end
+
+      stateaction 128133
+	uml "def DO"
+	transition 128389 "<transition>"
+	  on pseudostate_ref 128261 // fork
+	  external 
+	end
+
+	transition 129029 "<transition>"
+	  on stateaction_ref 128261
+	  external 
+	end
+
+	transition 129157 "<transition>"
+	  on stateaction_ref 128517
+	  external 
+	end
+      end
+
+      stateaction 128261
+	uml "def CAP"
+	transition 129285 "<transition>"
+	  on stateaction_ref 128389
+	  external 
+	end
+      end
+
+      stateaction 128389
+	uml "def UNDO"
+	transition 129541 "<transition>"
+	  on state_ref 128261 // CmdDef
+	  external 
+	end
+      end
+
+      stateaction 128517
+	uml "def UNDO"
+	transition 129413 "<transition>"
+	  on stateaction_ref 128645
+	  external 
+	end
+      end
+
+      stateaction 128645
+	uml "def CAP"
+	transition 129669 "<transition>"
+	  on state_ref 128261 // CmdDef
+	  external 
+	end
+      end
+
+      state 128261 "CmdDef"
+	transition 129797 "<transition>"
+	  on stateaction_ref 128773
+	  external 
+	end
+      end
+
+      stateaction 128773
+	uml "bind"
+	transition 129925 "<transition>"
+	  on state_ref 128389 // Command
+	  external 
+	end
+      end
+
+      state 128389 "Command"
+	transition 130053 "<transition>"
+	  on stateaction_ref 129029
+	  external 
+	end
+      end
+
+      stateaction 129029
+	stereotype "send-signal"
+	uml "exec pattern"
+	transition 130181 "<transition>"
+	  on state_ref 128517 // undo-able
+	  external 
+	end
+      end
+
+      state 128517 "undo-able"
+	transition 130309 "<transition>"
+	  on pseudostate_ref 128517 // exit_point
+	  external 
+	end
+
+	transition 130437 "<transition>"
+	  on stateaction_ref 129157
+	  external 
+	end
+
+	transition 130693 "<transition>"
+	  on stateaction_ref 129029
+	  external 
+	end
+      end
+
+      pseudostate 128133 choice 
+	stereotype "try"
+	transition 128005 "<transition>"
+	  on state_ref 128133 // scratch
+	    uml_expr "not found"
+	  external 
+	end
+
+	transition 128133 "<transition>"
+	  on state_ref 128261 // CmdDef
+	    uml_expr "found"
+	  external 
+	end
+      end
+
+      pseudostate 128261 fork 
+	transition 128517 "<transition>"
+	  on stateaction_ref 128261
+	  external 
+	end
+
+	transition 128645 "<transition>"
+	  on stateaction_ref 128517
+	  external 
+	end
+      end
+
+      pseudostate 128389 fork 
+      end
+
+      pseudostate 128517 exit_point "done"
+      end
+
+      stateaction 129157
+	stereotype "send-signal"
+	uml "undo"
+	transition 130565 "<transition>"
+	  on state_ref 128517 // undo-able
+	  external 
+	end
+      end
+    end
   end
 end
diff --git a/uml/lumiera/134021.diagram b/uml/lumiera/134021.diagram
index 47e68f995..fdf19d33b 100644
--- a/uml/lumiera/134021.diagram
+++ b/uml/lumiera/134021.diagram
@@ -7,7 +7,7 @@ classcanvas 128005 class_ref 148485 // Command
 end
 classcanvas 128133 class_ref 148613 // HandlingPattern
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
-  xyz 424 293 2000
+  xyz 421 307 2000
 end
 classcanvas 128261 class_ref 148741 // Mutation
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
@@ -19,7 +19,7 @@ classcanvas 128389 class_ref 148869 // UndoMutation
 end
 classcanvas 128517 class_ref 148997 // CmdClosure
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
-  xyz 25 178 2000
+  xyz 14 178 2000
 end
 classcanvas 128773 class_ref 149125 // DoSync
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
@@ -37,18 +37,22 @@ classcanvas 129157 class_ref 149509 // RedoLast
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   xyz 488 507 2000
 end
-classcanvas 130565 class_ref 134533 // Parameter
+classcanvas 130693 class_ref 149637 // ParamAccessor
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
-  xyz 112 298 2005
-end
-classcanvas 130693 class_ref 149637 // Target
-  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
-  xyz 112 249 2010
+  xyz 64 329 2010
 end
 classcanvas 133765 class_ref 141957 // ProcDispatcher
   draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
   color lightred
-  xyz 279 401 2000
+  xyz 281 411 2000
+end
+classcanvas 134021 class_ref 150789 // Closure
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 26 374 2015
+end
+classcanvas 134789 class_ref 150917 // ArgumentHolder
+  draw_all_relations default hide_attributes default hide_operations default show_members_full_definition default show_members_visibility default show_members_stereotype default show_members_multiplicity default show_members_initialization default member_max_width 0 show_parameter_dir default show_parameter_name default package_name_in_tab default class_drawing_mode default drawing_language default show_context_mode default auto_label_position default show_infonote default shadow default show_stereotype_properties default
+  xyz 64 260 2000
 end
 relationcanvas 128645 relation_ref 161925 // <generalisation>
   from ref 128389 z 1999 to ref 128261
@@ -57,58 +61,44 @@ relationcanvas 128645 relation_ref 161925 // <generalisation>
 end
 relationcanvas 129285 relation_ref 162053 // <generalisation>
   geometry VHr
-  from ref 128773 z 1999 to point 467 388
+  from ref 128773 z 1999 to point 464 388
   line 130309 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 129669 relation_ref 162181 // <generalisation>
   geometry VHr
-  from ref 128901 z 1999 to point 467 433
+  from ref 128901 z 1999 to point 464 433
   line 129797 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 129925 relation_ref 162309 // <generalisation>
   geometry VHr
-  from ref 129029 z 1999 to point 467 479
+  from ref 129029 z 1999 to point 464 479
   line 130053 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 130181 relation_ref 162437 // <generalisation>
   geometry VHr
-  from ref 129157 z 1999 to point 467 524
+  from ref 129157 z 1999 to point 464 524
   line 130437 z 1999 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
-relationcanvas 130821 relation_ref 162565 // <directional composition>
-  geometry VH
-  from ref 128517 z 1999 stereotype "<<list>>" xyz 67 239 3000 to point 59 266
-  line 130949 z 1999 to ref 130693
-  role_a_pos 69 251 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 47 222 3000
-end
-relationcanvas 131077 relation_ref 162693 // <directional composition>
-  geometry VH
-  from ref 128517 z 1999 stereotype "<<list>>" xyz 66 300 3000 to point 59 327
-  line 131205 z 1999 to ref 130565
-  role_a_pos 67 312 3000 no_role_b
-  no_multiplicity_a multiplicity_b_pos 47 222 3000
-end
 relationcanvas 131333 relation_ref 162821 // <unidirectional association>
   decenter_begin 780
-  from ref 128005 z 1999 stereotype "<<has_a>>" xyz 110 184 3000 to ref 128517
+  from ref 128005 z 1999 stereotype "<<has_a>>" xyz 104 184 3000 to ref 128517
   no_role_a no_role_b
-  multiplicity_a_pos 107 202 3000 multiplicity_b_pos 160 202 3000
+  multiplicity_a_pos 96 202 3000 multiplicity_b_pos 160 202 3000
 end
 relationcanvas 131461 relation_ref 162949 // <unidirectional association>
   decenter_begin 543
   from ref 128389 z 1999 to point 453 201
   line 132229 z 1999 to point 453 128
   line 131717 z 1999 to ref 128261
-  role_a_pos 410 174 3000 no_role_b
+  role_a_pos 411 174 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 131845 relation_ref 163077 // <unidirectional association>
@@ -116,7 +106,7 @@ relationcanvas 131845 relation_ref 163077 // <unidirectional association>
   from ref 128389 z 1999 to point 453 186
   line 131973 z 1999 to point 453 128
   line 132101 z 1999 to ref 128261
-  role_a_pos 409 203 3000 no_role_b
+  role_a_pos 410 207 3000 no_role_b
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 132613 relation_ref 163205 // <unidirectional association>
@@ -132,15 +122,44 @@ relationcanvas 132869 relation_ref 163333 // <unidirectional association>
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 133509 relation_ref 163589 // <dependency>
-  from ref 128005 z 1993 stereotype "<<invokes>>" xyz 263 248 3000 to point 245 214
+  from ref 128005 z 1993 stereotype "<<invokes>>" xyz 265 250 3000 to point 245 214
   line 133637 z 1993 to ref 128133
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
 relationcanvas 133893 relation_ref 163717 // <dependency>
-  from ref 128133 z 1999 stereotype "<<involves>>" xyz 314 370 3000 to ref 133765
+  from ref 128133 z 1999 stereotype "<<involves>>" xyz 314 382 3000 to ref 133765
   no_role_a no_role_b
   no_multiplicity_a no_multiplicity_b
 end
+relationcanvas 134149 relation_ref 164869 // <generalisation>
+  from ref 134021 z 1999 to ref 128517
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 134405 relation_ref 165125 // <directional composition>
+  geometry HV
+  from ref 134021 z 2009 stereotype "<<tuple>>" xyz 98 400 3000 to point 107 398
+  line 134661 z 2009 to ref 130693
+  role_a_pos 114 390 3000 no_role_b
+  no_multiplicity_a multiplicity_b_pos 86 406 3000
+end
+relationcanvas 134917 relation_ref 165253 // <generalisation>
+  geometry VHV unfixed
+  from ref 134789 z 1999 to point 107 240
+  line 135045 z 1999 to point 48 240
+  line 135173 z 1999 to ref 128517
+  no_role_a no_role_b
+  no_multiplicity_a no_multiplicity_b
+end
+relationcanvas 135685 relation_ref 165509 // <unidirectional association>
+  decenter_begin 490
+  from ref 134789 z 1999 stereotype "<<manages>>" xyz 103 418 3000 to point 174 298
+  line 135941 z 1999 to point 174 429
+  line 136069 z 1999 to point 92 429
+  line 135813 z 1999 to ref 134021
+  role_a_pos 110 430 3000 no_role_b
+  multiplicity_a_pos 86 431 3000 multiplicity_b_pos 164 297 3000
+end
 preferred_whz 575 622 1
 end
diff --git a/uml/lumiera/135173.diagram b/uml/lumiera/135173.diagram
new file mode 100644
index 000000000..e02ebcc50
--- /dev/null
+++ b/uml/lumiera/135173.diagram
@@ -0,0 +1,161 @@
+format 58
+
+pseudostatecanvas 128005 pseudostate_ref 128005 // entry_point
+   xyz 180 12 3005 label_xy 184 31
+end
+stateactioncanvas 128133 stateaction_ref 128005
+  xyzwh 225 41 2000 53 26
+end
+statecanvas 128261 state_ref 128133 // scratch
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+  xyzwh 74 82 2000 57 33
+end
+stateactioncanvas 128389 stateaction_ref 128133
+  xyzwh 80 133 2000 44 26
+end
+stateactioncanvas 128517 stateaction_ref 128261
+  xyzwh 53 175 2000 50 26
+end
+stateactioncanvas 128645 stateaction_ref 128389
+  xyzwh 49 213 2000 58 26
+end
+stateactioncanvas 128773 stateaction_ref 128517
+  xyzwh 110 175 2000 58 26
+end
+stateactioncanvas 128901 stateaction_ref 128645
+  xyzwh 114 213 2000 50 26
+end
+statecanvas 129029 state_ref 128261 // CmdDef
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+  xyzwh 73 276 2000 59 33
+end
+stateactioncanvas 129157 stateaction_ref 128773
+  xyzwh 112 337 2000 32 26
+end
+statecanvas 129413 state_ref 128389 // Command
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+  xyzwh 127 388 2000 69 33
+end
+stateactioncanvas 129541 stateaction_ref 129029
+  xyzwh 160 445 2000 84 30
+end
+statecanvas 129669 state_ref 128517 // undo-able
+  show_activities default region_horizontally default drawing_language default show_stereotype_properties default
+  xyzwh 162 501 2000 81 36
+end
+pseudostatecanvas 129797 pseudostate_ref 128133 // choice
+   xyz 238 81 2000
+end
+pseudostatecanvas 132997 pseudostate_ref 128517 // exit_point
+   xyz 288 510 3005 label_xy 286 529
+end
+stateactioncanvas 133125 stateaction_ref 129157
+  xyzwh 161 565 2000 85 30
+end
+transitioncanvas 129925 transition_ref 128005 // <transition>
+  
+  from ref 129797 z 1999 label "/ not found" xyz 155 100 1999 to ref 128261
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 130053 transition_ref 128133 // <transition>
+  geometry HVr
+  
+  from ref 129797 z 1999 label "/ found" xyz 215 129 1999 to point 248 290
+  line 130309 z 1999 to ref 129029
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 130437 transition_ref 128261 // <transition>
+  
+  from ref 128261 z 1999 to ref 128389
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 131205 transition_ref 128773 // <transition>
+  
+  from ref 128133 z 1999 to ref 129797
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 131589 transition_ref 128901 // <transition>
+  geometry HV
+  
+  from ref 128005 z 1999 to point 249 19
+  line 134661 z 1999 to ref 128133
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 131717 transition_ref 129029 // <transition>
+  
+  from ref 128389 z 1999 to ref 128517
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 131845 transition_ref 129157 // <transition>
+  
+  from ref 128389 z 1999 to ref 128773
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 131973 transition_ref 129285 // <transition>
+  
+  from ref 128517 z 1999 to ref 128645
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132101 transition_ref 129413 // <transition>
+  
+  from ref 128773 z 1999 to ref 128901
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132229 transition_ref 129541 // <transition>
+  
+  from ref 128645 z 1999 to ref 129029
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132357 transition_ref 129669 // <transition>
+  
+  from ref 128901 z 1999 to ref 129029
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132485 transition_ref 129797 // <transition>
+  
+  from ref 129029 z 1999 to ref 129157
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132613 transition_ref 129925 // <transition>
+  
+  from ref 129157 z 1999 to ref 129413
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132741 transition_ref 130053 // <transition>
+  
+  from ref 129413 z 1999 to ref 129541
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 132869 transition_ref 130181 // <transition>
+  
+  from ref 129541 z 1999 to ref 129669
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 133253 transition_ref 130309 // <transition>
+  
+  from ref 129669 z 1999 to ref 132997
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 133381 transition_ref 130437 // <transition>
+  
+  from ref 129669 z 1999 to ref 133125
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 133509 transition_ref 130565 // <transition>
+  decenter_end 702
+  
+  from ref 133125 z 1999 to point 138 576
+  line 133765 z 1999 to point 138 540
+  line 133637 z 1999 to ref 129669
+  write_horizontally default show_definition default drawing_language default
+end
+transitioncanvas 133893 transition_ref 130693 // <transition>
+  decenter_begin 324
+  
+  from ref 129669 z 1999 to point 137 496
+  line 134149 z 1999 to point 137 456
+  line 134533 z 1999 to ref 129541
+  write_horizontally default show_definition default drawing_language default
+end
+preferred_whz 349 682 1
+end
diff --git a/uml/lumiera/5.session b/uml/lumiera/5.session
index 05da50f1a..9d1a80e06 100644
--- a/uml/lumiera/5.session
+++ b/uml/lumiera/5.session
@@ -1,16 +1,23 @@
 window_sizes 1302 1004 270 1022 856 71
+diagrams
+  active  classdiagram_ref 134021 // Command structure
+    575 622 100 4 0 0
+  statediagram_ref 135173 // Command lifecycle
+    349 682 100 4 0 0
+end
 show_stereotypes
 selected 
   package_ref 129 // lumiera
 open
-  componentview_ref 128005 // Architecture
   classview_ref 129413 // Project Entities
   
   package_ref 128645 // codegen
   
   package_ref 128133 // Asset
-  
-  package_ref 129029 // Control
+  classview_ref 128389 // Controller Workings
+  class_ref 148997 // CmdClosure
+  class_ref 150789 // Closure
+  pseudostate_ref 128133 // choice
   
   package_ref 128261 // MObject
   classview_ref 128133 // Engine Workings
diff --git a/uml/lumiera/lumiera.prj b/uml/lumiera/lumiera.prj
index c978054a5..66d76596f 100644
--- a/uml/lumiera/lumiera.prj
+++ b/uml/lumiera/lumiera.prj
@@ -1,6 +1,6 @@
 format 58
 "lumiera"
-  revision 52
+  revision 53
   modified_by 5 "hiv"
   cpp_root_dir "../../src/"
 
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 426e40087..4645ae74b 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -951,7 +951,7 @@ TertiaryMid: #99a
 TertiaryDark: #667
 Error: #f88</pre>
 </div>
-<div title="Command" modifier="Ichthyostega" modified="200906140108" created="200906072020" tags="def SessionLogic draft" changecount="6">
+<div title="Command" modifier="Ichthyostega" modified="200907210134" created="200906072020" tags="def SessionLogic draft" changecount="7">
 <pre>Within Proc-Layer, a Command is the abstract representation of a single operation or a compound of operations mutating the HighLevelModel.
 Thus, each command is a ''Functor'' and a ''Closure'' ([[command pattern|http://en.wikipedia.org/wiki/Command_pattern]]), allowing commands to be treated uniformly, enqueued in a [[dispatcher|ProcDispatcher]], logged to the SessionStorage and registered with the UndoManager.
 
@@ -959,6 +959,7 @@ Commands are //defined// using a [[fluent API|http://en.wikipedia.org/wiki/Fluen
 
 &amp;rarr; see CommandDefinition
 &amp;rarr; see CommandHandling
+&amp;rarr; see CommandLifecycle
 </pre>
 </div>
 <div title="CommandDefinition" modifier="Ichthyostega" modified="200906140147" created="200906140124" tags="SessionLogic spec draft decision design img" changecount="9">
@@ -989,7 +990,7 @@ While generally there is //no limitation// on the number and type of parameters,
 Usually, parameters should be passed //by value// &amp;mdash; with the exception of target object(s), which are typically bound as MObjectRef, causing them to be resolved at commad execution time (late binding).
 </pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200906140100" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="23">
+<div title="CommandHandling" modifier="Ichthyostega" modified="200907210134" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="24">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
@@ -1005,9 +1006,22 @@ While obviously the first solution is much simpler to implement on behalf of the
 While the usual »Memento« implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function''&amp;nbsp;and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense than capturing state.
 
 !Handling of commands
-A command may be [[defined|CommandDefinition]] completely from scratch, or it might just instantiate a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
+A command may be [[defined|CommandDefinition]] completely from scratch, or it might just serve as a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
 
-By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation.
+By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation. While nothing prevents you from invoking the command operation functor several times, each invocation will overwrite the undo state captrued by the previous invocation. Thus, each command instance should bes seen as the promise (or later the trace) of a single operation execution. In a similar vein, the undo capturing should be defined as to be self sufficient, so that invoking just the undo functor of a single command performes any necessary steps to restore the situation found before invoking the corresponding mutation functor &amp;mdash; of course only //with respect to the topic covered by this command.// So, while commands provide a lot of flexibility and allow to do a multitude of things, certainly there is an intended CommandLifecycle.
+</pre>
+</div>
+<div title="CommandLifecycle" modifier="Ichthyostega" modified="200907210211" created="200907210135" tags="SessionLogic spec draft design img" changecount="5">
+<pre>[&lt;img[Structure of Commands|uml/fig135173.png]]
+While generally the command framework was designed to be flexible and allow a lot of different use cases, execution paths and to serve various goals, there is an ''intended lifecycle'' &amp;mdash; commands are expected to go through several distinct states.
+
+The handling of a command starts out with a ''command ID'' provided by the client code. Command IDs are unique (human readable) identifiers and should be organised in a hierarchical fashion. When provided with an ID, the CommandRegistry tries to fetch an existing command definition. In case this fails, we enter the [[command definition stage|CommandDefinition]], which includes specifying functions to implement the operation, state capturing and UNDO. When all these informations are available, the entity is called a ''command definition''. It is comparable to a //class// or //meta object.//
+
+By ''binding'' to specific operation arguments, the definition is //armed// and becomes a real ''command''. This is similar to creating an instance from a class
+
+A command is operated or executed by passing it to an ''execution pattern'' &amp;mdash; there is a multitude of possible execution patterns to choose from, depending on the situation. 
+{{red{WIP}}}
+When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. At any time, c ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
 </pre>
 </div>
 <div title="ConManager" modifier="Ichthyostega" modified="200810060300" created="200806050208" tags="def Builder" changecount="4">

From d80f0cfb8dae493670010f57034e59d29beaf9a8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 21 Jul 2009 04:49:00 +0200
Subject: [PATCH 210/368] WIP start some drafting

---
 src/proc/control/command-def.hpp              |  2 +-
 src/proc/control/command-registry.hpp         | 74 +++++++++++++++++++
 src/proc/control/command.cpp                  |  2 +
 .../proc/control/command-basic-test.cpp       |  1 +
 4 files changed, 78 insertions(+), 1 deletion(-)
 create mode 100644 src/proc/control/command-registry.hpp

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index acd3d71ce..54a3034d6 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -159,7 +159,7 @@ namespace control {
           BasicDefinition(function<SIG>& operation)
             {
               cout << showSizeof(operation) << endl;
-              UNIMPLEMENTED ("create new command object an store the operation functor");
+              UNIMPLEMENTED ("create new command object and store the operation functor");
             }
           
           
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
new file mode 100644
index 000000000..1b398c0f2
--- /dev/null
+++ b/src/proc/control/command-registry.hpp
@@ -0,0 +1,74 @@
+/*
+  COMMAND-REGISTRY.hpp  -  proc-Command object registration and storage management 
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-registry.hpp
+ ** Managing command definitions and the storage of individual command objects.
+ ** @todo WIP WIP.
+ ** 
+ ** \par Lifecycle
+ ** 
+ ** @see Command
+ ** @see ProcDispatcher
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_REGISTRY_H
+#define CONTROL_COMMAND_REGISTRY_H
+
+//#include "pre.hpp"
+#include "lib/error.hpp"
+//#include "lib/bool-checkable.hpp"
+//#include "proc/control/command-closure.hpp"
+//#include "proc/control/memento-tie.hpp"
+
+//#include <iostream>
+//#include <string>
+
+
+
+namespace control {
+  
+//  using std::ostream;
+//  using std::string;
+  
+  
+  
+  
+  /**
+   * TODO type comment
+   */
+  class CommandRegistry
+    {
+      
+    public:
+    };
+  
+  
+//  inline ostream& operator<< (ostream& os, Mutation const& muta) { return os << string(muta); }
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 2138ae18c..44ed430c4 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -25,11 +25,13 @@
  ** //TODO 
  ** 
  ** @see command.hpp
+ ** @see command-registry.hpp
  **
  */
 
 
 #include "proc/control/command.hpp"
+#include "proc/control/command-registry.hpp"
 //#include "proc/mobject/mobject-ref.hpp"
 //#include "proc/mobject/mobject.hpp"
 //#include "proc/mobject/placement.hpp"
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index f7d0bacf1..ef685f833 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -137,6 +137,7 @@ namespace test    {
           
           
           Command& ourCmd = Command::get("test.command1");
+          ////////////////////////////////////////////////////////////////////TODO: isn't this unlogical? Do I want a *definition* or an *instance* ??
           
           // invoke the command
           ASSERT (*obj == Time(5));

From 66f94f90f3a0eb510c6c8067fababcbd790b2e31 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 22 Jul 2009 05:12:48 +0200
Subject: [PATCH 211/368] drafting/design (cont)

---
 wiki/renderengine.html | 81 +++++++++++++++++++++++++++++++-----------
 1 file changed, 60 insertions(+), 21 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 4645ae74b..d0df4536a 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -514,7 +514,7 @@ ColorPalette
 
 SiteUrl</pre>
 </div>
-<div title="AllocationCluster" modifier="Ichthyostega" modified="200810200127" created="200810180031" tags="def" changecount="9">
+<div title="AllocationCluster" modifier="Ichthyostega" modified="200810200127" created="200810180031" tags="def img" changecount="9">
 <pre>Memory management facility for the low-level model (render nodes network). The model is organised into temporal segments, which are considered to be structurally constant and uniform. The objects within each segment are strongly interconnected, and thus each segment is being built in a single build process and is replaced or released as a whole. __~AllocationCluster__ implements memory management to support this usage pattern. He owns a number of object families of various types.[&gt;img[draw/AllocationCluster.png]]
 * [[processing nodes|ProcNode]] &amp;mdash; probably with several subclasses (?)
 * [[wiring descriptors|WiringDescriptor]]
@@ -607,7 +607,7 @@ Attachment on itself does //not// keep an object alive. Rather, it's implemented
 <div title="AutomationData" modifier="Ichthyostega" created="200805300105" tags="def automation" changecount="2">
 <pre>While generally automation is treated as a function over time, defining and providing such a function requires some //Automation Data.// The actual layout and meaning of this data is deemed an implementation detail of the [[parameter provider|ParamProvider]] used, but nevertheless an automation data set has object characteristics within the [[EDL (high-level-model)|EDL]], allowing it to be attached, moved and [[placed|Placement]] by the user.</pre>
 </div>
-<div title="BasicBuildingOperations" modifier="Ichthyostega" modified="200805210230" created="200712040334" tags="design dynamic Builder" changecount="24">
+<div title="BasicBuildingOperations" modifier="Ichthyostega" modified="200805210230" created="200712040334" tags="design dynamic Builder img" changecount="24">
 <pre>Starting out from the concepts of Objects, Placement to Tracks, render Pipes and connection properties (&amp;rarr; see [[here|TrackPipeEDL]]) within the EDL, we can identify the elementary operations occuring within the Builder. Overall, the Builder is organized as application of //visiting tools// to a collection of objects, so finally we have to consider some object kind appearing in the working function of the given builder tool, which holds at this moment some //context//. The job now is to organize this context such as to create a predictable build process from this //event driven// approach.
 &amp;rarr;see also: BuilderPrimitives for the elementary situations used to cary out the building operations
 
@@ -758,7 +758,7 @@ config.macros.timeline.handler = function(place,macroName,params,wikifier,paramS
 }
 //}}}</pre>
 </div>
-<div title="BindingMO" modifier="Ichthyostega" modified="200905222252" created="200905210144" tags="def design discuss SessionLogic" changecount="4">
+<div title="BindingMO" modifier="Ichthyostega" modified="200907220310" created="200905210144" tags="def design discuss SessionLogic" changecount="5">
 <pre>Sometimes, two entities within the [[Session]] are deliberately associated, and this association has to carry some specific mappings between properties or facilities within the entities to be linked together. When this connection isn't just the [[Placement]] of an object, and isn't just a logical or structural relationship either &amp;mdash; then we create an explicit Binding object to be stored into the session.
 * When connecting a [[Sequence|EDL]] to a certain [[Timeline]], we also establish a mapping between the possible media stream channels produced by the sequence and the real output slots found within the timeline.
 * similarly, using a sequence within a [[meta-clip|VirtualClip]] requires to remember such a mapping.
@@ -844,7 +844,7 @@ The working pattern of this builder mechanics can be described as triggering, en
 In all those cases, the active part is provided by [[processing patterns|ProcPatt]] &amp;mdash; sort of micro programs executed within the context of a given mould: the processing pattern defines the steps to take (in the standard/basic case this is just &quot;attach&quot;), while the mould holds and provides the location where these steps will operate. Actually, this location is represented as a OperationPoint, provided by the mould and abstracting the details of making multi-channel connections.
 </pre>
 </div>
-<div title="BuilderPrimitives" modifier="Ichthyostega" modified="200805260332" created="200805210327" tags="impl spec Builder" changecount="25">
+<div title="BuilderPrimitives" modifier="Ichthyostega" modified="200805260332" created="200805210327" tags="impl spec Builder img" changecount="25">
 <pre>While assembling and building up the render engines node network, a small number of primitive building situations is encountered repeatedly. The BuilderToolKit provides a &quot;[[mould|BuilderMould]]&quot; for each of these situations, typically involving parametrisation and the application of a [[processing pattern|ProcPatt]].
 
 The ''Lifecycle'' of such a mould starts out by arming it with the object references involved into the next building step. After conducting this building step, the resulting render nodes can be found &amp;mdash; depending on the situation &amp;mdash; attached either to the same mould, or to another kind of mould, but in any case ready to be included in the next building step. Thus, //effectively//&amp;nbsp; the moulds are //used to handle the nodes being built,// due to the fact that the low-level model (nodes to be built) and the high-level model (objects directing what is to be built) are //never connected directly.//
@@ -951,7 +951,7 @@ TertiaryMid: #99a
 TertiaryDark: #667
 Error: #f88</pre>
 </div>
-<div title="Command" modifier="Ichthyostega" modified="200907210134" created="200906072020" tags="def SessionLogic draft" changecount="7">
+<div title="Command" modifier="Ichthyostega" modified="200907212316" created="200906072020" tags="def SessionLogic draft" changecount="8">
 <pre>Within Proc-Layer, a Command is the abstract representation of a single operation or a compound of operations mutating the HighLevelModel.
 Thus, each command is a ''Functor'' and a ''Closure'' ([[command pattern|http://en.wikipedia.org/wiki/Command_pattern]]), allowing commands to be treated uniformly, enqueued in a [[dispatcher|ProcDispatcher]], logged to the SessionStorage and registered with the UndoManager.
 
@@ -960,9 +960,10 @@ Commands are //defined// using a [[fluent API|http://en.wikipedia.org/wiki/Fluen
 &amp;rarr; see CommandDefinition
 &amp;rarr; see CommandHandling
 &amp;rarr; see CommandLifecycle
+&amp;rarr; see CommandUsage
 </pre>
 </div>
-<div title="CommandDefinition" modifier="Ichthyostega" modified="200906140147" created="200906140124" tags="SessionLogic spec draft decision design img" changecount="9">
+<div title="CommandDefinition" modifier="Ichthyostega" modified="200907220310" created="200906140124" tags="SessionLogic spec draft decision design" changecount="10">
 <pre>Commands can be identified and accessed //by name// &amp;mdash; consequently there needs to be an internal command registry, including a link to the actual implementing function, thus allowing to re-establish the connection between command and implementing functions when de-serialising a persisted command. To create a command, we need to provide the following informations
 * operation function actually implementing the command
 * function to [[undo|UndoManager]] the effect of the command
@@ -990,7 +991,7 @@ While generally there is //no limitation// on the number and type of parameters,
 Usually, parameters should be passed //by value// &amp;mdash; with the exception of target object(s), which are typically bound as MObjectRef, causing them to be resolved at commad execution time (late binding).
 </pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200907210134" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="24">
+<div title="CommandHandling" modifier="Ichthyostega" modified="200907212323" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="26">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
@@ -1009,7 +1010,7 @@ While the usual »Memento« implementation might automatically capture the whole
 A command may be [[defined|CommandDefinition]] completely from scratch, or it might just serve as a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
 
 By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation. While nothing prevents you from invoking the command operation functor several times, each invocation will overwrite the undo state captrued by the previous invocation. Thus, each command instance should bes seen as the promise (or later the trace) of a single operation execution. In a similar vein, the undo capturing should be defined as to be self sufficient, so that invoking just the undo functor of a single command performes any necessary steps to restore the situation found before invoking the corresponding mutation functor &amp;mdash; of course only //with respect to the topic covered by this command.// So, while commands provide a lot of flexibility and allow to do a multitude of things, certainly there is an intended CommandLifecycle.
-</pre>
+&amp;rarr; more on possible [[command usage scenarios|CommandUsage]]</pre>
 </div>
 <div title="CommandLifecycle" modifier="Ichthyostega" modified="200907210211" created="200907210135" tags="SessionLogic spec draft design img" changecount="5">
 <pre>[&lt;img[Structure of Commands|uml/fig135173.png]]
@@ -1022,6 +1023,42 @@ By ''binding'' to specific operation arguments, the definition is //armed// and
 A command is operated or executed by passing it to an ''execution pattern'' &amp;mdash; there is a multitude of possible execution patterns to choose from, depending on the situation. 
 {{red{WIP}}}
 When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. At any time, c ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
+</pre>
+</div>
+<div title="CommandUsage" modifier="Ichthyostega" modified="200907220300" created="200907212338" tags="SessionLogic draft dynamic" changecount="3">
+<pre>//for now (7/09) I'll use this page to collect ideas how commands might be used...//
+
+* use a command for getting a log entry and an unto possibility automatically
+* might define, bind and then execute a command at once
+* might define it and bind it to a standard set of parameters, to be used as a prototype later.
+* might just create the definition, leaving the argument binding to the actual call site
+* execute it and check the success/failure result
+* just enqueue it, without caring for successful execution
+* place it into a command sequence bundle
+* repeat the execution
+
+!!!a command definition....
+* can be created from scratch, by ID
+* can be re-accessed, by ID
+* can be modified, which doesn't change any commands already created/derived from the previous version
+* usually will be the starting point for creating an actual command by //binding//
+
+!!!a command instance....
+* normally emerges from a definition by binding arguments
+* the first such binding will create a named command registration
+* but subsequent accesses by ID or new bindings create an anonymous clone
+* which then in turn might be registered explicitly with a new ID
+* anonymous command instances are managed by referral and ref-counting
+
+!!!an execution pattern....
+* can only be defined in code by a class definition, not at runtime
+* subclasses the !HandlingPattern interface, which automatically creates an registration.
+* a singleton instance is created on demand, triggered by referring the pattern's ID
+* is conceptually //stateless// &amp;mdash; of course there can be common configuration values
+* is always invoked providing a concrete command instance to execute
+* is configured into the command instance, to implement the command's invocation
+* returns a duck-typed //result// object
+
 </pre>
 </div>
 <div title="ConManager" modifier="Ichthyostega" modified="200810060300" created="200806050208" tags="def Builder" changecount="4">
@@ -1044,7 +1081,7 @@ Connecting data streams of differing type involves a StreamConversion. Mostly, t
 &amp;rarr; [[accessing and integrating configuration queries|ConfigQueryIntegration]]
 </pre>
 </div>
-<div title="ConfigQueryIntegration" modifier="Ichthyostega" modified="200804110350" created="200804070247" tags="overview draft impl" changecount="17">
+<div title="ConfigQueryIntegration" modifier="Ichthyostega" modified="200804110350" created="200804070247" tags="overview draft impl img" changecount="17">
 <pre>* planning to embed a YAP Prolog engine
 * currently just integrated by a table driven mock
 * the baseline is a bit more clear by now (4/08)
@@ -1945,7 +1982,7 @@ From experiences with other middle scale projects, I prefer having the test code
 &amp;rarr; [[overfiew and technical details|LayerSeparationInterfaces]]
 </pre>
 </div>
-<div title="LayerSeparationInterfaces" modifier="Ichthyostega" modified="200902090419" created="200812050619" tags="overview spec" changecount="22">
+<div title="LayerSeparationInterfaces" modifier="Ichthyostega" modified="200902090419" created="200812050619" tags="overview spec img" changecount="22">
 <pre>Lumiera uses a 3-layered architecture. Separation between layers is crucial. Any communication between the layers regarding the normal operation of the application should //at least be initiated// through ''Layer abstraction interfaces'' (Facade Interfaces). This is a low-impact version of layering, because, aside from this triggering, direct cooperation of parts within the single Lumiera process is allowed, under the condition that is is implemented using additional abstractions (interfaces with implementation level granularity). We stick to the policy of //disallowing direct coupling of implementations located in different layers.//
 
 [&gt;img[Anatomy of a Layer Separation Interface|uml/fig132869.png]]
@@ -2153,7 +2190,7 @@ For the case here in question this seems to be the ''resource allocation is cons
 And, last but not least, doing large scale allocations is the job of the backend. Exceptions being long-lived objects, like the Session or the EDL, which are created once and don't bear the danger of causing memory pressure. Besides, the ProcLayer code shouldn't issue &quot;new&quot; and &quot;delete&quot; when it comes in hand, rather it should use some centralized [[Factories]] for all allocation and freeing, so we can redirect these calls down to the backend, which may use pooling or special placement allocators or the like. The rationale is, for modern hardware/architectures, care has to be taken with heap allocations, esp. with many small objects and irregular usage patterns.
 </pre>
 </div>
-<div title="MultichannelMedia" modifier="Ichthyostega" modified="200710212326" created="200709200255" tags="design" changecount="6">
+<div title="MultichannelMedia" modifier="Ichthyostega" modified="200710212326" created="200709200255" tags="design img" changecount="6">
 <pre>Based on practical experiences, Ichthyo tends to consider Multichannel Media as the base case, while counting media files providing just one single media stream as exotic corner cases. This may seem counter intuitive at first sight; you should think of  it as an attempt to avoid right from start some of the common shortcomings found in many video editors, especially
 * having to deal with keeping a &quot;link&quot; between audio and video clips
 * silly limitations on the supported audio setups (e.g. &quot;sound is mono, stereo or Dolby-5.1&quot;)
@@ -3051,7 +3088,7 @@ We need a way of addressing existing [[pipes|Pipe]]. Besides, as the Pipes and T
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
-<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200906071927" created="200904252258" tags="impl SessionLogic draft" changecount="24">
+<div title="PlanningSessionInMem" modifier="Ichthyostega" modified="200907212231" created="200904252258" tags="impl SessionLogic draft" changecount="33">
 <pre>//This page is a scrapbook for working out the implementation of the [[Session Datastructure in Memory|SessionDataMem]]//
 This is a difficult untertaking, because there are several dependencies (most of which aren't fully designed yet as of 5/09)
 * the GUI uses an adapted version of the HighLevelModel; these datastructures are intended to be backed by the Session
@@ -3071,9 +3108,12 @@ This is a difficult untertaking, because there are several dependencies (most of
 
 &lt;&lt;tasksum start&gt;&gt;
 &lt;&lt;taskadder below&gt;&gt;
-&lt;&lt;task &gt;&gt; implement a system for defining parameters and targets
+&lt;&lt;task 3 3 3&gt;&gt; how to deal with UNDO
+&lt;&lt;task 2 2 2&gt;&gt; how to deal with CommandDefinition
+&lt;&lt;task &gt;&gt; outline the CommandLifecycle
+&lt;&lt;task 5 15 15&gt;&gt; implement a system for defining parameters and targets
 &lt;&lt;task &gt;&gt; implement a system for generating operations
-&lt;&lt;task &gt;&gt; define the general structure of operations
+&lt;&lt;task 2 2 1&gt;&gt; define the general structure of operations
 &lt;&lt;task &gt;&gt; specify the editing operations
 
 !Interface
@@ -3183,14 +3223,13 @@ Besides, they provide an important __inward interface__ for the [[ProcNode]]s, w
 
 </pre>
 </div>
-<div title="ProcLayer and Engine" modifier="Ichthyostega" modified="200905291850" created="200706190056" tags="overview" changecount="18">
+<div title="ProcLayer and Engine" modifier="Ichthyostega" modified="200907212232" created="200706190056" tags="overview" changecount="19">
 <pre>The Render Engine is the part of the application doing the actual video calculations. Its operations are guided by the Objects and Parameters edited by the user in [[the EDL|EDL]] and it retrieves the raw audio and video data from the [[Data backend|backend.html]]. Because the inner workings of the Render Engine are closely related to the structures used in the EDL, this design covers [[the aspect of objects placed into the EDL|MObjects]] as well.
 &lt;&lt;&lt;
 ''Status'': started out as design draft in summer '07, Ichthyo is now in the middle of a implementing the foundations and main structures in C++
 * basic [[AssetManager]] working
 * [[Builder]] implementation is on the way (&amp;rarr;[[more|BuilderPrimitives]])
 * made a first draft of how to wire and operate procesing nodes (&amp;rarr;[[more|RenderMechanics]])
-* working out the relation of [[Project, Timelines and Sequences|TimelineSequences]]
 * first attempts to [[integrate with the GUI|GuiIntegration]]
 * first outline of the [[session implementation|PlanningSessionInMem]]
 &lt;&lt;&lt;
@@ -3490,7 +3529,7 @@ config.macros.rssFeedUpdate = {
 //}}}
 </pre>
 </div>
-<div title="RelationClipAsset" modifier="Ichthyostega" modified="200710212327" created="200710191541" tags="design decision" changecount="7">
+<div title="RelationClipAsset" modifier="Ichthyostega" modified="200710212327" created="200710191541" tags="design decision img" changecount="7">
 <pre>What is the Role of the asset::Clip and how exactly are Assets and (Clip)-MObjects related?
 
 First of all: ~MObjects are the dynamic/editing/manipulation view, while Assets are the static/bookkeeping/searching/information view of the same entities. Thus, the asset::Clip contains the general configuration, the ref to the media and descriptive properties, while all parameters being &quot;manipulated&quot; belong to the session::Clip (MObject). Besides that, the practical purpose of asset::Clip is that you can save and remember some selection as a Clip (Asset), maybe even attach some informations or markup to it, and later be able to (re)create a editable representation in the Session (the GUI could implement this by allowing to drag from the asset::Clip GUI representation to the timeline window)
@@ -3521,7 +3560,7 @@ At first sight the link between asset and clip-MO is a simple logical relation b
 [img[Entities comprising the Render Engine|uml/fig128389.png]]
 </pre>
 </div>
-<div title="RenderImplDetails" modifier="Ichthyostega" modified="200807132338" created="200806220211" tags="Rendering impl" changecount="20">
+<div title="RenderImplDetails" modifier="Ichthyostega" modified="200807132338" created="200806220211" tags="Rendering impl img" changecount="20">
 <pre>Below are some notes regarding details of the actual implementation of the render process and processing node operation. In the description of the [[render node operation protocol|NodeOperationProtocol]] and the [[mechanics of the render process|RenderMechanics]], these details were left out deliberately.
 
 !Layered structure of State
@@ -3670,7 +3709,7 @@ Currently (as of 5/09), Ichthyo is [[targeting|PlanningSessionInMem]] a first pr
 Objects are attached and manipulated by [[placements|Placement]]; thus the organisation of these placements is part of the session data layout. Effectively, such a placement within the session behaves like an //instances// of a given object, and at the same time it defines the &quot;non-substantial&quot; properties of the object, e.g. its positions and relations. [[References|MObjectRef]] to these placement entries are handed out as parameters, both down to the [[Builder]] and from there to the render processes within the engine, but also to external parts within the GUI and in plugins. The actual implementation of these object references is built on top of the PlacementRef tags, thus relying on the PlacementIndex the session maintains to keep track of all placements and their relations. While &amp;mdash; using these references &amp;mdash; an external client can access the objects and structures within the session, any actual ''mutations'' should be done based on the CommandHandling: a single operation of a sequence of operations is defined as [[Command]], to be [[dispatched as mutation operation|ProcDispatcher]]. Following this policy ensures integration with the&amp;nbsp;SessionStorage and provides (unlimited) [[UNDO|UndoManager]].
 </pre>
 </div>
-<div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design" changecount="29">
+<div title="SessionOverview" modifier="Ichthyostega" modified="200811011805" created="200709272105" tags="design img" changecount="29">
 <pre>&lt;&lt;&lt;
 {{red{WARNING: Naming is currently being discussed (11/08)}}}
 * [[EDL]] probably will be called ''Sequence'' (or maybe ''Arrangement'')
@@ -3972,7 +4011,7 @@ When deciding if a connection can be made, we can build up the type information
 My Idea was to use [[type implementation constraints|StreamTypeImplConstraint]] for this, which are a special kind of ~ImplType
 </pre>
 </div>
-<div title="StrongSeparation" modifier="MichaelPloujnikov" modified="200706271504" created="200706220452" tags="design" changecount="5">
+<div title="StrongSeparation" modifier="Ichthyostega" modified="200907220311" created="200706220452" tags="design" changecount="6">
 <pre>This design lays great emphasis on separating all those components and subsystems, which are considered not to have a //natural link// of their underlying concepts. This often means putting some additional constraints on the implementation, so basically we need to rely on the actual implementation to live up to this goal. In many cases it may seem to be more natural to &quot;just access the necessary information&quot;. But on the long run this coupling of not-directly related components makes the whole codebase monolithic and introduces lots of //accidental complexity.//
 
 Instead, we should try to just connect the various subsystems via Interfaces and &amp;mdash; instead of just using some information, rather use some service to be located on an Interface to query other components for this information. The best approach of course is always to avoid the dependency altogether.
@@ -5181,7 +5220,7 @@ Within the Project, there may be ''multiple timelines'', to be viewed and render
 ''Note'': in early drafts of the design (2007) there was an entity called &quot;Timeline&quot; within the [[Fixture]]. This entity seems superfluous and has been dropped. It never got any relevance in existing code and at most was used in some code comments.
 </pre>
 </div>
-<div title="TimelineSequences" modifier="Ichthyostega" modified="200811022211" created="200811011836" tags="design draft discuss" changecount="14">
+<div title="TimelineSequences" modifier="Ichthyostega" modified="200811022211" created="200811011836" tags="design draft discuss img" changecount="14">
 <pre>There is a three-level hierarchy: [[Project|Session]], [[Timeline]], [[Sequence|EDL]]. Each project can contain ''multiple timelines'', to be viewed and rendered independently. But, being the top-level entities, these timelines may not be combined further. You can always just render (or view) one specific timeline. Each of those timelines refers to a Sequence, which is a bunch of [[media objects|MObject]] placed to a tree of [[tracks|Track]]. Of course it is possible to use ~Sub-EDLs (Sub-sequences) within the top-level sequence within a timeline to organize a movie into several scenes or chapters. 
 
 [&gt;img[Relation of Timelines, Sequences and MObjects within the Project|uml/fig132741.png]]

From c5f781596ed4b55335f2162a3af3fc920bd0dab1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 23 Jul 2009 03:47:27 +0200
Subject: [PATCH 212/368] reorganise the intermediary command def context
 classes

---
 src/proc/control/command-def.hpp              | 166 ++++++++++--------
 .../proc/control/command-basic-test.cpp       |   9 +-
 2 files changed, 94 insertions(+), 81 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 54a3034d6..9c2316b86 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -77,6 +77,93 @@ namespace control {
   using lumiera::typelist::Tuple;
   
   
+  namespace stage { ///< helpers for the building up a command definition
+    
+    
+    
+    template<typename SIG, typename MEM>
+    struct UndoDefinition
+      {
+        typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
+        typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
+        
+        UndoDefinition (function<UndoCaptureSig>& undoCapOperation)
+          {
+            cout << showSizeof(undoCapOperation) << endl;
+            UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
+          }
+        
+        template<typename SIG2>
+        UndoDefinition&
+        undoOperation (SIG2& how_to_Undo)
+          {
+            typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
+            
+            function<UndoSig> opera3 (how_to_Undo);
+            
+            UNIMPLEMENTED ("store actual Undo-Functor into the command definition held by the enclosing UndoDefinition instance");
+            return *this;
+          }
+        
+        template
+          < typename T1
+          , typename T2
+          >
+        UndoDefinition&    ///////TODO return here the completed Command
+        bind ( T1& p1
+             , T2& p2
+             )
+          {
+            typedef Types<T1,T2> ArgTypes;
+            Tuple<ArgTypes> params(p1,p2);
+            Closure<SIG> clo (params);
+            
+            cout << showSizeof(clo) << endl;
+            UNIMPLEMENTED ("complete Command definition by closing all functions");
+            return *this;
+          }
+        
+      };
+    
+    
+    
+    
+    /** type re-binding helper: create a suitable UndoDefinition type,
+     *  based on the UndoSignature template instance given as parameter */
+    template<typename U_SIG>
+    struct BuildUndoDefType
+      {
+        typedef UndoDefinition<typename U_SIG::OperateSig, typename U_SIG::Memento> Type;
+      };
+    
+    
+    
+    
+  
+  
+    template<typename SIG>
+    struct BasicDefinition
+      {
+        BasicDefinition(function<SIG>& operation)
+          {
+            cout << showSizeof(operation) << endl;
+            UNIMPLEMENTED ("create new command object and store the operation functor");
+          }
+        
+        
+        template<typename SIG2>
+        typename BuildUndoDefType<UndoSignature<SIG2> >::Type
+        captureUndo (SIG2& how_to_capture_UndoState)
+          {
+            typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
+            typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
+            
+            function<UndoCapSig> opera2 (how_to_capture_UndoState);
+            return SpecificUndoDefinition (opera2);
+          }
+      };
+    
+  } // (END) namespace stage (definition process)
   
   
   /**
@@ -95,86 +182,11 @@ namespace control {
    *           .executeSync();                         // convenience call, forwarding the Command to dispatch.
    * \endcode
    * 
-   * @todo of course, this needs to be extracted into command-definition.hpp 
    */
   class CommandDef
     {
       Symbol id_;
       
-      template<typename SIG, typename MEM>
-      struct UndoDefinition
-        {
-          typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
-          typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
-          
-          UndoDefinition (function<UndoCaptureSig>& undoCapOperation)
-            {
-              cout << showSizeof(undoCapOperation) << endl;
-              UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
-            }
-          
-          template<typename SIG2>
-          UndoDefinition&
-          undoOperation (SIG2& how_to_Undo)
-            {
-              typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
-              
-              function<UndoSig> opera3 (how_to_Undo);
-              
-              UNIMPLEMENTED ("store actual Undo-Functor into the command definition held by the enclosing UndoDefinition instance");
-              return *this;
-            }
-          
-          template
-            < typename T1
-            , typename T2
-            >
-          UndoDefinition&    ///////TODO return here the completed Command
-          bind ( T1& p1
-               , T2& p2
-               )
-            {
-              typedef Types<T1,T2> ArgTypes;
-              Tuple<ArgTypes> params(p1,p2);
-              Closure<SIG> clo (params);
-              
-              cout << showSizeof(clo) << endl;
-              UNIMPLEMENTED ("complete Command definition by closing all functions");
-              return *this;
-            }
-          
-        };
-      
-      /** type re-binding helper: create a suitable UndoDefinition type,
-       *  based on the UndoSignature template instance given as parameter */
-      template<typename U_SIG>
-      struct BuildUndoDefType
-        {
-          typedef UndoDefinition<typename U_SIG::OperateSig, typename U_SIG::Memento> Type;
-        };
-      
-      template<typename SIG>
-      struct BasicDefinition
-        {
-          BasicDefinition(function<SIG>& operation)
-            {
-              cout << showSizeof(operation) << endl;
-              UNIMPLEMENTED ("create new command object and store the operation functor");
-            }
-          
-          
-          template<typename SIG2>
-          typename BuildUndoDefType<UndoSignature<SIG2> >::Type
-          captureUndo (SIG2& how_to_capture_UndoState)
-            {
-              typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
-              typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
-              
-              function<UndoCapSig> opera2 (how_to_capture_UndoState);
-              return SpecificUndoDefinition (opera2);
-            }
-          
-        };
       
     public:
       CommandDef (Symbol cmdID)
@@ -182,11 +194,11 @@ namespace control {
         { }
       
       template<typename SIG>
-      BasicDefinition<SIG>
+      stage::BasicDefinition<SIG>
       operation (SIG& operation_to_define)
         {
           function<SIG> opera1 (operation_to_define);
-          return BasicDefinition<SIG>(opera1);
+          return stage::BasicDefinition<SIG>(opera1);
         }
     };
   
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index ef685f833..8823ed8f6 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -83,7 +83,8 @@ namespace test    {
   
   
   
-  namespace command1 {
+  namespace  {
+  
     void
     operate (P<Time> dummyObj, int randVal)
     {
@@ -129,9 +130,9 @@ namespace test    {
           int randVal ((rand() % 10) - 5);
           
           CommandDef ("test.command1")
-              .operation (command1::operate)
-              .captureUndo (command1::capture)
-              .undoOperation (command1::undoIt)
+              .operation (operate)
+              .captureUndo (capture)
+              .undoOperation (undoIt)
               .bind (obj, randVal)
               ;
           

From a8a0e07726297f56855ac13f1e3bea4392072bae Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 23 Jul 2009 03:47:57 +0200
Subject: [PATCH 213/368] test driven brainstorming

---
 .../proc/control/command-use1-test.cpp        | 190 ++++++++++++++++++
 .../proc/control/test-dummy-commands.hpp      | 105 ++++++++++
 wiki/renderengine.html                        |   4 +-
 3 files changed, 297 insertions(+), 2 deletions(-)
 create mode 100644 tests/components/proc/control/command-use1-test.cpp
 create mode 100644 tests/components/proc/control/test-dummy-commands.hpp

diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
new file mode 100644
index 000000000..a8b6f94a4
--- /dev/null
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -0,0 +1,190 @@
+/*
+  CommandUse1(Test)  -  usage scenario 1
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+//#include <boost/format.hpp>
+//#include <iostream>
+//#include <cstdlib>
+//#include <string>
+
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+//using std::string;
+//using std::rand;
+//using std::cout;
+//using std::endl;
+
+
+namespace control {
+namespace test    {
+
+//  using lib::test::showSizeof;
+  using util::isSameObject;
+
+//  using session::test::TestClip;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+  
+  
+  
+  
+  
+  
+  /***************************************************************************
+   * @test command usage scenario 1: defining commands in various ways.
+   *       
+   * @todo WIP
+   */
+  class CommandUse1_test : public Test
+    {
+    
+      int randVal;
+      int shuffle() { return randVal = 10 + (rand() % 40); }
+      
+      
+      
+      virtual void
+      run (Arg) 
+        {
+          command1::checksum_ = 0;
+          allInOneStep();
+          definePrototype();
+          usePrototype();
+          
+          ASSERT (0 == command1::checksum_);
+        }
+      
+      
+      void
+      allInOneStep()
+        {
+          
+          CommandDef ("test.command1.1")
+              .operation (command1::operate)
+              .captureUndo (command1::capture)
+              .undoOperation (command1::undoIt)
+              .bind (shuffle())
+              .exec()
+              ;
+          
+          ASSERT (randVal == checksum_);
+          
+          Command::get("test.command1.1").undo();
+          ASSERT ( 0 == command1::checksum_);
+        }
+      
+      
+      void
+      definePrototype()
+        {
+          CommandDef ("test.command1.2")
+              .operation (command1::operate)
+              .captureUndo (command1::capture)
+              .undoOperation (command1::undoIt)
+              .bind (shuffle())
+              ;
+          
+          
+          ASSERT (Command::get("test.command1.2").canExec());
+        }
+      
+      
+      void
+      usePrototype()
+        {
+          Command c1 = Command::get("test.command1.2");
+          ASSERT (c1);
+          ASSERT (c1.canExec());
+          ASSERT (!c1.canUndo());
+          
+          Command c2 = Command::get("test.command1.2");
+          ASSERT (c1);
+          ASSERT (c1.canExec());
+          ASSERT (!c1.canUndo());
+          
+          ASSERT (c1 == c2);
+          ASSERT (!isSameObject(c1, c2));
+          
+          ASSERT (0 == command1::checksum_);
+          
+          c1();
+          
+          ASSERT (randVal == command1::checksum_);
+          ASSERT (c1.canUndo());
+          ASSERT (c1 != c2);
+          ASSERT (!c2.canUndo());
+          
+          c2();
+          ASSERT (randVal + randVal == command1::checksum_);
+          ASSERT (c2.canUndo());
+          ASSERT (c1 != c2);
+          
+          c1.undo();
+          ASSERT (0 == command1::checksum_);
+          c2.undo();
+          ASSERT (randVal == command1::checksum_);
+          
+          c2.bind(23);
+          c2();
+          ASSERT (randVal + 23 == command1::checksum_);
+          
+          // you should not use a command more than once (but it works...)
+          c1();
+          ASSERT (randVal + 23 + randVal == command1::checksum_);
+          c1.undo();
+          ASSERT (randVal + 23 == command1::checksum_);
+          // note we've overwritten the previous undo state
+          // and get the sate captured on the second invocation
+          
+          c2.undo()
+          ASSERT (randVal == command1::checksum_);
+          c1.undo();
+          ASSERT (randVal + 23 == command1::checksum_);
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandUse1_test, "function controller");
+      
+      
+}} // namespace control::test
diff --git a/tests/components/proc/control/test-dummy-commands.hpp b/tests/components/proc/control/test-dummy-commands.hpp
new file mode 100644
index 000000000..9f94cc725
--- /dev/null
+++ b/tests/components/proc/control/test-dummy-commands.hpp
@@ -0,0 +1,105 @@
+/*
+  TEST-DUMMY-COMMANDS.hpp  -  dummy function used to build test commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file test-dummy-commands.hpp
+ ** Some dummy command functions used for building unit test cases. 
+ ** Any of these functions comes in triples of operation function, undo state
+ ** capturing function and und function. They are placed into a nested test
+ ** namespace, together with some global variables used as a backdoor to
+ ** verify the effect of calling these functions.
+ **
+ ** @see command-use1-test.cpp
+ ** @see CommandBasic_test simple complete command definition example
+ **
+ */
+
+
+
+#ifndef COMMAND_TEST_DUMMY_COMMANDS_H
+#define COMMAND_TEST_DUMMY_COMMANDS_H
+
+//#include "pre.hpp"
+//#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+//#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+//#include "lib/util.hpp"
+
+
+//#include <boost/format.hpp>
+//#include <iostream>
+//#include <cstdlib>
+//#include <string>
+
+//using boost::format;
+//using lumiera::Time;
+//using util::contains;
+//using std::string;
+//using std::rand;
+//using std::cout;
+//using std::endl;
+
+
+namespace control {
+namespace test    {
+
+//  using lib::test::showSizeof;
+
+  
+  
+  
+  namespace command1 { ///< test command just adding a given value
+    
+    long checksum_ = 0;
+      
+    void
+    operate (int someVal)
+    {
+      checksum_ += someVal;
+    }
+    
+    long
+    capture (int)
+    {
+      return checksum_;
+    }
+    
+    void
+    undoIt (int, long oldVal)
+    {
+      checksum_ = oldVal;
+    }
+  
+  }
+  
+      
+}} // namespace control::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index d0df4536a..2e9bd3a53 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1025,10 +1025,10 @@ A command is operated or executed by passing it to an ''execution pattern'' &amp
 When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. At any time, c ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
 </pre>
 </div>
-<div title="CommandUsage" modifier="Ichthyostega" modified="200907220300" created="200907212338" tags="SessionLogic draft dynamic" changecount="3">
+<div title="CommandUsage" modifier="Ichthyostega" modified="200907230031" created="200907212338" tags="SessionLogic draft dynamic" changecount="4">
 <pre>//for now (7/09) I'll use this page to collect ideas how commands might be used...//
 
-* use a command for getting a log entry and an unto possibility automatically
+* use a command for getting a log entry and an undo possibility automatically
 * might define, bind and then execute a command at once
 * might define it and bind it to a standard set of parameters, to be used as a prototype later.
 * might just create the definition, leaving the argument binding to the actual call site

From f40282b2ff1fac69880f2910e996a25b9a231dd1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 24 Jul 2009 05:24:39 +0200
Subject: [PATCH 214/368] WIP devised various aspects of command execution,
 drafted as unit test

---
 tests/45controller.tests                      |  15 ++
 tests/components/Makefile.am                  |   3 +
 .../proc/control/command-use1-test.cpp        | 167 ++++++++++++--
 .../proc/control/command-use2-test.cpp        | 208 ++++++++++++++++++
 .../proc/control/command-use3-test.cpp        | 121 ++++++++++
 .../proc/control/test-dummy-commands.hpp      |  54 ++++-
 wiki/renderengine.html                        |  12 +-
 7 files changed, 546 insertions(+), 34 deletions(-)
 create mode 100644 tests/components/proc/control/command-use2-test.cpp
 create mode 100644 tests/components/proc/control/command-use3-test.cpp

diff --git a/tests/45controller.tests b/tests/45controller.tests
index d93c7f5a0..a9f87cbf3 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -54,3 +54,18 @@ END
 TEST "Memento wiring and storage" MementoTie_test <<END
 return: 0
 END
+
+
+PLANNED "Command usage aspects I"  CommandUse1_test <<END
+return: 0
+END
+
+
+PLANNED "Command usage aspects II" CommandUse2_test <<END
+return: 0
+END
+
+
+PLANNED "Command usage aspects III" CommandUse3_test <<END
+return: 0
+END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 04599d4f8..31c5a46e3 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -50,6 +50,9 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-argument-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-use1-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-use2-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-use3-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index a8b6f94a4..2b1749f05 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -1,5 +1,5 @@
 /*
-  CommandUse1(Test)  -  usage scenario 1
+  CommandUse1(Test)  -  usage aspects I
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -22,7 +22,7 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/test/test-helper.hpp"
+#include "lib/test/test-helper.hpp"
 //#include "proc/asset/media.hpp"
 //#include "proc/mobject/session.hpp"
 //#include "proc/mobject/session/edl.hpp"
@@ -70,15 +70,18 @@ namespace test    {
   
   
   /***************************************************************************
-   * @test command usage scenario 1: defining commands in various ways.
+   * @test command usage aspects I: defining commands in various ways,
+   *       then re-accessing those definitions, create instances,
+   *       invoke them and undo the effect. Clean up finally.
    *       
-   * @todo WIP
+   * @see Command
+   * @see command-basic-test.cpp (simple usage example)
    */
   class CommandUse1_test : public Test
     {
     
       int randVal;
-      int shuffle() { return randVal = 10 + (rand() % 40); }
+      int random() { return randVal = 10 + (rand() % 40); }
       
       
       
@@ -86,11 +89,18 @@ namespace test    {
       run (Arg) 
         {
           command1::checksum_ = 0;
+          uint cnt_defs = Command::definition_count();
+          uint cnt_inst = Command::instance_count();
+          
           allInOneStep();
+          standardUse();
           definePrototype();
           usePrototype();
+          undef();
           
-          ASSERT (0 == command1::checksum_);
+          ASSERT (0 == command1::check_);
+          ASSERT (cnt_defs == Command::definition_count());
+          ASSERT (cnt_inst == Command::instance_count());
         }
       
       
@@ -102,41 +112,80 @@ namespace test    {
               .operation (command1::operate)
               .captureUndo (command1::capture)
               .undoOperation (command1::undoIt)
-              .bind (shuffle())
-              .exec()
+              .bind (random())
+              .execSync()
               ;
           
           ASSERT (randVal == checksum_);
           
           Command::get("test.command1.1").undo();
-          ASSERT ( 0 == command1::checksum_);
+          ASSERT ( 0 == command1::check_);
+        }
+      
+            
+      void
+      standardUse()
+        {
+          {
+            CommandDef ("test.command1.2")
+                .operation (command1::operate)
+                .captureUndo (command1::capture)
+                .undoOperation (command1::undoIt)
+                ;
+          }
+          ASSERT ( CommandDef("test.command1.2"));
+          ASSERT (!Command::get("test.command1.2"));
+          
+          Command com = Command::get("test.command1.2");
+          ASSERT (!com);
+          ASSERT (!com.canUndo());
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, com() );
+          
+          ASSERT ( 0 == command1::check_);
+          VERIFY_ERROR (INVALID_ARGUMENTS, com.bind ("foo") );
+          com.bind (random());             // note: run-time type check only
+          com();
+          ASSERT (randVal == command1::check_);
+          com.undo();
+          ASSERT ( 0 == command1::check_);
+
+          // the following shortcut does the same:
+          Command::invoke ("test.command1.2", 1234);
+          ASSERT ( 1234 == command1::check_);
+          
+          // another shortcut, with static type check:
+          invoke (command1::operate, 5678);
+          ASSERT ( 1234+5678 == command1::check_);
+          
+          com.undo();
+          ASSERT ( 0 == command1::check_);
         }
       
       
       void
       definePrototype()
         {
-          CommandDef ("test.command1.2")
+          CommandDef ("test.command1.3")
               .operation (command1::operate)
               .captureUndo (command1::capture)
               .undoOperation (command1::undoIt)
-              .bind (shuffle())
+              .bind (random())
               ;
           
           
-          ASSERT (Command::get("test.command1.2").canExec());
+          ASSERT (Command::get("test.command1.3").canExec());
         }
       
       
       void
       usePrototype()
         {
-          Command c1 = Command::get("test.command1.2");
+          Command c1 = Command::get("test.command1.3");
           ASSERT (c1);
           ASSERT (c1.canExec());
           ASSERT (!c1.canUndo());
           
-          Command c2 = Command::get("test.command1.2");
+          Command c2 = Command::get("test.command1.3");
           ASSERT (c1);
           ASSERT (c1.canExec());
           ASSERT (!c1.canUndo());
@@ -144,41 +193,111 @@ namespace test    {
           ASSERT (c1 == c2);
           ASSERT (!isSameObject(c1, c2));
           
-          ASSERT (0 == command1::checksum_);
+          ASSERT (0 == command1::check_);
           
           c1();
           
-          ASSERT (randVal == command1::checksum_);
+          ASSERT (randVal == command1::check_);
           ASSERT (c1.canUndo());
           ASSERT (c1 != c2);
           ASSERT (!c2.canUndo());
           
           c2();
-          ASSERT (randVal + randVal == command1::checksum_);
+          ASSERT (randVal + randVal == command1::check_);
           ASSERT (c2.canUndo());
           ASSERT (c1 != c2);
           
           c1.undo();
-          ASSERT (0 == command1::checksum_);
+          ASSERT (0 == command1::check_);
           c2.undo();
-          ASSERT (randVal == command1::checksum_);
+          ASSERT (randVal == command1::check_);
           
           c2.bind(23);
           c2();
-          ASSERT (randVal + 23 == command1::checksum_);
+          ASSERT (randVal + 23 == command1::check_);
           
           // you should not use a command more than once (but it works...)
           c1();
-          ASSERT (randVal + 23 + randVal == command1::checksum_);
+          ASSERT (randVal + 23 + randVal == command1::check_);
           c1.undo();
-          ASSERT (randVal + 23 == command1::checksum_);
+          ASSERT (randVal + 23 == command1::check_);
           // note we've overwritten the previous undo state
           // and get the sate captured on the second invocation
           
           c2.undo()
-          ASSERT (randVal == command1::checksum_);
+          ASSERT (randVal == command1::check_);
           c1.undo();
-          ASSERT (randVal + 23 == command1::checksum_);
+          ASSERT (randVal + 23 == command1::check_);
+          
+          // use the current sate of c2 as Prototype for new command definition
+          c2.storeDef ("test.command1.4");
+          Command c3 = Command::get("test.command1.4");
+          ASSERT (c3);
+          ASSERT (!c3.canUndo());
+          c3();
+          ASSERT (randVal + 2*23 == command1::check_);
+          
+          c3.bind(-command1::check_);
+          c3();
+          ASSERT (0 == command1::check_);
+          c2();
+          ASSERT (23 == command1::check_);
+          c2.undo();
+          ASSERT (0 == command1::check_);
+        }
+      
+      
+      void
+      undef()
+        {
+          ASSERT (CommandDef ("test.command1.1"))
+          ASSERT (CommandDef ("test.command1.2"))
+          ASSERT (CommandDef ("test.command1.3"))
+          ASSERT (CommandDef ("test.command1.4"))
+          
+          ASSERT (Command::get("test.command1.1"));
+          ASSERT (Command::get("test.command1.2"));
+          ASSERT (Command::get("test.command1.3"));
+          ASSERT (Command::get("test.command1.4"));
+          
+          VERIFY_ERROR (INVALID_COMMAND, Command::get("miracle"));
+          
+          CommandDef unbelievable ("miracle");
+          ASSERT (!unbelievable);
+          
+          // but because the miracle isn't yet defined, any use throws
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("miracle"));
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, unbelievable.execSync() );
+          VERIFY_ERROR (INVALID_COMMAND,   unbelievable.bind("abracadabra"));
+          
+          ASSERT (Command::remove("test.command1.1"));
+          ASSERT (Command::remove("test.command1.2"));
+          ASSERT (Command::remove("test.command1.3"));
+          
+          ASSERT (!Command::remove("miracle")); // there is no such thing...
+          
+          // note, we didn't remove the *definitions*
+          // thus we're free to create new instances...
+          Command xxx = Command::get("test.command1.1");
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, xxx() );
+          
+          // but this one is still there (we didn't remove it)
+          ASSERT (Command::get("test.command1.4"));
+          
+          // now kill the definitions too...
+          ASSERT (Command::undef ("test.command1.1"));
+          ASSERT (Command::undef ("test.command1.2"));
+          ASSERT (Command::undef ("test.command1.3"));
+          ASSERT (Command::undef ("test.command1.4"));
+          ASSERT (Command::undef ("miracle"));
+
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.1"));
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.2"));
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.3"));
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("miracle"));
+          
+          // note: removing the definition automatically killed the remaining instance:
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.4"));
         }
     };
   
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
new file mode 100644
index 000000000..924f9e8c5
--- /dev/null
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -0,0 +1,208 @@
+/*
+  CommandUse2(Test)  -  usage aspects II
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+#include <tr1/functional>
+#include <boost/ref.hpp>
+#include <boost/format.hpp>
+//#include <iostream>
+//#include <cstdlib>
+#include <string>
+
+
+namespace control {
+namespace test    {
+
+
+  using boost::format;
+  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+  using std::tr1::function;
+  using std::tr1::bind;
+  using std::string;
+  //using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+//  using util::isSameObject;
+  using util::contains;
+  using boost::ref;
+
+//  using session::test::TestClip;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  
+  
+  
+  
+  /***************************************************************************
+   * @test command usage aspects II: patterns of invoking commands.
+   *       
+   * @see Command
+   * @see command-basic-test.cpp (simple usage example)
+   */
+  class CommandUse2_test : public Test
+    {
+    
+      int randVal_;
+      
+      string randomTxt()
+        {
+          format fmt ("invoked( %2d )");
+          
+          randVal_ = rand() % 100;
+          return str (fmt % randVal_);
+        }
+      
+      bool blowUp_ = false;
+      
+      
+      virtual void
+      run (Arg) 
+        {
+          command2::check_.seekp(0);
+          uint cnt_defs = Command::definition_count();
+          uint cnt_inst = Command::instance_count();
+          
+          function<string()> randFun = bind (&CommandUse2_test::randomTxt, this);
+          
+          // prepare a command definition (prototype)
+          CommandDef ("test.command2")
+              .operation (command2::operate)
+              .captureUndo (command2::capture)
+              .undoOperation (command2::undoIt)
+              .bind (randFun, ref(blowUp_));
+          
+              // note: blowUp_ is bound via reference_wrapper,
+              //       so we can pull the trigger to provoke an exception
+          blowUp_ = false;
+          
+          
+          check_defaultHandlingPattern();
+          check_ThrowOnError();
+          
+          
+          Command::undef ("test.command2");
+          Command::undef ("test.command2.1");
+          ASSERT (cnt_defs == Command::definition_count());
+          ASSERT (cnt_inst == Command::instance_count());
+        }
+      
+      
+      
+      void
+      check_defaultHandlingPattern()
+        {
+          Command com = Command::get("test.command2");
+          
+          ASSERT (!contains (command2::check_, "invoked"));
+          
+          bool res = com();
+          
+          ASSERT (res);
+          ASSERT (contains (command2::check_, "invoked"));
+          ASSERT (contains (command2::check_, randVal_));
+          
+          res = com.undo();
+          ASSERT (res);        // UNDO invoked successfully
+          ASSERT (!contains (command2::check_, randVal_));
+          ASSERT (contains (command2::check_, "UNDO"));
+          
+          blowUp_ = true;
+          string current = command2::check_.str();
+          
+          res = com();
+          ASSERT (!res);       // not executed successfully (exception thrown)
+          ASSERT (command2::check_.str() == current);
+          ASSERT (LUMIERA_ERROR_EXTERNAL == lumiera_error());
+          
+          res = com.undo();
+          ASSERT (!res);       // UNDO failed (exception thrown)
+          ASSERT (command2::check_.str() == current);
+          ASSERT (LUMIERA_ERROR_EXTERNAL == lumiera_error());
+          
+          blowUp_ = false;
+        }
+      
+      
+      
+      void
+      check_ThrowOnError()
+        {
+          Command com = Command::get("test.command2");
+          
+          blowUp_ = false;
+          com.exec(HandlingPattern::THROW_SYNC);
+          ASSERT (contains (command2::check_, randVal_));
+          
+          blowUp_ = true;
+          string current = command2::check_.str();
+          VERIFY_ERROR( EXTERNAL, com.exec(HandlingPattern::THROW_SYNC) );
+          ASSERT (command2::check_.str() == current);
+          
+          // we can achieve the same effect,
+          // after changing the default HandlingPatern for this command instance
+          com.setHandlingPattern(HandlingPattern::THROW_SYNC);
+          com.storeDef ("test.command2.1");
+          
+          Command com2 = Command::get("test.command2.1");
+          VERIFY_ERROR( EXTERNAL, com2() );
+          ASSERT (command2::check_.str() == current);
+
+          blowUp_ = false;
+          com2();
+          ASSERT (command2::check_.str() > current);
+          ASSERT (contains (command2::check_, randVal_));
+          
+          com2.undo();
+          ASSERT (!contains (command2::check_, randVal_));
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandUse2_test, "function controller");
+      
+      
+}} // namespace control::test
diff --git a/tests/components/proc/control/command-use3-test.cpp b/tests/components/proc/control/command-use3-test.cpp
new file mode 100644
index 000000000..03048599c
--- /dev/null
+++ b/tests/components/proc/control/command-use3-test.cpp
@@ -0,0 +1,121 @@
+/*
+  CommandUse3(Test)  -  usage aspects III
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+//#include <tr1/functional>
+//#include <boost/ref.hpp>
+//#include <boost/format.hpp>
+//#include <iostream>
+//#include <cstdlib>
+//#include <string>
+
+
+namespace control {
+namespace test    {
+
+
+//  using boost::format;
+//  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+//  using std::tr1::function;
+//  using std::tr1::bind;
+//  using std::string;
+  //using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+//  using util::isSameObject;
+//  using util::contains;
+
+//  using session::test::TestClip;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  
+  
+  
+  
+  /***************************************************************************
+   * @test command usage aspects III: elaborate handling patterns, like e.g.
+   *       asynchronous or repeated invocation and command sequence bundles.
+   *
+   * @todo planned but not implemented as of 7/09
+   *        
+   * @see HandlingPattern
+   */
+  class CommandUse3_test : public Test
+    {
+    
+      
+      virtual void
+      run (Arg) 
+        {
+          command1::check_ = 0;
+          uint cnt_defs = Command::definition_count();
+          uint cnt_inst = Command::instance_count();
+          
+          // prepare a command definition (prototype)
+          CommandDef ("test.command1.1")
+              .operation (command1::operate)
+              .captureUndo (command1::capture)
+              .undoOperation (command1::undoIt);
+
+          UNIMPLEMENTED ("more elaborate command handling patterns")
+          ////////////////////////////////////////////////////////////////////////////////TODO: devise tests for async, repeated and compound sequences
+          
+          ASSERT (cnt_inst == Command::instance_count());
+          
+          Command::undef ("test.command1.1");
+          ASSERT (cnt_defs == Command::definition_count());
+        }
+      
+      
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandUse3_test, "function controller");
+      
+      
+}} // namespace control::test
diff --git a/tests/components/proc/control/test-dummy-commands.hpp b/tests/components/proc/control/test-dummy-commands.hpp
index 9f94cc725..4bbf9ed0e 100644
--- a/tests/components/proc/control/test-dummy-commands.hpp
+++ b/tests/components/proc/control/test-dummy-commands.hpp
@@ -61,42 +61,88 @@
 //#include <string>
 
 //using boost::format;
+
 //using lumiera::Time;
 //using util::contains;
 //using std::string;
 //using std::rand;
 //using std::cout;
 //using std::endl;
+#include <tr1/functional>
+#include <sstream>
+#include <string>
 
 
 namespace control {
 namespace test    {
 
 //  using lib::test::showSizeof;
+  using std::ostringstream;
+  using std::tr1::function;
+  using std::string;
 
   
   
   
   namespace command1 { ///< test command just adding a given value
     
-    long checksum_ = 0;
+    long check_ = 0;
       
     void
     operate (int someVal)
     {
-      checksum_ += someVal;
+      check_ += someVal;
     }
     
     long
     capture (int)
     {
-      return checksum_;
+      return check_;
     }
     
     void
     undoIt (int, long oldVal)
     {
-      checksum_ = oldVal;
+      check_ = oldVal;
+    }
+  
+  }
+  
+  
+  
+  
+  
+  namespace command2 { ///< test command writing to protocol and possibly throwing
+    
+    using lumiera::error::External;
+    
+    
+    ostringstream check_;
+      
+    
+    typedef function<string()> FunS;
+    
+    void
+    operate (FunS func, bool fail)
+    {
+      if (fail) throw External("simulated exception");
+      
+      check_ << func();
+    }
+    
+    string
+    capture (FunS, bool)
+    {
+      return check_.str();
+    }
+    
+    void
+    undoIt (FunS, bool fail, string previousProtocol)
+    {
+      if (fail) throw External("simulated exception in UNDO");
+      
+      check_.seekp(0);
+      check_ << previousProtocol << "|UNDO|";
     }
   
   }
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 2e9bd3a53..0df78873b 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1012,20 +1012,20 @@ A command may be [[defined|CommandDefinition]] completely from scratch, or it mi
 By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation. While nothing prevents you from invoking the command operation functor several times, each invocation will overwrite the undo state captrued by the previous invocation. Thus, each command instance should bes seen as the promise (or later the trace) of a single operation execution. In a similar vein, the undo capturing should be defined as to be self sufficient, so that invoking just the undo functor of a single command performes any necessary steps to restore the situation found before invoking the corresponding mutation functor &amp;mdash; of course only //with respect to the topic covered by this command.// So, while commands provide a lot of flexibility and allow to do a multitude of things, certainly there is an intended CommandLifecycle.
 &amp;rarr; more on possible [[command usage scenarios|CommandUsage]]</pre>
 </div>
-<div title="CommandLifecycle" modifier="Ichthyostega" modified="200907210211" created="200907210135" tags="SessionLogic spec draft design img" changecount="5">
+<div title="CommandLifecycle" modifier="Ichthyostega" modified="200907240010" created="200907210135" tags="SessionLogic spec draft design img" changecount="10">
 <pre>[&lt;img[Structure of Commands|uml/fig135173.png]]
 While generally the command framework was designed to be flexible and allow a lot of different use cases, execution paths and to serve various goals, there is an ''intended lifecycle'' &amp;mdash; commands are expected to go through several distinct states.
 
-The handling of a command starts out with a ''command ID'' provided by the client code. Command IDs are unique (human readable) identifiers and should be organised in a hierarchical fashion. When provided with an ID, the CommandRegistry tries to fetch an existing command definition. In case this fails, we enter the [[command definition stage|CommandDefinition]], which includes specifying functions to implement the operation, state capturing and UNDO. When all these informations are available, the entity is called a ''command definition''. It is comparable to a //class// or //meta object.//
+The handling of a command starts out with a ''command ID'' provided by the client code. Command IDs are unique (human readable) identifiers and should be organised in a hierarchical fashion. When provided with an ID, the CommandRegistry tries to fetch an existing command definition. In case this fails, we enter the [[command definition stage|CommandDefinition]], which includes specifying functions to implement the operation, state capturing and UNDO. When all these informations are available, the entity is called a ''command definition''. Conceptually, it is comparable to a //class// or //meta object.//
 
-By ''binding'' to specific operation arguments, the definition is //armed// and becomes a real ''command''. This is similar to creating an instance from a class
+By ''binding'' to specific operation arguments, the definition is //armed up//&amp;nbsp; and becomes a real ''command''. This is similar to creating an instance from a class. Behind the scenes, storage is allocated to hold the argument values and any state captured to create the ability to UNDO the command's effect later on.
 
 A command is operated or executed by passing it to an ''execution pattern'' &amp;mdash; there is a multitude of possible execution patterns to choose from, depending on the situation. 
 {{red{WIP}}}
-When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. At any time, c ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
+When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. Anyway, a ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
 </pre>
 </div>
-<div title="CommandUsage" modifier="Ichthyostega" modified="200907230031" created="200907212338" tags="SessionLogic draft dynamic" changecount="4">
+<div title="CommandUsage" modifier="Ichthyostega" modified="200907232209" created="200907212338" tags="SessionLogic draft dynamic" changecount="5">
 <pre>//for now (7/09) I'll use this page to collect ideas how commands might be used...//
 
 * use a command for getting a log entry and an undo possibility automatically
@@ -1052,7 +1052,7 @@ When a command has been executed (and maybe undone), it's best to leave it alone
 
 !!!an execution pattern....
 * can only be defined in code by a class definition, not at runtime
-* subclasses the !HandlingPattern interface, which automatically creates an registration.
+* subclasses the ~HandlingPattern interface, which automatically creates an registration.
 * a singleton instance is created on demand, triggered by referring the pattern's ID
 * is conceptually //stateless// &amp;mdash; of course there can be common configuration values
 * is always invoked providing a concrete command instance to execute

From 211a2dabddd627cd214eb65b79a4366efc97a720 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 24 Jul 2009 17:50:14 +0200
Subject: [PATCH 215/368] WIP stubbing undefined operations...

---
 src/proc/control/command-def.hpp              |  5 +
 src/proc/control/command.cpp                  | 91 +++++++++++++++++++
 src/proc/control/command.hpp                  | 42 ++++++++-
 src/proc/control/handling-pattern.hpp         |  6 ++
 .../proc/control/command-use1-test.cpp        | 12 +--
 .../proc/control/test-dummy-commands.hpp      |  1 +
 6 files changed, 147 insertions(+), 10 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 9c2316b86..159bdcdc7 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -57,6 +57,7 @@
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelist-util.hpp"
 #include "lib/meta/tuple.hpp"
+#include "lib/bool-checkable.hpp"
 
 //#include <tr1/memory>
 #include <tr1/functional>
@@ -184,6 +185,7 @@ namespace control {
    * 
    */
   class CommandDef
+    : public lib::BoolCheckable<CommandDef>
     {
       Symbol id_;
       
@@ -200,6 +202,9 @@ namespace control {
           function<SIG> opera1 (operation_to_define);
           return stage::BasicDefinition<SIG>(opera1);
         }
+      
+      
+      bool isValid()  const;
     };
   
   ////////////////TODO currently just fleshing  out the API....
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 44ed430c4..fbdebf4ab 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -31,7 +31,9 @@
 
 
 #include "proc/control/command.hpp"
+#include "proc/control/command-def.hpp"
 #include "proc/control/command-registry.hpp"
+#include "proc/control/handling-pattern.hpp"
 //#include "proc/mobject/mobject-ref.hpp"
 //#include "proc/mobject/mobject.hpp"
 //#include "proc/mobject/placement.hpp"
@@ -46,6 +48,9 @@ namespace control {
   
 
 
+  Command::~Command() { }
+  
+
   /** */
   Command& 
   Command::get (Symbol cmdID)
@@ -53,6 +58,92 @@ namespace control {
     UNIMPLEMENTED ("fetch an existing command from the internal cmd registry");
   }
   
+  
+  bool
+  Command::remove (Symbol cmdID)
+  {
+    UNIMPLEMENTED ("de-register a single command instance");
+  }
+  
+  
+  bool
+  Command::undef (Symbol cmdID)
+  {
+    UNIMPLEMENTED ("completely drop a command definition, together with all dependent instances");
+  }
+  
+  
+  
+  size_t
+  Command::definition_count()
+  {
+    UNIMPLEMENTED ("return number of command definitions currently in the registry");
+  }
+  
+  
+  
+  size_t
+  Command::instance_count()
+  {
+    UNIMPLEMENTED ("return number individual command instances currently in the registry");
+  }
+  
+  
+  
+  bool
+  CommandDef::isValid()  const
+  {
+    UNIMPLEMENTED ("command *definition* validity self check");
+  }
+  
+  
+  
+  bool
+  Command::isValid()  const
+  {
+    UNIMPLEMENTED ("command validity self check");
+  }
+  
+  
+  
+  bool
+  Command::canExec()  const
+  {
+    UNIMPLEMENTED ("state check: sufficiently defined to be invoked");
+  }
+  
+  
+  
+  bool
+  Command::canUndo()  const
+  {
+    UNIMPLEMENTED ("state check: has undo state been captured?");
+  }
+
+  
+  
+  
+  void
+  Command::undo ()
+  {
+    exec (getDefaultHandlingPattern().howtoUNDO());
+  }
+  
+  
+  void
+  Command::exec (HandlingPattern const& execPattern)
+  {
+    execPattern.invoke (*this);
+  }
+  
+  
+  HandlingPattern const&
+  Command::getDefaultHandlingPattern()  const
+  {
+    UNIMPLEMENTED ("manage the default command handling pattern");
+  }
+
+  
 
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index d48dba207..7c16761e5 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -38,6 +38,7 @@
 #include "include/symbol.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
+#include "lib/bool-checkable.hpp"
 
 //#include <tr1/memory>
 
@@ -51,24 +52,57 @@ namespace control {
 //  using std::tr1::shared_ptr;
   
   
+  class HandlingPattern;
+  
+  
   /**
    * @todo Type-comment
    */
   class Command
+    : public lib::BoolCheckable<Command>
     {
       
     public:
+      /* === command registry === */
       static Command& get (Symbol cmdID);
+      static bool  remove (Symbol cmdID); 
+      static bool   undef (Symbol cmdID); 
       
-      virtual ~Command() {};
       
-      virtual void operator() ()   =0;
-      virtual void undo ()         =0;         
       
+     ~Command();
+      
+      void operator() () ;
+      void undo () ;
+      
+      
+      /** core operation: invoke the command
+       *  @param execPattern describes the individual steps
+       *         necessary to get this command invoked properly
+       */
+      void exec (HandlingPattern const& execPattern);
+      
+      HandlingPattern const& getDefaultHandlingPattern()  const;
+      
+      
+      /* === diagnostics === */
+      
+      static size_t definition_count();
+      static size_t instance_count();
+      
+      bool isValid()  const;
+      bool canExec()  const;
+      bool canUndo()  const;
     };
   ////////////////TODO currently just fleshing  out the API....
   
-  
+
+  inline void
+  Command::operator() ()
+  {
+    exec (getDefaultHandlingPattern());
+  }
+
   
   
 } // namespace control
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 92bc776b9..d325453dd 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -58,6 +58,12 @@ namespace control {
       
     public:
       
+      virtual ~HandlingPattern() {}
+      
+      virtual void invoke (Command& command)  const  =0;
+      
+      virtual HandlingPattern const& howtoUNDO()  const  =0;
+      
     };
   ////////////////TODO currently just fleshing  out the API....
   
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 2b1749f05..bc43e2aaf 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -88,7 +88,7 @@ namespace test    {
       virtual void
       run (Arg) 
         {
-          command1::checksum_ = 0;
+          command1::check_ = 0;
           uint cnt_defs = Command::definition_count();
           uint cnt_inst = Command::instance_count();
           
@@ -116,7 +116,7 @@ namespace test    {
               .execSync()
               ;
           
-          ASSERT (randVal == checksum_);
+          ASSERT (randVal == command1::check_);
           
           Command::get("test.command1.1").undo();
           ASSERT ( 0 == command1::check_);
@@ -250,10 +250,10 @@ namespace test    {
       void
       undef()
         {
-          ASSERT (CommandDef ("test.command1.1"))
-          ASSERT (CommandDef ("test.command1.2"))
-          ASSERT (CommandDef ("test.command1.3"))
-          ASSERT (CommandDef ("test.command1.4"))
+          ASSERT (CommandDef ("test.command1.1"));
+          ASSERT (CommandDef ("test.command1.2"));
+          ASSERT (CommandDef ("test.command1.3"));
+          ASSERT (CommandDef ("test.command1.4"));
           
           ASSERT (Command::get("test.command1.1"));
           ASSERT (Command::get("test.command1.2"));
diff --git a/tests/components/proc/control/test-dummy-commands.hpp b/tests/components/proc/control/test-dummy-commands.hpp
index 4bbf9ed0e..b3a2a9c45 100644
--- a/tests/components/proc/control/test-dummy-commands.hpp
+++ b/tests/components/proc/control/test-dummy-commands.hpp
@@ -149,3 +149,4 @@ namespace test    {
   
       
 }} // namespace control::test
+#endif

From 76b6f5d37434ba14e1d33650fd080f2b66c66d5e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 25 Jul 2009 17:51:59 +0200
Subject: [PATCH 216/368] ooops, forgot some copy-n-pastes

---
 src/lib/meta/tuple.hpp                     |  69 ++++++++++++++
 src/proc/control/argument-tuple-accept.hpp | 100 +++++++++++++++++++++
 2 files changed, 169 insertions(+)

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index ff03cfff6..622246327 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -373,6 +373,75 @@ namespace typelist{
     }
     
     
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            >
+    inline
+    Tuple< Types<T1,T2,T3,T4,T5,T6> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         , T4 a4 =T4()
+         , T5 a5 =T5()
+         , T6 a6 =T6()
+         )
+    {
+      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            >
+    inline
+    Tuple< Types<T1,T2,T3,T4,T5,T6,T7> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         , T4 a4 =T4()
+         , T5 a5 =T5()
+         , T6 a6 =T6()
+         , T7 a7 =T7()
+         )
+    {
+      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7);
+    }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            >
+    inline
+    Tuple< Types<T1,T2,T3,T4,T5,T6,T7,T8> >
+    make ( T1 a1 =T1()
+         , T2 a2 =T2()
+         , T3 a3 =T3()
+         , T4 a4 =T4()
+         , T5 a5 =T5()
+         , T6 a6 =T6()
+         , T7 a7 =T7()
+         , T8 a8 =T8()
+         )
+    {
+      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7,a8);
+    }
+    
+    
     template< typename T1
             , typename T2
             , typename T3
diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 2c847d8d5..faadebc89 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -138,6 +138,106 @@ namespace control {
       };
     
     
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5> >                               ///< Accept binding for 5 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
+          {
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6> >                            ///< Accept binding for 6 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
+          {
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6,T7> >                         ///< Accept binding for 7 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
+          {
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                      ///< Accept binding for 8 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
+          {
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+          }
+      };
+    
+    
+    template< class TAR, class BA
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            , typename T9
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >                   ///< Accept binding for 9 Arguments
+      : BA
+      {
+        void
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
+          {
+            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+          }
+      };
+    
+    
     
     template<typename SIG>
     struct _Type

From 299c316ad49faf139a6f4581493412fb477408dd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 25 Jul 2009 19:20:21 +0200
Subject: [PATCH 217/368] Fix: containment check should take const args

---
 src/lib/util.hpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index bdee6ea5d..ccbb23b80 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -115,7 +115,7 @@ namespace util {
   /** shortcut for string value containment test */
   template <typename T>
   inline bool 
-  contains (std::string& str, const T& val)
+  contains (std::string const& str, const T& val)
   {
     return str.find (val) != std::string::npos;
   }
@@ -124,7 +124,7 @@ namespace util {
    *  in any sequential container */
   template <typename SEQ>
   inline bool 
-  contains (SEQ& cont, typename SEQ::const_reference val)
+  contains (SEQ const& cont, typename SEQ::const_reference val)
   {
     typename SEQ::const_iterator begin = cont.begin();
     typename SEQ::const_iterator end   = cont.end();

From 1db718c2b3339604e0a0f24cddb908c6543d3cd6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 25 Jul 2009 19:21:50 +0200
Subject: [PATCH 218/368] WIP more stubbing...

---
 src/lib/meta/tuple.hpp                        |   6 +-
 src/proc/control/argument-tuple-accept.hpp    |   4 +-
 src/proc/control/command-argument-holder.hpp  |   2 +-
 src/proc/control/command-binding.hpp          | 213 ++++++++++++++++++
 src/proc/control/command.cpp                  |  13 +-
 src/proc/control/command.hpp                  |  15 +-
 tests/45controller.tests                      |   2 +-
 .../control/argument-tuple-accept-test.cpp    |   8 +-
 .../proc/control/command-use1-test.cpp        |   4 +-
 .../proc/control/command-use2-test.cpp        |  40 +++-
 10 files changed, 280 insertions(+), 27 deletions(-)
 create mode 100644 src/proc/control/command-binding.hpp

diff --git a/src/lib/meta/tuple.hpp b/src/lib/meta/tuple.hpp
index 622246327..27f8538c1 100644
--- a/src/lib/meta/tuple.hpp
+++ b/src/lib/meta/tuple.hpp
@@ -390,7 +390,7 @@ namespace typelist{
          , T6 a6 =T6()
          )
     {
-      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6);
+      return Tuple<Types<T1,T2,T3,T4,T5,T6> > (a1,a2,a3,a4,a5,a6);
     }
     
     
@@ -413,7 +413,7 @@ namespace typelist{
          , T7 a7 =T7()
          )
     {
-      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7);
+      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7> > (a1,a2,a3,a4,a5,a6,a7);
     }
     
     
@@ -438,7 +438,7 @@ namespace typelist{
          , T8 a8 =T8()
          )
     {
-      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> > (a1,a2,a3,a4,a5,a6,a7,a8);
+      return Tuple<Types<T1,T2,T3,T4,T5,T6,T7,T8> > (a1,a2,a3,a4,a5,a6,a7,a8);
     }
     
     
diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index faadebc89..fe618f7dc 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -22,7 +22,7 @@
 
 
 /** @file argument-tuple-accept.hpp
- ** The ArgumentTupleAccept template allows to mix in a \c bind(...) function.
+ ** The AcceptArgumentTuple template allows to mix in a \c bind(...) function.
  ** Thereby, the correct number and types of arguments is derived according to
  ** the function signature given as template parameter. This helper template is
  ** used for the ArgumentHolder and generally for binding the arguments when
@@ -257,7 +257,7 @@ namespace control {
    *  @param BASE the base class for inheritance chaining
    */
   template<typename SIG, class TAR, class BASE>
-  class ArgumentTupleAccept
+  class AcceptArgumentTuple
     : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Args>
     {
     };
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index ef82f7fc6..50c784782 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -103,7 +103,7 @@ namespace control {
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
-    : public ArgumentTupleAccept< SIG                      // to derive the desired bind(..) signature
+    : public AcceptArgumentTuple< SIG                      // to derive the desired bind(..) signature
                                 , ArgumentHolder<SIG,MEM>  // target class providing the implementation
                                 , CmdClosure               // base class to inherit from
                                 > 
diff --git a/src/proc/control/command-binding.hpp b/src/proc/control/command-binding.hpp
new file mode 100644
index 000000000..79ae2f0c8
--- /dev/null
+++ b/src/proc/control/command-binding.hpp
@@ -0,0 +1,213 @@
+/*
+  COMMAND-BINDING.hpp  -  interface for various ways of binding command arguments
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-binding.hpp
+ ** Sub-include of command.hpp, providing an interface to various ways
+ ** of binding command arguments. While in some cases, a command will be
+ ** set up completely finished and closed over all it's arguments, usually
+ ** the CommandDef will just specify the command operation and undo function,
+ ** thus leaving the task of binding concrete arguments to the client code.
+ ** Thus, depending on the circumstances, there might be usage situations
+ ** where the exact number and type of arguments can be detected and checked
+ ** at compile time, while otherwise this check needs to be deferred to happen
+ ** at runtime, when the binding is actually invoked.
+ **
+ ** @see Command
+ ** @see CommandDef
+ ** @see command-use1-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_BINDING_H
+#define CONTROL_COMMAND_BINDING_H
+
+//#include "pre.hpp"
+//#include "include/symbol.hpp"
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/tuple.hpp"
+
+//#include <tr1/memory>
+
+
+
+
+namespace control {
+namespace com { ///< Proc-Layer command implementation details
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  using namespace lumiera::typelist;
+  
+  
+  
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  template<class TAR, class BA>
+  class ArgumentBinder
+    : public BA
+    {
+      
+    public:
+    
+    
+    /** Arm up a command by binding it with concrete arguments.
+     *  At this point, a run time type check is performed, to find out
+     *  if the number and type of arguments of the stored operation function
+     *  within the command matches the given argument pattern
+     */
+    void
+    bind ()
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple());
+      }
+    
+    
+    template<typename T1>
+    void                                                                                  //________________________________
+    bind (T1 a1)                                                                         ///< Accept binding with 1 Argument
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2)                                                                  ///< Accept binding for 2 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3)                                                           ///< Accept binding for 3 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3, T4 a4)                                                    ///< Accept binding for 4 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)                                             ///< Accept binding for 5 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)                                      ///< Accept binding for 6 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)                               ///< Accept binding for 7 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)                        ///< Accept binding for 8 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+      }
+    
+    
+    template< typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            , typename T9
+            >
+    void                                                                                  //________________________________
+    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)                 ///< Accept binding for 9 Arguments
+      {
+        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+      }
+    
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+
+
+  
+  
+}} // namespace control
+#endif
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index fbdebf4ab..e8a0fb469 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -43,8 +43,10 @@
 
 namespace control {
   
+  LUMIERA_ERROR_DEFINE (INVALID_COMMAND,   "Unknown or insufficiently defined command");
+  LUMIERA_ERROR_DEFINE (INVALID_ARGUMENTS, "Arguments provided for binding doesn't match stored command function parameters");
   LUMIERA_ERROR_DEFINE (UNBOUND_ARGUMENTS, "Command mutation functor not yet usable, because arguments aren't bound");
-  LUMIERA_ERROR_DEFINE (MISSING_MEMENTO, "Undo functor not yet usable, because no undo state has been captured");
+  LUMIERA_ERROR_DEFINE (MISSING_MEMENTO,   "Undo functor not yet usable, because no undo state has been captured");
   
 
 
@@ -142,6 +144,15 @@ namespace control {
   {
     UNIMPLEMENTED ("manage the default command handling pattern");
   }
+  
+  
+  template<typename TYPES>
+  void
+  Command::bindArg (Tuple<TYPES> const& args)
+  {
+    UNIMPLEMENTED ("create an argument-binding, with runtime type check");
+  }
+
 
   
 
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 7c16761e5..0a5b47828 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -34,8 +34,9 @@
 #ifndef CONTROL_COMMAND_H
 #define CONTROL_COMMAND_H
 
-//#include "pre.hpp"
+#include "pre.hpp"
 #include "include/symbol.hpp"
+#include "proc/control/command-binding.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
 #include "lib/bool-checkable.hpp"
@@ -51,6 +52,11 @@ namespace control {
   using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
+  LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Command functor not yet usable, because arguments aren't bound
+  LUMIERA_ERROR_DECLARE (INVALID_COMMAND);    ///< Unknown or insufficiently defined command
+  LUMIERA_ERROR_DECLARE (INVALID_ARGUMENTS);  ///< Arguments provided for binding doesn't match stored command function parameters
+
+  
   
   class HandlingPattern;
   
@@ -59,7 +65,8 @@ namespace control {
    * @todo Type-comment
    */
   class Command
-    : public lib::BoolCheckable<Command>
+    : public com::ArgumentBinder<Command
+           , lib::BoolCheckable<Command> >
     {
       
     public:
@@ -85,6 +92,10 @@ namespace control {
       HandlingPattern const& getDefaultHandlingPattern()  const;
       
       
+      template<typename TYPES>
+      void bindArg (Tuple<TYPES> const&);
+      
+      
       /* === diagnostics === */
       
       static size_t definition_count();
diff --git a/tests/45controller.tests b/tests/45controller.tests
index a9f87cbf3..f8ea6c8e6 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -43,7 +43,7 @@ out: saved state: 11
 END
 
 
-TEST "build argument accepting function" ArgumentTupleAccept_test <<END
+TEST "build argument accepting function" AcceptArgumentTuple_test <<END
 out: sizeof\( .+control.+TestClass.+ \) =   1
 out: sizeof\( .+control.+TestClass.+lumiera.Time.+ \) =  ( 8)|(16)
 out: 00:..:..\.000
diff --git a/tests/components/proc/control/argument-tuple-accept-test.cpp b/tests/components/proc/control/argument-tuple-accept-test.cpp
index 7416b1998..a1a939fee 100644
--- a/tests/components/proc/control/argument-tuple-accept-test.cpp
+++ b/tests/components/proc/control/argument-tuple-accept-test.cpp
@@ -1,5 +1,5 @@
 /*
-  ArgumentTupleAccept(Test)  -  verify synthesising a bind(...) function
+  AcceptArgumentTuple(Test)  -  verify synthesising a bind(...) function
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -63,7 +63,7 @@ namespace test    {
     
     template<typename SIG>
     class TestClass
-      : public ArgumentTupleAccept< SIG                     // to derive the desired signature
+      : public AcceptArgumentTuple< SIG                     // to derive the desired signature
                                   , TestClass<SIG>          // the target class providing the implementation
                                   , typename Tup<SIG>::Ty   // base class to inherit from
                                   >
@@ -93,7 +93,7 @@ namespace test    {
    *       
    * @see  control::CommandArgumentHolder
    */
-  class ArgumentTupleAccept_test : public Test
+  class AcceptArgumentTuple_test : public Test
     {
       
       virtual void
@@ -117,7 +117,7 @@ namespace test    {
   
   
   /** Register this test class... */
-  LAUNCHER (ArgumentTupleAccept_test, "unit controller");
+  LAUNCHER (AcceptArgumentTuple_test, "unit controller");
   
   
 }} // namespace control::test
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index bc43e2aaf..c6c3fdcc9 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -32,6 +32,7 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
 #include "lib/util.hpp"
@@ -224,7 +225,7 @@ namespace test    {
           // note we've overwritten the previous undo state
           // and get the sate captured on the second invocation
           
-          c2.undo()
+          c2.undo();
           ASSERT (randVal == command1::check_);
           c1.undo();
           ASSERT (randVal + 23 == command1::check_);
@@ -267,7 +268,6 @@ namespace test    {
           
           // but because the miracle isn't yet defined, any use throws
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("miracle"));
-          VERIFY_ERROR (UNBOUND_ARGUMENTS, unbelievable.execSync() );
           VERIFY_ERROR (INVALID_COMMAND,   unbelievable.bind("abracadabra"));
           
           ASSERT (Command::remove("test.command1.1"));
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
index 924f9e8c5..1069a06b0 100644
--- a/tests/components/proc/control/command-use2-test.cpp
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -32,7 +32,9 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
+#include "proc/control/handling-pattern.hpp"
 //#include "lib/lumitime.hpp"
 #include "lib/util.hpp"
 
@@ -41,6 +43,7 @@
 #include <tr1/functional>
 #include <boost/ref.hpp>
 #include <boost/format.hpp>
+#include <boost/lexical_cast.hpp>
 //#include <iostream>
 //#include <cstdlib>
 #include <string>
@@ -62,6 +65,7 @@ namespace test    {
   //using std::endl;
 //  using lib::test::showSizeof;
 //  using util::isSameObject;
+  using boost::lexical_cast;
   using util::contains;
   using boost::ref;
 
@@ -73,6 +77,20 @@ namespace test    {
   using lumiera::error::LUMIERA_ERROR_EXTERNAL;
   
   
+  /** diagnostics: checks if the given value has been written
+   *  to the test protocol (string stream) of command2 
+   *  Explanation: command2 accepts a function, invokes
+   *  it and writes the result to the protocol stream. 
+   */
+  template<typename TY>
+  inline bool
+  protocolled (TY val2check)
+    {
+      return contains ( command2::check_.str()
+                      , lexical_cast<string> (val2check)
+                      );
+    }
+      
   
   
   
@@ -95,7 +113,7 @@ namespace test    {
           return str (fmt % randVal_);
         }
       
-      bool blowUp_ = false;
+      bool blowUp_;
       
       
       virtual void
@@ -114,8 +132,8 @@ namespace test    {
               .undoOperation (command2::undoIt)
               .bind (randFun, ref(blowUp_));
           
-              // note: blowUp_ is bound via reference_wrapper,
-              //       so we can pull the trigger to provoke an exception
+           //note : blowUp_ is bound via reference_wrapper,
+          //        thus we can provoke an exception at will.
           blowUp_ = false;
           
           
@@ -136,18 +154,18 @@ namespace test    {
         {
           Command com = Command::get("test.command2");
           
-          ASSERT (!contains (command2::check_, "invoked"));
+          ASSERT (!protocolled("invoked"));
           
           bool res = com();
           
           ASSERT (res);
-          ASSERT (contains (command2::check_, "invoked"));
-          ASSERT (contains (command2::check_, randVal_));
+          ASSERT (protocolled("invoked"));
+          ASSERT (protocolled(randVal_));
           
           res = com.undo();
           ASSERT (res);        // UNDO invoked successfully
-          ASSERT (!contains (command2::check_, randVal_));
-          ASSERT (contains (command2::check_, "UNDO"));
+          ASSERT (!protocolled(randVal_));
+          ASSERT (protocolled("UNDO"));
           
           blowUp_ = true;
           string current = command2::check_.str();
@@ -174,7 +192,7 @@ namespace test    {
           
           blowUp_ = false;
           com.exec(HandlingPattern::THROW_SYNC);
-          ASSERT (contains (command2::check_, randVal_));
+          ASSERT (protocolled(randVal_));
           
           blowUp_ = true;
           string current = command2::check_.str();
@@ -193,10 +211,10 @@ namespace test    {
           blowUp_ = false;
           com2();
           ASSERT (command2::check_.str() > current);
-          ASSERT (contains (command2::check_, randVal_));
+          ASSERT (protocolled(randVal_));
           
           com2.undo();
-          ASSERT (!contains (command2::check_, randVal_));
+          ASSERT (!protocolled(randVal_));
         }
     };
   

From c85eb20cee5edebb283c497de58b54945e334a4c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 26 Jul 2009 02:00:00 +0200
Subject: [PATCH 219/368] allow bind functions with return value

---
 src/proc/control/argument-tuple-accept.hpp | 105 ++++++++++++---------
 1 file changed, 60 insertions(+), 45 deletions(-)

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index fe618f7dc..b7a309525 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -55,7 +55,7 @@ namespace control {
     
     /** @internal mix in a \c bind() function
      */
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename TYPES
             >
     struct AcceptArgs ;
@@ -63,100 +63,100 @@ namespace control {
     
     /* specialisations for 0...9 Arguments.... */
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             >                                                                        //____________________________________
-    struct AcceptArgs<TAR,BA, Types<> >                                             ///< Accept dummy binding (0 Arguments)
+    struct AcceptArgs<TAR,BA,RET, Types<> >                                         ///< Accept dummy binding (0 Arguments)
       : BA
       {
-        void
+        RET
         bind ()
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
+            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             >                                                                        //_______________________________
-    struct AcceptArgs<TAR,BA, Types<T1> >                                           ///< Accept binding for 1 Argument
+    struct AcceptArgs<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
       : BA
       {
-        void
+        RET
         bind (T1 a1)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2> >                                        ///< Accept binding for 2 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3> >                                     ///< Accept binding for 3 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
             , typename T4
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4> >                                  ///< Accept binding for 4 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3, T4 a4)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
             , typename T4
             , typename T5
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5> >                               ///< Accept binding for 5 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
@@ -164,18 +164,18 @@ namespace control {
             , typename T5
             , typename T6
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6> >                            ///< Accept binding for 6 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
@@ -184,18 +184,18 @@ namespace control {
             , typename T6
             , typename T7
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6,T7> >                         ///< Accept binding for 7 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
@@ -205,18 +205,18 @@ namespace control {
             , typename T7
             , typename T8
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                      ///< Accept binding for 8 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
           }
       };
     
     
-    template< class TAR, class BA
+    template< class TAR, class BA, class RET
             , typename T1
             , typename T2
             , typename T3
@@ -227,13 +227,13 @@ namespace control {
             , typename T8
             , typename T9
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >                   ///< Accept binding for 9 Arguments
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
       : BA
       {
-        void
+        RET
         bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
           {
-            static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
           }
       };
     
@@ -243,27 +243,42 @@ namespace control {
     struct _Type
       {
         typedef typename FunctionSignature< function<SIG> >::Args Args;
+        typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
         typedef Tuple<Args> ArgTuple;
       };
   
+    struct Dummy {}; 
+    
+    
   } // (END) impl details
   
   
   
   
   /** Helper Template for Proc-Layer control::Command : mix in a \c bind(...) function
-   *  @param SIG  function signature to mimic (regarding the arguments; return type will be void)
+   *  @param SIG  function signature to mimic (regarding the arguments and return type)
    *  @param TAR  the target class providing a function \c bindArg(Tuple<Types<T1...> >)
    *  @param BASE the base class for inheritance chaining
    */
-  template<typename SIG, class TAR, class BASE>
+  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
   class AcceptArgumentTuple
-    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Args>
+    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
+                                          , typename bind_arg::_Type<SIG>::Args>   
+    {
+    };
+  
+    
+  /** Variation of AcceptArgumentTuple, allowing to control the return type 
+   *  of the generated \c bind(...) functions independently from SIG
+   */
+  template<typename RET, typename SIG, class TAR, class BASE =bind_arg::Dummy>
+  class AcceptArgumentTupleRet
+    : public bind_arg::AcceptArgs<TAR,BASE, RET
+                                          , typename bind_arg::_Type<SIG>::Args>
     {
     };
   
   
   
-  
 } // namespace control
 #endif

From 3ebb8d02855f5db610eb9a99a3ee81402ced466e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 26 Jul 2009 02:00:47 +0200
Subject: [PATCH 220/368] WIP and more stubbing...

---
 src/proc/control/command-def.hpp              | 38 ++++++++++---------
 src/proc/control/command.cpp                  | 21 ++++++++++
 src/proc/control/command.hpp                  | 12 +++++-
 src/proc/control/handling-pattern.cpp         |  5 +++
 src/proc/control/handling-pattern.hpp         | 10 +++++
 .../proc/control/command-use1-test.cpp        |  3 +-
 .../proc/control/command-use2-test.cpp        |  6 +--
 7 files changed, 72 insertions(+), 23 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 159bdcdc7..c310a531f 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -53,6 +53,7 @@
 #include "proc/control/command-signature.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
+#include "proc/control/argument-tuple-accept.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelist-util.hpp"
@@ -74,7 +75,7 @@ namespace control {
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::FunctionTypedef;
   using lumiera::typelist::Types;
-//using lumiera::typelist::NullType;
+  using lumiera::typelist::NullType;
   using lumiera::typelist::Tuple;
   
   
@@ -84,11 +85,17 @@ namespace control {
     
     template<typename SIG, typename MEM>
     struct UndoDefinition
+      : AcceptArgumentTupleRet< Command&, SIG               // Return type and Argument Signature of the \c bind(..) function
+                              , UndoDefinition<SIG,MEM>    //  target type (this class) providing the implementation \c bindArg(Tuple<..>) 
+                              >
       {
         typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
         typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
         
-        UndoDefinition (function<UndoCaptureSig>& undoCapOperation)
+        Command& prototype_;
+        
+        UndoDefinition (Command& underConstruction, function<UndoCaptureSig>& undoCapOperation)
+          : prototype_(underConstruction)
           {
             cout << showSizeof(undoCapOperation) << endl;
             UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
@@ -106,22 +113,15 @@ namespace control {
             return *this;
           }
         
-        template
-          < typename T1
-          , typename T2
-          >
-        UndoDefinition&    ///////TODO return here the completed Command
-        bind ( T1& p1
-             , T2& p2
-             )
+        
+        Command&
+        bindArg (Tuple<BasicArgs> const& params)
           {
-            typedef Types<T1,T2> ArgTypes;
-            Tuple<ArgTypes> params(p1,p2);
             Closure<SIG> clo (params);
             
             cout << showSizeof(clo) << endl;
             UNIMPLEMENTED ("complete Command definition by closing all functions");
-            return *this;
+            return prototype_;
           }
         
       };
@@ -145,7 +145,10 @@ namespace control {
     template<typename SIG>
     struct BasicDefinition
       {
-        BasicDefinition(function<SIG>& operation)
+        Command& prototype_;
+        
+        BasicDefinition(Command& underConstruction, function<SIG>& operation)
+          : prototype_(underConstruction)
           {
             cout << showSizeof(operation) << endl;
             UNIMPLEMENTED ("create new command object and store the operation functor");
@@ -160,7 +163,7 @@ namespace control {
             typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
             
             function<UndoCapSig> opera2 (how_to_capture_UndoState);
-            return SpecificUndoDefinition (opera2);
+            return SpecificUndoDefinition (prototype_, opera2);
           }
       };
     
@@ -188,11 +191,12 @@ namespace control {
     : public lib::BoolCheckable<CommandDef>
     {
       Symbol id_;
-      
+      Command& prototype_;
       
     public:
       CommandDef (Symbol cmdID)
         : id_(cmdID)
+        , prototype_(Command::fetchDef(cmdID))
         { }
       
       template<typename SIG>
@@ -200,7 +204,7 @@ namespace control {
       operation (SIG& operation_to_define)
         {
           function<SIG> opera1 (operation_to_define);
-          return stage::BasicDefinition<SIG>(opera1);
+          return stage::BasicDefinition<SIG>(prototype_, opera1);
         }
       
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index e8a0fb469..25ee53c3f 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -61,6 +61,20 @@ namespace control {
   }
   
   
+  Command&
+  Command::fetchDef (Symbol cmdID)
+  {
+    UNIMPLEMENTED ("fetch an command prototype from the registry, create if necessary");
+  }
+  
+  
+  CommandDef
+  Command::storeDef (Symbol newCmdID)
+  {
+    UNIMPLEMENTED ("create a new definition & prototype based on this command");
+  }
+  
+  
   bool
   Command::remove (Symbol cmdID)
   {
@@ -139,6 +153,13 @@ namespace control {
   }
   
   
+  void
+  Command::execSync ()
+  {
+    exec (HandlingPattern::get(HandlingPattern::SYNC_THROW));
+  }
+  
+  
   HandlingPattern const&
   Command::getDefaultHandlingPattern()  const
   {
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 0a5b47828..ec0867fb8 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -58,6 +58,7 @@ namespace control {
 
   
   
+  class CommandDef;
   class HandlingPattern;
   
   
@@ -73,8 +74,9 @@ namespace control {
       /* === command registry === */
       static Command& get (Symbol cmdID);
       static bool  remove (Symbol cmdID); 
-      static bool   undef (Symbol cmdID); 
+      static bool   undef (Symbol cmdID);
       
+      CommandDef storeDef (Symbol newCmdID);
       
       
      ~Command();
@@ -89,6 +91,8 @@ namespace control {
        */
       void exec (HandlingPattern const& execPattern);
       
+      void execSync ();
+      
       HandlingPattern const& getDefaultHandlingPattern()  const;
       
       
@@ -104,6 +108,12 @@ namespace control {
       bool isValid()  const;
       bool canExec()  const;
       bool canUndo()  const;
+      
+    protected:
+     static Command& fetchDef (Symbol cmdID);
+     
+     friend class CommandDef;
+
     };
   ////////////////TODO currently just fleshing  out the API....
   
diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index 05b702c00..bb8987ad9 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -33,6 +33,11 @@
 namespace control {
   
   /** */
+  HandlingPattern const&
+  HandlingPattern::get (ID id)
+  {
+    UNIMPLEMENTED ("Factory for handling patterns");
+  }
   
   
   ///////////////////////////////////////////////////////////////////////TODO: is this implementation file actually required??
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index d325453dd..1210b5be7 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -35,6 +35,7 @@
 #define CONTROL_HANDLING_PATTERN_H
 
 //#include "pre.hpp"
+#include "lib/error.hpp"
 //#include "include/symbol.hpp"
 
 //#include <tr1/memory>
@@ -58,6 +59,15 @@ namespace control {
       
     public:
       
+      enum ID
+        { SYNC
+        , SYNC_THROW
+        , ASYNC
+        };
+      
+      static HandlingPattern const& get (ID id);
+      
+      
       virtual ~HandlingPattern() {}
       
       virtual void invoke (Command& command)  const  =0;
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index c6c3fdcc9..9dda3d68f 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -267,8 +267,7 @@ namespace test    {
           ASSERT (!unbelievable);
           
           // but because the miracle isn't yet defined, any use throws
-          VERIFY_ERROR (INVALID_COMMAND,   Command::get("miracle"));
-          VERIFY_ERROR (INVALID_COMMAND,   unbelievable.bind("abracadabra"));
+          VERIFY_ERROR (INVALID_COMMAND, Command::get("miracle"));
           
           ASSERT (Command::remove("test.command1.1"));
           ASSERT (Command::remove("test.command1.2"));
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
index 1069a06b0..e1fd8c3da 100644
--- a/tests/components/proc/control/command-use2-test.cpp
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -191,17 +191,17 @@ namespace test    {
           Command com = Command::get("test.command2");
           
           blowUp_ = false;
-          com.exec(HandlingPattern::THROW_SYNC);
+          com.exec(HandlingPattern::SYNC_THROW);
           ASSERT (protocolled(randVal_));
           
           blowUp_ = true;
           string current = command2::check_.str();
-          VERIFY_ERROR( EXTERNAL, com.exec(HandlingPattern::THROW_SYNC) );
+          VERIFY_ERROR( EXTERNAL, com.exec(HandlingPattern::get(SYNC_THROW)) );
           ASSERT (command2::check_.str() == current);
           
           // we can achieve the same effect,
           // after changing the default HandlingPatern for this command instance
-          com.setHandlingPattern(HandlingPattern::THROW_SYNC);
+          com.setHandlingPattern(HandlingPattern::SYNC_THROW);
           com.storeDef ("test.command2.1");
           
           Command com2 = Command::get("test.command2.1");

From 19dd606f5454d7402b3c9b0ddf6c8be64ed20e21 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 27 Jul 2009 02:38:53 +0200
Subject: [PATCH 221/368] WIP some implementation drafting...

---
 doc/devel/draw/CommandImpl-1.svg  | 1587 +++++++++++++++++++++++++++++
 src/proc/control/command-impl.cpp |   56 +
 src/proc/control/command-impl.hpp |   99 ++
 src/proc/control/command.cpp      |    2 +-
 src/proc/control/command.hpp      |    2 +
 5 files changed, 1745 insertions(+), 1 deletion(-)
 create mode 100644 doc/devel/draw/CommandImpl-1.svg
 create mode 100644 src/proc/control/command-impl.cpp
 create mode 100644 src/proc/control/command-impl.hpp

diff --git a/doc/devel/draw/CommandImpl-1.svg b/doc/devel/draw/CommandImpl-1.svg
new file mode 100644
index 000000000..1ebb5963c
--- /dev/null
+++ b/doc/devel/draw/CommandImpl-1.svg
@@ -0,0 +1,1587 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="800"
+   height="600"
+   id="svg2"
+   sodipodi:version="0.32"
+   inkscape:version="0.46"
+   sodipodi:docbase="/home/hiv/devel/lumi/doc/devel/draw"
+   sodipodi:docname="CommandImpl-1.svg"
+   inkscape:output_extension="org.inkscape.output.svg.inkscape"
+   version="1.0"
+   inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+   inkscape:export-xdpi="90"
+   inkscape:export-ydpi="90">
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.4142136"
+     inkscape:cx="601.93284"
+     inkscape:cy="351.50263"
+     inkscape:document-units="px"
+     inkscape:current-layer="svg2"
+     inkscape:window-width="1668"
+     inkscape:window-height="1016"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     width="800px"
+     height="600px"
+     showgrid="false"
+     gridanglex="30px"
+     gridanglez="30px"
+     grid_units="px"
+     inkscape:grid-points="true"
+     inkscape:grid-bbox="false"
+     showguides="true"
+     inkscape:object-paths="false"
+     inkscape:object-nodes="true"
+     gridtolerance="10000"
+     inkscape:guide-points="true"
+     guidetolerance="5">
+    <inkscape:grid
+       empspacing="5"
+       empopacity="0.4"
+       opacity="0.09019608"
+       empcolor="#0000ff"
+       color="#4b4bf4"
+       spacingy="2px"
+       spacingx="2px"
+       originy="0px"
+       originx="0px"
+       type="xygrid"
+       id="GridFromPre046Settings" />
+  </sodipodi:namedview>
+  <defs
+     id="globals">
+    <inkscape:perspective
+       id="perspective2539"
+       inkscape:persp3d-origin="400 : 200 : 1"
+       inkscape:vp_z="800 : 300 : 1"
+       inkscape:vp_y="0 : 1000 : 0"
+       inkscape:vp_x="0 : 300 : 1"
+       sodipodi:type="inkscape:persp3d" />
+    <marker
+       style="overflow:visible;"
+       id="Arrow2Mend"
+       refX="0.0"
+       refY="0.0"
+       orient="auto"
+       inkscape:stockid="Arrow2Mend">
+      <path
+         transform="scale(0.6) rotate(180) translate(0,0)"
+         d="M 8.7185878,4.0337352 L -2.2072895,0.016013256 L 8.7185884,-4.0017078 C 6.9730900,-1.6296469 6.9831476,1.6157441 8.7185878,4.0337352 z "
+         style="font-size:12.0;fill-rule:evenodd;stroke-width:0.62500000;stroke-linejoin:round;"
+         id="path3344" />
+    </marker>
+    <marker
+       style="overflow:visible;"
+       id="Arrow1Mend"
+       refX="0.0"
+       refY="0.0"
+       orient="auto"
+       inkscape:stockid="Arrow1Mend">
+      <path
+         transform="scale(0.4) rotate(180) translate(10,0)"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none;"
+         d="M 0.0,0.0 L 5.0,-5.0 L -12.5,0.0 L 5.0,5.0 L 0.0,0.0 z "
+         id="path3262" />
+    </marker>
+    <marker
+       style="overflow:visible"
+       id="TriangleInL"
+       refX="0.0"
+       refY="0.0"
+       orient="auto"
+       inkscape:stockid="TriangleInL">
+      <path
+         transform="scale(-0.8)"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1.0pt;marker-start:none"
+         d="M 5.77,0.0 L -2.88,5.0 L -2.88,-5.0 L 5.77,0.0 z "
+         id="path3342" />
+    </marker>
+    <marker
+       refX="0"
+       inkscape:stockid="ArrowHIV1end"
+       refY="0"
+       id="ArrowHIV1end"
+       orient="auto"
+       style="overflow:visible">
+      <path
+         id="pathPfeil1"
+         sodipodi:nodetypes="ccccccc"
+         d="M -8,0 L -10,1.2 L -2,1.2 L 5,0 L -2,-1.2 L -10,-1.2 L -8,0 z "
+         style="fill:#40c0ab;stroke:#01ffff;stroke-width:0.1;stroke-linecap:butt;stroke-miterlimit:6.5" />
+    </marker>
+  </defs>
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <cc:license
+           rdf:resource="http://creativecommons.org/licenses/by-sa/2.5/" />
+        <dc:title>AllocationCluster</dc:title>
+        <dc:creator>
+          <cc:Agent>
+            <dc:title>Ichthyostega</dc:title>
+          </cc:Agent>
+        </dc:creator>
+        <dc:description>design sketch: Structure of the AllocationCluster mem manager</dc:description>
+        <dc:date>2008</dc:date>
+      </cc:Work>
+      <cc:License
+         rdf:about="http://creativecommons.org/licenses/by-sa/2.5/">
+        <cc:permits
+           rdf:resource="http://web.resource.org/cc/Reproduction" />
+        <cc:permits
+           rdf:resource="http://web.resource.org/cc/Distribution" />
+        <cc:requires
+           rdf:resource="http://web.resource.org/cc/Notice" />
+        <cc:requires
+           rdf:resource="http://web.resource.org/cc/Attribution" />
+        <cc:permits
+           rdf:resource="http://web.resource.org/cc/DerivativeWorks" />
+        <cc:requires
+           rdf:resource="http://web.resource.org/cc/ShareAlike" />
+      </cc:License>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:groupmode="layer"
+     id="lay1"
+     inkscape:label="Drawing" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="318.5"
+     x="27"
+     height="190"
+     width="205.66087"
+     id="rect4196"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="451.5"
+     x="964.5"
+     height="30.243902"
+     width="110.59406"
+     id="rect4206"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect4208"
+     width="164.18504"
+     height="60.731766"
+     x="968.38855"
+     y="393" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text4216"
+     y="461.7439"
+     x="975.09406"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="461.7439"
+       x="975.09406"
+       id="tspan4218"
+       sodipodi:role="line">TickService</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text4224"
+     y="405.5"
+     x="1078.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#ff5555;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#ff5555;font-family:Bitstream Vera Sans"
+       y="405.5"
+       x="1078.5"
+       id="tspan4226"
+       sodipodi:role="line">doFrame()</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text4235"
+     y="332"
+     x="30.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       y="332"
+       x="30.5"
+       id="tspan2265"
+       sodipodi:role="line">CommandDef</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2226"
+     width="130.09683"
+     height="49.721359"
+     x="48"
+     y="59.5" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="58"
+     y="99.5"
+     id="text2236"
+     sodipodi:linespacing="100%"><tspan
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="99.5"
+       x="58"
+       id="tspan2263"
+       sodipodi:role="line">start( slot )</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="51.5"
+     y="73"
+     id="text2248"
+     sodipodi:linespacing="100%"><tspan
+       y="73"
+       x="51.5"
+       id="tspan2252"
+       sodipodi:role="line">Player (interface)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="37.875549"
+     y="362"
+     id="text2267"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan2269"
+       x="37.875549"
+       y="362"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">play()</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text3453"
+     y="403"
+     x="928.5"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="403"
+       x="928.5"
+       id="tspan3455"
+       sodipodi:role="line">yields</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;color:#000000;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="320"
+     y="90"
+     id="text3457"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan3459"
+       x="320"
+       y="90">GUI (Plugin)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text3461"
+     y="383"
+     x="908.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       y="383"
+       x="908.5"
+       id="tspan3463"
+       sodipodi:role="line">Proc (or Backend?)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text3471"
+     y="72.750885"
+     x="213.07803"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       id="tspan2303"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="72.750885"
+       x="213.07803"
+       sodipodi:role="line">Proxy&lt;Player&gt;</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="ccc"
+     id="path3481"
+     d="M 855,476 L 945,476 L 1005,456"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="834"
+     y="181.5"
+     id="text3485"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan3487"
+       x="834"
+       y="181.5"
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans">actually</tspan><tspan
+       id="tspan3489"
+       sodipodi:role="line"
+       x="834"
+       y="188.5"
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans">talks to...</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text3493"
+     y="246.5"
+     x="917"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       y="246.5"
+       x="917"
+       id="tspan3495"
+       sodipodi:role="line">libCommon</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="506"
+     x="854.901"
+     height="20"
+     width="70.181519"
+     id="rect2224"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2230"
+     y="516"
+     x="859.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       x="859.5"
+       y="516"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       id="tspan2232">PlayContext</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2234"
+     y="534"
+     x="894.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       id="tspan2236"
+       x="894.5"
+       y="534">PlayerService</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2239"
+     width="70.181519"
+     height="20"
+     x="854.81848"
+     y="486" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="859.5"
+     y="496"
+     id="text2245"
+     sodipodi:linespacing="100%"><tspan
+       id="tspan2247"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="496"
+       x="859.5"
+       sodipodi:role="line">PlayContext</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="cc"
+     style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     d="M 350,467 L 467.25,329.5"
+     id="path2257" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2227"
+     y="108.62411"
+     x="235.078"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       id="tspan2229"
+       x="235.078"
+       y="108.62411"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">start(...)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2231"
+     y="532"
+     x="913"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       id="tspan2233"
+       x="913"
+       y="532"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">start(...)</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="450"
+     x="279"
+     height="52.158669"
+     width="77.698021"
+     id="rect2235"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2237"
+     y="461.5"
+     x="283.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="461.5"
+       x="283.5"
+       id="tspan2239"
+       sodipodi:role="line">Command</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     id="path2241"
+     d="M 981,296.5 L 961,466.5"
+     style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     sodipodi:nodetypes="cc" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2244"
+     width="107.71078"
+     height="19.752098"
+     x="259"
+     y="390" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="263.5"
+     y="402"
+     id="text2246"
+     sodipodi:linespacing="100%"><tspan
+       id="tspan2541"
+       sodipodi:role="line"
+       x="263.5"
+       y="402"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">Handle&lt;CommandImpl&gt;</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInL);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     d="M 309,420 L 309,450"
+     id="path2250"
+     sodipodi:nodetypes="cc" />
+  <text
+     inkscape:transform-center-y="91"
+     inkscape:transform-center-x="43"
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="381.5"
+     y="137"
+     id="text2252"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan2254"
+       x="381.5"
+       y="137"
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans">yields</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     d="M 392,90 L 452,90 L 482,30"
+     id="path2256"
+     sodipodi:nodetypes="ccc" />
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="cc"
+     id="path2258"
+     d="M 188,89.5 L 208,89.5"
+     style="opacity:1;fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker:none;marker-start:url(#TriangleInL);marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="ccc"
+     id="path2260"
+     d="M 418.5,109.5 L 438.5,149.5 L 468.5,149.5"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2262"
+     y="118.5"
+     x="371"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="118.5"
+       x="371"
+       id="tspan2264"
+       sodipodi:role="line">has_a</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1.00000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2266"
+     width="99.876717"
+     height="49.91003"
+     x="689.078"
+     y="56" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="56"
+     x="529"
+     height="49.721359"
+     width="130.09683"
+     id="rect2268"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2274"
+     y="69.5"
+     x="532.5"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       id="tspan2276"
+       x="532.5"
+       y="69.5">Display (iface)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="694.078"
+     y="69.250885"
+     id="text2278"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan2280"
+       x="694.078"
+       y="69.250885"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">Proxy&lt;Display&gt;</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker:none;marker-start:url(#TriangleInL);marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     d="M 669,86 L 689,86"
+     id="path2286"
+     sodipodi:nodetypes="cc" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2288"
+     width="406.09683"
+     height="180.84619"
+     x="336.40317"
+     y="191.5" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2290"
+     width="70.181519"
+     height="20"
+     x="470.08246"
+     y="290" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="474.68152"
+     y="300"
+     id="text2292"
+     sodipodi:linespacing="100%"><tspan
+       id="tspan2294"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="300"
+       x="474.68152"
+       sodipodi:role="line">CommandImpl</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="346.90317"
+     y="207.56757"
+     id="text2296"
+     sodipodi:linespacing="100%"><tspan
+       y="207.56757"
+       x="346.90317"
+       id="tspan2298"
+       sodipodi:role="line">CommandRegistry</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="270"
+     x="470"
+     height="20"
+     width="70.181519"
+     id="rect2300"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="310"
+     x="470"
+     height="20"
+     width="70.181519"
+     id="rect2302"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2306"
+     y="280"
+     x="474.68152"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       x="474.68152"
+       y="280"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       id="tspan2308">CommandImpl</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="474.68152"
+     y="320"
+     id="text2310"
+     sodipodi:linespacing="100%"><tspan
+       id="tspan2312"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="320"
+       x="474.68152"
+       sodipodi:role="line">CommandImpl</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="353.40317"
+     y="244.5"
+     id="text2318"
+     sodipodi:linespacing="100%"><tspan
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="244.5"
+       x="353.40317"
+       id="tspan2320"
+       sodipodi:role="line">open(...)</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     d="M 934,311.5 L 934.1,211.52308 L 864,171.5 L 804,171.5"
+     id="path4332"
+     sodipodi:nodetypes="cccc" />
+  <g
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     transform="translate(723.80198,-98.256098)"
+     id="g4324">
+    <rect
+       y="320"
+       x="170"
+       height="9.7560978"
+       width="70.198021"
+       id="rect4326"
+       style="opacity:1;fill:#eff4fb;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+    <text
+       sodipodi:linespacing="100%"
+       id="text4328"
+       y="327.5"
+       x="180.5"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;stroke:#2d2abd;stroke-opacity:1;font-family:Bitstream Vera Sans"
+         y="327.5"
+         x="180.5"
+         id="tspan4330"
+         sodipodi:role="line">CL Interface</tspan></text>
+  </g>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text5310"
+     y="254.93243"
+     x="353.40317"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       id="tspan5312"
+       x="353.40317"
+       y="254.93243"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">close()</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="353.40317"
+     y="224.5"
+     id="text5314"
+     sodipodi:linespacing="100%"><tspan
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="224.5"
+       x="353.40317"
+       id="tspan5316"
+       sodipodi:role="line">getHandle(slot)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text5318"
+     y="86"
+     x="539"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       id="tspan5320"
+       x="539"
+       y="86"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">getHandle(slot)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="699"
+     y="86"
+     id="text5322"
+     sodipodi:linespacing="100%"><tspan
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="86"
+       x="699"
+       id="tspan5324"
+       sodipodi:role="line">getHandle(slot)</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="ccc"
+     id="path5326"
+     d="M 542,320 L 547.5,320 L 578,282"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text5328"
+     y="116"
+     x="759"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="116"
+       x="759"
+       id="tspan5330"
+       sodipodi:role="line">yields</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     d="M 934.5,411.5 L 984.5,411.5 L 994.5,441.5"
+     id="path2443"
+     sodipodi:nodetypes="ccc" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="964.5"
+     y="421.5"
+     id="text2445"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan2447"
+       x="964.5"
+       y="421.5"
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans">has_a</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="ccc"
+     id="path2449"
+     d="M 836.98633,260.87868 L 1086.9863,260.87868 L 1116.9863,210.87868"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2451"
+     y="397"
+     x="964.5"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="397"
+       x="964.5"
+       id="tspan2453"
+       sodipodi:role="line">invokes (periodically triggered)</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="ccc"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     d="M 974.5,471.5 L 944.5,471.5 C 889.5,470.5 884.5,411.5 884.5,411.5"
+     id="path2455" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2457"
+     y="465"
+     x="1113"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="465"
+       x="1113"
+       id="tspan2459"
+       sodipodi:role="line">periodically</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     id="path3436"
+     d="M 1025.5,393.50869 C 1025.5,393.50869 1021,403 1021,403 C 988.55312,492.14707 913,504.5 891,513"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     sodipodi:nodetypes="csc" />
+  <g
+     transform="translate(8.5,-197.5)"
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="g4319">
+    <rect
+       style="opacity:1;fill:#eff4fb;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect2322"
+       width="70.198021"
+       height="9.7560978"
+       x="170"
+       y="320" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="180.5"
+       y="327.5"
+       id="text2324"
+       sodipodi:linespacing="100%"><tspan
+         sodipodi:role="line"
+         id="tspan2326"
+         x="180.5"
+         y="327.5"
+         style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans">CL Interface</tspan></text>
+  </g>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text3438"
+     y="372.74805"
+     x="37.875549"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="372.74805"
+       x="37.875549"
+       id="tspan3440"
+       sodipodi:role="line">pause()</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="38.168518"
+     y="383.5"
+     id="text3442"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan3444"
+       x="38.168518"
+       y="383.5"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">stop()</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text3446"
+     y="348.5"
+     x="38.121643"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="348.5"
+       x="38.121643"
+       id="tspan3448"
+       sodipodi:role="line">use_display (slot)</tspan></text>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="70"
+     x="40"
+     height="460"
+     width="740"
+     id="rect_Canvas"
+     style="opacity:1;color:#000000;fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="978.5"
+     y="413"
+     id="text2307"
+     sodipodi:linespacing="100%"><tspan
+       y="413"
+       x="978.5"
+       id="tspan2309"
+       sodipodi:role="line">ProcessImpl</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     id="path2317"
+     d="M 584.7638,165.5 L 614.7638,165.5 C 657.76671,165.5 661,140.5 670,120"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     sodipodi:nodetypes="ccc" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2319"
+     y="110"
+     x="620"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;color:#000000;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="110"
+       x="620"
+       id="tspan2321"
+       sodipodi:role="line">dispatch to</tspan><tspan
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
+       y="117"
+       x="620"
+       sodipodi:role="line"
+       id="tspan2323">GTK main thread...</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2325"
+     y="482.24219"
+     x="309"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="482.24219"
+       x="309"
+       id="tspan2327"
+       sodipodi:role="line">exec(..)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="1028.5"
+     y="433"
+     id="text2329"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan2331"
+       x="1028.5"
+       y="433"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">play(..)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     xml:space="preserve"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="956.5"
+     y="503.5"
+     id="text2333"
+     sodipodi:linespacing="100%"><tspan
+       sodipodi:role="line"
+       id="tspan2335"
+       x="956.5"
+       y="503.5"
+       style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans">not yet implemented...</tspan></text>
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="cc"
+     id="path2337"
+     d="M 876.74621,564.02082 L 807.74621,552.02082"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:0.80000001;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#Arrow2Mend);marker-end:url(#Arrow1Mend);stroke-miterlimit:4;stroke-dasharray:1.6, 1.6;stroke-dashoffset:0;stroke-opacity:1" />
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="309"
+     y="492.5"
+     id="text2545"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       sodipodi:role="line"
+       id="tspan2547"
+       x="309"
+       y="492.5"
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">undo(..)</tspan></text>
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text2549"
+     y="472"
+     x="309"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="472"
+       x="309"
+       id="tspan2551"
+       sodipodi:role="line">bind(..)</tspan></text>
+  <rect
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2573"
+     width="50.037743"
+     height="79.987656"
+     x="380"
+     y="270"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="383.18149"
+     y="280"
+     id="text2575"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       id="tspan2577"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="280"
+       x="383.18149"
+       sodipodi:role="line">Index</tspan></text>
+  <g
+     transform="translate(-61,48.5)"
+     id="g2589">
+    <rect
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1.00000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect4200"
+       width="99.876717"
+       height="49.91003"
+       x="142.57802"
+       y="337.5"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2579"
+       y="346.56757"
+       x="145.9032"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="145.9032"
+         y="346.56757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2581">basic def</tspan></text>
+  </g>
+  <g
+     transform="translate(-41,18)"
+     id="g2594">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       y="386"
+       x="133.57802"
+       height="49.91003"
+       width="99.876717"
+       id="rect2596"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1.00000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="136.9032"
+       y="395.06757"
+       id="text2598"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2600"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="395.06757"
+         x="136.9032"
+         sodipodi:role="line">undo def</tspan></text>
+  </g>
+  <g
+     transform="translate(-8.2217102,-3.0675659)"
+     id="g2610">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect2604"
+       width="44.681519"
+       height="11.5"
+       x="389.72168"
+       y="294.06757" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2606"
+       y="302.06757"
+       x="391.4032"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="391.4032"
+         y="302.06757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2608">Command</tspan></text>
+  </g>
+  <g
+     transform="translate(-8.2217102,10.932434)"
+     id="g2615">
+    <rect
+       y="294.06757"
+       x="389.72168"
+       height="11.5"
+       width="44.681519"
+       id="rect2617"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="391.4032"
+       y="302.06757"
+       id="text2619"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2621"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="302.06757"
+         x="391.4032"
+         sodipodi:role="line">Command</tspan></text>
+  </g>
+  <g
+     transform="translate(-8.2217102,38.932434)"
+     id="g2631">
+    <rect
+       y="294.06757"
+       x="389.72168"
+       height="11.5"
+       width="44.681519"
+       id="rect2633"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="391.4032"
+       y="302.06757"
+       id="text2635"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2637"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="302.06757"
+         x="391.4032"
+         sodipodi:role="line">Command</tspan></text>
+  </g>
+  <path
+     id="path2639"
+     d="M 424,314.5 L 463.5,320.5"
+     style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     sodipodi:nodetypes="cc"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <g
+     id="g2665">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       y="270"
+       x="580"
+       height="20"
+       width="70.181519"
+       id="rect2647"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2653"
+       y="279.81757"
+       x="581.6532"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="581.6532"
+         y="279.81757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2655">ArgumentHolder</tspan></text>
+  </g>
+  <g
+     transform="translate(0,20)"
+     id="g2670">
+    <rect
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect2672"
+       width="70.181519"
+       height="20"
+       x="580"
+       y="270"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="581.6532"
+       y="279.81757"
+       id="text2674"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2676"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="279.81757"
+         x="581.6532"
+         sodipodi:role="line">ArgumentHolder</tspan></text>
+  </g>
+  <g
+     id="g2678"
+     transform="translate(0,40.182434)">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       y="270"
+       x="580"
+       height="20"
+       width="70.181519"
+       id="rect2680"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2682"
+       y="279.81757"
+       x="581.6532"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="581.6532"
+         y="279.81757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2684">ArgumentHolder</tspan></text>
+  </g>
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="556.5"
+     y="476.5"
+     id="text2692"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="476.5"
+       x="556.5"
+       id="tspan2694"
+       sodipodi:role="line">getHandle(slot)</tspan></text>
+  <g
+     id="g16601"
+     transform="translate(70.71069,-114.5513)">
+    <g
+       id="g16603"
+       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate">
+      <path
+         id="path16605"
+         d="M 399.28931,444.5513 L 469.47083,444.5513 L 669.28931,514.5513 L 469.85857,515.12056 L 399.28931,444.5513 z"
+         sodipodi:nodetypes="ccccc" />
+      <path
+         id="path16607"
+         d="M 469.47083,444.5513 L 469.47083,464.5513 L 669.28931,574.5513 L 669.28931,514.5513 L 469.47083,444.5513 z"
+         sodipodi:nodetypes="ccccc" />
+      <path
+         id="path16609"
+         d="M 469.47083,464.5513 L 399.28931,464.5513 L 469.28931,574.5513 L 669.28931,574.5513 L 469.47083,464.5513 z"
+         sodipodi:nodetypes="ccccc" />
+      <path
+         id="path16611"
+         d="M 399.28931,464.5513 L 399.28931,444.5513 L 469.85857,515.12056 L 469.28931,574.5513 L 399.28931,464.5513 z"
+         sodipodi:nodetypes="ccccc" />
+    </g>
+    <path
+       id="rect12791"
+       d="M 399.28931,444.5513 L 469.47083,444.5513 L 469.47083,464.5513 L 399.28931,464.5513 L 399.28931,444.5513 z"
+       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  </g>
+  <rect
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect16814"
+     width="70.181519"
+     height="20"
+     x="470"
+     y="330"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     sodipodi:linespacing="100%"
+     id="text16816"
+     y="340"
+     x="474.68152"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       sodipodi:role="line"
+       x="474.68152"
+       y="340"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       id="tspan16818">CommandImpl</tspan></text>
+  <rect
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2686"
+     width="199.98341"
+     height="60.001945"
+     x="540"
+     y="399.99997"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="545.75739"
+     y="414.3916"
+     id="text2688"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       y="414.3916"
+       x="545.75739"
+       id="tspan2690"
+       sodipodi:role="line">Command Impl</tspan></text>
+  <g
+     transform="translate(180.52917,-134.5513)"
+     id="g16820">
+    <g
+       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="g16822">
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 399.47083,444.5513 L 469.47083,444.5513 L 609.47083,464.5513 L 499.47083,464.5513 L 399.47083,444.5513 z"
+         id="path16824" />
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 469.47083,444.5513 L 469.47083,464.5513 L 609.47083,494.5513 L 609.47083,464.5513 L 469.47083,444.5513 z"
+         id="path16826" />
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 469.47083,464.5513 L 399.47083,464.5513 L 499.47083,494.5513 L 609.47083,494.5513 L 469.47083,464.5513 z"
+         id="path16828" />
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 399.47083,464.5513 L 399.47083,444.5513 L 499.97083,465.07898 L 499.47083,494.5513 L 399.47083,464.5513 z"
+         id="path16830" />
+    </g>
+    <path
+       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       d="M 399.47083,444.5513 L 469.47083,444.5513 L 469.47083,464.5513 L 399.47083,464.5513 L 399.47083,444.5513 z"
+       id="path16832"
+       sodipodi:nodetypes="ccccc" />
+  </g>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="330.349"
+     x="680"
+     height="29.556213"
+     width="110.03513"
+     id="rect16834"
+     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000024;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+</svg>
diff --git a/src/proc/control/command-impl.cpp b/src/proc/control/command-impl.cpp
new file mode 100644
index 000000000..39cb0b290
--- /dev/null
+++ b/src/proc/control/command-impl.cpp
@@ -0,0 +1,56 @@
+/*
+  CommandImpl  -  Proc-Layer command implementation (top level)
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+/** @file command-impl.cpp 
+ ** //TODO 
+ ** 
+ ** @see command.hpp
+ ** @see command-registry.hpp
+ **
+ */
+
+
+#include "proc/control/command-impl.hpp"
+//#include "proc/mobject/mobject-ref.hpp"
+//#include "proc/mobject/mobject.hpp"
+//#include "proc/mobject/placement.hpp"
+
+//#include <boost/format.hpp>
+//using boost::str;
+
+namespace control {
+  
+
+
+  /** */
+  CommandImpl::~CommandImpl() { }
+  
+
+  /** */
+  
+
+  
+  
+  
+  
+} // namespace control
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
new file mode 100644
index 000000000..97c3add88
--- /dev/null
+++ b/src/proc/control/command-impl.hpp
@@ -0,0 +1,99 @@
+/*
+  COMMAND-IMPL.hpp  -  Proc-Layer command implementation (top level)
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-impl.hpp
+ ** Top level of the command implementation. CommandImpl holds together
+ ** the various data and sub-objects involved into the inner workings of a
+ ** Proc-Layer command. It serves to implement a "command definition" (prototype)
+ ** as well as a concrete command instance. It is a data holder with a well defined
+ ** identity and usually located within the (pooled) storage managed by the
+ ** CommandRegistry. Client code gets access to a specific CommandImpl through
+ ** a Command instance, which is a small (refcounting smart-ptr) handle.
+ ** 
+ ** //TODO 
+ **
+ ** @see Command
+ ** @see ProcDispatcher
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_IMPL_H
+#define CONTROL_COMMAND_IMPL_H
+
+#include "proc/control/command.hpp"
+
+//#include <tr1/memory>
+
+
+
+namespace control {
+  
+
+  
+  
+  /**
+   * @todo Type-comment
+   */
+  class CommandImpl
+    {
+      
+    public:
+      /* === command registry === */
+      
+      
+     ~CommandImpl();
+      
+      
+      /** core operation: invoke the command
+       *  @param execPattern describes the individual steps
+       *         necessary to get this command invoked properly
+       */
+      void exec (HandlingPattern const& execPattern);
+      
+      
+      template<typename TYPES>
+      void bindArg (Tuple<TYPES> const&);
+      
+      
+      /* === diagnostics === */
+      
+      bool isValid()  const;
+      bool canExec()  const;
+      bool canUndo()  const;
+      
+    protected:
+//     static Command& fetchDef (Symbol cmdID);
+     
+//     friend class CommandDef;
+
+    };
+  ////////////////TODO currently just fleshing  out the API....
+  
+
+
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 25ee53c3f..bc9f1fba6 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -2,7 +2,7 @@
   Command  -  Key abstraction for proc/edit operations and UNDO management
  
   Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
  
   This program is free software; you can redistribute it and/or
   modify it under the terms of the GNU General Public License as
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index ec0867fb8..e07653b93 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -40,6 +40,7 @@
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
 #include "lib/bool-checkable.hpp"
+#include "lib/handle.hpp"
 
 //#include <tr1/memory>
 
@@ -68,6 +69,7 @@ namespace control {
   class Command
     : public com::ArgumentBinder<Command
            , lib::BoolCheckable<Command> >
+    ////////////////////////////////////////////////////////////////TODO: inherit from lib/handle
     {
       
     public:

From eaa4adddde79e8c1bccda6fafcf6595a4789f332 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 29 Jul 2009 16:55:15 +0200
Subject: [PATCH 222/368] WIP more implementation drafting...

---
 doc/devel/draw/CommandImpl-1.svg      | 777 +++++++++++++++++---------
 src/lib/handle.hpp                    |  12 +-
 src/proc/control/command-def.hpp      |   2 +-
 src/proc/control/command-impl.cpp     |  14 +
 src/proc/control/command-registry.hpp |  55 ++
 src/proc/control/command.cpp          |  18 +-
 src/proc/control/command.hpp          |  24 +-
 7 files changed, 631 insertions(+), 271 deletions(-)

diff --git a/doc/devel/draw/CommandImpl-1.svg b/doc/devel/draw/CommandImpl-1.svg
index 1ebb5963c..5e4bc6b1d 100644
--- a/doc/devel/draw/CommandImpl-1.svg
+++ b/doc/devel/draw/CommandImpl-1.svg
@@ -28,12 +28,12 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="1.4142136"
-     inkscape:cx="601.93284"
-     inkscape:cy="351.50263"
+     inkscape:cx="410.87417"
+     inkscape:cy="293.93224"
      inkscape:document-units="px"
      inkscape:current-layer="svg2"
      inkscape:window-width="1668"
-     inkscape:window-height="1016"
+     inkscape:window-height="1020"
      inkscape:window-x="0"
      inkscape:window-y="0"
      width="800px"
@@ -65,6 +65,22 @@
   </sodipodi:namedview>
   <defs
      id="globals">
+    <pattern
+       inkscape:stockid="Stripes 1:2"
+       id="Strips1_2"
+       patternTransform="matrix(0.8406114,0.5442428,-0.5442428,0.8406114,685.45306,294.40072)"
+       height="1"
+       width="3"
+       patternUnits="userSpaceOnUse"
+       inkscape:collect="always">
+      <rect
+         id="rect4287"
+         height="2"
+         width="1"
+         y="-0.5"
+         x="0"
+         style="fill:#bab3ee;stroke:none" />
+    </pattern>
     <inkscape:perspective
        id="perspective2539"
        inkscape:persp3d-origin="400 : 200 : 1"
@@ -169,10 +185,10 @@
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="318.5"
-     x="27"
-     height="190"
-     width="205.66087"
+     y="226.3103"
+     x="26.567444"
+     height="180.80762"
+     width="189.39742"
      id="rect4196"
      style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
   <rect
@@ -231,12 +247,12 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text4235"
-     y="332"
-     x="30.5"
+     y="239.48544"
+     x="30.464859"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
-       y="332"
-       x="30.5"
+       y="239.48544"
+       x="30.464859"
        id="tspan2265"
        sodipodi:role="line">CommandDef</tspan></text>
   <rect
@@ -247,21 +263,21 @@
      id="rect2226"
      width="130.09683"
      height="49.721359"
-     x="48"
-     y="59.5" />
+     x="677"
+     y="-79.5" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="58"
-     y="99.5"
+     x="687"
+     y="-39.499996"
      id="text2236"
      sodipodi:linespacing="100%"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="99.5"
-       x="58"
+       y="-39.499996"
+       x="687"
        id="tspan2263"
        sodipodi:role="line">start( slot )</tspan></text>
   <text
@@ -270,29 +286,14 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="51.5"
-     y="73"
+     x="680.5"
+     y="-66"
      id="text2248"
      sodipodi:linespacing="100%"><tspan
-       y="73"
-       x="51.5"
+       y="-66"
+       x="680.5"
        id="tspan2252"
        sodipodi:role="line">Player (interface)</tspan></text>
-  <text
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     xml:space="preserve"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="37.875549"
-     y="362"
-     id="text2267"
-     sodipodi:linespacing="100%"><tspan
-       sodipodi:role="line"
-       id="tspan2269"
-       x="37.875549"
-       y="362"
-       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">play()</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
@@ -313,43 +314,43 @@
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;color:#000000;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="320"
-     y="90"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="174.71809"
+     y="79.693436"
      id="text3457"
      sodipodi:linespacing="100%"><tspan
        sodipodi:role="line"
        id="tspan3459"
-       x="320"
-       y="90">GUI (Plugin)</tspan></text>
+       x="174.71809"
+       y="79.693436">GUI</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text3461"
-     y="383"
-     x="908.5"
+     y="206.22331"
+     x="244.52675"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
-       y="383"
-       x="908.5"
+       y="206.22331"
+       x="244.52675"
        id="tspan3463"
-       sodipodi:role="line">Proc (or Backend?)</tspan></text>
+       sodipodi:role="line">Proc-Layer</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text3471"
-     y="72.750885"
-     x="213.07803"
+     y="-66.249115"
+     x="842.078"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        id="tspan2303"
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="72.750885"
-       x="213.07803"
+       y="-66.249115"
+       x="842.078"
        sodipodi:role="line">Proxy&lt;Player&gt;</tspan></text>
   <path
      inkscape:export-ydpi="90"
@@ -463,7 +464,7 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="cc"
      style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 350,467 L 467.25,329.5"
+     d="M 349.96486,307.3103 L 467.21486,169.8103"
      id="path2257" />
   <text
      inkscape:export-ydpi="90"
@@ -471,14 +472,14 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2227"
-     y="108.62411"
-     x="235.078"
+     y="-30.375889"
+     x="864.078"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
        id="tspan2229"
-       x="235.078"
-       y="108.62411"
+       x="864.078"
+       y="-30.375889"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">start(...)</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -499,8 +500,8 @@
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="450"
-     x="279"
+     y="300.8103"
+     x="289.46484"
      height="52.158669"
      width="77.698021"
      id="rect2235"
@@ -511,13 +512,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2237"
-     y="461.5"
-     x="283.5"
+     y="312.3103"
+     x="293.96484"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="461.5"
-       x="283.5"
+       y="312.3103"
+       x="293.96484"
        id="tspan2239"
        sodipodi:role="line">Command</tspan></text>
   <path
@@ -536,29 +537,29 @@
      id="rect2244"
      width="107.71078"
      height="19.752098"
-     x="259"
-     y="390" />
+     x="269.46484"
+     y="240.8103" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="263.5"
-     y="402"
+     x="273.96484"
+     y="252.8103"
      id="text2246"
      sodipodi:linespacing="100%"><tspan
        id="tspan2541"
        sodipodi:role="line"
-       x="263.5"
-       y="402"
+       x="273.96484"
+       y="252.8103"
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">Handle&lt;CommandImpl&gt;</tspan></text>
   <path
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInL);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 309,420 L 309,450"
+     d="M 319.46486,270.8103 L 319.46486,300.8103"
      id="path2250"
      sodipodi:nodetypes="cc" />
   <text
@@ -569,21 +570,21 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="381.5"
-     y="137"
+     x="1010.5"
+     y="-1.9999967"
      id="text2252"
      sodipodi:linespacing="100%"><tspan
        sodipodi:role="line"
        id="tspan2254"
-       x="381.5"
-       y="137"
+       x="1010.5"
+       y="-1.9999967"
        style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans">yields</tspan></text>
   <path
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
-     d="M 392,90 L 452,90 L 482,30"
+     d="M 1021,-48.999997 L 1081,-48.999997 L 1111,-109"
      id="path2256"
      sodipodi:nodetypes="ccc" />
   <path
@@ -592,7 +593,7 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="cc"
      id="path2258"
-     d="M 188,89.5 L 208,89.5"
+     d="M 816.99998,-49.499997 L 836.99998,-49.499997"
      style="opacity:1;fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker:none;marker-start:url(#TriangleInL);marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
   <path
      inkscape:export-ydpi="90"
@@ -600,7 +601,7 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="ccc"
      id="path2260"
-     d="M 418.5,109.5 L 438.5,149.5 L 468.5,149.5"
+     d="M 1047.5,-29.499997 L 1067.5,10.500003 L 1097.5,10.500003"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
   <text
      inkscape:export-ydpi="90"
@@ -608,13 +609,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2262"
-     y="118.5"
-     x="371"
+     y="-20.499996"
+     x="1000"
      style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
-       y="118.5"
-       x="371"
+       y="-20.499996"
+       x="1000"
        id="tspan2264"
        sodipodi:role="line">has_a</tspan></text>
   <rect
@@ -625,14 +626,14 @@
      id="rect2266"
      width="99.876717"
      height="49.91003"
-     x="689.078"
-     y="56" />
+     x="992.078"
+     y="41" />
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="56"
-     x="529"
+     y="41"
+     x="832"
      height="49.721359"
      width="130.09683"
      id="rect2268"
@@ -643,35 +644,35 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2274"
-     y="69.5"
-     x="532.5"
+     y="54.5"
+     x="835.5"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
        id="tspan2276"
-       x="532.5"
-       y="69.5">Display (iface)</tspan></text>
+       x="835.5"
+       y="54.5">Display (iface)</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="694.078"
-     y="69.250885"
+     x="997.078"
+     y="54.250885"
      id="text2278"
      sodipodi:linespacing="100%"><tspan
        sodipodi:role="line"
        id="tspan2280"
-       x="694.078"
-       y="69.250885"
+       x="997.078"
+       y="54.250885"
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">Proxy&lt;Display&gt;</tspan></text>
   <path
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      style="opacity:1;fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker:none;marker-start:url(#TriangleInL);marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-     d="M 669,86 L 689,86"
+     d="M 971.99999,71 L 991.99999,71"
      id="path2286"
      sodipodi:nodetypes="cc" />
   <rect
@@ -682,8 +683,8 @@
      id="rect2288"
      width="406.09683"
      height="180.84619"
-     x="336.40317"
-     y="191.5" />
+     x="336.36804"
+     y="31.810305" />
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
@@ -692,22 +693,22 @@
      id="rect2290"
      width="70.181519"
      height="20"
-     x="470.08246"
-     y="290" />
+     x="470.0473"
+     y="130.3103" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="474.68152"
-     y="300"
+     x="474.64636"
+     y="140.3103"
      id="text2292"
      sodipodi:linespacing="100%"><tspan
        id="tspan2294"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="300"
-       x="474.68152"
+       y="140.3103"
+       x="474.64636"
        sodipodi:role="line">CommandImpl</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -715,20 +716,20 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="346.90317"
-     y="207.56757"
+     x="346.86804"
+     y="47.877869"
      id="text2296"
      sodipodi:linespacing="100%"><tspan
-       y="207.56757"
-       x="346.90317"
+       y="47.877869"
+       x="346.86804"
        id="tspan2298"
        sodipodi:role="line">CommandRegistry</tspan></text>
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="270"
-     x="470"
+     y="110.3103"
+     x="469.96484"
      height="20"
      width="70.181519"
      id="rect2300"
@@ -737,8 +738,8 @@
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="310"
-     x="470"
+     y="150.3103"
+     x="469.96484"
      height="20"
      width="70.181519"
      id="rect2302"
@@ -749,13 +750,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2306"
-     y="280"
-     x="474.68152"
+     y="120.3103"
+     x="474.64636"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
-       x="474.68152"
-       y="280"
+       x="474.64636"
+       y="120.3103"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
        id="tspan2308">CommandImpl</tspan></text>
   <text
@@ -764,14 +765,14 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="474.68152"
-     y="320"
+     x="474.64636"
+     y="160.3103"
      id="text2310"
      sodipodi:linespacing="100%"><tspan
        id="tspan2312"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="320"
-       x="474.68152"
+       y="160.3103"
+       x="474.64636"
        sodipodi:role="line">CommandImpl</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -779,21 +780,21 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="353.40317"
-     y="244.5"
+     x="353.36804"
+     y="84.810303"
      id="text2318"
      sodipodi:linespacing="100%"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="244.5"
-       x="353.40317"
+       y="84.810303"
+       x="353.36804"
        id="tspan2320"
-       sodipodi:role="line">open(...)</tspan></text>
+       sodipodi:role="line">xxx(...)</tspan></text>
   <path
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
-     d="M 934,311.5 L 934.1,211.52308 L 864,171.5 L 804,171.5"
+     d="M 964.40559,297.35786 L 964.50559,197.38094 L 894.40559,157.35786 L 834.40559,157.35786"
      id="path4332"
      sodipodi:nodetypes="cccc" />
   <g
@@ -828,44 +829,44 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text5310"
-     y="254.93243"
-     x="353.40317"
+     y="95.242737"
+     x="353.36804"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
        id="tspan5312"
-       x="353.40317"
-       y="254.93243"
-       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">close()</tspan></text>
+       x="353.36804"
+       y="95.242737"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">sss()</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="353.40317"
-     y="224.5"
+     x="353.36804"
+     y="64.81031"
      id="text5314"
      sodipodi:linespacing="100%"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="224.5"
-       x="353.40317"
-       id="tspan5316"
-       sodipodi:role="line">getHandle(slot)</tspan></text>
+       y="64.81031"
+       x="353.36804"
+       sodipodi:role="line"
+       id="tspan2741">Command::get(&quot;name&quot;)</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text5318"
-     y="86"
-     x="539"
+     y="71"
+     x="842"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
        id="tspan5320"
-       x="539"
-       y="86"
+       x="842"
+       y="71"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">getHandle(slot)</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -873,36 +874,28 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="699"
-     y="86"
+     x="1002"
+     y="71"
      id="text5322"
      sodipodi:linespacing="100%"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="86"
-       x="699"
+       y="71"
+       x="1002"
        id="tspan5324"
        sodipodi:role="line">getHandle(slot)</tspan></text>
-  <path
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     sodipodi:nodetypes="ccc"
-     id="path5326"
-     d="M 542,320 L 547.5,320 L 578,282"
-     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text5328"
-     y="116"
-     x="759"
+     y="101"
+     x="1062"
      style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
-       y="116"
-       x="759"
+       y="101"
+       x="1062"
        id="tspan5330"
        sodipodi:role="line">yields</tspan></text>
   <path
@@ -983,7 +976,7 @@
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
      sodipodi:nodetypes="csc" />
   <g
-     transform="translate(8.5,-197.5)"
+     transform="translate(29.464859,-167.1897)"
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1009,51 +1002,6 @@
          y="327.5"
          style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#2d2abd;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans">CL Interface</tspan></text>
   </g>
-  <text
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     sodipodi:linespacing="100%"
-     id="text3438"
-     y="372.74805"
-     x="37.875549"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     xml:space="preserve"><tspan
-       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="372.74805"
-       x="37.875549"
-       id="tspan3440"
-       sodipodi:role="line">pause()</tspan></text>
-  <text
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     xml:space="preserve"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="38.168518"
-     y="383.5"
-     id="text3442"
-     sodipodi:linespacing="100%"><tspan
-       sodipodi:role="line"
-       id="tspan3444"
-       x="38.168518"
-       y="383.5"
-       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">stop()</tspan></text>
-  <text
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     sodipodi:linespacing="100%"
-     id="text3446"
-     y="348.5"
-     x="38.121643"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     xml:space="preserve"><tspan
-       style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="348.5"
-       x="38.121643"
-       id="tspan3448"
-       sodipodi:role="line">use_display (slot)</tspan></text>
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
@@ -1083,7 +1031,7 @@
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      id="path2317"
-     d="M 584.7638,165.5 L 614.7638,165.5 C 657.76671,165.5 661,140.5 670,120"
+     d="M 887.76379,150.5 L 917.76379,150.5 C 960.7667,150.5 963.99999,125.5 972.99999,105"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
      sodipodi:nodetypes="ccc" />
   <text
@@ -1092,18 +1040,18 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2319"
-     y="110"
-     x="620"
-     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;color:#000000;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     y="95"
+     x="923"
+     style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:none;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
-       y="110"
-       x="620"
+       y="95"
+       x="923"
        id="tspan2321"
        sodipodi:role="line">dispatch to</tspan><tspan
        style="font-size:7px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;stroke-opacity:1;font-family:Bitstream Vera Sans"
-       y="117"
-       x="620"
+       y="102"
+       x="923"
        sodipodi:role="line"
        id="tspan2323">GTK main thread...</tspan></text>
   <text
@@ -1112,13 +1060,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2325"
-     y="482.24219"
-     x="309"
+     y="333.05249"
+     x="319.46484"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="482.24219"
-       x="309"
+       y="333.05249"
+       x="319.46484"
        id="tspan2327"
        sodipodi:role="line">exec(..)</tspan></text>
   <text
@@ -1157,13 +1105,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="cc"
      id="path2337"
-     d="M 876.74621,564.02082 L 807.74621,552.02082"
+     d="M 923.74621,566.02082 L 854.74621,554.02082"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:0.80000001;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#Arrow2Mend);marker-end:url(#Arrow1Mend);stroke-miterlimit:4;stroke-dasharray:1.6, 1.6;stroke-dashoffset:0;stroke-opacity:1" />
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="309"
-     y="492.5"
+     x="319.46484"
+     y="343.3103"
      id="text2545"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1171,8 +1119,8 @@
      inkscape:export-ydpi="90"><tspan
        sodipodi:role="line"
        id="tspan2547"
-       x="309"
-       y="492.5"
+       x="319.46484"
+       y="343.3103"
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">undo(..)</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -1180,13 +1128,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2549"
-     y="472"
-     x="309"
+     y="322.8103"
+     x="319.46484"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="472"
-       x="309"
+       y="322.8103"
+       x="319.46484"
        id="tspan2551"
        sodipodi:role="line">bind(..)</tspan></text>
   <rect
@@ -1194,16 +1142,16 @@
      id="rect2573"
      width="50.037743"
      height="79.987656"
-     x="380"
-     y="270"
+     x="379.96484"
+     y="110.3103"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="383.18149"
-     y="280"
+     x="383.14636"
+     y="120.3103"
      id="text2575"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1211,11 +1159,11 @@
      inkscape:export-ydpi="90"><tspan
        id="tspan2577"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="280"
-       x="383.18149"
+       y="120.3103"
+       x="383.14636"
        sodipodi:role="line">Index</tspan></text>
   <g
-     transform="translate(-61,48.5)"
+     transform="translate(-54.67118,-41.893236)"
      id="g2589">
     <rect
        style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1.00000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
@@ -1244,7 +1192,7 @@
          id="tspan2581">basic def</tspan></text>
   </g>
   <g
-     transform="translate(-41,18)"
+     transform="translate(-34.67118,-72.393233)"
      id="g2594">
     <rect
        inkscape:export-ydpi="90"
@@ -1273,7 +1221,7 @@
          sodipodi:role="line">undo def</tspan></text>
   </g>
   <g
-     transform="translate(-8.2217102,-3.0675659)"
+     transform="translate(-8.2568512,-162.75726)"
      id="g2610">
     <rect
        inkscape:export-ydpi="90"
@@ -1302,7 +1250,7 @@
          id="tspan2608">Command</tspan></text>
   </g>
   <g
-     transform="translate(-8.2217102,10.932434)"
+     transform="translate(-8.2568512,-148.75726)"
      id="g2615">
     <rect
        y="294.06757"
@@ -1331,7 +1279,7 @@
          sodipodi:role="line">Command</tspan></text>
   </g>
   <g
-     transform="translate(-8.2217102,38.932434)"
+     transform="translate(-8.2568512,-120.75726)"
      id="g2631">
     <rect
        y="294.06757"
@@ -1361,14 +1309,15 @@
   </g>
   <path
      id="path2639"
-     d="M 424,314.5 L 463.5,320.5"
+     d="M 423.96486,154.8103 L 463.46486,160.8103"
      style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
      sodipodi:nodetypes="cc"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <g
-     id="g2665">
+     id="g2665"
+     transform="translate(-3.5140952e-2,-159.6897)">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1396,7 +1345,7 @@
          id="tspan2655">ArgumentHolder</tspan></text>
   </g>
   <g
-     transform="translate(0,20)"
+     transform="translate(-3.5140952e-2,-139.6897)"
      id="g2670">
     <rect
        style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
@@ -1426,7 +1375,7 @@
   </g>
   <g
      id="g2678"
-     transform="translate(0,40.182434)">
+     transform="translate(-3.5140952e-2,-119.50726)">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1456,21 +1405,21 @@
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="556.5"
-     y="476.5"
+     x="850.65643"
+     y="335.78577"
      id="text2692"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="476.5"
-       x="556.5"
+       y="335.78577"
+       x="850.65643"
        id="tspan2694"
        sodipodi:role="line">getHandle(slot)</tspan></text>
   <g
      id="g16601"
-     transform="translate(70.71069,-114.5513)">
+     transform="translate(70.675549,-274.241)">
     <g
        id="g16603"
        style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate">
@@ -1501,24 +1450,24 @@
      id="rect16814"
      width="70.181519"
      height="20"
-     x="470"
-     y="330"
+     x="469.96484"
+     y="170.3103"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      sodipodi:linespacing="100%"
      id="text16816"
-     y="340"
-     x="474.68152"
+     y="180.3103"
+     x="474.64636"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
        sodipodi:role="line"
-       x="474.68152"
-       y="340"
+       x="474.64636"
+       y="180.3103"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
        id="tspan16818">CommandImpl</tspan></text>
   <rect
@@ -1526,27 +1475,27 @@
      id="rect2686"
      width="199.98341"
      height="60.001945"
-     x="540"
-     y="399.99997"
+     x="539.96484"
+     y="240.31027"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="545.75739"
-     y="414.3916"
+     x="545.72223"
+     y="254.7019"
      id="text2688"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
-       y="414.3916"
-       x="545.75739"
+       y="254.7019"
+       x="545.72223"
        id="tspan2690"
        sodipodi:role="line">Command Impl</tspan></text>
   <g
-     transform="translate(180.52917,-134.5513)"
+     transform="translate(180.49403,-294.241)"
      id="g16820">
     <g
        style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
@@ -1578,10 +1527,328 @@
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="330.349"
-     x="680"
+     y="170.6593"
+     x="679.96484"
      height="29.556213"
      width="110.03513"
      id="rect16834"
      style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000024;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="cc"
+     style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
+     d="M 535.96486,160.3103 L 575.96486,142.3103"
+     id="path2590" />
+  <flowRoot
+     xml:space="preserve"
+     id="flowRoot2592"
+     style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans"
+     transform="translate(-84.180846,-100.29273)"><flowRegion
+       id="flowRegion2594"><rect
+         id="rect2597"
+         width="126.57211"
+         height="76.367516"
+         x="120.91525"
+         y="347.5629"
+         style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans;-inkscape-font-specification:Bitstream Vera Sans" /></flowRegion><flowPara
+       id="flowPara2629">CommandDefinition (&quot;name1&quot;)</flowPara><flowPara
+       id="flowPara2631"> .operation (func1)</flowPara><flowPara
+       id="flowPara2633"> .captureUndo (func2)</flowPara><flowPara
+       id="flowPara2635"> .undoOperation (func3)</flowPara><flowPara
+       id="flowPara2637"> .bind (...)</flowPara><flowPara
+       id="flowPara2639" /><flowPara
+       id="flowPara2641" /><flowPara
+       id="flowPara2643" /><flowPara
+       id="flowPara2645" /></flowRoot>  <g
+     id="g2647"
+     transform="translate(158.62035,-32.368916)">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect2649"
+       width="72.258682"
+       height="11.5"
+       x="389.72168"
+       y="294.06757" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2651"
+       y="302.06757"
+       x="391.4032"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="391.4032"
+         y="302.06757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2653">mutation functor</tspan></text>
+    <rect
+       y="311.03812"
+       x="389.72168"
+       height="11.5"
+       width="72.258682"
+       id="rect2658"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="391.4032"
+       y="319.03812"
+       id="text2660"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2662"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="319.03812"
+         x="391.4032"
+         sodipodi:role="line">undo functor</tspan></text>
+  </g>
+  <rect
+     y="269.47681"
+     x="628.24512"
+     height="11.5"
+     width="34.074917"
+     id="rect2666"
+     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="629.92664"
+     y="277.47681"
+     id="text2668"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       id="tspan2670"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="277.47681"
+       x="629.92664"
+       sodipodi:role="line">closure</tspan></text>
+  <g
+     id="g2680"
+     transform="translate(316.6378,-119.75726)">
+    <rect
+       y="294.06757"
+       x="389.72168"
+       height="11.5"
+       width="17.605364"
+       id="rect2674"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="391.4032"
+       y="302.06757"
+       id="text2676"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2678"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="302.06757"
+         x="391.4032"
+         sodipodi:role="line">arg</tspan></text>
+  </g>
+  <g
+     transform="translate(337.10734,-119.75726)"
+     id="g2685">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect2687"
+       width="17.605364"
+       height="11.5"
+       x="389.72168"
+       y="294.06757" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2689"
+       y="302.06757"
+       x="391.4032"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="391.4032"
+         y="302.06757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2691">arg</tspan></text>
+  </g>
+  <g
+     id="g2693"
+     transform="translate(357.10734,-119.75726)">
+    <rect
+       y="294.06757"
+       x="389.72168"
+       height="11.5"
+       width="17.605364"
+       id="rect2695"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90" />
+    <text
+       xml:space="preserve"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       x="391.4032"
+       y="302.06757"
+       id="text2697"
+       sodipodi:linespacing="100%"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       inkscape:export-xdpi="90"
+       inkscape:export-ydpi="90"><tspan
+         id="tspan2699"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         y="302.06757"
+         x="391.4032"
+         sodipodi:role="line">arg</tspan></text>
+  </g>
+  <g
+     transform="translate(377.08311,-119.75726)"
+     id="g2701">
+    <rect
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="rect2703"
+       width="17.605364"
+       height="11.5"
+       x="389.72168"
+       y="294.06757" />
+    <text
+       inkscape:export-ydpi="90"
+       inkscape:export-xdpi="90"
+       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+       sodipodi:linespacing="100%"
+       id="text2705"
+       y="302.06757"
+       x="391.4032"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         x="391.4032"
+         y="302.06757"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         id="tspan2707">arg</tspan></text>
+  </g>
+  <rect
+     y="190.48422"
+     x="709.96484"
+     height="7.665247"
+     width="44.223175"
+     id="rect2711"
+     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="712.84399"
+     y="196.3103"
+     id="text2713"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       id="tspan2715"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       y="196.3103"
+       x="712.84399"
+       sodipodi:role="line">memento</tspan></text>
+  <path
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
+     d="M 624.69635,289.35729 L 678.27961,289.35729 L 728.68457,221.69775 C 746.28171,201.94355 685.65518,207.38 697.77225,201.06082 L 709.84027,194.08163"
+     id="path2739"
+     sodipodi:nodetypes="ccccz"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <path
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:nodetypes="ccccc"
+     id="path5326"
+     d="M 666.41565,276.27581 L 671.91565,276.27581 L 712.42112,225.23328 C 730.01826,205.12552 674.34148,211.62265 683.27656,203.18215 L 702.41565,183.82859"
+     style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
+  <rect
+     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2745"
+     width="130.09683"
+     height="60.31007"
+     x="609.90314"
+     y="350"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     xml:space="preserve"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="613.40314"
+     y="402"
+     id="text2747"
+     sodipodi:linespacing="100%"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90"><tspan
+       y="402"
+       x="613.40314"
+       id="tspan2749"
+       sodipodi:role="line">ProcDispatcher</tspan></text>
+  <rect
+     style="opacity:0.5;fill:url(#Strips1_2);fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994000000003;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2759"
+     width="47.311901"
+     height="90.143509"
+     x="688.38611"
+     y="289.97452"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text5120"
+     y="313.53925"
+     x="693.56622"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       x="693.56622"
+       y="313.53925"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       id="tspan5122">Handling</tspan><tspan
+       sodipodi:role="line"
+       x="693.56622"
+       y="321.53925"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       id="tspan5129">Pattern</tspan></text>
 </svg>
diff --git a/src/lib/handle.hpp b/src/lib/handle.hpp
index 54bff4c89..948130ac8 100644
--- a/src/lib/handle.hpp
+++ b/src/lib/handle.hpp
@@ -44,7 +44,7 @@
 #define LIB_HANDLE_H
 
 #include "lib/nobug-init.hpp"
-#include "lib/sync.hpp"
+#include "lib/bool-checkable.hpp"
 
 #include <tr1/memory>
 
@@ -61,13 +61,14 @@ namespace lib {
    * and managing its lifecycle. Usually such a handle is created by
    * an service interface and \link #activate activated \endlink by
    * setting up the link to some internal implementation object.
-   * This setup can only be done by a friend or derived class,
+   * This setup can only be done by a friend or derived class,       //////////////////////////TODO: that was the intention. Why didn't this work out as expected?
    * while client code is free to copy and store handle objects.
    * Finally, any handle can be closed, thereby decrementing
    * the use count.
    */
   template<class IMP>
   class Handle 
+    : public lib::BoolCheckable<Handle<IMP> >
     {
     protected:
       typedef std::tr1::shared_ptr<IMP> SmPtr;
@@ -115,11 +116,8 @@ namespace lib {
       void close ()  { smPtr_.reset(); }
       
       
-      typedef SmPtr Handle::*__unspecified_bool_type;
-      
-      /** implicit conversion to "bool" */ 
-      operator __unspecified_bool_type()  const { return  smPtr_? &Handle::smPtr_ : 0; }  // never throws
-      bool operator! ()                   const { return !bool(smPtr_); }                //  ditto
+      /** implicit conversion to bool (BoolCheckable) */
+      bool isValid()  const { return bool(smPtr_);}
       
       
       
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index c310a531f..43603bfe1 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -191,7 +191,7 @@ namespace control {
     : public lib::BoolCheckable<CommandDef>
     {
       Symbol id_;
-      Command& prototype_;
+      Command prototype_;
       
     public:
       CommandDef (Symbol cmdID)
diff --git a/src/proc/control/command-impl.cpp b/src/proc/control/command-impl.cpp
index 39cb0b290..a2aed63c3 100644
--- a/src/proc/control/command-impl.cpp
+++ b/src/proc/control/command-impl.cpp
@@ -47,6 +47,20 @@ namespace control {
   
 
   /** */
+  template<typename TYPES>
+  void
+  CommandImpl::bindArg (Tuple<TYPES> const&)
+  {
+    UNIMPLEMENTED ("actually bind arguments, maybe create ArgumentHolder");
+  }
+  
+  
+  void
+  CommandImpl::exec (HandlingPattern const& execPattern)
+  {
+    UNIMPLEMENTED ("actually invoke the command");
+  }
+
   
 
   
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 1b398c0f2..5cadf66fe 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -39,6 +39,8 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
+#include "lib/singleton.hpp"
+#include "lib/sync.hpp"
 //#include "lib/bool-checkable.hpp"
 //#include "proc/control/command-closure.hpp"
 //#include "proc/control/memento-tie.hpp"
@@ -60,14 +62,67 @@ namespace control {
    * TODO type comment
    */
   class CommandRegistry
+    : lib::Sync<>
     {
       
     public:
+      static lumiera::Singleton<CommandRegistry> instance;
+      
+      
+      /** register a command (Frontend) under the given ID
+       *  @return either the new command, or an already existing
+       *          command registerd under the given ID*/ 
+      static Command&
+      track (Symbol cmdID, Command& commandHandle)
+        {
+          return instance().putIndex (cmdID, commandHandle);
+        }
+      
+      
+      /** set up a new command implementation frame */
+      static CommandImpl*
+      newCommandImpl ()
+        {
+          return instance().createImpl();
+        }
+      
+      
+      /** discard an command implementation frame */
+      static void
+      killCommandImpl (CommandImpl* entry)
+        {
+                                  ///////////////////////////////////////////////TODO: clean behaviour while in App shutdown (Ticket #196)
+          instance().removeImpl(entry);
+        }
+      
+      
+    private:
+      CommandImpl*
+      createImpl ()
+        {
+          Lock sync(this);
+          UNIMPLEMENTED ("set up a new impl instance located within the instance table");
+        }
+      
+      void
+      removeImpl (CommandImpl* entry)
+        {
+          UNIMPLEMENTED ("remove entry from instance table");
+        }
+      
+      Command&
+      putIndex (Symbol cmdID, Command& commandHandle)
+        {
+          Lock sync(this);
+          UNIMPLEMENTED ("place a commandHandle into the command index, or return the command already registered there");
+        }
     };
   
   
 //  inline ostream& operator<< (ostream& os, Mutation const& muta) { return os << string(muta); }
   
+  /** storage for the singleton factory used to access CommandRegistry */
+  lumiera::Singleton<CommandRegistry> CommandRegistry::instance;
   
   
 } // namespace control
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index bc9f1fba6..4a2ead3f7 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -48,10 +48,17 @@ namespace control {
   LUMIERA_ERROR_DEFINE (UNBOUND_ARGUMENTS, "Command mutation functor not yet usable, because arguments aren't bound");
   LUMIERA_ERROR_DEFINE (MISSING_MEMENTO,   "Undo functor not yet usable, because no undo state has been captured");
   
-
+  
 
   Command::~Command() { }
   
+  
+  /** @internal to be invoked by #fetchDef */
+  Command::Command (CommandImpl* pImpl)
+  {
+    Handle::activate (pImpl, CommandRegistry::killCommandImpl);
+  }
+  
 
   /** */
   Command& 
@@ -64,7 +71,14 @@ namespace control {
   Command&
   Command::fetchDef (Symbol cmdID)
   {
-    UNIMPLEMENTED ("fetch an command prototype from the registry, create if necessary");
+    Command* cmd = CommandRegistry::queryIndex (cmdID);
+    if (cmd)
+      ////////////////////////////////////////////////////////////////////////TODO: race
+      return *cmd;
+    
+    Command newDefinition (CommandRegistry::newCommandImpl());
+    
+    return CommandRegistry::track (cmdID, newDefinition);
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index e07653b93..5be5474c8 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -67,9 +67,10 @@ namespace control {
    * @todo Type-comment
    */
   class Command
-    : public com::ArgumentBinder<Command
-           , lib::BoolCheckable<Command> >
-    ////////////////////////////////////////////////////////////////TODO: inherit from lib/handle
+    : public com::ArgumentBinder<Command    // accepts arbitrary bind(..) calls (with runtime check)
+           , lib::BoolCheckable<Command    //  implicit conversion to bool for status check
+           , lib::Handle<CommandImpl>     //   actually implemented as ref counting Handle
+           > >
     {
       
     public:
@@ -112,10 +113,21 @@ namespace control {
       bool canUndo()  const;
       
     protected:
-     static Command& fetchDef (Symbol cmdID);
+      static Command& fetchDef (Symbol cmdID);
+      
+      friend class CommandDef;
+      
+      
+    private:
+    /** Commands can only be created through the framework
+     *  (by setting up an CommandDef), thus ensuring there's
+     *  always a corresponding CommandImpl within the registry.
+     *  @note the copy operations are public though
+     *  @see Command#fetchDef
+     *  @see CommandDef 
+     */
+    Command (CommandImpl* pImpl);
      
-     friend class CommandDef;
-
     };
   ////////////////TODO currently just fleshing  out the API....
   

From 655177921fc6c49288c229c9c9b1edd8b67d7112 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 30 Jul 2009 03:57:19 +0200
Subject: [PATCH 223/368] WIP this might solve the race condition

---
 src/proc/control/command-registry.hpp | 34 ++++++++++++++++++++++-----
 src/proc/control/command.cpp          |  9 ++++---
 src/proc/control/command.hpp          |  2 +-
 3 files changed, 33 insertions(+), 12 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 5cadf66fe..819abcaf4 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -42,7 +42,8 @@
 #include "lib/singleton.hpp"
 #include "lib/sync.hpp"
 //#include "lib/bool-checkable.hpp"
-//#include "proc/control/command-closure.hpp"
+
+#include "proc/control/command.hpp"
 //#include "proc/control/memento-tie.hpp"
 
 //#include <iostream>
@@ -71,14 +72,24 @@ namespace control {
       
       /** register a command (Frontend) under the given ID
        *  @return either the new command, or an already existing
-       *          command registerd under the given ID*/ 
-      static Command&
-      track (Symbol cmdID, Command& commandHandle)
+       *          command registered under the given ID*/ 
+      static Command
+      track (Symbol cmdID, Command const& commandHandle)
         {
           return instance().putIndex (cmdID, commandHandle);
         }
       
       
+      /** query the command index by ID
+       *  @return the registered command,
+       *          or an "invalid" token */
+      static Command
+      queryIndex (Symbol cmdID)
+        {
+          return instance().fetchIndex (cmdID);
+        }
+      
+      
       /** set up a new command implementation frame */
       static CommandImpl*
       newCommandImpl ()
@@ -110,12 +121,23 @@ namespace control {
           UNIMPLEMENTED ("remove entry from instance table");
         }
       
-      Command&
-      putIndex (Symbol cmdID, Command& commandHandle)
+      Command
+      putIndex (Symbol cmdID, Command const& commandHandle)
         {
           Lock sync(this);
           UNIMPLEMENTED ("place a commandHandle into the command index, or return the command already registered there");
         }
+      
+      Command
+      fetchIndex (Symbol cmdID)
+        {
+          Lock sync(this);
+          UNIMPLEMENTED ("retrieve the command registered under the given ID, maybe return a »empty« command");
+          // if index.contains(cmdID)
+          //   return index[cmdID]
+          // else
+          return Command();
+        }
     };
   
   
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 4a2ead3f7..abc880e2c 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -68,18 +68,17 @@ namespace control {
   }
   
   
-  Command&
+  Command
   Command::fetchDef (Symbol cmdID)
   {
-    Command* cmd = CommandRegistry::queryIndex (cmdID);
+    Command cmd = CommandRegistry::queryIndex (cmdID);
     if (cmd)
-      ////////////////////////////////////////////////////////////////////////TODO: race
-      return *cmd;
+      return cmd;
     
     Command newDefinition (CommandRegistry::newCommandImpl());
     
     return CommandRegistry::track (cmdID, newDefinition);
-  }
+  }                      // return new or currently registered cmd...
   
   
   CommandDef
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 5be5474c8..c5aafa66e 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -81,7 +81,7 @@ namespace control {
       
       CommandDef storeDef (Symbol newCmdID);
       
-      
+      Command() { } ///< undefined command
      ~Command();
       
       void operator() () ;

From c9e143995e305ed135f27c6d6bfb30729b766eb2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 30 Jul 2009 20:50:57 +0200
Subject: [PATCH 224/368] WIP phase out the superfluous static access functions

---
 src/proc/control/command-registry.hpp | 37 ++++++++++-----------------
 src/proc/control/command.cpp          | 22 +++++++++++-----
 2 files changed, 29 insertions(+), 30 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 819abcaf4..1112961a0 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -73,20 +73,26 @@ namespace control {
       /** register a command (Frontend) under the given ID
        *  @return either the new command, or an already existing
        *          command registered under the given ID*/ 
-      static Command
+      Command
       track (Symbol cmdID, Command const& commandHandle)
         {
-          return instance().putIndex (cmdID, commandHandle);
+          Lock sync(this);
+          UNIMPLEMENTED ("place a commandHandle into the command index, or return the command already registered there");
         }
       
       
       /** query the command index by ID
        *  @return the registered command,
        *          or an "invalid" token */
-      static Command
+      Command
       queryIndex (Symbol cmdID)
         {
-          return instance().fetchIndex (cmdID);
+          Lock sync(this);
+          UNIMPLEMENTED ("retrieve the command registered under the given ID, maybe return a »empty« command");
+          // if index.contains(cmdID)
+          //   return index[cmdID]
+          // else
+          return Command();
         }
       
       
@@ -94,7 +100,8 @@ namespace control {
       static CommandImpl*
       newCommandImpl ()
         {
-          return instance().createImpl();
+          Lock sync(this);
+          UNIMPLEMENTED ("set up a new impl instance located within the instance table");
         }
       
       
@@ -111,8 +118,7 @@ namespace control {
       CommandImpl*
       createImpl ()
         {
-          Lock sync(this);
-          UNIMPLEMENTED ("set up a new impl instance located within the instance table");
+          ///////////////////////////////TODO: still necessary?
         }
       
       void
@@ -121,23 +127,6 @@ namespace control {
           UNIMPLEMENTED ("remove entry from instance table");
         }
       
-      Command
-      putIndex (Symbol cmdID, Command const& commandHandle)
-        {
-          Lock sync(this);
-          UNIMPLEMENTED ("place a commandHandle into the command index, or return the command already registered there");
-        }
-      
-      Command
-      fetchIndex (Symbol cmdID)
-        {
-          Lock sync(this);
-          UNIMPLEMENTED ("retrieve the command registered under the given ID, maybe return a »empty« command");
-          // if index.contains(cmdID)
-          //   return index[cmdID]
-          // else
-          return Command();
-        }
     };
   
   
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index abc880e2c..1cd653b78 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -30,6 +30,7 @@
  */
 
 
+#include "lib/error.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
 #include "proc/control/command-registry.hpp"
@@ -39,8 +40,12 @@
 //#include "proc/mobject/placement.hpp"
 
 //#include <boost/format.hpp>
+#include <string>
+
+using std::string;
 //using boost::str;
 
+
 namespace control {
   
   LUMIERA_ERROR_DEFINE (INVALID_COMMAND,   "Unknown or insufficiently defined command");
@@ -61,24 +66,29 @@ namespace control {
   
 
   /** */
-  Command& 
+  Command 
   Command::get (Symbol cmdID)
   {
-    UNIMPLEMENTED ("fetch an existing command from the internal cmd registry");
+    Command cmd = CommandRegistry::instance().queryIndex (cmdID);
+    if (!cmd)
+      throw lumiera::error::Invalid("Command definition not found", LUMIERA_ERROR_INVALID_COMMAND);
+      
+    return cmd;
   }
   
   
   Command
   Command::fetchDef (Symbol cmdID)
   {
-    Command cmd = CommandRegistry::queryIndex (cmdID);
+    CommandRegistry& registry = CommandRegistry::instance();
+    Command cmd = registry.queryIndex (cmdID);
     if (cmd)
       return cmd;
     
-    Command newDefinition (CommandRegistry::newCommandImpl());
+    Command newDefinition (registry.newCommandImpl());
     
-    return CommandRegistry::track (cmdID, newDefinition);
-  }                      // return new or currently registered cmd...
+    return registry.track (cmdID, newDefinition);
+  }              // return new or currently registered cmd...
   
   
   CommandDef

From c2d9a02303ed2cc16c770f661c1c34a0b50fe8c6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 1 Aug 2009 02:18:01 +0200
Subject: [PATCH 225/368] WIP some more nailing down of implementation details

---
 src/proc/control/command-impl.hpp     | 40 +++++++++++++++++++++++++--
 src/proc/control/command-registry.hpp | 16 ++++++++++-
 src/proc/control/command.cpp          | 29 +++++++++++++++----
 src/proc/control/command.hpp          | 19 +++++++++++++
 4 files changed, 94 insertions(+), 10 deletions(-)

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 97c3add88..720fc0d29 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -43,6 +43,11 @@
 #define CONTROL_COMMAND_IMPL_H
 
 #include "proc/control/command.hpp"
+#include "proc/control/command-mutation.hpp"
+#include "lib/bool-checkable.hpp"
+
+#include <boost/noncopyable.hpp>
+#include <boost/operators.hpp>
 
 //#include <tr1/memory>
 
@@ -57,7 +62,13 @@ namespace control {
    * @todo Type-comment
    */
   class CommandImpl
+    : public lib::BoolCheckable<CommandImpl
+           , boost::equality_comparable<CommandImpl
+           , boost::noncopyable
+           > >
     {
+      Mutation do_;
+      UndoMutation undo_;
       
     public:
       /* === command registry === */
@@ -79,9 +90,32 @@ namespace control {
       
       /* === diagnostics === */
       
-      bool isValid()  const;
-      bool canExec()  const;
-      bool canUndo()  const;
+      bool
+      isValid()  const
+        {
+          UNIMPLEMENTED ("command validity self check");
+        }
+      
+      bool
+      canExec()  const
+        {
+          UNIMPLEMENTED ("state check: sufficiently defined to be invoked");
+        }
+      
+      bool
+      canUndo()  const
+        {
+          UNIMPLEMENTED ("state check: has undo state been captured?");
+        }
+      
+      
+      /** @note strict instance equality */
+      bool
+      operator== (CommandImpl const& oi)
+        {
+          return (this == &oi); 
+        }
+      
       
     protected:
 //     static Command& fetchDef (Symbol cmdID);
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 1112961a0..533250f54 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -88,7 +88,7 @@ namespace control {
       queryIndex (Symbol cmdID)
         {
           Lock sync(this);
-          UNIMPLEMENTED ("retrieve the command registered under the given ID, maybe return a »empty« command");
+          UNIMPLEMENTED ("retrieve the command registered under the given ID, maybe return an »empty« command");
           // if index.contains(cmdID)
           //   return index[cmdID]
           // else
@@ -96,6 +96,20 @@ namespace control {
         }
       
       
+      size_t
+      index_size()
+      {
+        UNIMPLEMENTED ("number of defs in the index");
+      }
+      
+      
+      size_t
+      instance_count()
+      {
+        UNIMPLEMENTED ("number of active command impl instances");
+      }
+      
+      
       /** set up a new command implementation frame */
       static CommandImpl*
       newCommandImpl ()
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 1cd653b78..89e190642 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -113,26 +113,40 @@ namespace control {
   
   
   
+  /** @return the number of command \em definitions currently registered */
   size_t
   Command::definition_count()
   {
-    UNIMPLEMENTED ("return number of command definitions currently in the registry");
+    return CommandRegistry::instance().index_size();
   }
   
   
   
+  /** @return number distinguishable registered command \em instances */
   size_t
   Command::instance_count()
   {
-    UNIMPLEMENTED ("return number individual command instances currently in the registry");
+    return CommandRegistry::instance().instance_count();
   }
   
   
   
+  /** is this a valid command definition frame? especially
+   *  - the prototype command is initialised properly
+   *  - there is a command definition registered for our command ID
+   *  - and the registered command uses the same underlying command impl
+   *    record than our prototype
+   */
   bool
   CommandDef::isValid()  const
   {
-    UNIMPLEMENTED ("command *definition* validity self check");
+    if (prototype_)
+      {
+        Command cmd = CommandRegistry::instance().queryIndex (this->id_);
+        return cmd.isValid()
+            && (prototype_ == cmd);
+      }
+    return false;
   }
   
   
@@ -140,7 +154,8 @@ namespace control {
   bool
   Command::isValid()  const
   {
-    UNIMPLEMENTED ("command validity self check");
+    return _Handle::isValid()
+        && impl().isValid();
   }
   
   
@@ -148,7 +163,8 @@ namespace control {
   bool
   Command::canExec()  const
   {
-    UNIMPLEMENTED ("state check: sufficiently defined to be invoked");
+    return isValid()
+        && impl().canExec();
   }
   
   
@@ -156,7 +172,8 @@ namespace control {
   bool
   Command::canUndo()  const
   {
-    UNIMPLEMENTED ("state check: has undo state been captured?");
+    return isValid()
+        && impl().canUndo();
   }
 
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index c5aafa66e..f39c3af63 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -72,6 +72,7 @@ namespace control {
            , lib::Handle<CommandImpl>     //   actually implemented as ref counting Handle
            > >
     {
+      typedef lib::Handle<CommandImpl> _Handle;
       
     public:
       /* === command registry === */
@@ -112,6 +113,9 @@ namespace control {
       bool canExec()  const;
       bool canUndo()  const;
       
+      friend bool operator== (Command const&, Command const&);
+      
+      
     protected:
       static Command& fetchDef (Symbol cmdID);
       
@@ -137,6 +141,21 @@ namespace control {
   {
     exec (getDefaultHandlingPattern());
   }
+  
+  
+  bool
+  operator== (Command const& c1, Command const& c2)
+    {
+      return (!c1 && !c2)
+          || ( c1 &&  c2  && c1.impl() == c2.impl()); 
+    }
+  
+  bool
+  operator!= (Command const& c1, Command const& c2)
+    {
+      return ! (c1 == c2); 
+    }
+  
 
   
   

From 8971d667cf297fe815e565d3cb48bf9f038ff2f2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 1 Aug 2009 17:14:27 +0200
Subject: [PATCH 226/368] WIP more implementation...

---
 src/include/logging.h                         |  8 ++-
 src/lib/handle.hpp                            |  1 +
 src/proc/control/command-def.hpp              | 53 +++++++++-----
 src/proc/control/command-registry.hpp         | 23 ++++--
 src/proc/control/command.cpp                  | 71 ++++++++++++++++---
 src/proc/control/command.hpp                  | 25 +++----
 .../proc/control/command-use1-test.cpp        | 29 +++++++-
 7 files changed, 161 insertions(+), 49 deletions(-)

diff --git a/src/include/logging.h b/src/include/logging.h
index 4d674bc03..1871da2fa 100644
--- a/src/include/logging.h
+++ b/src/include/logging.h
@@ -120,8 +120,8 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (    mmap,                      backend);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (    thread,                    backend);       //starting/stopping threads
 /** progress log for the proc layer */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   proc,                       progress);
-/** progress log for the render subsystem of proc */
-NOBUG_CPP_DEFINE_FLAG_PARENT    (    render,                    proc);          //ichthyo: did you want this as global channel or as progress child?
+/** progress log for proc-layer command dispatch */
+NOBUG_CPP_DEFINE_FLAG_PARENT    (    command,                   proc);
 /** progress log for the gui */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   gui,                        progress);
 /** progress log for the support lib */
@@ -130,7 +130,7 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (    resourcecollector,         library);
 /** progress log for the common lib */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   common,                     progress);
 /** progress log, config subsystem */
-NOBUG_CPP_DEFINE_FLAG_PARENT    (    config,                    common);
+NOBUG_CPP_DEFINE_FLAG_PARENT    (    config,                    common);        //TODO: here seems to be a name clash with the global "config" channel
 NOBUG_CPP_DEFINE_FLAG_PARENT    (     configfiles,              config);        //reading, writing, lookup configfiles
 NOBUG_CPP_DEFINE_FLAG_PARENT    (     configtyped,              config);        //values queried, errors
 /** progress log, interfaces */
@@ -142,6 +142,8 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (    subsystem,                 common);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (    pluginloader,              common);        //plugins loaded/unloaded/errors
 /** progress log, external plugins*/
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   plugins,                    progress);
+/** base channel flag to track overall working of the render engine */
+NOBUG_CPP_DEFINE_FLAG_PARENT    (    render,                    logging);
 /** base flag for software testing */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (  test,                        logging);
 /** base flag for syncronization logging */
diff --git a/src/lib/handle.hpp b/src/lib/handle.hpp
index 948130ac8..938046e0f 100644
--- a/src/lib/handle.hpp
+++ b/src/lib/handle.hpp
@@ -98,6 +98,7 @@ namespace lib {
       /** Activation of the handle by the managing service.
        *  @param impl the implementation object this handle is tied to
        *  @param whenDead functor to be invoked when reaching end-of-life 
+       *  @throw std::bad_alloc, in which case \c whenDead(impl) is invoked
        */
       template<typename DEL>
       Handle&
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 43603bfe1..4df46099e 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -48,8 +48,10 @@
 #define CONTROL_COMMAND_DEF_H
 
 //#include "pre.hpp"
+#include "lib/error.hpp"
 #include "include/symbol.hpp"
 #include "proc/control/command.hpp"
+#include "proc/control/command-registry.hpp"
 #include "proc/control/command-signature.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
@@ -89,27 +91,47 @@ namespace control {
                               , UndoDefinition<SIG,MEM>    //  target type (this class) providing the implementation \c bindArg(Tuple<..>) 
                               >
       {
-        typedef typename FunctionSignature< function<SIG> >::Args BasicArgs;
-        typedef typename FunctionTypedef<MEM,BasicArgs>::Sig      UndoCaptureSig;
+        typedef CommandSignature<SIG,MEM> CmdType;
+        typedef typename CmdType::OperateSig CommandOperationSig;
+        typedef typename CmdType::UndoOp_Sig UndoOperationSig;
+        typedef typename CmdType::CaptureSig UndoCaptureSig;
+        
+        typedef function<CommandOperationSig> OperFunc;
+        typedef function<UndoOperationSig>    UndoFunc;
+        typedef function<UndoCaptureSig>      CaptFunc;
         
         Command& prototype_;
+        OperFunc operFunctor_;
+        UndoFunc undoFunctor_;
+        CaptFunc captFunctor_;
         
-        UndoDefinition (Command& underConstruction, function<UndoCaptureSig>& undoCapOperation)
+        
+        UndoDefinition (Command& underConstruction, 
+                        OperFunc& commandOperation,
+                        CaptFunc& undoCapOperation)
           : prototype_(underConstruction)
+          , operFunctor_(commandOperation)
+          , captFunctor_(undoCapOperation)
+          , undoFunctor_()
           {
             cout << showSizeof(undoCapOperation) << endl;
-            UNIMPLEMENTED ("re-fetch command definition and augment it with Functor for capturing Undo information");
           }
         
-        template<typename SIG2>
+        
         UndoDefinition&
-        undoOperation (SIG2& how_to_Undo)
+        undoOperation (UndoOperationSig& how_to_Undo)
           {
-            typedef typename UndoSignature<SIG2>::UndoOp_Sig UndoSig;
+            undoFunctor_ = UndoFunc (how_to_Undo);
+            REQUIRE (operFunctor_);
+            REQUIRE (undoFunctor_);
+            REQUIRE (captFunctor_);
             
-            function<UndoSig> opera3 (how_to_Undo);
-            
-            UNIMPLEMENTED ("store actual Undo-Functor into the command definition held by the enclosing UndoDefinition instance");
+            CommandRegistry& registry = CommandRegistry::instance();
+            CommandImpl& completedDef = registry.newCommandImpl(operFunctor_
+                                                               ,undoFunctor_
+                                                               ,captFunctor_);
+            prototype_.activate(completedDef);
+            ENSURE (prototype_);
             return *this;
           }
         
@@ -146,13 +168,12 @@ namespace control {
     struct BasicDefinition
       {
         Command& prototype_;
+        function<SIG>& operation_;
         
         BasicDefinition(Command& underConstruction, function<SIG>& operation)
           : prototype_(underConstruction)
-          {
-            cout << showSizeof(operation) << endl;
-            UNIMPLEMENTED ("create new command object and store the operation functor");
-          }
+          , operation_(operation)
+          { }
         
         
         template<typename SIG2>
@@ -162,8 +183,8 @@ namespace control {
             typedef typename UndoSignature<SIG2>::CaptureSig UndoCapSig;
             typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
             
-            function<UndoCapSig> opera2 (how_to_capture_UndoState);
-            return SpecificUndoDefinition (prototype_, opera2);
+            function<UndoCapSig> captureOperation (how_to_capture_UndoState);
+            return SpecificUndoDefinition (prototype_, operation_, captureOperation);
           }
       };
     
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 533250f54..91fdd945c 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -96,18 +96,29 @@ namespace control {
         }
       
       
+      /** search the command index for a definition
+       *  @param cmdInstance using the definition to look up
+       *  @return the ID used to register this definition 
+       *          or \c NULL in case of an "anonymous" command */
+      Symbol
+      findDefinition (Command const& cmdInstance)
+        {
+          UNIMPLEMENTED ("try to find a registration in the index for a given command instance");
+        }
+      
+      
       size_t
       index_size()
-      {
-        UNIMPLEMENTED ("number of defs in the index");
-      }
+        {
+          UNIMPLEMENTED ("number of defs in the index");
+        }
       
       
       size_t
       instance_count()
-      {
-        UNIMPLEMENTED ("number of active command impl instances");
-      }
+        {
+          UNIMPLEMENTED ("number of active command impl instances");
+        }
       
       
       /** set up a new command implementation frame */
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 89e190642..6b89aef50 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -30,7 +30,9 @@
  */
 
 
+#include "lib/util.hpp"
 #include "lib/error.hpp"
+#include "include/logging.h"
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
 #include "proc/control/command-registry.hpp"
@@ -39,16 +41,22 @@
 //#include "proc/mobject/mobject.hpp"
 //#include "proc/mobject/placement.hpp"
 
-//#include <boost/format.hpp>
+#include <boost/format.hpp>
+#include <sstream>
 #include <string>
 
+using namespace lumiera;
+using std::ostringstream;
 using std::string;
-//using boost::str;
+using boost::format;
+using boost::str;
+using util::cStr;
 
 
 namespace control {
   
   LUMIERA_ERROR_DEFINE (INVALID_COMMAND,   "Unknown or insufficiently defined command");
+  LUMIERA_ERROR_DEFINE (DUPLICATE_COMMAND, "Attempt to redefine an already existing command definition");
   LUMIERA_ERROR_DEFINE (INVALID_ARGUMENTS, "Arguments provided for binding doesn't match stored command function parameters");
   LUMIERA_ERROR_DEFINE (UNBOUND_ARGUMENTS, "Command mutation functor not yet usable, because arguments aren't bound");
   LUMIERA_ERROR_DEFINE (MISSING_MEMENTO,   "Undo functor not yet usable, because no undo state has been captured");
@@ -58,20 +66,15 @@ namespace control {
   Command::~Command() { }
   
   
-  /** @internal to be invoked by #fetchDef */
-  Command::Command (CommandImpl* pImpl)
-  {
-    Handle::activate (pImpl, CommandRegistry::killCommandImpl);
-  }
-  
 
   /** */
   Command 
   Command::get (Symbol cmdID)
   {
     Command cmd = CommandRegistry::instance().queryIndex (cmdID);
+    static format fmt("Command definition \"%s\" not found");
     if (!cmd)
-      throw lumiera::error::Invalid("Command definition not found", LUMIERA_ERROR_INVALID_COMMAND);
+      throw error::Invalid(str(fmt % cmdID), LUMIERA_ERROR_INVALID_COMMAND);
       
     return cmd;
   }
@@ -85,12 +88,32 @@ namespace control {
     if (cmd)
       return cmd;
     
-    Command newDefinition (registry.newCommandImpl());
+    // create an empty definition, later to be activated
+    Command newDefinition;
     
     return registry.track (cmdID, newDefinition);
   }              // return new or currently registered cmd...
   
   
+  /** @internal to be invoked by CommandDef
+   *  @throw std::bad_alloc, in which case
+   *         CommandRegistry::killCommandImpl is invoked */
+  Command&
+  Command::activate (CommandImpl& implFrame)
+  {
+    static format fmt_err("Command \"%s\" already defined");
+    static format fmt_ok("Command \"%s\" defined OK");
+    
+    if (this->isValid())
+      throw error::Logic (str(fmt_err % *this), LUMIERA_ERROR_DUPLICATE_COMMAND);
+          
+    _Handle::activate (&implFrame, CommandRegistry::killCommandImpl);
+            
+    INFO (command, cStr(fmt_ok % *this));
+    return *this;
+  }
+  
+  
   CommandDef
   Command::storeDef (Symbol newCmdID)
   {
@@ -175,6 +198,34 @@ namespace control {
     return isValid()
         && impl().canUndo();
   }
+  
+  
+  
+  /** diagnostics: shows the commandID, if any,
+   *  and the degree of definition of this command */
+  Command::operator string() const
+  {
+    ostringstream repr;
+    repr << "Command";
+    ////////////////////////////////////////////////////////////////////TODO do we need no-throw guarantee here?
+    Symbol id = CommandRegistry::instance().findCommand (*this);
+    if (id)
+      repr << "(\""<<id<<"\") ";
+    else 
+      repr << "(_xxx_) ";
+    if (!isValid())
+      repr << "NIL";
+    else
+      if (canUndo())
+        repr << "{undo}";
+      else
+        if (canExec())
+          repr << "{exec}";
+        else
+            repr << "{def}";
+    
+    return repr.str();
+  }
 
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index f39c3af63..0a4cdf27c 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -43,6 +43,7 @@
 #include "lib/handle.hpp"
 
 //#include <tr1/memory>
+#include <string>
 
 ///////////////////////////////////////////TODO: define an C-API representation here, make the header multilingual!
 
@@ -50,11 +51,13 @@
 
 namespace control {
   
+  using std::string;
   using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
   LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Command functor not yet usable, because arguments aren't bound
   LUMIERA_ERROR_DECLARE (INVALID_COMMAND);    ///< Unknown or insufficiently defined command
+  LUMIERA_ERROR_DECLARE (DUPLICATE_COMMAND);  ///< Attempt to redefine an already existing command definition
   LUMIERA_ERROR_DECLARE (INVALID_ARGUMENTS);  ///< Arguments provided for binding doesn't match stored command function parameters
 
   
@@ -76,9 +79,9 @@ namespace control {
       
     public:
       /* === command registry === */
-      static Command& get (Symbol cmdID);
-      static bool  remove (Symbol cmdID); 
-      static bool   undef (Symbol cmdID);
+      static Command get (Symbol cmdID);
+      static bool remove (Symbol cmdID); 
+      static bool  undef (Symbol cmdID);
       
       CommandDef storeDef (Symbol newCmdID);
       
@@ -100,6 +103,11 @@ namespace control {
       HandlingPattern const& getDefaultHandlingPattern()  const;
       
       
+      
+      /* === command lifecycle === */
+      
+      Command& activate (CommandImpl&);
+      
       template<typename TYPES>
       void bindArg (Tuple<TYPES> const&);
       
@@ -113,24 +121,17 @@ namespace control {
       bool canExec()  const;
       bool canUndo()  const;
       
+      operator string() const;
       friend bool operator== (Command const&, Command const&);
       
       
     protected:
-      static Command& fetchDef (Symbol cmdID);
+      static Command fetchDef (Symbol cmdID);
       
       friend class CommandDef;
       
       
     private:
-    /** Commands can only be created through the framework
-     *  (by setting up an CommandDef), thus ensuring there's
-     *  always a corresponding CommandImpl within the registry.
-     *  @note the copy operations are public though
-     *  @see Command#fetchDef
-     *  @see CommandDef 
-     */
-    Command (CommandImpl* pImpl);
      
     };
   ////////////////TODO currently just fleshing  out the API....
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 9dda3d68f..bcb81b8af 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -58,6 +58,7 @@ namespace test    {
 
 //  using lib::test::showSizeof;
   using util::isSameObject;
+  using util::contains;
 
 //  using session::test::TestClip;
 //  using lumiera::P;
@@ -97,6 +98,7 @@ namespace test    {
           standardUse();
           definePrototype();
           usePrototype();
+          preventDuplicates();
           undef();
           
           ASSERT (0 == command1::check_);
@@ -138,7 +140,9 @@ namespace test    {
           ASSERT (!Command::get("test.command1.2"));
           
           Command com = Command::get("test.command1.2");
-          ASSERT (!com);
+          ASSERT (contains (str(com), "test.command1.2"));
+          ASSERT (contains (str(com), "{def}"));
+          ASSERT (!com);                                                      ////////////////////TODO: mismatch: shall bool() < canExec() ????
           ASSERT (!com.canUndo());
           VERIFY_ERROR (UNBOUND_ARGUMENTS, com() );
           
@@ -248,6 +252,20 @@ namespace test    {
         }
       
       
+      void
+      preventDuplicates()
+        {
+          ASSERT (CommandDef ("test.command1.1"));
+          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.1").operation (command1::operate) );    
+          ASSERT (CommandDef ("test.command1.2"));
+          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.2").operation (command1::operate) );    
+          ASSERT (CommandDef ("test.command1.3"));
+          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.3").operation (command1::operate) );    
+          ASSERT (CommandDef ("test.command1.4"));
+          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.4").operation (command1::operate) );    
+        }
+      
+      
       void
       undef()
         {
@@ -266,8 +284,15 @@ namespace test    {
           CommandDef unbelievable ("miracle");
           ASSERT (!unbelievable);
           
+          Command miracle;
           // but because the miracle isn't yet defined, any use throws
-          VERIFY_ERROR (INVALID_COMMAND, Command::get("miracle"));
+          VERIFY_ERROR (INVALID_COMMAND, miracle.bind("abracadabra"));
+          VERIFY_ERROR (INVALID_COMMAND, miracle.execSync());
+          VERIFY_ERROR (INVALID_COMMAND, miracle.undo());
+          VERIFY_ERROR (INVALID_COMMAND, miracle());
+          ASSERT (!miracle.canExec());
+          ASSERT (!miracle.canUndo());
+          ASSERT (!miracle);
           
           ASSERT (Command::remove("test.command1.1"));
           ASSERT (Command::remove("test.command1.2"));

From f2126c076481c062c30aacf991691b1510571107 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 1 Aug 2009 23:57:12 +0200
Subject: [PATCH 227/368] WIP partially get new proc-layer command impl through
 the compiler

---
 src/include/logging.h                         | 10 ++++++----
 src/lib/handle.hpp                            |  2 +-
 src/proc/control/command-def.hpp              |  5 +++--
 src/proc/control/command-impl.hpp             |  9 +--------
 src/proc/control/command-registry.hpp         | 14 ++++++++++----
 src/proc/control/command-signature.hpp        |  1 +
 src/proc/control/command.cpp                  | 19 +++++--------------
 src/proc/control/command.hpp                  | 13 ++++++-------
 .../proc/control/command-basic-test.cpp       |  2 +-
 .../proc/control/command-use1-test.cpp        |  2 ++
 wiki/renderengine.html                        |  7 ++++---
 11 files changed, 40 insertions(+), 44 deletions(-)

diff --git a/src/include/logging.h b/src/include/logging.h
index 1871da2fa..b48f3bdff 100644
--- a/src/include/logging.h
+++ b/src/include/logging.h
@@ -130,9 +130,9 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (    resourcecollector,         library);
 /** progress log for the common lib */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   common,                     progress);
 /** progress log, config subsystem */
-NOBUG_CPP_DEFINE_FLAG_PARENT    (    config,                    common);        //TODO: here seems to be a name clash with the global "config" channel
-NOBUG_CPP_DEFINE_FLAG_PARENT    (     configfiles,              config);        //reading, writing, lookup configfiles
-NOBUG_CPP_DEFINE_FLAG_PARENT    (     configtyped,              config);        //values queried, errors
+NOBUG_CPP_DEFINE_FLAG_PARENT    (    configsys,                 common);        //TODO: here seems to be an ambiguity weather "config" should denote the global config channel or the config-loder internals
+NOBUG_CPP_DEFINE_FLAG_PARENT    (     configfiles,              configsys);     //reading, writing, lookup configfiles
+NOBUG_CPP_DEFINE_FLAG_PARENT    (     configtyped,              configsys);     //values queried, errors
 /** progress log, interfaces */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (    interface,                 common);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (     interfaceregistry,        common);        //interfaces which get registered/removed
@@ -143,7 +143,9 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (    pluginloader,              common);
 /** progress log, external plugins*/
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   plugins,                    progress);
 /** base channel flag to track overall working of the render engine */
-NOBUG_CPP_DEFINE_FLAG_PARENT    (    render,                    logging);
+NOBUG_CPP_DEFINE_FLAG_PARENT    (  render,                      logging);
+NOBUG_CPP_DEFINE_FLAG_PARENT    (  config,                      logging);       //TODO: here seems to be an ambiguity weather "config" should denote the global config channel or the config-loder internals
+
 /** base flag for software testing */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (  test,                        logging);
 /** base flag for syncronization logging */
diff --git a/src/lib/handle.hpp b/src/lib/handle.hpp
index 938046e0f..12a8b4979 100644
--- a/src/lib/handle.hpp
+++ b/src/lib/handle.hpp
@@ -125,7 +125,7 @@ namespace lib {
       
     protected:
       IMP& 
-      impl()
+      impl()  const
         {
           REQUIRE (smPtr_.get(), "Lifecycle-Error");
           return *(smPtr_.get());
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 4df46099e..15f7ae7ed 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -95,6 +95,7 @@ namespace control {
         typedef typename CmdType::OperateSig CommandOperationSig;
         typedef typename CmdType::UndoOp_Sig UndoOperationSig;
         typedef typename CmdType::CaptureSig UndoCaptureSig;
+        typedef typename CmdType::CmdArgs    CmdArgs;
         
         typedef function<CommandOperationSig> OperFunc;
         typedef function<UndoOperationSig>    UndoFunc;
@@ -102,8 +103,8 @@ namespace control {
         
         Command& prototype_;
         OperFunc operFunctor_;
-        UndoFunc undoFunctor_;
         CaptFunc captFunctor_;
+        UndoFunc undoFunctor_;
         
         
         UndoDefinition (Command& underConstruction, 
@@ -137,7 +138,7 @@ namespace control {
         
         
         Command&
-        bindArg (Tuple<BasicArgs> const& params)
+        bindArg (Tuple<CmdArgs> const& params)
           {
             Closure<SIG> clo (params);
             
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 720fc0d29..e329d6bfb 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -63,9 +63,8 @@ namespace control {
    */
   class CommandImpl
     : public lib::BoolCheckable<CommandImpl
-           , boost::equality_comparable<CommandImpl
            , boost::noncopyable
-           > >
+           >
     {
       Mutation do_;
       UndoMutation undo_;
@@ -109,12 +108,6 @@ namespace control {
         }
       
       
-      /** @note strict instance equality */
-      bool
-      operator== (CommandImpl const& oi)
-        {
-          return (this == &oi); 
-        }
       
       
     protected:
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 91fdd945c..3d25fd016 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -63,7 +63,7 @@ namespace control {
    * TODO type comment
    */
   class CommandRegistry
-    : lib::Sync<>
+    : public lib::Sync<>
     {
       
     public:
@@ -100,7 +100,7 @@ namespace control {
        *  @param cmdInstance using the definition to look up
        *  @return the ID used to register this definition 
        *          or \c NULL in case of an "anonymous" command */
-      Symbol
+      const char*
       findDefinition (Command const& cmdInstance)
         {
           UNIMPLEMENTED ("try to find a registration in the index for a given command instance");
@@ -122,8 +122,14 @@ namespace control {
       
       
       /** set up a new command implementation frame */
-      static CommandImpl*
-      newCommandImpl ()
+      template< typename SIG_OPER    ///< signature of the command operation
+              , typename SIG_UNDO    ///< signature to undo the command
+              , typename SIG_CAPT    ///< signature for capturing undo state
+              >
+      CommandImpl&
+      newCommandImpl (function<SIG_OPER>& operFunctor_
+                     ,function<SIG_UNDO>& undoFunctor_
+                     ,function<SIG_CAPT>& captFunctor_)
         {
           Lock sync(this);
           UNIMPLEMENTED ("set up a new impl instance located within the instance table");
diff --git a/src/proc/control/command-signature.hpp b/src/proc/control/command-signature.hpp
index a408724f2..5c403cace 100644
--- a/src/proc/control/command-signature.hpp
+++ b/src/proc/control/command-signature.hpp
@@ -95,6 +95,7 @@ namespace control {
       typedef typename FunctionTypedef<void, Args>::Sig          OperateSig;
       typedef typename FunctionTypedef<MEM, Args>::Sig           CaptureSig;
       typedef typename FunctionTypedef<void, ExtendedArgs>::Sig  UndoOp_Sig;
+      typedef Args                                               CmdArgs;
       typedef MEM                                                Memento;
     };
   
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 6b89aef50..fd166417d 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -35,6 +35,7 @@
 #include "include/logging.h"
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
+#include "proc/control/command-impl.hpp"
 #include "proc/control/command-registry.hpp"
 #include "proc/control/handling-pattern.hpp"
 //#include "proc/mobject/mobject-ref.hpp"
@@ -101,15 +102,14 @@ namespace control {
   Command&
   Command::activate (CommandImpl& implFrame)
   {
-    static format fmt_err("Command \"%s\" already defined");
-    static format fmt_ok("Command \"%s\" defined OK");
+    static format fmt("Command \"%s\" already defined");
     
     if (this->isValid())
-      throw error::Logic (str(fmt_err % *this), LUMIERA_ERROR_DUPLICATE_COMMAND);
+      throw error::Logic (str (fmt % *this), LUMIERA_ERROR_DUPLICATE_COMMAND);
           
     _Handle::activate (&implFrame, CommandRegistry::killCommandImpl);
             
-    INFO (command, cStr(fmt_ok % *this));
+    INFO (command, "Command \"%s\" defined OK", cStr(*this));
     return *this;
   }
   
@@ -174,15 +174,6 @@ namespace control {
   
   
   
-  bool
-  Command::isValid()  const
-  {
-    return _Handle::isValid()
-        && impl().isValid();
-  }
-  
-  
-  
   bool
   Command::canExec()  const
   {
@@ -208,7 +199,7 @@ namespace control {
     ostringstream repr;
     repr << "Command";
     ////////////////////////////////////////////////////////////////////TODO do we need no-throw guarantee here?
-    Symbol id = CommandRegistry::instance().findCommand (*this);
+    Symbol id = CommandRegistry::instance().findDefinition (*this);
     if (id)
       repr << "(\""<<id<<"\") ";
     else 
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 0a4cdf27c..2dae7896b 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -63,6 +63,7 @@ namespace control {
   
   
   class CommandDef;
+  class CommandImpl;
   class HandlingPattern;
   
   
@@ -71,9 +72,8 @@ namespace control {
    */
   class Command
     : public com::ArgumentBinder<Command    // accepts arbitrary bind(..) calls (with runtime check)
-           , lib::BoolCheckable<Command    //  implicit conversion to bool for status check
-           , lib::Handle<CommandImpl>     //   actually implemented as ref counting Handle
-           > >
+           , lib::Handle<CommandImpl>      //  actually implemented as ref counting Handle
+           >
     {
       typedef lib::Handle<CommandImpl> _Handle;
       
@@ -117,7 +117,6 @@ namespace control {
       static size_t definition_count();
       static size_t instance_count();
       
-      bool isValid()  const;
       bool canExec()  const;
       bool canUndo()  const;
       
@@ -144,14 +143,14 @@ namespace control {
   }
   
   
-  bool
+  inline bool
   operator== (Command const& c1, Command const& c2)
     {
       return (!c1 && !c2)
-          || ( c1 &&  c2  && c1.impl() == c2.impl()); 
+          || ( c1 &&  c2  && (&c1.impl() == &c2.impl())); 
     }
   
-  bool
+  inline bool
   operator!= (Command const& c1, Command const& c2)
     {
       return ! (c1 == c2); 
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 8823ed8f6..87be6205a 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -137,7 +137,7 @@ namespace test    {
               ;
           
           
-          Command& ourCmd = Command::get("test.command1");
+          Command ourCmd = Command::get("test.command1");
           ////////////////////////////////////////////////////////////////////TODO: isn't this unlogical? Do I want a *definition* or an *instance* ??
           
           // invoke the command
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index bcb81b8af..60f100361 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -35,6 +35,7 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
+#include "lib/format.hpp"
 #include "lib/util.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
@@ -59,6 +60,7 @@ namespace test    {
 //  using lib::test::showSizeof;
   using util::isSameObject;
   using util::contains;
+  using util::str;
 
 //  using session::test::TestClip;
 //  using lumiera::P;
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 0df78873b..4f6605af1 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1025,7 +1025,7 @@ A command is operated or executed by passing it to an ''execution pattern'' &amp
 When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. Anyway, a ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
 </pre>
 </div>
-<div title="CommandUsage" modifier="Ichthyostega" modified="200907232209" created="200907212338" tags="SessionLogic draft dynamic" changecount="5">
+<div title="CommandUsage" modifier="Ichthyostega" modified="200908011235" created="200907212338" tags="SessionLogic draft dynamic" changecount="7">
 <pre>//for now (7/09) I'll use this page to collect ideas how commands might be used...//
 
 * use a command for getting a log entry and an undo possibility automatically
@@ -1040,14 +1040,15 @@ When a command has been executed (and maybe undone), it's best to leave it alone
 !!!a command definition....
 * can be created from scratch, by ID
 * can be re-accessed, by ID
-* can be modified, which doesn't change any commands already created/derived from the previous version
+* can't be modified once defined (this is to prevent duplicate definitions with the same ID)
+* but can be dropped, which doesn't influence already existing dependent command instances
 * usually will be the starting point for creating an actual command by //binding//
 
 !!!a command instance....
 * normally emerges from a definition by binding arguments
 * the first such binding will create a named command registration
 * but subsequent accesses by ID or new bindings create an anonymous clone
-* which then in turn might be registered explicitly with a new ID
+* which then in turn might then be registered explicitly with a new ID
 * anonymous command instances are managed by referral and ref-counting
 
 !!!an execution pattern....

From 4236d0649a016ae219e26f98cdf30bb7a2d9699f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 2 Aug 2009 18:00:03 +0200
Subject: [PATCH 228/368] WIP: implement the basic operation of execution
 pattern

---
 doc/devel/draw/CommandImpl-1.svg              | 677 +++++++++---------
 src/lib/error.hpp                             |   4 +-
 src/lib/exception.cpp                         |   2 +-
 src/proc/control/command-closure.hpp          |   3 +-
 src/proc/control/command.cpp                  |  22 +-
 src/proc/control/command.hpp                  |  10 +-
 src/proc/control/handling-pattern.cpp         |  97 ++-
 src/proc/control/handling-pattern.hpp         |  39 +-
 src/tool/try.cpp                              |   5 +
 .../proc/control/command-use2-test.cpp        |   4 +-
 10 files changed, 509 insertions(+), 354 deletions(-)

diff --git a/doc/devel/draw/CommandImpl-1.svg b/doc/devel/draw/CommandImpl-1.svg
index 5e4bc6b1d..84db4bbc3 100644
--- a/doc/devel/draw/CommandImpl-1.svg
+++ b/doc/devel/draw/CommandImpl-1.svg
@@ -28,8 +28,8 @@
      inkscape:pageopacity="0.0"
      inkscape:pageshadow="2"
      inkscape:zoom="1.4142136"
-     inkscape:cx="410.87417"
-     inkscape:cy="293.93224"
+     inkscape:cx="420.65266"
+     inkscape:cy="293.18784"
      inkscape:document-units="px"
      inkscape:current-layer="svg2"
      inkscape:window-width="1668"
@@ -68,7 +68,7 @@
     <pattern
        inkscape:stockid="Stripes 1:2"
        id="Strips1_2"
-       patternTransform="matrix(0.8406114,0.5442428,-0.5442428,0.8406114,685.45306,294.40072)"
+       patternTransform="matrix(0.8406114,0.5442428,-0.5442428,0.8406114,675.45306,294.09066)"
        height="1"
        width="3"
        patternUnits="userSpaceOnUse"
@@ -315,26 +315,26 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="174.71809"
-     y="79.693436"
+     x="164.71809"
+     y="79.383377"
      id="text3457"
      sodipodi:linespacing="100%"><tspan
        sodipodi:role="line"
        id="tspan3459"
-       x="174.71809"
-       y="79.693436">GUI</tspan></text>
+       x="164.71809"
+       y="79.383377">GUI</tspan></text>
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text3461"
-     y="206.22331"
-     x="244.52675"
+     y="205.91325"
+     x="234.52675"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#008080;fill-opacity:1;fill-rule:evenodd;stroke:#008080;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
-       y="206.22331"
-       x="244.52675"
+       y="205.91325"
+       x="234.52675"
        id="tspan3463"
        sodipodi:role="line">Proc-Layer</tspan></text>
   <text
@@ -464,7 +464,7 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="cc"
      style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 349.96486,307.3103 L 467.21486,169.8103"
+     d="M 339.96486,307.00024 L 457.21486,169.50024"
      id="path2257" />
   <text
      inkscape:export-ydpi="90"
@@ -500,25 +500,25 @@
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="300.8103"
-     x="289.46484"
+     y="300.50024"
+     x="279.46484"
      height="52.158669"
      width="77.698021"
      id="rect2235"
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2237"
-     y="312.3103"
-     x="293.96484"
+     y="312.00024"
+     x="283.96484"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="312.3103"
-       x="293.96484"
+       y="312.00024"
+       x="283.96484"
        id="tspan2239"
        sodipodi:role="line">Command</tspan></text>
   <path
@@ -537,29 +537,29 @@
      id="rect2244"
      width="107.71078"
      height="19.752098"
-     x="269.46484"
-     y="240.8103" />
+     x="259.46484"
+     y="240.50024" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="273.96484"
-     y="252.8103"
+     x="263.96484"
+     y="252.50024"
      id="text2246"
      sodipodi:linespacing="100%"><tspan
        id="tspan2541"
        sodipodi:role="line"
-       x="273.96484"
-       y="252.8103"
+       x="263.96484"
+       y="252.50024"
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">Handle&lt;CommandImpl&gt;</tspan></text>
   <path
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#4f4f4f;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-start:url(#TriangleInL);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 319.46486,270.8103 L 319.46486,300.8103"
+     d="M 309.46486,270.50024 L 309.46486,300.50024"
      id="path2250"
      sodipodi:nodetypes="cc" />
   <text
@@ -683,32 +683,32 @@
      id="rect2288"
      width="406.09683"
      height="180.84619"
-     x="336.36804"
-     y="31.810305" />
+     x="326.36804"
+     y="31.500246" />
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
      id="rect2290"
      width="70.181519"
      height="20"
-     x="470.0473"
-     y="130.3103" />
+     x="460.0473"
+     y="130.00024" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="474.64636"
-     y="140.3103"
+     x="464.64636"
+     y="140.00024"
      id="text2292"
      sodipodi:linespacing="100%"><tspan
        id="tspan2294"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="140.3103"
-       x="474.64636"
+       y="140.00024"
+       x="464.64636"
        sodipodi:role="line">CommandImpl</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -716,47 +716,47 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="346.86804"
-     y="47.877869"
+     x="336.86804"
+     y="47.56781"
      id="text2296"
      sodipodi:linespacing="100%"><tspan
-       y="47.877869"
-       x="346.86804"
+       y="47.56781"
+       x="336.86804"
        id="tspan2298"
        sodipodi:role="line">CommandRegistry</tspan></text>
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="110.3103"
-     x="469.96484"
+     y="110.00024"
+     x="459.96484"
      height="20"
      width="70.181519"
      id="rect2300"
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000" />
   <rect
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="150.3103"
-     x="469.96484"
+     y="150.00024"
+     x="459.96484"
      height="20"
      width="70.181519"
      id="rect2302"
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000" />
   <text
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2306"
-     y="120.3103"
-     x="474.64636"
+     y="120.00024"
+     x="464.64636"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
-       x="474.64636"
-       y="120.3103"
+       x="464.64636"
+       y="120.00024"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
        id="tspan2308">CommandImpl</tspan></text>
   <text
@@ -765,14 +765,14 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="474.64636"
-     y="160.3103"
+     x="464.64636"
+     y="160.00024"
      id="text2310"
      sodipodi:linespacing="100%"><tspan
        id="tspan2312"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="160.3103"
-       x="474.64636"
+       y="160.00024"
+       x="464.64636"
        sodipodi:role="line">CommandImpl</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -780,13 +780,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="353.36804"
-     y="84.810303"
+     x="343.36804"
+     y="84.500244"
      id="text2318"
      sodipodi:linespacing="100%"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="84.810303"
-       x="353.36804"
+       y="84.500244"
+       x="343.36804"
        id="tspan2320"
        sodipodi:role="line">xxx(...)</tspan></text>
   <path
@@ -829,14 +829,14 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text5310"
-     y="95.242737"
-     x="353.36804"
+     y="94.932678"
+     x="343.36804"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        sodipodi:role="line"
        id="tspan5312"
-       x="353.36804"
-       y="95.242737"
+       x="343.36804"
+       y="94.932678"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">sss()</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -844,13 +844,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="353.36804"
-     y="64.81031"
+     x="343.36804"
+     y="64.500252"
      id="text5314"
      sodipodi:linespacing="100%"><tspan
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="64.81031"
-       x="353.36804"
+       y="64.500252"
+       x="343.36804"
        sodipodi:role="line"
        id="tspan2741">Command::get(&quot;name&quot;)</tspan></text>
   <text
@@ -976,7 +976,7 @@
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
      sodipodi:nodetypes="csc" />
   <g
-     transform="translate(29.464859,-167.1897)"
+     transform="translate(19.464859,-167.49976)"
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1060,13 +1060,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2325"
-     y="333.05249"
-     x="319.46484"
+     y="332.74243"
+     x="309.46484"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="333.05249"
-       x="319.46484"
+       y="332.74243"
+       x="309.46484"
        id="tspan2327"
        sodipodi:role="line">exec(..)</tspan></text>
   <text
@@ -1110,8 +1110,8 @@
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="319.46484"
-     y="343.3103"
+     x="309.46484"
+     y="343.00024"
      id="text2545"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1119,8 +1119,8 @@
      inkscape:export-ydpi="90"><tspan
        sodipodi:role="line"
        id="tspan2547"
-       x="319.46484"
-       y="343.3103"
+       x="309.46484"
+       y="343.00024"
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans">undo(..)</tspan></text>
   <text
      inkscape:export-ydpi="90"
@@ -1128,13 +1128,13 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:linespacing="100%"
      id="text2549"
-     y="322.8103"
-     x="319.46484"
+     y="322.50024"
+     x="309.46484"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"><tspan
        style="font-size:8px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="322.8103"
-       x="319.46484"
+       y="322.50024"
+       x="309.46484"
        id="tspan2551"
        sodipodi:role="line">bind(..)</tspan></text>
   <rect
@@ -1142,16 +1142,16 @@
      id="rect2573"
      width="50.037743"
      height="79.987656"
-     x="379.96484"
-     y="110.3103"
+     x="369.96484"
+     y="110.00024"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="383.14636"
-     y="120.3103"
+     x="373.14636"
+     y="120.00024"
      id="text2575"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1159,14 +1159,14 @@
      inkscape:export-ydpi="90"><tspan
        id="tspan2577"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="120.3103"
-       x="383.14636"
+       y="120.00024"
+       x="373.14636"
        sodipodi:role="line">Index</tspan></text>
   <g
      transform="translate(-54.67118,-41.893236)"
      id="g2589">
     <rect
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1.00000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
        id="rect4200"
        width="99.876717"
        height="49.91003"
@@ -1193,7 +1193,8 @@
   </g>
   <g
      transform="translate(-34.67118,-72.393233)"
-     id="g2594">
+     id="g2594"
+     style="fill:#eeffda;fill-opacity:0.71532845">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1203,10 +1204,10 @@
        height="49.91003"
        width="99.876717"
        id="rect2596"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1.00000012;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532845;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
     <text
        xml:space="preserve"
-       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#eeffda;fill-opacity:0.71532845;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
        x="136.9032"
        y="395.06757"
        id="text2598"
@@ -1215,19 +1216,19 @@
        inkscape:export-xdpi="90"
        inkscape:export-ydpi="90"><tspan
          id="tspan2600"
-         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans;fill:#eeffda;fill-opacity:0.71532845"
          y="395.06757"
          x="136.9032"
          sodipodi:role="line">undo def</tspan></text>
   </g>
   <g
-     transform="translate(-8.2568512,-162.75726)"
+     transform="translate(-18.256851,-163.06732)"
      id="g2610">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
        inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
        id="rect2604"
        width="44.681519"
        height="11.5"
@@ -1250,7 +1251,7 @@
          id="tspan2608">Command</tspan></text>
   </g>
   <g
-     transform="translate(-8.2568512,-148.75726)"
+     transform="translate(-18.256851,-149.06732)"
      id="g2615">
     <rect
        y="294.06757"
@@ -1258,7 +1259,7 @@
        height="11.5"
        width="44.681519"
        id="rect2617"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
        inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
        inkscape:export-xdpi="90"
        inkscape:export-ydpi="90" />
@@ -1279,7 +1280,7 @@
          sodipodi:role="line">Command</tspan></text>
   </g>
   <g
-     transform="translate(-8.2568512,-120.75726)"
+     transform="translate(-18.256851,-121.06732)"
      id="g2631">
     <rect
        y="294.06757"
@@ -1287,7 +1288,7 @@
        height="11.5"
        width="44.681519"
        id="rect2633"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
        inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
        inkscape:export-xdpi="90"
        inkscape:export-ydpi="90" />
@@ -1309,7 +1310,7 @@
   </g>
   <path
      id="path2639"
-     d="M 423.96486,154.8103 L 463.46486,160.8103"
+     d="M 413.96486,154.50024 L 453.46486,160.50024"
      style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
      sodipodi:nodetypes="cc"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1317,7 +1318,7 @@
      inkscape:export-ydpi="90" />
   <g
      id="g2665"
-     transform="translate(-3.5140952e-2,-159.6897)">
+     transform="translate(-10.035141,-159.99976)">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1327,7 +1328,7 @@
        height="20"
        width="70.181519"
        id="rect2647"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000" />
     <text
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1345,10 +1346,10 @@
          id="tspan2655">ArgumentHolder</tspan></text>
   </g>
   <g
-     transform="translate(-3.5140952e-2,-139.6897)"
+     transform="translate(-10.035141,-139.99976)"
      id="g2670">
     <rect
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
        id="rect2672"
        width="70.181519"
        height="20"
@@ -1375,7 +1376,7 @@
   </g>
   <g
      id="g2678"
-     transform="translate(-3.5140952e-2,-119.50726)">
+     transform="translate(-10.035141,-119.81732)">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1385,7 +1386,7 @@
        height="20"
        width="70.181519"
        id="rect2680"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
+       style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000" />
     <text
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1419,7 +1420,7 @@
        sodipodi:role="line">getHandle(slot)</tspan></text>
   <g
      id="g16601"
-     transform="translate(70.675549,-274.241)">
+     transform="translate(60.675549,-274.55106)">
     <g
        id="g16603"
        style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate">
@@ -1446,100 +1447,61 @@
        style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
   </g>
   <rect
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
      id="rect16814"
      width="70.181519"
      height="20"
-     x="469.96484"
-     y="170.3103"
+     x="459.96484"
+     y="170.00024"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      sodipodi:linespacing="100%"
      id="text16816"
-     y="180.3103"
-     x="474.64636"
+     y="180.00024"
+     x="464.64636"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
      xml:space="preserve"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
        sodipodi:role="line"
-       x="474.64636"
-       y="180.3103"
+       x="464.64636"
+       y="180.00024"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
        id="tspan16818">CommandImpl</tspan></text>
   <rect
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532843999999995;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000024000000010;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;color:#000000"
      id="rect2686"
      width="199.98341"
      height="60.001945"
-     x="539.96484"
-     y="240.31027"
+     x="529.96484"
+     y="240.00021"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="545.72223"
-     y="254.7019"
+     x="535.72223"
+     y="254.39185"
      id="text2688"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
-       y="254.7019"
-       x="545.72223"
+       y="254.39185"
+       x="535.72223"
        id="tspan2690"
        sodipodi:role="line">Command Impl</tspan></text>
-  <g
-     transform="translate(180.49403,-294.241)"
-     id="g16820">
-    <g
-       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-       id="g16822">
-      <path
-         sodipodi:nodetypes="ccccc"
-         d="M 399.47083,444.5513 L 469.47083,444.5513 L 609.47083,464.5513 L 499.47083,464.5513 L 399.47083,444.5513 z"
-         id="path16824" />
-      <path
-         sodipodi:nodetypes="ccccc"
-         d="M 469.47083,444.5513 L 469.47083,464.5513 L 609.47083,494.5513 L 609.47083,464.5513 L 469.47083,444.5513 z"
-         id="path16826" />
-      <path
-         sodipodi:nodetypes="ccccc"
-         d="M 469.47083,464.5513 L 399.47083,464.5513 L 499.47083,494.5513 L 609.47083,494.5513 L 469.47083,464.5513 z"
-         id="path16828" />
-      <path
-         sodipodi:nodetypes="ccccc"
-         d="M 399.47083,464.5513 L 399.47083,444.5513 L 499.97083,465.07898 L 499.47083,494.5513 L 399.47083,464.5513 z"
-         id="path16830" />
-    </g>
-    <path
-       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-       d="M 399.47083,444.5513 L 469.47083,444.5513 L 469.47083,464.5513 L 399.47083,464.5513 L 399.47083,444.5513 z"
-       id="path16832"
-       sodipodi:nodetypes="ccccc" />
-  </g>
-  <rect
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     y="170.6593"
-     x="679.96484"
-     height="29.556213"
-     width="110.03513"
-     id="rect16834"
-     style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000024;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
   <path
      inkscape:export-ydpi="90"
      inkscape:export-xdpi="90"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="cc"
      style="fill:#55cbb9;fill-opacity:1;fill-rule:evenodd;stroke:#55cbb9;stroke-width:1.5;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#ArrowHIV1end);stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1"
-     d="M 535.96486,160.3103 L 575.96486,142.3103"
+     d="M 525.96486,160.00024 L 565.96486,142.00024"
      id="path2590" />
   <flowRoot
      xml:space="preserve"
@@ -1563,7 +1525,7 @@
        id="flowPara2643" /><flowPara
        id="flowPara2645" /></flowRoot>  <g
      id="g2647"
-     transform="translate(158.62035,-32.368916)">
+     transform="translate(148.62035,-32.678975)">
     <rect
        inkscape:export-ydpi="90"
        inkscape:export-xdpi="90"
@@ -1616,8 +1578,8 @@
          sodipodi:role="line">undo functor</tspan></text>
   </g>
   <rect
-     y="269.47681"
-     x="628.24512"
+     y="269.16675"
+     x="618.24512"
      height="11.5"
      width="34.074917"
      id="rect2666"
@@ -1628,8 +1590,8 @@
   <text
      xml:space="preserve"
      style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="629.92664"
-     y="277.47681"
+     x="619.92664"
+     y="277.16675"
      id="text2668"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1637,153 +1599,100 @@
      inkscape:export-ydpi="90"><tspan
        id="tspan2670"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="277.47681"
-       x="629.92664"
+       y="277.16675"
+       x="619.92664"
        sodipodi:role="line">closure</tspan></text>
-  <g
-     id="g2680"
-     transform="translate(316.6378,-119.75726)">
-    <rect
-       y="294.06757"
-       x="389.72168"
-       height="11.5"
-       width="17.605364"
-       id="rect2674"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       inkscape:export-xdpi="90"
-       inkscape:export-ydpi="90" />
-    <text
-       xml:space="preserve"
-       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-       x="391.4032"
-       y="302.06757"
-       id="text2676"
-       sodipodi:linespacing="100%"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       inkscape:export-xdpi="90"
-       inkscape:export-ydpi="90"><tspan
-         id="tspan2678"
-         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-         y="302.06757"
-         x="391.4032"
-         sodipodi:role="line">arg</tspan></text>
-  </g>
-  <g
-     transform="translate(337.10734,-119.75726)"
-     id="g2685">
-    <rect
-       inkscape:export-ydpi="90"
-       inkscape:export-xdpi="90"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-       id="rect2687"
-       width="17.605364"
-       height="11.5"
-       x="389.72168"
-       y="294.06757" />
-    <text
-       inkscape:export-ydpi="90"
-       inkscape:export-xdpi="90"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       sodipodi:linespacing="100%"
-       id="text2689"
-       y="302.06757"
-       x="391.4032"
-       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-       xml:space="preserve"><tspan
-         sodipodi:role="line"
-         x="391.4032"
-         y="302.06757"
-         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-         id="tspan2691">arg</tspan></text>
-  </g>
-  <g
-     id="g2693"
-     transform="translate(357.10734,-119.75726)">
-    <rect
-       y="294.06757"
-       x="389.72168"
-       height="11.5"
-       width="17.605364"
-       id="rect2695"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       inkscape:export-xdpi="90"
-       inkscape:export-ydpi="90" />
-    <text
-       xml:space="preserve"
-       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-       x="391.4032"
-       y="302.06757"
-       id="text2697"
-       sodipodi:linespacing="100%"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       inkscape:export-xdpi="90"
-       inkscape:export-ydpi="90"><tspan
-         id="tspan2699"
-         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-         y="302.06757"
-         x="391.4032"
-         sodipodi:role="line">arg</tspan></text>
-  </g>
-  <g
-     transform="translate(377.08311,-119.75726)"
-     id="g2701">
-    <rect
-       inkscape:export-ydpi="90"
-       inkscape:export-xdpi="90"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-       id="rect2703"
-       width="17.605364"
-       height="11.5"
-       x="389.72168"
-       y="294.06757" />
-    <text
-       inkscape:export-ydpi="90"
-       inkscape:export-xdpi="90"
-       inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-       sodipodi:linespacing="100%"
-       id="text2705"
-       y="302.06757"
-       x="391.4032"
-       style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-       xml:space="preserve"><tspan
-         sodipodi:role="line"
-         x="391.4032"
-         y="302.06757"
-         style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-         id="tspan2707">arg</tspan></text>
-  </g>
   <rect
-     y="190.48422"
-     x="709.96484"
-     height="7.665247"
-     width="44.223175"
-     id="rect2711"
-     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2745"
+     width="130.09683"
+     height="60.31007"
+     x="599.90314"
+     y="349.68994"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      xml:space="preserve"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="712.84399"
-     y="196.3103"
-     id="text2713"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="603.40314"
+     y="401.68994"
+     id="text2747"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
-       id="tspan2715"
+       y="401.68994"
+       x="603.40314"
+       id="tspan2749"
+       sodipodi:role="line">ProcDispatcher</tspan></text>
+  <rect
+     style="opacity:0.5;fill:url(#Strips1_2);fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+     id="rect2759"
+     width="47.311901"
+     height="90.143509"
+     x="678.38611"
+     y="289.66446"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     inkscape:export-xdpi="90"
+     inkscape:export-ydpi="90" />
+  <text
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     sodipodi:linespacing="100%"
+     id="text5120"
+     y="313.22919"
+     x="683.56622"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     xml:space="preserve"><tspan
+       sodipodi:role="line"
+       x="683.56622"
+       y="313.22919"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       y="196.3103"
-       x="712.84399"
-       sodipodi:role="line">memento</tspan></text>
+       id="tspan5122">Handling</tspan><tspan
+       sodipodi:role="line"
+       x="683.56622"
+       y="321.22919"
+       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+       id="tspan5129">Pattern</tspan></text>
+  <g
+     transform="translate(170.49403,-294.55106)"
+     id="g16820">
+    <g
+       style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+       id="g16822">
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 399.47083,444.5513 L 469.47083,444.5513 L 609.47083,464.5513 L 499.47083,464.5513 L 399.47083,444.5513 z"
+         id="path16824" />
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 469.47083,444.5513 L 469.47083,464.5513 L 609.47083,494.5513 L 609.47083,464.5513 L 469.47083,444.5513 z"
+         id="path16826" />
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 469.47083,464.5513 L 399.47083,464.5513 L 499.47083,494.5513 L 609.47083,494.5513 L 469.47083,464.5513 z"
+         id="path16828" />
+      <path
+         sodipodi:nodetypes="ccccc"
+         d="M 399.47083,464.5513 L 399.47083,444.5513 L 499.97083,465.07898 L 499.47083,494.5513 L 399.47083,464.5513 z"
+         id="path16830" />
+    </g>
+  </g>
+  <rect
+     inkscape:export-ydpi="90"
+     inkscape:export-xdpi="90"
+     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+     y="170.34924"
+     x="669.96484"
+     height="29.556213"
+     width="110.03513"
+     id="rect16834"
+     style="opacity:1;fill:#f7fceb;fill-opacity:0.71532845;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.50000024000000010;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate" />
   <path
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1"
-     d="M 624.69635,289.35729 L 678.27961,289.35729 L 728.68457,221.69775 C 746.28171,201.94355 685.65518,207.38 697.77225,201.06082 L 709.84027,194.08163"
+     d="M 614.69635,289.04723 L 668.27961,289.04723 L 718.68457,221.38769 C 736.28171,201.63349 675.65518,207.06994 687.77225,200.75076 L 699.84027,193.77157"
      id="path2739"
      sodipodi:nodetypes="ccccz"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
@@ -1795,60 +1704,150 @@
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      sodipodi:nodetypes="ccccc"
      id="path5326"
-     d="M 666.41565,276.27581 L 671.91565,276.27581 L 712.42112,225.23328 C 730.01826,205.12552 674.34148,211.62265 683.27656,203.18215 L 702.41565,183.82859"
+     d="M 656.41565,275.96575 L 661.91565,275.96575 L 702.42112,224.92322 C 720.01826,204.81546 664.34148,211.31259 673.27656,202.87209 L 692.41565,183.51853"
      style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;marker-end:url(#Arrow1Mend);stroke-opacity:1" />
   <rect
-     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#6c6c6c;stroke-width:1.5;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-     id="rect2745"
-     width="130.09683"
-     height="60.31007"
-     x="609.90314"
-     y="350"
+     y="190.17416"
+     x="699.96484"
+     height="7.665247"
+     width="44.223175"
+     id="rect2711"
+     style="fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90" />
   <text
      xml:space="preserve"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:100%;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     x="613.40314"
-     y="402"
-     id="text2747"
+     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+     x="702.84399"
+     y="196.00024"
+     id="text2713"
      sodipodi:linespacing="100%"
      inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
      inkscape:export-xdpi="90"
      inkscape:export-ydpi="90"><tspan
-       y="402"
-       x="613.40314"
-       id="tspan2749"
-       sodipodi:role="line">ProcDispatcher</tspan></text>
-  <rect
-     style="opacity:0.5;fill:url(#Strips1_2);fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994000000003;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
-     id="rect2759"
-     width="47.311901"
-     height="90.143509"
-     x="688.38611"
-     y="289.97452"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     inkscape:export-xdpi="90"
-     inkscape:export-ydpi="90" />
-  <text
-     inkscape:export-ydpi="90"
-     inkscape:export-xdpi="90"
-     inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
-     sodipodi:linespacing="100%"
-     id="text5120"
-     y="313.53925"
-     x="693.56622"
-     style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
-     xml:space="preserve"><tspan
-       sodipodi:role="line"
-       x="693.56622"
-       y="313.53925"
+       id="tspan2715"
        style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       id="tspan5122">Handling</tspan><tspan
-       sodipodi:role="line"
-       x="693.56622"
-       y="321.53925"
-       style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
-       id="tspan5129">Pattern</tspan></text>
+       y="196.00024"
+       x="702.84399"
+       sodipodi:role="line">memento</tspan></text>
+  <g
+     id="g3428">
+    <g
+       transform="translate(306.6378,-120.06732)"
+       id="g2680">
+      <rect
+         inkscape:export-ydpi="90"
+         inkscape:export-xdpi="90"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+         id="rect2674"
+         width="17.605364"
+         height="11.5"
+         x="389.72168"
+         y="294.06757" />
+      <text
+         inkscape:export-ydpi="90"
+         inkscape:export-xdpi="90"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         sodipodi:linespacing="100%"
+         id="text2676"
+         y="302.06757"
+         x="391.4032"
+         style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+         xml:space="preserve"><tspan
+           sodipodi:role="line"
+           x="391.4032"
+           y="302.06757"
+           style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+           id="tspan2678">arg</tspan></text>
+    </g>
+    <g
+       id="g2685"
+       transform="translate(327.10734,-120.06732)">
+      <rect
+         y="294.06757"
+         x="389.72168"
+         height="11.5"
+         width="17.605364"
+         id="rect2687"
+         style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         inkscape:export-xdpi="90"
+         inkscape:export-ydpi="90" />
+      <text
+         xml:space="preserve"
+         style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+         x="391.4032"
+         y="302.06757"
+         id="text2689"
+         sodipodi:linespacing="100%"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         inkscape:export-xdpi="90"
+         inkscape:export-ydpi="90"><tspan
+           id="tspan2691"
+           style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+           y="302.06757"
+           x="391.4032"
+           sodipodi:role="line">arg</tspan></text>
+    </g>
+    <g
+       transform="translate(347.10734,-120.06732)"
+       id="g2693">
+      <rect
+         inkscape:export-ydpi="90"
+         inkscape:export-xdpi="90"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+         id="rect2695"
+         width="17.605364"
+         height="11.5"
+         x="389.72168"
+         y="294.06757" />
+      <text
+         inkscape:export-ydpi="90"
+         inkscape:export-xdpi="90"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         sodipodi:linespacing="100%"
+         id="text2697"
+         y="302.06757"
+         x="391.4032"
+         style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+         xml:space="preserve"><tspan
+           sodipodi:role="line"
+           x="391.4032"
+           y="302.06757"
+           style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+           id="tspan2699">arg</tspan></text>
+    </g>
+    <g
+       id="g2701"
+       transform="translate(367.08311,-120.06732)">
+      <rect
+         y="294.06757"
+         x="389.72168"
+         height="11.5"
+         width="17.605364"
+         id="rect2703"
+         style="opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:0.99999994;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         inkscape:export-xdpi="90"
+         inkscape:export-ydpi="90" />
+      <text
+         xml:space="preserve"
+         style="font-size:14px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;opacity:1;fill:none;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;marker:none;marker-start:none;marker-mid:none;marker-end:none;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Bitstream Vera Sans"
+         x="391.4032"
+         y="302.06757"
+         id="text2705"
+         sodipodi:linespacing="100%"
+         inkscape:export-filename="/home/hiv/devel/lumi/wiki/draw/PlayerArch1.png"
+         inkscape:export-xdpi="90"
+         inkscape:export-ydpi="90"><tspan
+           id="tspan2707"
+           style="font-size:8px;font-style:oblique;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:100%;writing-mode:lr-tb;text-anchor:start;font-family:Bitstream Vera Sans"
+           y="302.06757"
+           x="391.4032"
+           sodipodi:role="line">arg</tspan></text>
+    </g>
+  </g>
 </svg>
diff --git a/src/lib/error.hpp b/src/lib/error.hpp
index ac089518c..b17d808f8 100644
--- a/src/lib/error.hpp
+++ b/src/lib/error.hpp
@@ -50,7 +50,7 @@ namespace lumiera {
     {
     public:
       Error (string description="", const char* id=LUMIERA_ERROR_EXCEPTION) throw();
-      Error (std::exception& cause,
+      Error (std::exception const& cause,
              string description="", const char* id=LUMIERA_ERROR_EXCEPTION) throw();
       
       Error (const Error&) throw();
@@ -87,7 +87,7 @@ namespace lumiera {
       mutable string what_;  ///< buffer for generating the detailed description on demand
       const string cause_;   ///< description of first exception encountered in the chain
 
-      static const string extractCauseMsg (const std::exception&)  throw();
+      static const string extractCauseMsg (std::exception const&)  throw();
     };
   
     
diff --git a/src/lib/exception.cpp b/src/lib/exception.cpp
index 879862982..a86d796ea 100644
--- a/src/lib/exception.cpp
+++ b/src/lib/exception.cpp
@@ -87,7 +87,7 @@ namespace lumiera {
   }
   
   
-  Error::Error (std::exception& cause, 
+  Error::Error (std::exception const& cause, 
                 string description, const char* id) throw()
     : std::exception (),
       id_ (error::default_or_given (id)),
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index d18aefbf1..b3af1080d 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -42,6 +42,7 @@
 #include "lib/meta/function-closure.hpp"
 #include "lib/meta/function-erasure.hpp"
 #include "lib/meta/tuple.hpp"
+#include "lib/format.hpp"
 #include "lib/util.hpp"
 
 //#include <tr1/memory>
@@ -133,7 +134,7 @@ namespace control {
       ostream&
       dump (ostream& output)  const
         {
-          return BASE::dump (output << element() << ',');
+          return BASE::dump (output << util::str (element()) << ',');
         }
       
       friend bool
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index fd166417d..89ffcb5c9 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -224,14 +224,23 @@ namespace control {
   void
   Command::undo ()
   {
-    exec (getDefaultHandlingPattern().howtoUNDO());
+    HandlingPattern const& defaultPattern
+      = HandlingPattern::get (getDefaultHandlingPattern()); 
+    exec (defaultPattern.howtoUNDO());
   }
   
   
   void
   Command::exec (HandlingPattern const& execPattern)
   {
-    execPattern.invoke (*this);
+    execPattern (*this);
+  }
+  
+  
+  void
+  Command::exec (HandlingPattern::ID pattID)
+  {
+    HandlingPattern::get(pattID) (*this);
   }
   
   
@@ -242,13 +251,20 @@ namespace control {
   }
   
   
-  HandlingPattern const&
+  HandlingPattern::ID
   Command::getDefaultHandlingPattern()  const
   {
     UNIMPLEMENTED ("manage the default command handling pattern");
   }
   
   
+  HandlingPattern::ID
+  Command::setHandlingPattern (HandlingPattern::ID pattID)
+  {
+    UNIMPLEMENTED ("manage handling patterns in general");
+  }
+  
+  
   template<typename TYPES>
   void
   Command::bindArg (Tuple<TYPES> const& args)
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 2dae7896b..bf12734e2 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -39,6 +39,7 @@
 #include "proc/control/command-binding.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
+#include "proc/control/handling-pattern.hpp"
 #include "lib/bool-checkable.hpp"
 #include "lib/handle.hpp"
 
@@ -64,7 +65,6 @@ namespace control {
   
   class CommandDef;
   class CommandImpl;
-  class HandlingPattern;
   
   
   /**
@@ -97,10 +97,16 @@ namespace control {
        *         necessary to get this command invoked properly
        */
       void exec (HandlingPattern const& execPattern);
+      void exec (HandlingPattern::ID);
       
       void execSync ();
       
-      HandlingPattern const& getDefaultHandlingPattern()  const;
+      /** @return ID of the execution pattern used by operator() */
+      HandlingPattern::ID getDefaultHandlingPattern()  const;
+      
+      /** define a handling pattern to be used by default
+       *  @return ID of the currently defined default pattern */
+      HandlingPattern::ID setHandlingPattern (HandlingPattern::ID);
       
       
       
diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index bb8987ad9..cef91d3e0 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -23,12 +23,24 @@
 
 
 #include "proc/control/handling-pattern.hpp"
+#include "proc/control/command.hpp"
+
+#include "include/symbol.hpp"
+#include "include/logging.h"
+#include "lib/util.hpp"
 //#include "proc/mobject/mobject-ref.hpp"
 //#include "proc/mobject/mobject.hpp"
 //#include "proc/mobject/placement.hpp"
 
-//#include <boost/format.hpp>
-//using boost::str;
+#include <boost/format.hpp>
+
+
+using boost::str;
+using boost::format;
+using namespace lumiera;
+using util::cStr;
+using util::isnil;
+
 
 namespace control {
   
@@ -39,8 +51,87 @@ namespace control {
     UNIMPLEMENTED ("Factory for handling patterns");
   }
   
+
+  /** @note: does error handling, but delegates the actual
+   *         execution to the protected (subclass) member */
+  ExecResult
+  HandlingPattern::operator() (Command& command)  const
+  {
+    TRACE (proc_dbg, "invoking %s...", cStr(command));
+    static format err_pre ("Error state detected, %s *NOT* invoked.");
+    static format err_post ("Error state after %s invocation.");
+    static format err_fatal ("Execution of %s raised unknown error.");
+    try
+      {
+        Symbol errID_pre = lumiera_error();
+        if (errID_pre)
+          return ExecResult (error::Logic (str (err_pre % command), errID_pre));
+        
+        // Execute the command
+        perform (command);
+        
+        Symbol errID = lumiera_error();
+        if (errID)
+          return ExecResult (error::State (str (err_post % command),errID));
+        else
+          return ExecResult();
+      }
+    
+    
+    catch (lumiera::Error& problem)
+      {
+        Symbol errID = lumiera_error();
+        WARN (command, "Invocation of %s failed: %s", cStr(command), problem.what());
+        TRACE (proc_dbg, "Error flag was: %s", errID);
+        return ExecResult (problem);
+      }
+    catch (std::exception& library_problem)
+      {
+        Symbol errID = lumiera_error();
+        WARN (command, "Invocation of %s failed: %s", cStr(command), library_problem.what());
+        TRACE (proc_dbg, "Error flag was: %s", errID);
+        return ExecResult (error::External (library_problem));
+      }
+    catch (...)
+      {
+        Symbol errID = lumiera_error();
+        ERROR (command, "Invocation of %s failed with unknown exception; error flag is: %s", cStr(command), errID);
+        throw error::Fatal (str (err_fatal % command), errID);
+      }
+  }
   
-  ///////////////////////////////////////////////////////////////////////TODO: is this implementation file actually required??
   
+  HandlingPattern const&
+  HandlingPattern::howtoUNDO()  const
+  {
+    return defineUNDO();
+  }
+  
+  
+  
+  /* ====== execution result state object ======= */
+  
+  
+  /** @note we just grab an retain the error message.
+   *  @todo rather keep the exception object around. */
+  ExecResult::ExecResult (lumiera::Error const& problem)
+    : log_(problem.what())
+  { }
+  
+  
+  bool
+  ExecResult::isValid() const
+  {
+    return isnil(log_);
+  }
+  
+  
+  void
+  ExecResult::maybeThrow() const
+  {
+    if (!isnil (log_))
+      throw error::Logic ("Command execution failed: "+log_);
+  }
+      
   
 } // namespace control
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 1210b5be7..775fc7bb2 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -36,14 +36,17 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
+#include "lib/bool-checkable.hpp"
 //#include "include/symbol.hpp"
 
 //#include <tr1/memory>
+#include <string>
 
 
 
 namespace control {
   
+  using std::string;
 //  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
@@ -51,6 +54,25 @@ namespace control {
   class Command;
   
   
+  /**
+   * @todo Type-comment
+   */
+  class ExecResult
+    : public lib::BoolCheckable<ExecResult>
+    {
+      const string log_;
+      
+    public:
+      bool isValid() const;
+      void maybeThrow() const;
+      
+    protected:
+      ExecResult () { }                   ///< default: command executed successfully
+      ExecResult (lumiera::Error const&); ///< this result marks a failed execution
+      
+      friend class HandlingPattern;
+    };
+  
   /**
    * @todo Type-comment
    */
@@ -70,9 +92,22 @@ namespace control {
       
       virtual ~HandlingPattern() {}
       
-      virtual void invoke (Command& command)  const  =0;
+      /** main functionality: invoke a command, detect errors.
+       *  @return ExecResult object, which might later be used to 
+       *          detect errors on execution */
+      ExecResult operator() (Command& command)  const;
+      
+      /** @return HandlingPatter describing how the UNDO operation is to be performed */
+      HandlingPattern const& howtoUNDO()  const;
+      
+      
+      
+    protected:
+      
+      virtual void perform (Command& command)  const  =0;
+      
+      virtual HandlingPattern const& defineUNDO()  const  =0;
       
-      virtual HandlingPattern const& howtoUNDO()  const  =0;
       
     };
   ////////////////TODO currently just fleshing  out the API....
diff --git a/src/tool/try.cpp b/src/tool/try.cpp
index de0d698f9..de206c43e 100644
--- a/src/tool/try.cpp
+++ b/src/tool/try.cpp
@@ -16,6 +16,8 @@
 
 
 #include <nobug.h>
+#define LUMIERA_LOGGING_CXX
+#include "include/logging.h"
 //#include "include/nobugcfg.h"
 #include "lib/bool-checkable.hpp"
 
@@ -23,6 +25,7 @@
 //#include <typeinfo>
 #include <boost/format.hpp>
 #include <cstdlib>
+#include <cstdio>
 
 
 using std::rand;
@@ -73,6 +76,8 @@ main (int, char**) //(int argc, char* argv[])
       }
     cout << "size=" << sizeof(TestIt1) <<"\n";
     
+    char* horror = 0;
+    ERROR (all, "note: %s is a horrible thing", horror);
     
     cout <<  "\n.gulp.\n";
     
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
index e1fd8c3da..5b6e18be6 100644
--- a/tests/components/proc/control/command-use2-test.cpp
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -196,7 +196,9 @@ namespace test    {
           
           blowUp_ = true;
           string current = command2::check_.str();
-          VERIFY_ERROR( EXTERNAL, com.exec(HandlingPattern::get(SYNC_THROW)) );
+          HandlingPattern const& doThrow = HandlingPattern::get(HandlingPattern::SYNC_THROW);
+          
+          VERIFY_ERROR( EXTERNAL, com.exec (doThrow) );
           ASSERT (command2::check_.str() == current);
           
           // we can achieve the same effect,

From 327cbc822a977ae42f93c45315b4fee86c431757 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 2 Aug 2009 20:55:43 +0200
Subject: [PATCH 229/368] WIP extended binding and invocation to support the
 convenience shortcuts

---
 src/proc/control/argument-tuple-accept.hpp    | 230 ++++++++++++++++--
 src/proc/control/command-argument-holder.hpp  |   8 +-
 src/proc/control/command-binding.hpp          |  42 ++--
 src/proc/control/command-def.hpp              |   6 +-
 src/proc/control/command-invocation.hpp       | 162 ++++++++++++
 src/proc/control/command.hpp                  |  16 +-
 .../control/argument-tuple-accept-test.cpp    |  12 +-
 7 files changed, 418 insertions(+), 58 deletions(-)
 create mode 100644 src/proc/control/command-invocation.hpp

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index b7a309525..4018da73a 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -22,7 +22,7 @@
 
 
 /** @file argument-tuple-accept.hpp
- ** The AcceptArgumentTuple template allows to mix in a \c bind(...) function.
+ ** The AcceptArgumentBinding template allows to mix in a \c bind(...) function.
  ** Thereby, the correct number and types of arguments is derived according to
  ** the function signature given as template parameter. This helper template is
  ** used for the ArgumentHolder and generally for binding the arguments when
@@ -53,8 +53,7 @@ namespace control {
     using namespace lumiera::typelist;
     
     
-    /** @internal mix in a \c bind() function
-     */
+    /** @internal mix in a function operator */
     template< class TAR, class BA, class RET
             , typename TYPES
             >
@@ -69,7 +68,7 @@ namespace control {
       : BA
       {
         RET
-        bind ()
+        operator() ()
           {
             return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
           }
@@ -80,6 +79,192 @@ namespace control {
             , typename T1
             >                                                                        //_______________________________
     struct AcceptArgs<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
+      : BA
+      {
+        RET
+        operator() (T1 a1)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            , typename T9
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+          }
+      };
+    
+    
+    
+    /** @internal mix in a \c bind() function
+     */
+    template< class TAR, class BA, class RET
+            , typename TYPES
+            >
+    struct AcceptBind ;
+    
+    
+    /* specialisations for 0...9 Arguments.... */
+    
+    template< class TAR, class BA, class RET
+            >                                                                        //____________________________________
+    struct AcceptBind<TAR,BA,RET, Types<> >                                         ///< Accept dummy binding (0 Arguments)
+      : BA
+      {
+        RET
+        bind ()
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            >                                                                        //_______________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
       : BA
       {
         RET
@@ -94,7 +279,7 @@ namespace control {
             , typename T1
             , typename T2
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
       : BA
       {
         RET
@@ -110,7 +295,7 @@ namespace control {
             , typename T2
             , typename T3
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
       : BA
       {
         RET
@@ -127,7 +312,7 @@ namespace control {
             , typename T3
             , typename T4
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
       : BA
       {
         RET
@@ -145,7 +330,7 @@ namespace control {
             , typename T4
             , typename T5
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
       : BA
       {
         RET
@@ -164,7 +349,7 @@ namespace control {
             , typename T5
             , typename T6
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
       : BA
       {
         RET
@@ -184,7 +369,7 @@ namespace control {
             , typename T6
             , typename T7
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
       : BA
       {
         RET
@@ -205,7 +390,7 @@ namespace control {
             , typename T7
             , typename T8
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
       : BA
       {
         RET
@@ -227,7 +412,7 @@ namespace control {
             , typename T8
             , typename T9
             >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
       : BA
       {
         RET
@@ -261,19 +446,30 @@ namespace control {
    *  @param BASE the base class for inheritance chaining
    */
   template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
-  class AcceptArgumentTuple
-    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
+  class AcceptArgumentBinding
+    : public bind_arg::AcceptBind<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
                                           , typename bind_arg::_Type<SIG>::Args>   
     {
     };
   
     
-  /** Variation of AcceptArgumentTuple, allowing to control the return type 
+  /** Variation of AcceptArgumentBinding, allowing to control the return type 
    *  of the generated \c bind(...) functions independently from SIG
    */
   template<typename RET, typename SIG, class TAR, class BASE =bind_arg::Dummy>
-  class AcceptArgumentTupleRet
-    : public bind_arg::AcceptArgs<TAR,BASE, RET
+  class AcceptArgumentBindingRet
+    : public bind_arg::AcceptBind<TAR,BASE, RET
+                                          , typename bind_arg::_Type<SIG>::Args>
+    {
+    };
+  
+  
+  /** This variation of AcceptArgumentBindingRet mixes in a function call operator
+   *  according to the specified signature SIG
+   */
+  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
+  class AcceptArgumentTuple
+    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
                                           , typename bind_arg::_Type<SIG>::Args>
     {
     };
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 50c784782..1e627c9ca 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -103,10 +103,10 @@ namespace control {
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
-    : public AcceptArgumentTuple< SIG                      // to derive the desired bind(..) signature
-                                , ArgumentHolder<SIG,MEM>  // target class providing the implementation
-                                , CmdClosure               // base class to inherit from
-                                > 
+    : public AcceptArgumentBinding< SIG                      // to derive the desired bind(..) signature
+                                  , ArgumentHolder<SIG,MEM>  // target class providing the implementation
+                                  , CmdClosure               // base class to inherit from
+                                  > 
     {
       /** copy construction allowed(but no assignment)*/
       ArgumentHolder& operator= (ArgumentHolder const&);
diff --git a/src/proc/control/command-binding.hpp b/src/proc/control/command-binding.hpp
index 79ae2f0c8..35b81b575 100644
--- a/src/proc/control/command-binding.hpp
+++ b/src/proc/control/command-binding.hpp
@@ -80,28 +80,28 @@ namespace com { ///< Proc-Layer command implementation details
      *  if the number and type of arguments of the stored operation function
      *  within the command matches the given argument pattern
      */
-    void
+    TAR&
     bind ()
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple());
+        return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple());
       }
     
     
     template<typename T1>
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1)                                                                         ///< Accept binding with 1 Argument
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
       }
     
     
     template< typename T1
             , typename T2
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2)                                                                  ///< Accept binding for 2 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
       }
     
     
@@ -109,10 +109,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T2
             , typename T3
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3)                                                           ///< Accept binding for 3 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
       }
     
     
@@ -121,10 +121,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T3
             , typename T4
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3, T4 a4)                                                    ///< Accept binding for 4 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
       }
     
     
@@ -134,10 +134,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T4
             , typename T5
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)                                             ///< Accept binding for 5 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
       }
     
     
@@ -148,10 +148,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T5
             , typename T6
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)                                      ///< Accept binding for 6 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
       }
     
     
@@ -163,10 +163,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T6
             , typename T7
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)                               ///< Accept binding for 7 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
       }
     
     
@@ -179,10 +179,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T7
             , typename T8
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)                        ///< Accept binding for 8 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
       }
     
     
@@ -196,10 +196,10 @@ namespace com { ///< Proc-Layer command implementation details
             , typename T8
             , typename T9
             >
-    void                                                                                  //________________________________
+    TAR&                                                                                  //________________________________
     bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)                 ///< Accept binding for 9 Arguments
       {
-        static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
       }
     
     };
@@ -209,5 +209,5 @@ namespace com { ///< Proc-Layer command implementation details
 
   
   
-}} // namespace control
+}} // namespace control::com
 #endif
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 15f7ae7ed..ad8a17152 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -87,9 +87,9 @@ namespace control {
     
     template<typename SIG, typename MEM>
     struct UndoDefinition
-      : AcceptArgumentTupleRet< Command&, SIG               // Return type and Argument Signature of the \c bind(..) function
-                              , UndoDefinition<SIG,MEM>    //  target type (this class) providing the implementation \c bindArg(Tuple<..>) 
-                              >
+      : AcceptArgumentBindingRet< Command&, SIG               // Return type and Argument Signature of the \c bind(..) function
+                                , UndoDefinition<SIG,MEM>    //  target type (this class) providing the implementation \c bindArg(Tuple<..>) 
+                                >
       {
         typedef CommandSignature<SIG,MEM> CmdType;
         typedef typename CmdType::OperateSig CommandOperationSig;
diff --git a/src/proc/control/command-invocation.hpp b/src/proc/control/command-invocation.hpp
new file mode 100644
index 000000000..f8ab945cb
--- /dev/null
+++ b/src/proc/control/command-invocation.hpp
@@ -0,0 +1,162 @@
+/*
+  COMMAND-INVOCATION.hpp  -  shortcuts and helpers for calling Proc-Layer commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-invocation.hpp
+ ** Some additional helpers and convenience shortcuts to ease command invocation.
+ ** Especially, this header defines a set of free \c invoke(...) functions,
+ ** allowing to bind to specific arguments and then invoke through the default
+ ** HandlingPatern in a single call.
+ **
+ ** @see Command
+ ** @see CommandDef
+ ** @see command-binding.hpp
+ ** @see command-use1-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_INVOCACTION_H
+#define CONTROL_COMMAND_INVOCACTION_H
+
+//#include "pre.hpp"
+//#include "include/symbol.hpp"
+//#include "lib/meta/typelist.hpp"
+//#include "lib/meta/tuple.hpp"
+#include "proc/control/command.hpp"
+#include "proc/control/handling-pattern.hpp"
+#include "proc/control/argument-tuple-accept.hpp"
+
+//#include <tr1/memory>
+#include <tr1/functional>
+
+
+
+
+namespace control {
+  
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+  using namespace lumiera::typelist;
+  
+
+  namespace com { // define transient invoker objects, to allow for arbitrary bindings
+  
+    template<typename SIG>
+    struct _DefineBindFunc
+      {
+        typedef ExecResult SIG_Bind(int);
+      };
+  
+    
+    /** @internal transient invoker object for invoking the command based
+     *            on a function provided at compile time. Because of the
+     *            known signature, we're able to expose a precisely typed
+     *            function invocation operator.
+     */
+    template<typename SIG>
+    struct CommandInvoker
+      : AcceptArgumentTuple< typename _DefineBindFunc<SIG>::SIG_Bind
+                           , CommandInvoker<SIG>
+                           >
+      {
+        Command com_;
+
+        CommandInvoker (Command c)
+          : com_(c)
+          { }
+        
+        
+        template<typename TYPES>
+        ExecResult
+        bindArg (Tuple<TYPES> const& args)
+          {
+            com_.bindArg(args);
+            ASSERT (com_.canExec());
+            return com_();
+          }
+      };
+    
+    
+    
+    /** @internal transient invoker object, usable when the exact signature
+     *            of the command's operation isn't known at compile time.
+     *            In this case, we allow any invocation call to compile, 
+     *            but the command will reject unsuitable signatures
+     *            at runtime, when fetching the operation functor.
+     */
+    struct RuntimeCheckedCommandInvoker
+      {
+        Command com_;
+
+        RuntimeCheckedCommandInvoker (Command c)
+          : com_(c)
+          { }
+        
+        
+        template< typename T1>
+        ExecResult                                                                        //_________________________________
+        operator() (T1 a1)                                                               ///< Invoke command with 1 Argument.
+          {
+            com_.bind(a1);
+            return com_();
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                >
+        ExecResult                                                                        //_________________________________
+        operator() (T1 a1, T2 a2, T3 a3)                                                 ///< Invoke command with 3 Arguments
+          {
+            com_.bind(a1,a2,a3);
+            return com_();
+          }
+      };
+  }
+  
+  
+  
+  template<typename SIG>
+  inline
+  com::CommandInvoker<SIG>
+  invoke (SIG& operation_func)
+  {
+    Command command = Command::get ((FuncPtr)&operation_func);
+    ASSERT (command);
+    return com::CommandInvoker<SIG> (command);
+  }
+  
+  
+  inline
+  com::RuntimeCheckedCommandInvoker
+  invoke (Symbol cmdID)
+  {
+    Command command = Command::get (cmdID);
+    ASSERT (command);
+    return com::RuntimeCheckedCommandInvoker (command);
+  }
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index bf12734e2..a4674279f 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -88,18 +88,18 @@ namespace control {
       Command() { } ///< undefined command
      ~Command();
       
-      void operator() () ;
-      void undo () ;
+      ExecResult operator() () ;
+      ExecResult undo () ;
       
       
       /** core operation: invoke the command
        *  @param execPattern describes the individual steps
        *         necessary to get this command invoked properly
        */
-      void exec (HandlingPattern const& execPattern);
-      void exec (HandlingPattern::ID);
+      ExecResult exec (HandlingPattern const& execPattern);
+      ExecResult exec (HandlingPattern::ID);
       
-      void execSync ();
+      ExecResult execSync ();
       
       /** @return ID of the execution pattern used by operator() */
       HandlingPattern::ID getDefaultHandlingPattern()  const;
@@ -115,7 +115,7 @@ namespace control {
       Command& activate (CommandImpl&);
       
       template<typename TYPES>
-      void bindArg (Tuple<TYPES> const&);
+      Command& bindArg (Tuple<TYPES> const&);
       
       
       /* === diagnostics === */
@@ -142,10 +142,10 @@ namespace control {
   ////////////////TODO currently just fleshing  out the API....
   
 
-  inline void
+  inline ExecResult
   Command::operator() ()
   {
-    exec (getDefaultHandlingPattern());
+    return exec (getDefaultHandlingPattern());
   }
   
   
diff --git a/tests/components/proc/control/argument-tuple-accept-test.cpp b/tests/components/proc/control/argument-tuple-accept-test.cpp
index a1a939fee..e6ebb7bd3 100644
--- a/tests/components/proc/control/argument-tuple-accept-test.cpp
+++ b/tests/components/proc/control/argument-tuple-accept-test.cpp
@@ -57,22 +57,24 @@ namespace test    {
     struct Tup
       {
         typedef typename FunctionSignature< function<SIG> >::Args Args;
+        typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
         typedef Tuple<Args> Ty;
       };
     
     
     template<typename SIG>
     class TestClass
-      : public AcceptArgumentTuple< SIG                     // to derive the desired signature
-                                  , TestClass<SIG>          // the target class providing the implementation
-                                  , typename Tup<SIG>::Ty   // base class to inherit from
-                                  >
+      : public AcceptArgumentBinding< SIG                     // to derive the desired signature
+                                    , TestClass<SIG>          // the target class providing the implementation
+                                    , typename Tup<SIG>::Ty   // base class to inherit from
+                                    >
       {
         typedef typename Tup<SIG>::Ty ATuple;
+        typedef typename Tup<SIG>::Ret RetType;
         
       public:
         
-        void
+        RetType
         bindArg (ATuple const& tuple)
           {
             static_cast<ATuple&> (*this) = tuple;

From 853aff1228ac0ead4bec64971a853e7294a3888c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 2 Aug 2009 20:57:04 +0200
Subject: [PATCH 230/368] fixed and stubbed until it passes compiler again

---
 src/lib/util.hpp                              |  6 +--
 src/proc/control/command-registry.hpp         |  6 ---
 src/proc/control/command.cpp                  | 46 +++++++++++--------
 src/proc/control/command.hpp                  | 13 ++++++
 .../proc/control/command-use1-test.cpp        |  7 +--
 .../proc/control/command-use3-test.cpp        |  2 +-
 .../proc/control/test-dummy-commands.hpp      | 16 +++----
 7 files changed, 56 insertions(+), 40 deletions(-)

diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index ccbb23b80..a72f6c2b1 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -107,7 +107,7 @@ namespace util {
   /** shortcut for set value containment test */
   template <typename T>
   inline bool 
-  contains (std::set<T>& set, const T& val)
+  contains (std::set<T>& set, T const& val)
   {
     return set.end() != set.find (val);
   }
@@ -247,7 +247,7 @@ namespace util {
 \endverbatim
    * @see sanitised-identifier-test.cpp
    */
-  string sanitise (const string& org);
+  string sanitise (string const& org);
   
   
   
@@ -256,7 +256,7 @@ namespace util {
    *  usable for printf with objects providing to-string conversion.
    */
   inline const char* 
-  cStr (const string& org)
+  cStr (string const& org)
   {
     return org.c_str();
   }
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 3d25fd016..b82a27986 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -161,11 +161,5 @@ namespace control {
     };
   
   
-//  inline ostream& operator<< (ostream& os, Mutation const& muta) { return os << string(muta); }
-  
-  /** storage for the singleton factory used to access CommandRegistry */
-  lumiera::Singleton<CommandRegistry> CommandRegistry::instance;
-  
-  
 } // namespace control
 #endif
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 89ffcb5c9..690c51b03 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -63,6 +63,11 @@ namespace control {
   LUMIERA_ERROR_DEFINE (MISSING_MEMENTO,   "Undo functor not yet usable, because no undo state has been captured");
   
   
+  
+  /** storage for the singleton factory used to access CommandRegistry */
+  lumiera::Singleton<CommandRegistry> CommandRegistry::instance;
+  
+  
 
   Command::~Command() { }
   
@@ -81,6 +86,19 @@ namespace control {
   }
   
   
+  /** @todo this is a "nice-to-have"; it would allow to call a function as a command,
+   *        almost as if it was a normal function. But this function needs to be defined
+   *        as a command previously, together with a suitable UNDO function. Moreover
+   *        this would probably require to build an additional index; 
+   *        thus this feature is unimplemented for the time being.
+   */
+  Command
+  Command::get (FuncPtr funcP)
+  {
+    UNIMPLEMENTED ("find a command definition which was based on the given function (ptr)");
+  }
+  
+  
   Command
   Command::fetchDef (Symbol cmdID)
   {
@@ -221,33 +239,34 @@ namespace control {
   
   
   
-  void
+  ExecResult
   Command::undo ()
   {
     HandlingPattern const& defaultPattern
       = HandlingPattern::get (getDefaultHandlingPattern()); 
-    exec (defaultPattern.howtoUNDO());
+    
+    return exec (defaultPattern.howtoUNDO());
   }
   
   
-  void
+  ExecResult
   Command::exec (HandlingPattern const& execPattern)
   {
-    execPattern (*this);
+    return execPattern (*this);
   }
   
   
-  void
+  ExecResult
   Command::exec (HandlingPattern::ID pattID)
   {
-    HandlingPattern::get(pattID) (*this);
+    return HandlingPattern::get(pattID) (*this);
   }
   
   
-  void
+  ExecResult
   Command::execSync ()
   {
-    exec (HandlingPattern::get(HandlingPattern::SYNC_THROW));
+    return exec (HandlingPattern::get(HandlingPattern::SYNC_THROW));
   }
   
   
@@ -263,17 +282,6 @@ namespace control {
   {
     UNIMPLEMENTED ("manage handling patterns in general");
   }
-  
-  
-  template<typename TYPES>
-  void
-  Command::bindArg (Tuple<TYPES> const& args)
-  {
-    UNIMPLEMENTED ("create an argument-binding, with runtime type check");
-  }
-
-
-  
 
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index a4674279f..0cd713e1f 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -62,6 +62,8 @@ namespace control {
   LUMIERA_ERROR_DECLARE (INVALID_ARGUMENTS);  ///< Arguments provided for binding doesn't match stored command function parameters
 
   
+
+  typedef void* FuncPtr;
   
   class CommandDef;
   class CommandImpl;
@@ -80,6 +82,7 @@ namespace control {
     public:
       /* === command registry === */
       static Command get (Symbol cmdID);
+      static Command get (FuncPtr func);
       static bool remove (Symbol cmdID); 
       static bool  undef (Symbol cmdID);
       
@@ -149,6 +152,16 @@ namespace control {
   }
   
   
+  template<typename TYPES>
+  inline Command&
+  Command::bindArg (Tuple<TYPES> const&)
+    {
+      UNIMPLEMENTED("delegate argument binding to command-impl");
+      return *this;
+    }
+  
+  
+  
   inline bool
   operator== (Command const& c1, Command const& c2)
     {
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 60f100361..f004f7006 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -32,7 +32,7 @@
 //#include "proc/mobject/placement.hpp"
 //#include "proc/mobject/placement-index.hpp"
 //#include "proc/mobject/explicitplacement.hpp"
-#include "proc/control/command.hpp"
+#include "proc/control/command-invocation.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
 #include "lib/format.hpp"
@@ -157,11 +157,11 @@ namespace test    {
           ASSERT ( 0 == command1::check_);
 
           // the following shortcut does the same:
-          Command::invoke ("test.command1.2", 1234);
+          invoke ("test.command1.2") (1234);
           ASSERT ( 1234 == command1::check_);
           
           // another shortcut, with static type check:
-          invoke (command1::operate, 5678);
+          invoke (command1::operate) (5678);
           ASSERT ( 1234+5678 == command1::check_);
           
           com.undo();
@@ -282,6 +282,7 @@ namespace test    {
           ASSERT (Command::get("test.command1.4"));
           
           VERIFY_ERROR (INVALID_COMMAND, Command::get("miracle"));
+          VERIFY_ERROR (INVALID_COMMAND, invoke ("miracle") (1,2,3));
           
           CommandDef unbelievable ("miracle");
           ASSERT (!unbelievable);
diff --git a/tests/components/proc/control/command-use3-test.cpp b/tests/components/proc/control/command-use3-test.cpp
index 03048599c..f922c55d6 100644
--- a/tests/components/proc/control/command-use3-test.cpp
+++ b/tests/components/proc/control/command-use3-test.cpp
@@ -100,7 +100,7 @@ namespace test    {
               .captureUndo (command1::capture)
               .undoOperation (command1::undoIt);
 
-          UNIMPLEMENTED ("more elaborate command handling patterns")
+          UNIMPLEMENTED ("more elaborate command handling patterns");
           ////////////////////////////////////////////////////////////////////////////////TODO: devise tests for async, repeated and compound sequences
           
           ASSERT (cnt_inst == Command::instance_count());
diff --git a/tests/components/proc/control/test-dummy-commands.hpp b/tests/components/proc/control/test-dummy-commands.hpp
index b3a2a9c45..fe24a059a 100644
--- a/tests/components/proc/control/test-dummy-commands.hpp
+++ b/tests/components/proc/control/test-dummy-commands.hpp
@@ -86,21 +86,21 @@ namespace test    {
   
   namespace command1 { ///< test command just adding a given value
     
-    long check_ = 0;
+    static long check_ = 0;
       
-    void
+    inline void
     operate (int someVal)
     {
       check_ += someVal;
     }
     
-    long
+    inline long
     capture (int)
     {
       return check_;
     }
     
-    void
+    inline void
     undoIt (int, long oldVal)
     {
       check_ = oldVal;
@@ -117,12 +117,12 @@ namespace test    {
     using lumiera::error::External;
     
     
-    ostringstream check_;
+    static ostringstream check_;
       
     
     typedef function<string()> FunS;
     
-    void
+    inline void
     operate (FunS func, bool fail)
     {
       if (fail) throw External("simulated exception");
@@ -130,13 +130,13 @@ namespace test    {
       check_ << func();
     }
     
-    string
+    inline string
     capture (FunS, bool)
     {
       return check_.str();
     }
     
-    void
+    inline void
     undoIt (FunS, bool fail, string previousProtocol)
     {
       if (fail) throw External("simulated exception in UNDO");

From b3cd834d9e252c42ce533dc31e44c7bda007e454 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 3 Aug 2009 17:59:13 +0200
Subject: [PATCH 231/368] try to get generated code a bit more readable

---
 src/common/interface.h | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/common/interface.h b/src/common/interface.h
index 83d1a4e6b..d50af3233 100644
--- a/src/common/interface.h
+++ b/src/common/interface.h
@@ -169,7 +169,9 @@ LUMIERA_INTERFACE_TYPE(name, version)                   \
  * @param name name of this slot
  * @param params parentized list of parameters for the function
  */
-#define PPMPL_FOREACH_LUMIERA_INTERFACE_SLOT(ret, name, params)  ret (*name) params; lumiera_uid name##_uid;
+#define PPMPL_FOREACH_LUMIERA_INTERFACE_SLOT(ret, name, params)  \
+        ret (*name) params; \
+                             lumiera_uid name##_uid;
 
 
 /*

From 59f42c28ef6d0f3d239be8673f1e4df9aef7b84e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 3 Aug 2009 18:15:08 +0200
Subject: [PATCH 232/368] get type-id string

---
 src/lib/format.hpp | 30 ++++++++++++++++++++++--------
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/src/lib/format.hpp b/src/lib/format.hpp
index db53affcd..a7856e183 100644
--- a/src/lib/format.hpp
+++ b/src/lib/format.hpp
@@ -81,14 +81,28 @@ namespace util {
       , Symbol prefix=""      ///< prefix to prepend in case conversion is possible
       , Symbol fallback =0   /// < replacement text to show if string conversion fails
       )
-    {
-      if (can_ToString<TY>::value)
-        return string(prefix) + invoke_2string<TY>(val);
-      
-      else
-        return fallback? fallback
-                       : string("«")+typeid(val).name()+"»";
-    }
+  {
+    if (can_ToString<TY>::value)
+      return string(prefix) + invoke_2string<TY>(val);
+    
+    else
+      return fallback? fallback
+                     : tyStr(val);
+  }
+  
+  
+  /** @return a string denoting the type. */
+  template<typename TY>
+  inline string
+  tyStr (const TY* =0)
+  {
+    return string("«")+typeid(TY).name()+"»";
+  }
+  
+  template<typename TY>
+  inline string
+  tyStr (TY const& ref)
+  { return tyStr(&ref); }
   
   
 } // namespace util

From 155254dd9b69f7711964af92e54818cb80fa19fd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 3 Aug 2009 18:17:41 +0200
Subject: [PATCH 233/368] build new cmd impl object within registry

---
 src/include/logging.h                        |  1 +
 src/proc/control/command-argument-holder.hpp |  1 +
 src/proc/control/command-def.hpp             |  7 +-
 src/proc/control/command-impl.cpp            |  8 --
 src/proc/control/command-impl.hpp            | 47 +++++++++-
 src/proc/control/command-registry.hpp        | 91 ++++++++++++++++----
 src/proc/control/command.cpp                 |  5 +-
 src/proc/control/command.hpp                 |  2 +-
 8 files changed, 126 insertions(+), 36 deletions(-)

diff --git a/src/include/logging.h b/src/include/logging.h
index b48f3bdff..ad67cb300 100644
--- a/src/include/logging.h
+++ b/src/include/logging.h
@@ -85,6 +85,7 @@ NOBUG_CPP_DEFINE_FLAG_PARENT    (   mmapings_dbg,               backend_dbg);
 NOBUG_CPP_DEFINE_FLAG_PARENT    (   threads_dbg,                backend_dbg);
 /** base of debug logging for the proc layer */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (  proc_dbg,                    debugging);
+NOBUG_CPP_DEFINE_FLAG_PARENT    (   command_dbg,                proc_dbg);
 /** base of debug logging for the gui */
 NOBUG_CPP_DEFINE_FLAG_PARENT    (  gui_dbg,                     debugging);
 /** base if debug logging for the support library */
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 1e627c9ca..10daadaf9 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -192,6 +192,7 @@ namespace control {
         }
       
       
+      typedef typename CommandSignature<SIG,MEM>::OperateSig SIG_op;
       typedef typename CommandSignature<SIG,MEM>::CaptureSig SIG_cap;
       typedef typename CommandSignature<SIG,MEM>::UndoOp_Sig SIG_undo;
       
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index ad8a17152..5dac4c4d2 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -51,6 +51,7 @@
 #include "lib/error.hpp"
 #include "include/symbol.hpp"
 #include "proc/control/command.hpp"
+#include "proc/control/command-impl.hpp"                   /////TODO: any chance to get rid of this import here??
 #include "proc/control/command-registry.hpp"
 #include "proc/control/command-signature.hpp"
 #include "proc/control/command-mutation.hpp"
@@ -128,9 +129,9 @@ namespace control {
             REQUIRE (captFunctor_);
             
             CommandRegistry& registry = CommandRegistry::instance();
-            CommandImpl& completedDef = registry.newCommandImpl(operFunctor_
-                                                               ,undoFunctor_
-                                                               ,captFunctor_);
+            CommandImpl* completedDef = registry.newCommandImpl(operFunctor_
+                                                               ,captFunctor_
+                                                               ,undoFunctor_);
             prototype_.activate(completedDef);
             ENSURE (prototype_);
             return *this;
diff --git a/src/proc/control/command-impl.cpp b/src/proc/control/command-impl.cpp
index a2aed63c3..a0ab3e174 100644
--- a/src/proc/control/command-impl.cpp
+++ b/src/proc/control/command-impl.cpp
@@ -47,14 +47,6 @@ namespace control {
   
 
   /** */
-  template<typename TYPES>
-  void
-  CommandImpl::bindArg (Tuple<TYPES> const&)
-  {
-    UNIMPLEMENTED ("actually bind arguments, maybe create ArgumentHolder");
-  }
-  
-  
   void
   CommandImpl::exec (HandlingPattern const& execPattern)
   {
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index e329d6bfb..7778d0ce7 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -44,17 +44,20 @@
 
 #include "proc/control/command.hpp"
 #include "proc/control/command-mutation.hpp"
+#include "proc/control/command-argument-holder.hpp"
 #include "lib/bool-checkable.hpp"
 
 #include <boost/noncopyable.hpp>
 #include <boost/operators.hpp>
 
-//#include <tr1/memory>
-
+#include <tr1/memory>
+#include <tr1/functional>
 
 
 namespace control {
   
+  using std::tr1::function;
+  using std::tr1::shared_ptr;
 
   
   
@@ -69,8 +72,40 @@ namespace control {
       Mutation do_;
       UndoMutation undo_;
       
+      shared_ptr<CmdClosure> pClo_;
+      
+      
+      template<typename ARG>
+      struct _Type
+        {
+          typedef typename ARG::SIG_op SIG_op;
+          typedef typename ARG::SIG_cap SIG_cap;
+          typedef typename ARG::SIG_undo SIG_undo;
+          
+          typedef function<SIG_op> Func_op;
+          typedef function<SIG_cap> Func_cap;
+          typedef function<SIG_undo> Func_undo;
+        };
+#define _TY(_ID_) typename _Type<ARG>::_ID_
+      
     public:
-      /* === command registry === */
+      /** build a new implementation frame, and do the initial wiring.
+       *  On the interface the specific type is discarded afterwards.
+       *  This information is still kept though, as encoded into the vtable
+       *  of the embedded FunErasure objects holding the command operation
+       *  and undo functors, and the vtable of the embedded CmdClosure */
+      template<typename ARG>
+      CommandImpl (shared_ptr<ARG> pArgHolder
+                  ,_TY (Func_op) const& operFunctor
+                  ,_TY (Func_cap) const& captFunctor
+                  ,_TY (Func_undo) const& undoFunctor
+                  )
+        : do_(operFunctor)
+        , undo_(pArgHolder->tie (undoFunctor, captFunctor))
+        , pClo_(pArgHolder)
+        { }
+      
+#undef _TY      
       
       
      ~CommandImpl();
@@ -84,7 +119,11 @@ namespace control {
       
       
       template<typename TYPES>
-      void bindArg (Tuple<TYPES> const&);
+      void bindArg (Tuple<TYPES> const&)
+        {
+          UNIMPLEMENTED ("actually bind arguments, maybe create ArgumentHolder");
+        }
+            
       
       
       /* === diagnostics === */
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index b82a27986..4792392da 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -41,20 +41,26 @@
 #include "lib/error.hpp"
 #include "lib/singleton.hpp"
 #include "lib/sync.hpp"
+#include "lib/format.hpp"
+#include "include/logging.h"
 //#include "lib/bool-checkable.hpp"
 
 #include "proc/control/command.hpp"
+#include "proc/control/command-signature.hpp"
+#include "proc/control/command-argument-holder.hpp"
 //#include "proc/control/memento-tie.hpp"
 
+#include <tr1/memory>
 //#include <iostream>
-//#include <string>
+#include <string>
 
 
 
 namespace control {
   
+  using std::tr1::shared_ptr;
 //  using std::ostream;
-//  using std::string;
+  using std::string;
   
   
   
@@ -121,41 +127,90 @@ namespace control {
         }
       
       
-      /** set up a new command implementation frame */
+      /** set up a new command implementation frame
+       *  @return pointer to a newly created CommandImpl, allocated 
+       *          through the registry. The caller is responsible for
+       *          deallocating this frame by calling #killCommandImpl 
+       */
       template< typename SIG_OPER    ///< signature of the command operation
-              , typename SIG_UNDO    ///< signature to undo the command
               , typename SIG_CAPT    ///< signature for capturing undo state
+              , typename SIG_UNDO    ///< signature to undo the command
               >
-      CommandImpl&
-      newCommandImpl (function<SIG_OPER>& operFunctor_
-                     ,function<SIG_UNDO>& undoFunctor_
-                     ,function<SIG_CAPT>& captFunctor_)
+      CommandImpl*
+      newCommandImpl (function<SIG_OPER>& operFunctor
+                     ,function<SIG_CAPT>& captFunctor
+                     ,function<SIG_UNDO>& undoFunctor)
         {
           Lock sync(this);
-          UNIMPLEMENTED ("set up a new impl instance located within the instance table");
-        }
+          
+          // derive the storage type necessary
+          // to hold the command arguments and UNDO memento
+          typedef typename UndoSignature<SIG_CAPT>::Memento Mem;
+          typedef ArgumentHolder<SIG_OPER,Mem> Arguments;
+          
+          shared_ptr<Arguments> pArg ( new (allocateSlot<Arguments>()) Arguments()
+                                     , &kill<Arguments>
+                                     );
+          void* implStorage = 0;
+          try
+            {
+              implStorage = allocateSlot<CommandImpl>();
+              ASSERT (implStorage);
+              
+              return new(implStorage) CommandImpl (pArg, operFunctor,captFunctor,undoFunctor);
+            }
+          catch(...)
+            {
+              if (implStorage)
+                releaseSlot<CommandImpl> (implStorage);
+              throw;
+        }   }
       
       
-      /** discard an command implementation frame */
+      /** delete the command implementation and free the corresponding allocation */
+      static void killCommandImpl (CommandImpl* entry) { kill(entry); }
+      
+      
+      template<class IMP>
       static void
-      killCommandImpl (CommandImpl* entry)
+      kill (IMP* entry)
         {
                                   ///////////////////////////////////////////////TODO: clean behaviour while in App shutdown (Ticket #196)
-          instance().removeImpl(entry);
+          instance().destroyImpl(entry);
         }
       
       
     private:
-      CommandImpl*
-      createImpl ()
+      template<class IMP>
+      void*
+      allocateSlot ()
         {
-          ///////////////////////////////TODO: still necessary?
+          TODO ("redirect to the corresponding pool allocator");
         }
       
+      template<class IMP>
       void
-      removeImpl (CommandImpl* entry)
+      releaseSlot (void* entry)
         {
-          UNIMPLEMENTED ("remove entry from instance table");
+          TODO ("redirect to the corresponding pool allocator");
+        }
+      
+      
+      template<class IMP>
+      void
+      destroyImpl (IMP* entry)
+        {
+          if (!entry) return;
+          try
+            {
+              entry->~IMP();
+            }
+          catch(...)
+            {
+              WARN (command_dbg, "dtor of %s failed: %s", util::tyStr(entry).c_str()
+                                                        , lumiera_error() );
+            }
+          releaseSlot<IMP> (entry);
         }
       
     };
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 690c51b03..fad9cd19d 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -118,14 +118,15 @@ namespace control {
    *  @throw std::bad_alloc, in which case
    *         CommandRegistry::killCommandImpl is invoked */
   Command&
-  Command::activate (CommandImpl& implFrame)
+  Command::activate (CommandImpl* implFrame)
   {
     static format fmt("Command \"%s\" already defined");
+    REQUIRE (implFrame);
     
     if (this->isValid())
       throw error::Logic (str (fmt % *this), LUMIERA_ERROR_DUPLICATE_COMMAND);
           
-    _Handle::activate (&implFrame, CommandRegistry::killCommandImpl);
+    _Handle::activate (implFrame, CommandRegistry::killCommandImpl);
             
     INFO (command, "Command \"%s\" defined OK", cStr(*this));
     return *this;
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 0cd713e1f..51b7c57a9 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -115,7 +115,7 @@ namespace control {
       
       /* === command lifecycle === */
       
-      Command& activate (CommandImpl&);
+      Command& activate (CommandImpl*);
       
       template<typename TYPES>
       Command& bindArg (Tuple<TYPES> const&);

From efd6e99c990047f16cf169556c729681c3c9dd3f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 4 Aug 2009 01:30:50 +0200
Subject: [PATCH 234/368] first shot at solving the problem how to bind later
 on

---
 src/proc/control/argument-tuple-accept.hpp | 78 ++++++++++++++++++++--
 1 file changed, 71 insertions(+), 7 deletions(-)

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 4018da73a..80cc94f9b 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -430,16 +430,40 @@ namespace control {
         typedef typename FunctionSignature< function<SIG> >::Args Args;
         typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
         typedef Tuple<Args> ArgTuple;
+        typedef SIG Sig;
+      };
+    
+    template<typename TYPES>
+    struct _Type<Tuple<TYPES> >
+      {
+        typedef TYPES Args;
+        typedef void  Ret;
+        typedef Tuple<TYPES> ArgTuple;
+        typedef typename FunctionTypedef<void, TYPES>::Sig Sig;
       };
   
     struct Dummy {}; 
     
     
-  } // (END) impl details
+  } // (END) impl details (bind_arg)
   
   
   
   
+  /** Helper Template for building a Functor or function-like class:
+   *  Mix in a function call operator, which mimics the specified signature SIG .
+   *  This template is to be used as a base class to inherit the target type TAR from;
+   *  this target type is assumed to provide a function \bindArg(Tuple<TYPES..>) --
+   *  where \c TYPES... is the sequence of types found in the provided Signature SIG.
+   */
+  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
+  class AcceptArgumentTuple
+    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
+                                          , typename bind_arg::_Type<SIG>::Args>
+    {
+    };
+  
+  
   /** Helper Template for Proc-Layer control::Command : mix in a \c bind(...) function
    *  @param SIG  function signature to mimic (regarding the arguments and return type)
    *  @param TAR  the target class providing a function \c bindArg(Tuple<Types<T1...> >)
@@ -464,17 +488,57 @@ namespace control {
     };
   
   
-  /** This variation of AcceptArgumentBindingRet mixes in a function call operator
-   *  according to the specified signature SIG
+  
+  /** 
+   * Adapter interface for invoking an argument binding (e.g. as defined through
+   * AcceptArgumentBinding) \em without the need to disclose the concrete type
+   * actually accepting the bind call. This is an application of the "type erasure"
+   * pattern; in order to use it
+   *  - the concrete type accepting the \bind(..) call need to have a vtable,
+   *    so it can be re-discovered by dynamic_cast
+   *  - moreover, the concrete type must inherit from
+   *  - at the call site, only a reference to the adapter interface is exposed.
    */
-  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
-  class AcceptArgumentTuple
-    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
-                                          , typename bind_arg::_Type<SIG>::Args>
+  class ArgumentReceiver;
+  
+  template<typename SIG>
+  class TypedArgumentReceiver;
+  
+  
+  class ArgumentReceiver
     {
+    public:
+      virtual ~ArgumentReceiver() {}
+     
+      template<typename TUP>
+      void
+      bindArg (TUP const& args)
+        {
+          typedef typename bind_arg::_Type<TUP>::Sig Sig;
+          typedef TypedArgumentReceiver<Sig> Receiver;
+          
+          Receiver* dest = dynamic_cast<Receiver*> (this);
+          if (!dest)
+            throw lumiera::error::Invalid("Wrong type or number of arguments");
+          
+          dest->bindArg(args);
+        }
     };
   
   
+  template<typename SIG>
+  class TypedArgumentReceiver
+    : public ArgumentReceiver
+    {
+      typedef typename bind_arg::_Type<SIG>::Args ArgTypes;
+      
+      virtual void bindArg (lumiera::typelist::Tuple<ArgTypes> const&) =0;
+    };
+  
+    
+    
+
+
   
 } // namespace control
 #endif

From b6246cbb1062e741bee43023b0dc538b259a9f01 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 4 Aug 2009 02:24:47 +0200
Subject: [PATCH 235/368] rename the operation "closeArguments", which is more
 to the point

---
 src/proc/control/command-closure.hpp                    | 6 ++++--
 src/proc/control/command-mutation.hpp                   | 2 +-
 tests/components/proc/control/command-argument-test.cpp | 6 +++---
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index b3af1080d..dce2c9e22 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -101,7 +101,9 @@ namespace control {
       
       virtual bool isValid ()   const =0;
       
-      virtual CmdFunctor bindArguments (CmdFunctor const&) =0;
+      virtual void bindArguments (Arguments&) =0;
+      
+      virtual CmdFunctor closeArguments (CmdFunctor const&) =0;
     };
   
   
@@ -208,7 +210,7 @@ namespace control {
        *         can't be const.
        */
       CmdFunctor
-      bindArguments (CmdFunctor const& unboundFunctor)
+      closeArguments (CmdFunctor const& unboundFunctor)
         {
           return CmdFunctor (TupleApplicator<SIG> (params_)
                                .bind ( unboundFunctor.getFun<SIG>()) );
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 25fa31bc5..92a5c876b 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -105,7 +105,7 @@ namespace control {
         {
           REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
           REQUIRE (func_, "Param error: not bound to a valid function");
-          func_ = cmdClosure.bindArguments(func_);
+          func_ = cmdClosure.closeArguments(func_);
           clo_ = &cmdClosure;
           return *this;
         }
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index e50751b77..ab7e8ab22 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -324,9 +324,9 @@ namespace test    {
           typedef function<void()> OpFun;
           
           // now close all the functions with the stored parameter values... 
-          OpFun bound_doItFun = args.bindArguments (CmdFunctor(doItFun)).getFun<void()>();
-          OpFun bound_undoFun = args.bindArguments (CmdFunctor(undoFun)).getFun<void()>();
-          OpFun bound_captFun = args.bindArguments (CmdFunctor(captFun)).getFun<void()>();
+          OpFun bound_doItFun = args.closeArguments (CmdFunctor(doItFun)).getFun<void()>();
+          OpFun bound_undoFun = args.closeArguments (CmdFunctor(undoFun)).getFun<void()>();
+          OpFun bound_captFun = args.closeArguments (CmdFunctor(captFun)).getFun<void()>();
           
           protocol.seekp(0);
           protocol << "START...";

From a677e2eddec009d7c524cffc6c84a3017d0eb4a9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 4 Aug 2009 02:25:50 +0200
Subject: [PATCH 236/368] second shot for implementing the binding: better the
 other way round

---
 src/proc/control/argument-tuple-accept.hpp   | 41 ++++++++------------
 src/proc/control/command-argument-holder.hpp | 16 ++++++--
 src/proc/control/command-closure.hpp         |  9 +++++
 src/proc/control/command-impl.hpp            |  5 +--
 src/proc/control/command.cpp                 | 10 +++++
 src/proc/control/command.hpp                 |  9 +++--
 6 files changed, 56 insertions(+), 34 deletions(-)

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 80cc94f9b..003a38391 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -492,47 +492,40 @@ namespace control {
   /** 
    * Adapter interface for invoking an argument binding (e.g. as defined through
    * AcceptArgumentBinding) \em without the need to disclose the concrete type
-   * actually accepting the bind call. This is an application of the "type erasure"
-   * pattern; in order to use it
-   *  - the concrete type accepting the \bind(..) call need to have a vtable,
-   *    so it can be re-discovered by dynamic_cast
-   *  - moreover, the concrete type must inherit from
-   *  - at the call site, only a reference to the adapter interface is exposed.
+   * actually accepting the bind call. This is an application of "type erasure"
    */
-  class ArgumentReceiver;
+  struct Arguments;
   
-  template<typename SIG>
-  class TypedArgumentReceiver;
+  template<typename TUP>
+  struct TypedArguments;
   
   
-  class ArgumentReceiver
+  struct Arguments
     {
-    public:
-      virtual ~ArgumentReceiver() {}
+      virtual ~Arguments() {}
      
       template<typename TUP>
-      void
-      bindArg (TUP const& args)
+      TUP const&
+      get ()
         {
-          typedef typename bind_arg::_Type<TUP>::Sig Sig;
-          typedef TypedArgumentReceiver<Sig> Receiver;
-          
-          Receiver* dest = dynamic_cast<Receiver*> (this);
+          TypedArguments<TUP>* dest = dynamic_cast<TypedArguments<TUP>*> (this);
           if (!dest)
             throw lumiera::error::Invalid("Wrong type or number of arguments");
           
-          dest->bindArg(args);
+          return dest->args_;
         }
     };
   
   
-  template<typename SIG>
-  class TypedArgumentReceiver
-    : public ArgumentReceiver
+  template<typename TUP>
+  struct TypedArguments
+    : Arguments
     {
-      typedef typename bind_arg::_Type<SIG>::Args ArgTypes;
+      TUP const& args_;
       
-      virtual void bindArg (lumiera::typelist::Tuple<ArgTypes> const&) =0;
+      TypedArguments (TUP const& a)
+        : args_(a)
+        { }
     };
   
     
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 10daadaf9..bbd6a54a2 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -137,14 +137,24 @@ namespace control {
         }
       
       
-      virtual CmdFunctor bindArguments (CmdFunctor const& func)
+      /** assign a new parameter tuple to this */
+      virtual void bindArguments (Arguments& args)
+      {
+        if (!arguments_->isValid())
+          bindArg(args.get<ArgTuple>());
+        else
+          arguments_->bindArguments(args);
+      }
+      
+      
+      virtual CmdFunctor closeArguments (CmdFunctor const& func)
         {
           if (!isValid())
             throw lumiera::error::State ("Lifecycle error: can't bind functor, "
                                          "command arguments not yet provided",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          return arguments_->bindArguments(func);
+          return arguments_->closeArguments(func);
         }
       
       
@@ -186,7 +196,7 @@ namespace control {
       /** store a new argument tuple within this ArgumentHolder,
        *  discarding and previously stored arguments */
       void
-      bindArg (ArgTuple argTup)
+      bindArg (ArgTuple const& argTup)
         {
           arguments_.template create<ArgHolder> (argTup);
         }
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index dce2c9e22..d1ce82d1d 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -44,6 +44,7 @@
 #include "lib/meta/tuple.hpp"
 #include "lib/format.hpp"
 #include "lib/util.hpp"
+#include "proc/control/argument-tuple-accept.hpp"  ////TODO better factor out struct TypedArguments
 
 //#include <tr1/memory>
 #include <tr1/functional>
@@ -194,6 +195,14 @@ namespace control {
         { }
       
       
+      /** assign a new parameter tuple to this */
+      void
+      bindArguments (Arguments& args)
+      {
+        params_ = args.get<ArgTuple>();
+      }
+      
+      
       /** Core operation: use the embedded argument tuple
        *  to close a given functor over its arguments.
        *  @param unboundFunctor an function object, whose
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 7778d0ce7..9b2c93df6 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -118,10 +118,9 @@ namespace control {
       void exec (HandlingPattern const& execPattern);
       
       
-      template<typename TYPES>
-      void bindArg (Tuple<TYPES> const&)
+      void setArguments (Arguments& args)
         {
-          UNIMPLEMENTED ("actually bind arguments, maybe create ArgumentHolder");
+          pClo_->bindArguments(args);
         }
             
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index fad9cd19d..cafeac58a 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -133,6 +133,16 @@ namespace control {
   }
   
   
+  /** @internal pass a new argument tuple to the
+   *  CommandImpl without exposing implementation.
+   */
+  void
+  Command::setArguments (Arguments& args)
+  {
+    _Handle::impl().setArguments(args);
+  }
+  
+  
   CommandDef
   Command::storeDef (Symbol newCmdID)
   {
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 51b7c57a9..61f19ff0f 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -37,7 +37,7 @@
 #include "pre.hpp"
 #include "include/symbol.hpp"
 #include "proc/control/command-binding.hpp"
-#include "proc/control/command-mutation.hpp"
+#include "proc/control/command-mutation.hpp"         /////TODO: do we need to expose this here?
 #include "proc/control/command-closure.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "lib/bool-checkable.hpp"
@@ -140,7 +140,7 @@ namespace control {
       
       
     private:
-     
+      void setArguments (Arguments&);
     };
   ////////////////TODO currently just fleshing  out the API....
   
@@ -154,9 +154,10 @@ namespace control {
   
   template<typename TYPES>
   inline Command&
-  Command::bindArg (Tuple<TYPES> const&)
+  Command::bindArg (Tuple<TYPES> const& tuple)
     {
-      UNIMPLEMENTED("delegate argument binding to command-impl");
+      TypedArguments<Tuple<TYPES> > args(tuple);
+      this->setArguments (args);
       return *this;
     }
   

From 09a594d2c5b2e4ed4185620bdc29cfad510fb078 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 6 Aug 2009 18:00:19 +0200
Subject: [PATCH 237/368] WIP: considerations for a store-as (clone) operation

---
 src/proc/control/command-impl.hpp     | 11 +++++++++++
 src/proc/control/command-registry.hpp | 15 +++++++++++++++
 src/proc/control/command.cpp          | 12 ++++++++++--
 src/proc/control/command.hpp          |  2 +-
 4 files changed, 37 insertions(+), 3 deletions(-)

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 9b2c93df6..25669809b 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -111,6 +111,17 @@ namespace control {
      ~CommandImpl();
       
       
+      /** cloning service for the CommandRegistry:
+       *  effectively this is a placement-copy ctor,
+       *  requiring a sufficient amount of storage for
+       *  holding the clone to be already allocated  */
+      CommandImpl (CommandImpl const& orig, void* paramStorage)
+        : do_(orig.do_)
+        , undo_(orig.undo_)
+        , pClo_(orig.pClo_->createClone(paramStorage))   ///////////////////TODO should pass in a callback/interface for allocations instead  
+        { }
+     
+      
       /** core operation: invoke the command
        *  @param execPattern describes the individual steps
        *         necessary to get this command invoked properly
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 4792392da..349e134d7 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -171,6 +171,21 @@ namespace control {
       static void killCommandImpl (CommandImpl* entry) { kill(entry); }
       
       
+      /** create an allocation for holding a clone of the given CommandImpl data.
+       *  @todo this is a tricky and problematic operation, as the CommandImpl
+       *        erases the specific type information pertaining the ArgumentHolder.
+       *        But this specific type information is vital for determining the
+       *        exact allocation size for the clone ArgumentHolder.
+       */
+      CommandImpl*
+      createCloneImpl (CommandImpl const& reference)
+        {
+          UNIMPLEMENTED ("allocate clone, solve the re-discovery problem");
+        }
+      
+      
+      
+      
       template<class IMP>
       static void
       kill (IMP* entry)
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index cafeac58a..e3b6d58d7 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -143,10 +143,18 @@ namespace control {
   }
   
   
-  CommandDef
+  Command
   Command::storeDef (Symbol newCmdID)
   {
-    UNIMPLEMENTED ("create a new definition & prototype based on this command");
+    static format fmt("Unable to store %s as new command. ID \"%s\" is already in use");
+    if (registry.queryIndex (newCmdID))
+      throw error::Logic (str (fmt % *this % newCmdID), LUMIERA_ERROR_DUPLICATE_COMMAND);
+    
+    Command cloneDefinition;
+    CommandRegistry& registry = CommandRegistry::instance();
+    cloneDefinition.activate (registry.createCloneImpl(impl()));
+    
+    return registry.track (newCmdID, cloneDefinition);
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 61f19ff0f..d35dcf064 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -86,7 +86,7 @@ namespace control {
       static bool remove (Symbol cmdID); 
       static bool  undef (Symbol cmdID);
       
-      CommandDef storeDef (Symbol newCmdID);
+      Command storeDef (Symbol newCmdID);
       
       Command() { } ///< undefined command
      ~Command();

From 82aee60b14f063b165b14de74badcfcf34bf4a63 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 7 Aug 2009 17:13:21 +0200
Subject: [PATCH 238/368] WIP attempt to solve the clone problem (draft)

---
 src/proc/control/command-registry.hpp         |  39 +---
 src/proc/control/typed-allocation-manager.hpp | 177 ++++++++++++++++++
 2 files changed, 178 insertions(+), 38 deletions(-)
 create mode 100644 src/proc/control/typed-allocation-manager.hpp

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 349e134d7..040193933 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -186,47 +186,10 @@ namespace control {
       
       
       
-      template<class IMP>
-      static void
-      kill (IMP* entry)
-        {
-                                  ///////////////////////////////////////////////TODO: clean behaviour while in App shutdown (Ticket #196)
-          instance().destroyImpl(entry);
-        }
+      ///////////////////TODO solve the problem how to re-access the instance from within the deletor
       
       
     private:
-      template<class IMP>
-      void*
-      allocateSlot ()
-        {
-          TODO ("redirect to the corresponding pool allocator");
-        }
-      
-      template<class IMP>
-      void
-      releaseSlot (void* entry)
-        {
-          TODO ("redirect to the corresponding pool allocator");
-        }
-      
-      
-      template<class IMP>
-      void
-      destroyImpl (IMP* entry)
-        {
-          if (!entry) return;
-          try
-            {
-              entry->~IMP();
-            }
-          catch(...)
-            {
-              WARN (command_dbg, "dtor of %s failed: %s", util::tyStr(entry).c_str()
-                                                        , lumiera_error() );
-            }
-          releaseSlot<IMP> (entry);
-        }
       
     };
   
diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
new file mode 100644
index 000000000..5ce904261
--- /dev/null
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -0,0 +1,177 @@
+/*
+  TYPED-ALLOCATION-MANAGER.hpp  -  abstract backbone to build custom memory managers 
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file typed-allocation-manager.hpp
+ ** Abstract foundation for building custom allocation managers.
+ ** Currently (as of 8/09) this is a draft, factored out of the command-registry.
+ ** The expectation is that we'll face several similar situations, and thus it
+ ** would be good to build up a common set of operations and behaviour.
+ ** @todo WIP WIP.
+ **
+ ** \par Concept Summary
+ ** The idea is rather to tie the memory manager to a very specific usage situation,
+ ** then to provide a general-purpose allocator to be used by any instance of a given
+ ** type. Typically, the goal is to handle memory management for an index or registry,
+ ** holding implementation objects to be shielded from the client code. Moreover, we'll
+ ** have to deal with families of types rather then with individual types, and typically
+ ** there will be some common or combined handling for all family members.
+ ** 
+ ** The intention is for this TypedAllocationManager template to be used both as a base
+ ** class providing the implementation skeleton for the actual custom allocation manager,
+ ** and as an abstract interface, which can be forwarded to the \em implementation classes
+ ** in case there is some cooperation required to get the allocation done (for example,
+ ** there might be some type erasure involved, leaving the (otherwise opaque) implementation
+ ** class as the only entity with a limited knowledge about the actual memory layout, and
+ ** thus the only way of creating a clone properly would be to forward down into this
+ ** implementation class). As we can't expect to create a one-size-fits-all implementation,
+ ** we'll allow for customising the TypedAllocationManager through policy classes. 
+ ** 
+ ** Thus, TypedAllocationManager provides the classical operations of an allocator
+ ** - allocate
+ ** - construct
+ ** - deallocate
+ ** But each of these operations is to be invoked in a \em typed context. Besides,
+ ** there is a facility allowing to create ref-counting handles and smart-pointers,
+ ** which are internally tied to this memory manager through a deleter function.
+ ** 
+ ** @see CommandRegistry
+ ** @see AllocationCluster (another custom allocation scheme, which could be united)
+ **
+ */
+
+
+
+#ifndef CONTROL_TYPED_ALLOCATION_MANAGER_H
+#define CONTROL_TYPED_ALLOCATION_MANAGER_H
+
+//#include "pre.hpp"
+#include "lib/error.hpp"
+//#include "lib/singleton.hpp"
+//#include "lib/sync.hpp"
+#include "lib/format.hpp"
+#include "include/logging.h"
+//#include "lib/bool-checkable.hpp"
+
+
+//#include <tr1/memory>
+//#include <iostream>
+//#include <string>
+
+
+
+namespace control {
+  
+//  using std::tr1::shared_ptr;
+//  using std::ostream;
+//  using std::string;
+  
+  
+  
+  
+  /**
+   * TODO type comment
+   */
+  class TypedAllocationManager
+    {
+      typedef TypedAllocationManager _TheManager;
+      
+    public:
+
+      /** this is an ABC */
+      virtual ~TypedAllocationManager() {}
+      
+      
+      
+      
+      template<class XOX>
+      struct Slot
+        {
+          typedef void DelFun(XOX*);
+          
+          void*   const storage;
+          DelFun* const killer;
+          
+        protected:
+          Slot(void* sto, DelFun* kil)
+            : storage(sto)
+            , killer(kil)
+            { }
+          
+          friend class _TheManager;
+        };
+      
+      
+      /** static entry point to be used by
+       *  handles and smart pointers to trigger
+       *  preconfigured destruction */
+      template<class XOX>
+      static void
+      kill (XOX* entry)
+        {
+                                  ///////////////////////////////////////////////TODO: clean behaviour while in App shutdown (Ticket #196)
+          instance().destroyElement(entry);
+        }
+      ///////////////////TODO solve the problem how to re-access the instance from within the deletor
+      
+      
+      
+    protected:
+      template<class XX>
+      Slot<XX>
+      allocateSlot ()
+        {
+          UNIMPLEMENTED ("redirect to the corresponding pool allocator");
+          void* space = 0;
+          return Slot<XX> (space, &kill<XX>);
+        }
+      
+      template<class XX>
+      void
+      releaseSlot (void* entry)
+        {
+          UNIMPLEMENTED ("redirect to the corresponding pool allocator");
+        }
+      
+      
+      template<class XX>
+      void
+      destroyElement (XX* entry)
+        {
+          if (!entry) return;
+          try
+            {
+              entry->~IMP();
+            }
+          catch(...)
+            {
+              WARN (command_dbg, "dtor of %s failed: %s", util::tyStr(entry).c_str()
+                                                        , lumiera_error() );
+            }
+          releaseSlot<XX> (entry);
+        }
+      
+    };
+  
+  
+} // namespace control
+#endif

From ba2d4dc761ac14e08e44c97cc6c054c632ae057d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 9 Aug 2009 03:38:44 +0200
Subject: [PATCH 239/368] a handle may also be activated by sharing ownership
 with a manager

---
 src/lib/handle.hpp | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/lib/handle.hpp b/src/lib/handle.hpp
index 12a8b4979..cb3b56e55 100644
--- a/src/lib/handle.hpp
+++ b/src/lib/handle.hpp
@@ -108,6 +108,15 @@ namespace lib {
           return *this;
         }
       
+      /** another way of activating a handle by sharing ownership
+       *  with an existing smart-ptr */
+      Handle&
+      activate(shared_ptr<IMP> const& impl)
+        {
+          smPtr_ = impl;
+          return *this;
+        }
+      
       /** deactivate this handle, so it isn't tied any longer
        *  to the associated implementation or service object.
        *  When all handles have either been deactivated or

From e178bd08113646797bd8e0a6a6efd00e829f049b Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 9 Aug 2009 03:47:32 +0200
Subject: [PATCH 240/368] completely factor out allocation/deallocation and
 placement new into a base class

---
 src/proc/control/command.cpp                  |   3 +-
 src/proc/control/typed-allocation-manager.hpp | 165 +++++++++++++++---
 2 files changed, 144 insertions(+), 24 deletions(-)

diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index e3b6d58d7..ae42bf5c5 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -146,12 +146,13 @@ namespace control {
   Command
   Command::storeDef (Symbol newCmdID)
   {
+    CommandRegistry& registry = CommandRegistry::instance();
     static format fmt("Unable to store %s as new command. ID \"%s\" is already in use");
+    
     if (registry.queryIndex (newCmdID))
       throw error::Logic (str (fmt % *this % newCmdID), LUMIERA_ERROR_DUPLICATE_COMMAND);
     
     Command cloneDefinition;
-    CommandRegistry& registry = CommandRegistry::instance();
     cloneDefinition.activate (registry.createCloneImpl(impl()));
     
     return registry.track (newCmdID, cloneDefinition);
diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
index 5ce904261..397bc0e9f 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -73,7 +73,7 @@
 //#include "lib/bool-checkable.hpp"
 
 
-//#include <tr1/memory>
+#include <tr1/memory>
 //#include <iostream>
 //#include <string>
 
@@ -81,7 +81,7 @@
 
 namespace control {
   
-//  using std::tr1::shared_ptr;
+  using std::tr1::shared_ptr;
 //  using std::ostream;
 //  using std::string;
   
@@ -102,47 +102,166 @@ namespace control {
       
       
       
+      /* ======= managing the created objects ============= */
       
+      /** opaque link to the manager, to be used by handles and
+       *  smart-ptrs to trigger preconfigured destruction.  */
       template<class XOX>
-      struct Slot
+      class Killer
         {
-          typedef void DelFun(XOX*);
+          _TheManager* manager_;
           
-          void*   const storage;
-          DelFun* const killer;
+        public:
+          void
+          operator() (XOX* victim)
+            {
+              REQUIRE (manager_);
+                                  ///////////////////////////////////////////////TODO: clean behaviour while in App shutdown (Ticket #196)
+              manager_->destroyElement (victim);
+            }
           
         protected:
-          Slot(void* sto, DelFun* kil)
-            : storage(sto)
-            , killer(kil)
+          Killer(_TheManager* m)
+            : manager_(m)
             { }
-          
-          friend class _TheManager;
         };
       
-      
-      /** static entry point to be used by
-       *  handles and smart pointers to trigger
-       *  preconfigured destruction */
+      /** a token representing a newly opened slot
+       *  capable for holding an object of type XOX .
+       *  The receiver is responsible for
+       *  - either calling releaseSlot
+       *  - or building a smart-ptr / handle wired to
+       *    the \link #getDeleter deleter function \endlink
+       */
       template<class XOX>
-      static void
-      kill (XOX* entry)
+      struct Slot
+        : private Killer<XOX>
         {
-                                  ///////////////////////////////////////////////TODO: clean behaviour while in App shutdown (Ticket #196)
-          instance().destroyElement(entry);
+          /** pointer to the allocated storage
+           *  with \c sizeof(XOX) bytes */
+          void* const storage_;
+          
+          /** build a refcounting smart-ptr,
+           *  complete with back-link to the manager
+           *  for de-allocation */
+          shared_ptr<XOX>
+          build (XOX* toTrack)
+            {
+              return shared_ptr<XOX> (toTrack, getDeleter());
+            }
+          
+          Killer<XOX> const&
+          getDeleter()
+            {
+              return *this;
+            }
+          
+        protected:
+          Slot(_TheManager* don, void* mem)
+            : Killer<XOX>(don)
+            , storage_(mem)
+            { }
+          
+          friend class TypedAllocationManager;
+        };
+      
+        
+      
+      
+      /* ==== build objects with managed allocation ==== */
+      
+#define _EXCEPTION_SAFE_INVOKE(_CTOR_)                    \
+                                                           \
+          Slot<XX> slot = allocateSlot<XX>();               \
+          try                                                \
+            {                                                 \
+              return slot.build (new(slot.storage_) _CTOR_ );  \
+            }                                                  \
+          catch(...)                                           \
+            {                                                  \
+              releaseSlot<XX>(slot.storage_);                  \
+              throw;                                           \
+            }
+      
+      template< class XX>
+      shared_ptr<XX>                                                                   //_____________________
+      create ()                                                                       ///< invoke default ctor
+        {
+          _EXCEPTION_SAFE_INVOKE ( XX() )
         }
-      ///////////////////TODO solve the problem how to re-access the instance from within the deletor
       
       
+      template< class XX, typename P1>
+      shared_ptr<XX>                                                                   //___________________
+      create (P1& p1)                                                                 ///< invoke 1-arg ctor
+        {
+          _EXCEPTION_SAFE_INVOKE ( XX (p1) )
+        }
+      
+      
+      template< class XX
+              , typename P1
+              , typename P2
+              >
+      shared_ptr<XX>                                                                   //___________________
+      create (P1& p1, P2& p2)                                                         ///< invoke 2-arg ctor
+        {
+          _EXCEPTION_SAFE_INVOKE ( XX (p1,p2) )
+        }
+      
+      
+      template< class XX
+              , typename P1
+              , typename P2
+              , typename P3
+              >
+      shared_ptr<XX>                                                                   //___________________
+      create (P1& p1, P2& p2, P3& p3)                                                 ///< invoke 3-arg ctor
+        {
+          _EXCEPTION_SAFE_INVOKE ( XX (p1,p2,p3) )
+        }
+      
+      
+      template< class XX
+              , typename P1
+              , typename P2
+              , typename P3
+              , typename P4
+              >
+      shared_ptr<XX>                                                                   //___________________
+      create (P1& p1, P2& p2, P3& p3, P4& p4)                                         ///< invoke 4-arg ctor
+        {
+          _EXCEPTION_SAFE_INVOKE ( XX (p1,p2,p3,p4) )
+        }
+      
+      
+      template< class XX
+              , typename P1
+              , typename P2
+              , typename P3
+              , typename P4
+              , typename P5
+              >
+      shared_ptr<XX>                                                                   //___________________
+      create (P1& p1, P2& p2, P3& p3, P4& p4, P5& p5)                                 ///< invoke 5-arg ctor
+        {
+          _EXCEPTION_SAFE_INVOKE ( XX (p1,p2,p3,p4,p5) )
+        }
+      
+#undef _EXCEPTION_SAFE_INVOKE
+
+    
+    
+      
+    protected: /* ======= Managed Allocation Implementation ========== */
       
-    protected:
       template<class XX>
       Slot<XX>
       allocateSlot ()
         {
           UNIMPLEMENTED ("redirect to the corresponding pool allocator");
           void* space = 0;
-          return Slot<XX> (space, &kill<XX>);
+          return Slot<XX> (this, space);
         }
       
       template<class XX>
@@ -160,7 +279,7 @@ namespace control {
           if (!entry) return;
           try
             {
-              entry->~IMP();
+              entry->~XX();
             }
           catch(...)
             {

From da3cf5a6a6c6964388add4c1e83630f885c85a61 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 9 Aug 2009 03:48:19 +0200
Subject: [PATCH 241/368] rework the cmd registry to build on this

---
 src/proc/control/command-def.hpp      |  7 +++---
 src/proc/control/command-registry.hpp | 35 ++++++---------------------
 src/proc/control/command.cpp          |  4 +--
 src/proc/control/command.hpp          |  4 +--
 4 files changed, 16 insertions(+), 34 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 5dac4c4d2..e5972d2a0 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -63,7 +63,7 @@
 #include "lib/meta/tuple.hpp"
 #include "lib/bool-checkable.hpp"
 
-//#include <tr1/memory>
+#include <tr1/memory>
 #include <tr1/functional>
 
 
@@ -72,7 +72,7 @@
 namespace control {
   
   using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
+  using std::tr1::shared_ptr;
   using std::tr1::function;
   
   using lumiera::typelist::FunctionSignature;
@@ -128,8 +128,9 @@ namespace control {
             REQUIRE (undoFunctor_);
             REQUIRE (captFunctor_);
             
+            typedef shared_ptr<CommandImpl> ImplInstance;
             CommandRegistry& registry = CommandRegistry::instance();
-            CommandImpl* completedDef = registry.newCommandImpl(operFunctor_
+            ImplInstance completedDef = registry.newCommandImpl(operFunctor_
                                                                ,captFunctor_
                                                                ,undoFunctor_);
             prototype_.activate(completedDef);
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 040193933..50c769a5e 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -48,6 +48,7 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-signature.hpp"
 #include "proc/control/command-argument-holder.hpp"
+#include "proc/control/typed-allocation-manager.hpp"
 //#include "proc/control/memento-tie.hpp"
 
 #include <tr1/memory>
@@ -70,6 +71,7 @@ namespace control {
    */
   class CommandRegistry
     : public lib::Sync<>
+    , protected TypedAllocationManager
     {
       
     public:
@@ -136,7 +138,7 @@ namespace control {
               , typename SIG_CAPT    ///< signature for capturing undo state
               , typename SIG_UNDO    ///< signature to undo the command
               >
-      CommandImpl*
+      shared_ptr<CommandImpl>
       newCommandImpl (function<SIG_OPER>& operFunctor
                      ,function<SIG_CAPT>& captFunctor
                      ,function<SIG_UNDO>& undoFunctor)
@@ -148,27 +150,12 @@ namespace control {
           typedef typename UndoSignature<SIG_CAPT>::Memento Mem;
           typedef ArgumentHolder<SIG_OPER,Mem> Arguments;
           
-          shared_ptr<Arguments> pArg ( new (allocateSlot<Arguments>()) Arguments()
-                                     , &kill<Arguments>
-                                     );
-          void* implStorage = 0;
-          try
-            {
-              implStorage = allocateSlot<CommandImpl>();
-              ASSERT (implStorage);
-              
-              return new(implStorage) CommandImpl (pArg, operFunctor,captFunctor,undoFunctor);
-            }
-          catch(...)
-            {
-              if (implStorage)
-                releaseSlot<CommandImpl> (implStorage);
-              throw;
-        }   }
+          shared_ptr<Arguments> pArg (this->create<Arguments>());
+          
+          return this->create<CommandImpl> (pArg, operFunctor,captFunctor,undoFunctor);
+        }
       
       
-      /** delete the command implementation and free the corresponding allocation */
-      static void killCommandImpl (CommandImpl* entry) { kill(entry); }
       
       
       /** create an allocation for holding a clone of the given CommandImpl data.
@@ -177,7 +164,7 @@ namespace control {
        *        But this specific type information is vital for determining the
        *        exact allocation size for the clone ArgumentHolder.
        */
-      CommandImpl*
+      shared_ptr<CommandImpl>
       createCloneImpl (CommandImpl const& reference)
         {
           UNIMPLEMENTED ("allocate clone, solve the re-discovery problem");
@@ -185,12 +172,6 @@ namespace control {
       
       
       
-      
-      ///////////////////TODO solve the problem how to re-access the instance from within the deletor
-      
-      
-    private:
-      
     };
   
   
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index ae42bf5c5..ba4699e4a 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -118,7 +118,7 @@ namespace control {
    *  @throw std::bad_alloc, in which case
    *         CommandRegistry::killCommandImpl is invoked */
   Command&
-  Command::activate (CommandImpl* implFrame)
+  Command::activate (shared_ptr<CommandImpl> const& implFrame)
   {
     static format fmt("Command \"%s\" already defined");
     REQUIRE (implFrame);
@@ -126,7 +126,7 @@ namespace control {
     if (this->isValid())
       throw error::Logic (str (fmt % *this), LUMIERA_ERROR_DUPLICATE_COMMAND);
           
-    _Handle::activate (implFrame, CommandRegistry::killCommandImpl);
+    _Handle::activate (implFrame);
             
     INFO (command, "Command \"%s\" defined OK", cStr(*this));
     return *this;
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index d35dcf064..8f1850642 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -54,7 +54,7 @@ namespace control {
   
   using std::string;
   using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
+  using std::tr1::shared_ptr;
   
   LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Command functor not yet usable, because arguments aren't bound
   LUMIERA_ERROR_DECLARE (INVALID_COMMAND);    ///< Unknown or insufficiently defined command
@@ -115,7 +115,7 @@ namespace control {
       
       /* === command lifecycle === */
       
-      Command& activate (CommandImpl*);
+      Command& activate (shared_ptr<CommandImpl> const&);
       
       template<typename TYPES>
       Command& bindArg (Tuple<TYPES> const&);

From eada1aa7454136594e3bda2a98a93b29d4b764f6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 9 Aug 2009 04:12:46 +0200
Subject: [PATCH 242/368] now able to solve the store-as (clone) problem

---
 src/proc/control/command-argument-holder.hpp |  8 ++++++++
 src/proc/control/command-closure.hpp         | 14 +++++++++++++-
 src/proc/control/command-impl.hpp            | 12 +++++++-----
 src/proc/control/command-registry.hpp        | 12 +++++++-----
 4 files changed, 35 insertions(+), 11 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index bbd6a54a2..cdb3f2d73 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -42,6 +42,7 @@
 #ifndef CONTROL_COMMAND_ARGUMENT_HOLDER_H
 #define CONTROL_COMMAND_ARGUMENT_HOLDER_H
 
+#include "proc/control/typed-allocation-manager.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
@@ -187,6 +188,13 @@ namespace control {
           memento_.template  create<MemHolder> (*oAh.memento_);
         }
       
+      /** create a clone copy, without disclosing the exact type */
+      PClo
+      createClone (TypedAllocationManager& storageManager)
+        {
+          return storageManager.create<ArgumentHolder> (*this);
+        }
+      
       
       /** has undo state capturing been invoked? */
       bool canUndo () const { return memento_->isValid();   }
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index d1ce82d1d..d0e2cf247 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -45,8 +45,9 @@
 #include "lib/format.hpp"
 #include "lib/util.hpp"
 #include "proc/control/argument-tuple-accept.hpp"  ////TODO better factor out struct TypedArguments
+#include "proc/control/typed-allocation-manager.hpp"
 
-//#include <tr1/memory>
+#include <tr1/memory>
 #include <tr1/functional>
 #include <iostream>
 #include <sstream>
@@ -89,6 +90,9 @@ namespace control {
    */
   typedef FunErasure<StoreFunction> CmdFunctor;
   
+  class CmdClosure;
+  typedef std::tr1::shared_ptr<CmdClosure> PClo;
+  
   
   
   /** Interface */
@@ -105,6 +109,8 @@ namespace control {
       virtual void bindArguments (Arguments&) =0;
       
       virtual CmdFunctor closeArguments (CmdFunctor const&) =0;
+      
+      virtual PClo createClone (TypedAllocationManager&) =0;
     };
   
   
@@ -194,6 +200,12 @@ namespace control {
         : params_(BuildAccessor(args))
         { }
       
+      /** create a clone copy of this, without disclosing the exact type */
+      PClo
+      createClone (TypedAllocationManager& storageManager)
+        {
+          return storageManager.create<Closure> (*this);
+        }
       
       /** assign a new parameter tuple to this */
       void
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 25669809b..36585326f 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -45,6 +45,7 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-argument-holder.hpp"
+#include "proc/control/typed-allocation-manager.hpp"
 #include "lib/bool-checkable.hpp"
 
 #include <boost/noncopyable.hpp>
@@ -112,13 +113,14 @@ namespace control {
       
       
       /** cloning service for the CommandRegistry:
-       *  effectively this is a placement-copy ctor,
-       *  requiring a sufficient amount of storage for
-       *  holding the clone to be already allocated  */
-      CommandImpl (CommandImpl const& orig, void* paramStorage)
+       *  effectively this is a copy ctor, but as we rely
+       *  on a argument holder (without knowing the exact type),
+       *  we need to delegate the cloning of the arguments down
+       *  while providing a means of allocating storage for the clone */
+      CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
         : do_(orig.do_)
         , undo_(orig.undo_)
-        , pClo_(orig.pClo_->createClone(paramStorage))   ///////////////////TODO should pass in a callback/interface for allocations instead  
+        , pClo_(orig.pClo_->createClone(storageManager))  
         { }
      
       
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 50c769a5e..2aaea1e52 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -159,15 +159,17 @@ namespace control {
       
       
       /** create an allocation for holding a clone of the given CommandImpl data.
-       *  @todo this is a tricky and problematic operation, as the CommandImpl
-       *        erases the specific type information pertaining the ArgumentHolder.
-       *        But this specific type information is vital for determining the
-       *        exact allocation size for the clone ArgumentHolder.
+       *  This is a tricky operation, as the CommandImpl after construction erases the
+       *  specific type information pertaining the ArgumentHolder. But this specific
+       *  type information is vital for determining the exact allocation size for
+       *  the clone ArgumentHolder. The only solution is to delegate the cloning
+       *  of the arguments down into the ArgumentHolder, passing a reference
+       *  to the memory manager (=this object) for allocating the clone. 
        */
       shared_ptr<CommandImpl>
       createCloneImpl (CommandImpl const& reference)
         {
-          UNIMPLEMENTED ("allocate clone, solve the re-discovery problem");
+          return this->create<CommandImpl> (reference, *this);
         }
       
       

From 2e58611e2d64dc721334b562c1b45fc09bbd2065 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 9 Aug 2009 19:22:07 +0200
Subject: [PATCH 243/368] define session lifecycle event IDs

---
 src/proc/mobject/session.hpp         |  5 ++
 src/proc/mobject/session/session.cpp | 51 ++++++++++++++---
 tests/lib/lifecycletest.cpp          | 86 ++++++++++++++--------------
 3 files changed, 90 insertions(+), 52 deletions(-)

diff --git a/src/proc/mobject/session.hpp b/src/proc/mobject/session.hpp
index 2759ded09..c9b0c5c62 100644
--- a/src/proc/mobject/session.hpp
+++ b/src/proc/mobject/session.hpp
@@ -98,6 +98,11 @@ namespace mobject {
     };
   
   
+  extern Symbol ON_SESSION_START;  ///< triggered before loading any content into a newly created session
+  extern Symbol ON_SESSION_INIT;   ///< triggered when initialising a new session, after adding content
+  extern Symbol ON_SESSION_END;    ///< triggered before discarding an existing session
+  
+  
   namespace session {
 
     /**
diff --git a/src/proc/mobject/session/session.cpp b/src/proc/mobject/session/session.cpp
index d8e390eb5..1a75c5e9b 100644
--- a/src/proc/mobject/session/session.cpp
+++ b/src/proc/mobject/session/session.cpp
@@ -35,17 +35,18 @@
 #include "proc/mobject/session/defsmanager.hpp"
 #include "proc/mobject/session/session-impl.hpp"
 
+#include "include/symbol.hpp"
 #include "lib/singleton.hpp"
 
 
+using lumiera::Symbol;
 using lumiera::Singleton;
 using mobject::session::SessManager;
 using mobject::session::SessManagerImpl;
 
-namespace mobject
-  {
-
-  /** the sole acces point for all client code to the system-wide
+namespace mobject {
+  
+  /** the sole access point for all client code to the system-wide
    *  "current session". Implemented as smart pointer to singleton
    *  implementation object, where the smart pointer is actually
    *  the SessionManager (which is singleton as well...).
@@ -55,13 +56,45 @@ namespace mobject
    *  via arrow notaion (e.g. \code Session::current->getFixture() )
    */
   SessManager& Session::current = Singleton<SessManagerImpl>()();
-
-    
-    
-    
+  
+  
+  /** \par
+   *  LifecycleHook, to perform all the basic setup for a new session,
+   *  prior to adding any specific data, configuration or content. Any subsystems
+   *  requiring to (re)-initialise for a new session should register here. When this
+   *  hook is activated, the session implementation facilities are available and the
+   *  corresponding interfaces are already opened and accessible, but the session itself
+   *  is completely pristine and empty.
+   *  @note plugins providing additional facilities to be used by content of a (persisted)
+   *        session should register their basic setup functions using this hook, which can be
+   *        done via the C interface functions defined in lifecycle.h
+   */
+  Symbol ON_SESSION_START ("ON_SESSION_START");
+  
+  /** \par
+   *  LifecycleHook, to perform any initialisation, wiring and registrations necessary
+   *  to get the session into a usable state. When activated, the specific session content
+   *  and configuration has already be loaded. Any subsystems requiring to build some indices
+   *  or wiring to keep track of the session's content should register here.
+   */
+  Symbol ON_SESSION_INIT ("ON_SESSION_INIT");
+  
+  /** \par
+   *  LifecycleHook, to perform any state saving, deregistration or de-activation necessary 
+   *  before bringing down an existing session. When invoked, the session is still fully valid
+   *  and functional, but the GUI/external access has already been closed.
+   *  @todo specify how this is related to "saving". Is there a way for subsystems to add
+   *        specific/internal information into the persisted state, besides actually attaching
+   *        data to objects within the session?
+   */
+  Symbol ON_SESSION_END ("ON_SESSION_END");
+  
+  
+  
+  
   Session::~Session () 
   { }
-
+  
   Session::Session (session::DefsManager& def)  throw()
     : defaults(def)
   { }
diff --git a/tests/lib/lifecycletest.cpp b/tests/lib/lifecycletest.cpp
index b3f909965..8b98373e5 100644
--- a/tests/lib/lifecycletest.cpp
+++ b/tests/lib/lifecycletest.cpp
@@ -30,48 +30,48 @@
 
 
 
-namespace lumiera {
-  namespace test  {
-    
-    uint basicInit (0);
-    uint customCallback (0);
-    
-    void basicInitHook () { ++basicInit; }
-    void myCallback() { ++customCallback; }
-
-    Symbol MY_DEADLY_EVENT = "dial M for murder";
-    
-    
-    namespace // register them to be invoked by lifecycle event id 
-      {
-      LifecycleHook _schedule1 (ON_BASIC_INIT, &basicInitHook);         
-      LifecycleHook _schedule2 (MY_DEADLY_EVENT, &myCallback);   
-    }
-    
-    
-    /** @test the global lifecycle hooks got registered,
-     *        the ON_BASIC_INIT hook has been already called,
-     *        while our custom callback can be trigged at our will
-     */
-    class LifeCycle_test : public Test
-      {
-        virtual void 
-        run (Arg)
-          {
-            ASSERT (basicInit, "the basic-init callback hasn't been invoked automatically");
-            ASSERT (1 == basicInit, "the basic-init callback has been invoked more than once");
-            
-            ASSERT (!customCallback);
-            LifecycleHook::trigger  (MY_DEADLY_EVENT);
-            ASSERT ( 1 == customCallback);
-          }
-        
-      };
-    
-      LAUNCHER (LifeCycle_test, "function common");
-
+namespace lumiera{
+namespace test   {
+  
+  uint basicInit (0);
+  uint customCallback (0);
+  
+  void basicInitHook () { ++basicInit; }
+  void myCallback() { ++customCallback; }
+  
+  Symbol MY_DEADLY_EVENT = "dial M for murder";
+  
+  
+  namespace // register them to be invoked by lifecycle event id
+    {
+    LifecycleHook _schedule1 (ON_BASIC_INIT, &basicInitHook);
+    LifecycleHook _schedule2 (MY_DEADLY_EVENT, &myCallback);
+  }
+  
+  
+  /** @test the global lifecycle hooks got registered,
+   *        the ON_BASIC_INIT hook has been already called,
+   *        while our custom callback can be triggered at our will
+   */
+  class LifeCycle_test : public Test
+    {
+      virtual void 
+      run (Arg)
+        {
+          ASSERT (basicInit, "the basic-init callback hasn't been invoked automatically");
+          ASSERT (1 == basicInit, "the basic-init callback has been invoked more than once");
+          
+          ASSERT (!customCallback);
+          LifecycleHook::trigger  (MY_DEADLY_EVENT);
+          ASSERT ( 1 == customCallback);
+        }
       
-  } // namespace test
-    
-} // namespace util
+    };
+  
+  LAUNCHER (LifeCycle_test, "function common");
+  
+  
+  
+  
+}} // namespace util::test
 

From 9f40e4af9c7b7d13c07b13d23a1b7e3fa9ccc312 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 9 Aug 2009 21:55:47 +0200
Subject: [PATCH 244/368] implemented definition and access of handling
 patterns

---
 src/common/configrules.hpp                    |   2 +-
 src/lib/Makefile.am                           |   2 +-
 ...tonsubclass.hpp => singleton-subclass.hpp} |   8 +-
 src/proc/control/command-def.hpp              |  51 +++--
 src/proc/control/command-impl.cpp             |   7 +-
 src/proc/control/command-impl.hpp             |  39 ++--
 src/proc/control/command.cpp                  |   4 +-
 src/proc/control/command.hpp                  |   6 +-
 src/proc/control/handling-pattern.cpp         |   7 +-
 src/proc/control/handling-pattern.hpp         |   5 +
 src/proc/control/handling-patterns.hpp        | 182 ++++++++++++++++++
 src/proc/mobject/session.hpp                  |   7 +-
 tests/lib/singleton-subclass-test.cpp         |   2 +-
 wiki/renderengine.html                        |   4 +-
 14 files changed, 274 insertions(+), 52 deletions(-)
 rename src/lib/{singletonsubclass.hpp => singleton-subclass.hpp} (97%)
 create mode 100644 src/proc/control/handling-patterns.hpp

diff --git a/src/common/configrules.hpp b/src/common/configrules.hpp
index f16cf3a9f..66c2c95ec 100644
--- a/src/common/configrules.hpp
+++ b/src/common/configrules.hpp
@@ -49,7 +49,7 @@
 #include "lib/p.hpp"
 #include "lib/query.hpp"
 #include "lib/meta/generator.hpp"
-#include "lib/singletonsubclass.hpp"
+#include "lib/singleton-subclass.hpp"
 
 //TODO: is it sensible to bring in the types explicitly here? (it's not necessary, but may be convenient...)
 #include "proc/mobject/session/track.hpp"
diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index 7a371da5a..76c72be62 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -83,7 +83,7 @@ noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/p.hpp				\
 	$(liblumiera_la_srcdir)/query.hpp			\
 	$(liblumiera_la_srcdir)/singletonfactory.hpp		\
-	$(liblumiera_la_srcdir)/singletonsubclass.hpp		\
+	$(liblumiera_la_srcdir)/singleton-subclass.hpp		\
 	$(liblumiera_la_srcdir)/meta/typelist.hpp		\
 	$(liblumiera_la_srcdir)/meta/configflags.hpp		\
 	$(liblumiera_la_srcdir)/meta/generator.hpp		\
diff --git a/src/lib/singletonsubclass.hpp b/src/lib/singleton-subclass.hpp
similarity index 97%
rename from src/lib/singletonsubclass.hpp
rename to src/lib/singleton-subclass.hpp
index bfac1c734..e3c6b530c 100644
--- a/src/lib/singletonsubclass.hpp
+++ b/src/lib/singleton-subclass.hpp
@@ -1,5 +1,5 @@
 /*
-  SINGLETONSUBCLASS.hpp  -  variant of the singleton (factory) creating a subclass
+  SINGLETON-SUBCLASS.hpp  -  variant of the singleton (factory) creating a subclass
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -20,7 +20,7 @@
  
 */
 
-/** @file singletonsubclass.hpp
+/** @file singleton-subclass.hpp
  ** Specialised SingletonFactory creating subclasses of the nominal type.
  ** The rationale is to be able to defer the decision what type to create
  ** down to the point where the singleton factory is actually created.
@@ -35,8 +35,8 @@
  */
 
 
-#ifndef LUMIERA_SINGLETONSUBCLASS_H
-#define LUMIERA_SINGLETONSUBCLASS_H
+#ifndef LUMIERA_SINGLETON_SUBCLASS_H
+#define LUMIERA_SINGLETON_SUBCLASS_H
 
 
 #include "lib/singleton.hpp"
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index e5972d2a0..3d952fe80 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -86,11 +86,40 @@ namespace control {
     
     
     
+    template<typename SIG>
+    struct CompletedDefinition
+      : AcceptArgumentBindingRet< Command&, SIG               // Return type and Argument Signature of the \c bind(..) function
+                                , CompletedDefinition<SIG>   //  target type (this class) providing the implementation \c bindArg(Tuple<..>) 
+                                >
+      {
+        Command& prototype_;
+        
+        typedef typename FunctionSignature< function<SIG> >::Args CmdArgs;
+        
+        CompletedDefinition (Command& definedCommand)
+          : prototype_(definedCommand)
+          {
+                    
+          }
+        
+        typedef HandlingPattern::ID PattID;
+        
+        PattID getDefaultHandlingPattern()  const { return prototype_.getDefaultHandlingPattern();}
+        PattID setHandlingPattern (PattID newID)  { return prototype_.setHandlingPattern(newID); }
+        
+        Command&
+        bindArg (Tuple<CmdArgs> const& params)
+          {
+            return prototype_.bindArg(params);
+          }
+      };
+    
+    
+    
+    
+    
     template<typename SIG, typename MEM>
     struct UndoDefinition
-      : AcceptArgumentBindingRet< Command&, SIG               // Return type and Argument Signature of the \c bind(..) function
-                                , UndoDefinition<SIG,MEM>    //  target type (this class) providing the implementation \c bindArg(Tuple<..>) 
-                                >
       {
         typedef CommandSignature<SIG,MEM> CmdType;
         typedef typename CmdType::OperateSig CommandOperationSig;
@@ -120,7 +149,7 @@ namespace control {
           }
         
         
-        UndoDefinition&
+        CompletedDefinition<SIG>
         undoOperation (UndoOperationSig& how_to_Undo)
           {
             undoFunctor_ = UndoFunc (how_to_Undo);
@@ -135,20 +164,8 @@ namespace control {
                                                                ,undoFunctor_);
             prototype_.activate(completedDef);
             ENSURE (prototype_);
-            return *this;
+            return CompletedDefinition<SIG> (prototype_);
           }
-        
-        
-        Command&
-        bindArg (Tuple<CmdArgs> const& params)
-          {
-            Closure<SIG> clo (params);
-            
-            cout << showSizeof(clo) << endl;
-            UNIMPLEMENTED ("complete Command definition by closing all functions");
-            return prototype_;
-          }
-        
       };
     
     
diff --git a/src/proc/control/command-impl.cpp b/src/proc/control/command-impl.cpp
index a0ab3e174..f8b31dd2b 100644
--- a/src/proc/control/command-impl.cpp
+++ b/src/proc/control/command-impl.cpp
@@ -46,12 +46,7 @@ namespace control {
   CommandImpl::~CommandImpl() { }
   
 
-  /** */
-  void
-  CommandImpl::exec (HandlingPattern const& execPattern)
-  {
-    UNIMPLEMENTED ("actually invoke the command");
-  }
+  /////////////////////////////////////////TODO: is this impl file actually necessary??
 
   
 
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 36585326f..60141b0b0 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -75,6 +75,8 @@ namespace control {
       
       shared_ptr<CmdClosure> pClo_;
       
+      HandlingPattern::ID defaultPatt_;
+      
       
       template<typename ARG>
       struct _Type
@@ -104,9 +106,10 @@ namespace control {
         : do_(operFunctor)
         , undo_(pArgHolder->tie (undoFunctor, captFunctor))
         , pClo_(pArgHolder)
+        , defaultPatt_(HandlingPattern::defaultID())
         { }
       
-#undef _TY      
+#undef _TY
       
       
      ~CommandImpl();
@@ -120,22 +123,36 @@ namespace control {
       CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
         : do_(orig.do_)
         , undo_(orig.undo_)
-        , pClo_(orig.pClo_->createClone(storageManager))  
+        , pClo_(orig.pClo_->createClone(storageManager))
+        , defaultPatt_(orig.defaultPatt_)
         { }
-     
-      
-      /** core operation: invoke the command
-       *  @param execPattern describes the individual steps
-       *         necessary to get this command invoked properly
-       */
-      void exec (HandlingPattern const& execPattern);
       
       
-      void setArguments (Arguments& args)
+      void
+      setArguments (Arguments& args)
         {
           pClo_->bindArguments(args);
         }
-            
+      
+      
+      typedef HandlingPattern::ID PattID;
+      
+      PattID
+      getDefaultHandlingPattern()  const
+        {
+          return defaultPatt_;
+        }
+      
+      /** define a handling pattern to be used by default
+       *  @return ID of the currently defined default pattern */
+      PattID
+      setHandlingPattern (PattID newID)
+        {
+          PattID currID = defaultPatt_;
+          defaultPatt_ = newID;
+          return currID;
+        }
+      
       
       
       /* === diagnostics === */
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index ba4699e4a..ce3b139d0 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -293,14 +293,14 @@ namespace control {
   HandlingPattern::ID
   Command::getDefaultHandlingPattern()  const
   {
-    UNIMPLEMENTED ("manage the default command handling pattern");
+    return impl().getDefaultHandlingPattern();
   }
   
   
   HandlingPattern::ID
   Command::setHandlingPattern (HandlingPattern::ID pattID)
   {
-    UNIMPLEMENTED ("manage handling patterns in general");
+    return impl().setHandlingPattern(pattID);
   }
 
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 8f1850642..525af5962 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -142,9 +142,11 @@ namespace control {
     private:
       void setArguments (Arguments&);
     };
-  ////////////////TODO currently just fleshing  out the API....
   
-
+  
+  
+  
+  
   inline ExecResult
   Command::operator() ()
   {
diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index cef91d3e0..8d02128e7 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -22,8 +22,9 @@
 
 
 
-#include "proc/control/handling-pattern.hpp"
 #include "proc/control/command.hpp"
+#include "proc/control/handling-pattern.hpp"
+#include "proc/control/handling-patterns.hpp"
 
 #include "include/symbol.hpp"
 #include "include/logging.h"
@@ -48,7 +49,9 @@ namespace control {
   HandlingPattern const&
   HandlingPattern::get (ID id)
   {
-    UNIMPLEMENTED ("Factory for handling patterns");
+    REQUIRE ((0 <= id) && (id < NUM_IDS));
+    
+    return getPatternInstance(id); 
   }
   
 
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 775fc7bb2..67b326c81 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -85,8 +85,13 @@ namespace control {
         { SYNC
         , SYNC_THROW
         , ASYNC
+        
+        , NUM_IDS
         };
       
+      static ID defaultID() { return SYNC; }
+      
+      
       static HandlingPattern const& get (ID id);
       
       
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
new file mode 100644
index 000000000..7b3d94d2b
--- /dev/null
+++ b/src/proc/control/handling-patterns.hpp
@@ -0,0 +1,182 @@
+/*
+  HANDLILNG-PATTERNS.hpp  -  Collection of predefinded command handling patterns
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file handling-patterns.hpp
+ ** A hard wired collection of predefined command handling patterns.
+ ** There is a small number of different possibilities to handle execution
+ ** and UNDO of proc-Layer commands. Each of these is defined as a subclass
+ ** in this header and then hard wired into a small table. Handling patterns
+ ** are stateless singleton objects, thus we build use SingletonSubclass
+ ** factory objects and configure them hard wired with the respective
+ ** implementation classes. The index positions in this table match
+ ** the sequence within the enum HandlingPattern::ID; all of this
+ ** is done hard wired and without any dynamic configuration.
+ **
+ ** @see ProcDispatcher
+ ** @see Session
+ **
+ */
+
+
+
+#ifndef CONTROL_HANDLING_PATTERNS_DEF_H
+#define CONTROL_HANDLING_PATTERNS_DEF_H
+
+//#include "pre.hpp"
+#include "lib/error.hpp"
+#include "lib/singleton-subclass.hpp"
+#include "proc/control/handling-pattern.hpp"
+#include "proc/mobject/session.hpp"
+#include "include/lifecycle.h"
+//#include "include/symbol.hpp"
+
+//#include <tr1/memory>
+//#include <string>
+#include<vector>
+
+
+
+namespace control {
+
+  namespace { // concrete command handling patterns 
+  
+    using std::vector;
+//  using std::string;
+//  using lumiera::Symbol;
+//  using std::tr1::shared_ptr;
+    
+    
+    
+    /**
+     * Handling Pattern: invoke blocking, translate exceptions into an error state
+     * @todo describe this pattern in more detail....
+     */
+    class InvokeSyncNoThrow
+      : public HandlingPattern
+      {
+        void
+        perform (Command& command)  const
+          {
+            UNIMPLEMENTED ("actually invoke a command, according to this pattern");
+          }
+        
+        HandlingPattern const&
+        defineUNDO()  const
+          {
+            UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
+          }
+      };
+    
+    
+    
+    /**
+     * Handling Pattern: invoke blocking, propagating any exceptions immediately
+     * @todo describe this pattern in more detail....
+     */
+    class InvokeSyncThrow
+      : public HandlingPattern
+      {
+        void
+        perform (Command& command)  const
+          {
+            UNIMPLEMENTED ("actually invoke a command, according to this pattern");
+          }
+        
+        HandlingPattern const&
+        defineUNDO()  const
+          {
+            UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
+          }
+      };
+    
+    
+    
+    /**
+     * Handling Pattern: just schedule command to be invoked asynchronously
+     * @todo describe this pattern in more detail....
+     */
+    class InvokeAsync
+      : public HandlingPattern
+      {
+        void
+        perform (Command& command)  const
+          {
+            UNIMPLEMENTED ("actually invoke a command, according to this pattern");
+          }
+        
+        HandlingPattern const&
+        defineUNDO()  const
+          {
+            UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
+          }
+      };
+    
+    
+    
+    
+    
+    
+    /* ======== Handling Pattern Table ========== */
+    
+    typedef lumiera::SingletonSub<HandlingPattern> SingletonFac;
+    
+    /** Table of available command handling patterns */
+    vector<SingletonFac> patternTable;
+    
+    
+    /** access the singleton instance for a given ID */
+    HandlingPattern const&
+    getPatternInstance (HandlingPattern::ID id)
+    {
+      REQUIRE (id < patternTable.size());
+      return patternTable[id] ();
+    }
+    
+    
+    /** populate the handling pattern table.
+     *  This init-function will be invoked each time
+     *  a new session is created or loaded.
+     */
+    void
+    prepareCommandHandlingPatterns()
+    {
+      using lumiera::singleton::UseSubclass;
+      
+      patternTable[HandlingPattern::SYNC]        = SingletonFac(UseSubclass<InvokeSyncNoThrow>());
+      patternTable[HandlingPattern::SYNC_THROW]  = SingletonFac(UseSubclass<InvokeSyncThrow>());
+      patternTable[HandlingPattern::ASYNC]       = SingletonFac(UseSubclass<InvokeAsync>());
+    }
+    
+    
+    lumiera::LifecycleHook _schedule (mobject::ON_SESSION_START, &prepareCommandHandlingPatterns);
+  
+  } // (END) definition of concrete handling patterns
+  
+  
+  
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/src/proc/mobject/session.hpp b/src/proc/mobject/session.hpp
index c9b0c5c62..7ce03ed62 100644
--- a/src/proc/mobject/session.hpp
+++ b/src/proc/mobject/session.hpp
@@ -36,6 +36,7 @@
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/session/defsmanager.hpp"
 #include "lib/singleton.hpp"
+#include "include/symbol.hpp"
 
 #include <boost/noncopyable.hpp>
 #include <tr1/memory>
@@ -98,9 +99,9 @@ namespace mobject {
     };
   
   
-  extern Symbol ON_SESSION_START;  ///< triggered before loading any content into a newly created session
-  extern Symbol ON_SESSION_INIT;   ///< triggered when initialising a new session, after adding content
-  extern Symbol ON_SESSION_END;    ///< triggered before discarding an existing session
+  extern lumiera::Symbol ON_SESSION_START;  ///< triggered before loading any content into a newly created session
+  extern lumiera::Symbol ON_SESSION_INIT;   ///< triggered when initialising a new session, after adding content
+  extern lumiera::Symbol ON_SESSION_END;    ///< triggered before discarding an existing session
   
   
   namespace session {
diff --git a/tests/lib/singleton-subclass-test.cpp b/tests/lib/singleton-subclass-test.cpp
index 3a925b70e..1ffa4a079 100644
--- a/tests/lib/singleton-subclass-test.cpp
+++ b/tests/lib/singleton-subclass-test.cpp
@@ -25,7 +25,7 @@
 #include "lib/util.hpp"
 
 #include "testtargetobj.hpp"
-#include "lib/singletonsubclass.hpp"
+#include "lib/singleton-subclass.hpp"
 
 #include <boost/lexical_cast.hpp>
 #include <boost/format.hpp>
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 4f6605af1..1972e98c8 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1025,7 +1025,7 @@ A command is operated or executed by passing it to an ''execution pattern'' &amp
 When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. Anyway, a ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
 </pre>
 </div>
-<div title="CommandUsage" modifier="Ichthyostega" modified="200908011235" created="200907212338" tags="SessionLogic draft dynamic" changecount="7">
+<div title="CommandUsage" modifier="Ichthyostega" modified="200908091509" created="200907212338" tags="SessionLogic draft dynamic" changecount="8">
 <pre>//for now (7/09) I'll use this page to collect ideas how commands might be used...//
 
 * use a command for getting a log entry and an undo possibility automatically
@@ -1053,7 +1053,7 @@ When a command has been executed (and maybe undone), it's best to leave it alone
 
 !!!an execution pattern....
 * can only be defined in code by a class definition, not at runtime
-* subclasses the ~HandlingPattern interface, which automatically creates an registration.
+* subclasses the ~HandlingPattern interface and uses an predefined ID (enum).
 * a singleton instance is created on demand, triggered by referring the pattern's ID
 * is conceptually //stateless// &amp;mdash; of course there can be common configuration values
 * is always invoked providing a concrete command instance to execute

From 5988b1d697b86ab1fc26e6c290e871e978b9b39a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 10 Aug 2009 01:30:59 +0200
Subject: [PATCH 245/368] clean up command interface

---
 src/proc/control/argument-erasure.hpp         | 537 ++++++++++++++++++
 src/proc/control/command-registry.hpp         |  12 +
 src/proc/control/command.cpp                  |   9 +-
 src/proc/control/command.hpp                  |   1 -
 .../proc/control/command-mutation-test.cpp    |   1 +
 .../proc/control/command-use1-test.cpp        |  39 +-
 .../proc/control/command-use2-test.cpp        |   4 +-
 .../proc/control/command-use3-test.cpp        |   2 +-
 8 files changed, 570 insertions(+), 35 deletions(-)
 create mode 100644 src/proc/control/argument-erasure.hpp

diff --git a/src/proc/control/argument-erasure.hpp b/src/proc/control/argument-erasure.hpp
new file mode 100644
index 000000000..003a38391
--- /dev/null
+++ b/src/proc/control/argument-erasure.hpp
@@ -0,0 +1,537 @@
+/*
+  ARGUMENT-TUPLE-ACCEPT.hpp  -  helper template providing a bind(...) member function
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file argument-tuple-accept.hpp
+ ** The AcceptArgumentBinding template allows to mix in a \c bind(...) function.
+ ** Thereby, the correct number and types of arguments is derived according to
+ ** the function signature given as template parameter. This helper template is
+ ** used for the ArgumentHolder and generally for binding the arguments when
+ ** defining Proc-Layer commands.
+ ** 
+ ** @see CommandDef
+ ** @see ArgumentHolder
+ ** @see argument-tuple-accept-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_ARGUMENT_TUPLE_ACCEPT_H
+#define CONTROL_ARGUMENT_TUPLE_ACCEPT_H
+
+#include "lib/meta/typelist.hpp"
+#include "lib/meta/function.hpp"
+#include "lib/meta/tuple.hpp"
+
+
+
+namespace control {
+  
+  
+  namespace bind_arg { // internals....
+    
+    using namespace lumiera::typelist;
+    
+    
+    /** @internal mix in a function operator */
+    template< class TAR, class BA, class RET
+            , typename TYPES
+            >
+    struct AcceptArgs ;
+    
+    
+    /* specialisations for 0...9 Arguments.... */
+    
+    template< class TAR, class BA, class RET
+            >                                                                        //____________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<> >                                         ///< Accept dummy binding (0 Arguments)
+      : BA
+      {
+        RET
+        operator() ()
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            >                                                                        //_______________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
+      : BA
+      {
+        RET
+        operator() (T1 a1)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            , typename T9
+            >                                                                        //________________________________
+    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
+      : BA
+      {
+        RET
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+          }
+      };
+    
+    
+    
+    /** @internal mix in a \c bind() function
+     */
+    template< class TAR, class BA, class RET
+            , typename TYPES
+            >
+    struct AcceptBind ;
+    
+    
+    /* specialisations for 0...9 Arguments.... */
+    
+    template< class TAR, class BA, class RET
+            >                                                                        //____________________________________
+    struct AcceptBind<TAR,BA,RET, Types<> >                                         ///< Accept dummy binding (0 Arguments)
+      : BA
+      {
+        RET
+        bind ()
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            >                                                                        //_______________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
+      : BA
+      {
+        RET
+        bind (T1 a1)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3, T4 a4)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+          }
+      };
+    
+    
+    template< class TAR, class BA, class RET
+            , typename T1
+            , typename T2
+            , typename T3
+            , typename T4
+            , typename T5
+            , typename T6
+            , typename T7
+            , typename T8
+            , typename T9
+            >                                                                        //________________________________
+    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
+      : BA
+      {
+        RET
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+          }
+      };
+    
+    
+    
+    template<typename SIG>
+    struct _Type
+      {
+        typedef typename FunctionSignature< function<SIG> >::Args Args;
+        typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
+        typedef Tuple<Args> ArgTuple;
+        typedef SIG Sig;
+      };
+    
+    template<typename TYPES>
+    struct _Type<Tuple<TYPES> >
+      {
+        typedef TYPES Args;
+        typedef void  Ret;
+        typedef Tuple<TYPES> ArgTuple;
+        typedef typename FunctionTypedef<void, TYPES>::Sig Sig;
+      };
+  
+    struct Dummy {}; 
+    
+    
+  } // (END) impl details (bind_arg)
+  
+  
+  
+  
+  /** Helper Template for building a Functor or function-like class:
+   *  Mix in a function call operator, which mimics the specified signature SIG .
+   *  This template is to be used as a base class to inherit the target type TAR from;
+   *  this target type is assumed to provide a function \bindArg(Tuple<TYPES..>) --
+   *  where \c TYPES... is the sequence of types found in the provided Signature SIG.
+   */
+  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
+  class AcceptArgumentTuple
+    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
+                                          , typename bind_arg::_Type<SIG>::Args>
+    {
+    };
+  
+  
+  /** Helper Template for Proc-Layer control::Command : mix in a \c bind(...) function
+   *  @param SIG  function signature to mimic (regarding the arguments and return type)
+   *  @param TAR  the target class providing a function \c bindArg(Tuple<Types<T1...> >)
+   *  @param BASE the base class for inheritance chaining
+   */
+  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
+  class AcceptArgumentBinding
+    : public bind_arg::AcceptBind<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
+                                          , typename bind_arg::_Type<SIG>::Args>   
+    {
+    };
+  
+    
+  /** Variation of AcceptArgumentBinding, allowing to control the return type 
+   *  of the generated \c bind(...) functions independently from SIG
+   */
+  template<typename RET, typename SIG, class TAR, class BASE =bind_arg::Dummy>
+  class AcceptArgumentBindingRet
+    : public bind_arg::AcceptBind<TAR,BASE, RET
+                                          , typename bind_arg::_Type<SIG>::Args>
+    {
+    };
+  
+  
+  
+  /** 
+   * Adapter interface for invoking an argument binding (e.g. as defined through
+   * AcceptArgumentBinding) \em without the need to disclose the concrete type
+   * actually accepting the bind call. This is an application of "type erasure"
+   */
+  struct Arguments;
+  
+  template<typename TUP>
+  struct TypedArguments;
+  
+  
+  struct Arguments
+    {
+      virtual ~Arguments() {}
+     
+      template<typename TUP>
+      TUP const&
+      get ()
+        {
+          TypedArguments<TUP>* dest = dynamic_cast<TypedArguments<TUP>*> (this);
+          if (!dest)
+            throw lumiera::error::Invalid("Wrong type or number of arguments");
+          
+          return dest->args_;
+        }
+    };
+  
+  
+  template<typename TUP>
+  struct TypedArguments
+    : Arguments
+    {
+      TUP const& args_;
+      
+      TypedArguments (TUP const& a)
+        : args_(a)
+        { }
+    };
+  
+    
+    
+
+
+  
+} // namespace control
+#endif
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 2aaea1e52..fba0ad032 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -89,6 +89,18 @@ namespace control {
         }
       
       
+      /** remove the given command registration. 
+       *  @return \c true if actually removed an entry
+       *  @note existing command instances remain valid;
+       *        storage will be freed at zero use-count */
+      bool
+      remove (Symbol cmdID)
+        {
+          Lock sync(this);
+          UNIMPLEMENTED ("de-register a command definition.");
+        }
+      
+      
       /** query the command index by ID
        *  @return the registered command,
        *          or an "invalid" token */
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index ce3b139d0..eca322e58 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -162,14 +162,7 @@ namespace control {
   bool
   Command::remove (Symbol cmdID)
   {
-    UNIMPLEMENTED ("de-register a single command instance");
-  }
-  
-  
-  bool
-  Command::undef (Symbol cmdID)
-  {
-    UNIMPLEMENTED ("completely drop a command definition, together with all dependent instances");
+    return CommandRegistry::instance().remove (cmdID); 
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 525af5962..642e8cbbe 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -84,7 +84,6 @@ namespace control {
       static Command get (Symbol cmdID);
       static Command get (FuncPtr func);
       static bool remove (Symbol cmdID); 
-      static bool  undef (Symbol cmdID);
       
       Command storeDef (Symbol newCmdID);
       
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index b52a10a5f..39c88355c 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -22,6 +22,7 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/meta/typelist.hpp"
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index f004f7006..c7bcf4326 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -238,14 +238,14 @@ namespace test    {
           
           // use the current sate of c2 as Prototype for new command definition
           c2.storeDef ("test.command1.4");
-          Command c3 = Command::get("test.command1.4");
-          ASSERT (c3);
-          ASSERT (!c3.canUndo());
-          c3();
+          Command c4 = Command::get("test.command1.4");
+          ASSERT (c4);
+          ASSERT (!c4.canUndo());
+          c4();
           ASSERT (randVal + 2*23 == command1::check_);
           
-          c3.bind(-command1::check_);
-          c3();
+          c4.bind(-command1::check_);
+          c4();
           ASSERT (0 == command1::check_);
           c2();
           ASSERT (23 == command1::check_);
@@ -297,34 +297,27 @@ namespace test    {
           ASSERT (!miracle.canUndo());
           ASSERT (!miracle);
           
+          Command c4 (Command::get("test.command1.4"));
+          
           ASSERT (Command::remove("test.command1.1"));
           ASSERT (Command::remove("test.command1.2"));
           ASSERT (Command::remove("test.command1.3"));
+          ASSERT (Command::remove("test.command1.4"));
           
           ASSERT (!Command::remove("miracle")); // there is no such thing...
-          
-          // note, we didn't remove the *definitions*
-          // thus we're free to create new instances...
-          Command xxx = Command::get("test.command1.1");
-          VERIFY_ERROR (UNBOUND_ARGUMENTS, xxx() );
-          
-          // but this one is still there (we didn't remove it)
-          ASSERT (Command::get("test.command1.4"));
-          
-          // now kill the definitions too...
-          ASSERT (Command::undef ("test.command1.1"));
-          ASSERT (Command::undef ("test.command1.2"));
-          ASSERT (Command::undef ("test.command1.3"));
-          ASSERT (Command::undef ("test.command1.4"));
-          ASSERT (Command::undef ("miracle"));
 
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.1"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.2"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.3"));
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.4"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("miracle"));
           
-          // note: removing the definition automatically killed the remaining instance:
-          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.4"));
+          
+          // note, removed the registered definitions,
+          // but existing instances remain valid...
+          // thus we're free to create new instances...
+          ASSERT (c4.isValid());
+          ASSERT (c4.canExec());
         }
     };
   
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
index 5b6e18be6..e8d217fd2 100644
--- a/tests/components/proc/control/command-use2-test.cpp
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -141,8 +141,8 @@ namespace test    {
           check_ThrowOnError();
           
           
-          Command::undef ("test.command2");
-          Command::undef ("test.command2.1");
+          Command::remove ("test.command2");
+          Command::remove ("test.command2.1");
           ASSERT (cnt_defs == Command::definition_count());
           ASSERT (cnt_inst == Command::instance_count());
         }
diff --git a/tests/components/proc/control/command-use3-test.cpp b/tests/components/proc/control/command-use3-test.cpp
index f922c55d6..0ce985079 100644
--- a/tests/components/proc/control/command-use3-test.cpp
+++ b/tests/components/proc/control/command-use3-test.cpp
@@ -105,7 +105,7 @@ namespace test    {
           
           ASSERT (cnt_inst == Command::instance_count());
           
-          Command::undef ("test.command1.1");
+          Command::remove ("test.command1.1");
           ASSERT (cnt_defs == Command::definition_count());
         }
       

From b9763b6c16a5184e6c8370d14af68f9f0b3fe8f0 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 10 Aug 2009 01:32:33 +0200
Subject: [PATCH 246/368] command frontend sort-of written now, pending
 integration test

---
 src/proc/control/argument-erasure.hpp        | 477 +------------------
 src/proc/control/argument-tuple-accept.hpp   |  41 --
 src/proc/control/command-argument-holder.hpp |   2 +-
 src/proc/control/command-binding.hpp         |  17 +-
 src/proc/control/command-closure.hpp         |  28 +-
 src/proc/control/command-def.hpp             |  26 +-
 src/proc/control/command-mutation.hpp        |   4 +-
 src/proc/control/command-registry.hpp        |   2 +-
 src/proc/control/command.cpp                 |  22 +-
 src/proc/control/command.hpp                 |  51 +-
 src/proc/control/handling-patterns.hpp       |   2 +-
 11 files changed, 110 insertions(+), 562 deletions(-)

diff --git a/src/proc/control/argument-erasure.hpp b/src/proc/control/argument-erasure.hpp
index 003a38391..fc825024d 100644
--- a/src/proc/control/argument-erasure.hpp
+++ b/src/proc/control/argument-erasure.hpp
@@ -1,5 +1,5 @@
 /*
-  ARGUMENT-TUPLE-ACCEPT.hpp  -  helper template providing a bind(...) member function
+  ARGUMENT-ERASURE.hpp  -  helper for passing on a dynamic typed argument tuple
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,478 +21,31 @@
 */
 
 
-/** @file argument-tuple-accept.hpp
- ** The AcceptArgumentBinding template allows to mix in a \c bind(...) function.
- ** Thereby, the correct number and types of arguments is derived according to
- ** the function signature given as template parameter. This helper template is
- ** used for the ArgumentHolder and generally for binding the arguments when
- ** defining Proc-Layer commands.
- ** 
- ** @see CommandDef
- ** @see ArgumentHolder
- ** @see argument-tuple-accept-test.cpp
- **
- */
 
+#ifndef CONTROL_ARGUMENT_ERASURE_H
+#define CONTROL_ARGUMENT_ERASURE_H
 
-
-#ifndef CONTROL_ARGUMENT_TUPLE_ACCEPT_H
-#define CONTROL_ARGUMENT_TUPLE_ACCEPT_H
-
-#include "lib/meta/typelist.hpp"
-#include "lib/meta/function.hpp"
-#include "lib/meta/tuple.hpp"
+#include "lib/error.hpp"
 
 
 
 namespace control {
   
   
-  namespace bind_arg { // internals....
-    
-    using namespace lumiera::typelist;
-    
-    
-    /** @internal mix in a function operator */
-    template< class TAR, class BA, class RET
-            , typename TYPES
-            >
-    struct AcceptArgs ;
-    
-    
-    /* specialisations for 0...9 Arguments.... */
-    
-    template< class TAR, class BA, class RET
-            >                                                                        //____________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<> >                                         ///< Accept dummy binding (0 Arguments)
-      : BA
-      {
-        RET
-        operator() ()
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            >                                                                        //_______________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
-      : BA
-      {
-        RET
-        operator() (T1 a1)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3, T4 a4)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            , typename T8
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            , typename T8
-            , typename T9
-            >                                                                        //________________________________
-    struct AcceptArgs<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
-      : BA
-      {
-        RET
-        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
-          }
-      };
-    
-    
-    
-    /** @internal mix in a \c bind() function
-     */
-    template< class TAR, class BA, class RET
-            , typename TYPES
-            >
-    struct AcceptBind ;
-    
-    
-    /* specialisations for 0...9 Arguments.... */
-    
-    template< class TAR, class BA, class RET
-            >                                                                        //____________________________________
-    struct AcceptBind<TAR,BA,RET, Types<> >                                         ///< Accept dummy binding (0 Arguments)
-      : BA
-      {
-        RET
-        bind ()
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple() );
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            >                                                                        //_______________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1> >                                       ///< Accept binding for 1 Argument
-      : BA
-      {
-        RET
-        bind (T1 a1)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2> >                                    ///< Accept binding for 2 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3> >                                 ///< Accept binding for 3 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4> >                              ///< Accept binding for 4 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3, T4 a4)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5> >                           ///< Accept binding for 5 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6> >                        ///< Accept binding for 6 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7> >                     ///< Accept binding for 7 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            , typename T8
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8> >                  ///< Accept binding for 8 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
-          }
-      };
-    
-    
-    template< class TAR, class BA, class RET
-            , typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            , typename T8
-            , typename T9
-            >                                                                        //________________________________
-    struct AcceptBind<TAR,BA,RET, Types<T1,T2,T3,T4,T5,T6,T7,T8,T9> >               ///< Accept binding for 9 Arguments
-      : BA
-      {
-        RET
-        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)
-          {
-            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
-          }
-      };
-    
-    
-    
-    template<typename SIG>
-    struct _Type
-      {
-        typedef typename FunctionSignature< function<SIG> >::Args Args;
-        typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
-        typedef Tuple<Args> ArgTuple;
-        typedef SIG Sig;
-      };
-    
-    template<typename TYPES>
-    struct _Type<Tuple<TYPES> >
-      {
-        typedef TYPES Args;
-        typedef void  Ret;
-        typedef Tuple<TYPES> ArgTuple;
-        typedef typename FunctionTypedef<void, TYPES>::Sig Sig;
-      };
-  
-    struct Dummy {}; 
-    
-    
-  } // (END) impl details (bind_arg)
   
   
   
   
-  /** Helper Template for building a Functor or function-like class:
-   *  Mix in a function call operator, which mimics the specified signature SIG .
-   *  This template is to be used as a base class to inherit the target type TAR from;
-   *  this target type is assumed to provide a function \bindArg(Tuple<TYPES..>) --
-   *  where \c TYPES... is the sequence of types found in the provided Signature SIG.
-   */
-  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
-  class AcceptArgumentTuple
-    : public bind_arg::AcceptArgs<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
-                                          , typename bind_arg::_Type<SIG>::Args>
-    {
-    };
-  
-  
-  /** Helper Template for Proc-Layer control::Command : mix in a \c bind(...) function
-   *  @param SIG  function signature to mimic (regarding the arguments and return type)
-   *  @param TAR  the target class providing a function \c bindArg(Tuple<Types<T1...> >)
-   *  @param BASE the base class for inheritance chaining
-   */
-  template<typename SIG, class TAR, class BASE =bind_arg::Dummy>
-  class AcceptArgumentBinding
-    : public bind_arg::AcceptBind<TAR,BASE, typename bind_arg::_Type<SIG>::Ret
-                                          , typename bind_arg::_Type<SIG>::Args>   
-    {
-    };
-  
-    
-  /** Variation of AcceptArgumentBinding, allowing to control the return type 
-   *  of the generated \c bind(...) functions independently from SIG
-   */
-  template<typename RET, typename SIG, class TAR, class BASE =bind_arg::Dummy>
-  class AcceptArgumentBindingRet
-    : public bind_arg::AcceptBind<TAR,BASE, RET
-                                          , typename bind_arg::_Type<SIG>::Args>
-    {
-    };
-  
-  
   
   /** 
-   * Adapter interface for invoking an argument binding (e.g. as defined through
-   * AcceptArgumentBinding) \em without the need to disclose the concrete type
-   * actually accepting the bind call. This is an application of "type erasure"
+   * Adapter interface for invoking an argument binding for a command
+   * \em without the need to disclose the concrete types and number of arguments.
+   * At the receiver side, the concrete type can be restored by a dynamic cast.
+   * This requires the receiver somehow to know the desired argument types;
+   * usually this receiver will be an implementation object, whose exact
+   * type has been erased after definition, while the implementation
+   * internally of course knows the type and thus can perform an
+   * dynamic cast on the passed on argument tuple 
    */
   struct Arguments;
   
@@ -528,10 +81,8 @@ namespace control {
         { }
     };
   
-    
-    
-
-
+  
+  
   
 } // namespace control
 #endif
diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 003a38391..8a7d2d2f7 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -489,49 +489,8 @@ namespace control {
   
   
   
-  /** 
-   * Adapter interface for invoking an argument binding (e.g. as defined through
-   * AcceptArgumentBinding) \em without the need to disclose the concrete type
-   * actually accepting the bind call. This is an application of "type erasure"
-   */
-  struct Arguments;
-  
-  template<typename TUP>
-  struct TypedArguments;
   
   
-  struct Arguments
-    {
-      virtual ~Arguments() {}
-     
-      template<typename TUP>
-      TUP const&
-      get ()
-        {
-          TypedArguments<TUP>* dest = dynamic_cast<TypedArguments<TUP>*> (this);
-          if (!dest)
-            throw lumiera::error::Invalid("Wrong type or number of arguments");
-          
-          return dest->args_;
-        }
-    };
-  
-  
-  template<typename TUP>
-  struct TypedArguments
-    : Arguments
-    {
-      TUP const& args_;
-      
-      TypedArguments (TUP const& a)
-        : args_(a)
-        { }
-    };
-  
-    
-    
-
-
   
 } // namespace control
 #endif
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index cdb3f2d73..189a8f84e 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -22,7 +22,7 @@
 
 
 /** @file command-argument-holder.hpp
- ** A passive container record holding the actual command arguments & UNDO state. 
+ ** A passive container record holding the actual command arguments & UNDO state.
  ** While all command objects themselves have a common type (type erasure),
  ** the actual argument tuple and the state memento for UNDO can't. Especially,
  ** the size of arguments and memento will depend on their respective types.
diff --git a/src/proc/control/command-binding.hpp b/src/proc/control/command-binding.hpp
index 35b81b575..14532ecbb 100644
--- a/src/proc/control/command-binding.hpp
+++ b/src/proc/control/command-binding.hpp
@@ -43,21 +43,15 @@
 #ifndef CONTROL_COMMAND_BINDING_H
 #define CONTROL_COMMAND_BINDING_H
 
-//#include "pre.hpp"
-//#include "include/symbol.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/tuple.hpp"
 
-//#include <tr1/memory>
-
 
 
 
 namespace control {
 namespace com { ///< Proc-Layer command implementation details
   
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
   using namespace lumiera::typelist;
   
   
@@ -65,7 +59,12 @@ namespace com { ///< Proc-Layer command implementation details
   
   
   /**
-   * @todo Type-comment
+   * Building block for commands, allowing to mix in
+   * a set of \c bind(...) function for up to nine arbitrary arguments.
+   * All these functions will package the argument values into a Tuple
+   * (record) and forward the call to a \c bindArg(Tuple<TYPES...>) function
+   * on the target class. The latter function is asumed to perform a 
+   * run-time check to detect calls with invalid signature.
    */
   template<class TAR, class BA>
   class ArgumentBinder
@@ -203,10 +202,8 @@ namespace com { ///< Proc-Layer command implementation details
       }
     
     };
-  ////////////////TODO currently just fleshing  out the API....
   
-
-
+  
   
   
 }} // namespace control::com
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index d0e2cf247..fc3e70d0f 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -23,6 +23,17 @@
 
 /** @file command-closure.hpp
  ** A closure enabling self-contained execution of commands within the ProcDispatcher.
+ ** After defining a proc-layer command, at some point the function arguments
+ ** of the contained operation are "closed" by storing concrete argument values.
+ ** These values will later on be fed to the operation when the command is invoked.
+ ** 
+ ** Most of the command machinery accesses this function closure through the interface
+ ** CmdClosure, while, when defining a command, subclasses typed to the specific
+ ** function arguments are created. Especially, there is an ArgumentHolder template,
+ ** which is used to define the storage for the concrete arguments. This ArgumentHolder
+ ** internally contains an Closure<SIG> instance (where SIG is the signature of the
+ ** actual command operation function), which implements the invocation of the
+ ** operation function with the stored argument tuple.
  ** //TODO
  **  
  ** @see Command
@@ -44,7 +55,7 @@
 #include "lib/meta/tuple.hpp"
 #include "lib/format.hpp"
 #include "lib/util.hpp"
-#include "proc/control/argument-tuple-accept.hpp"  ////TODO better factor out struct TypedArguments
+#include "proc/control/argument-erasure.hpp"
 #include "proc/control/typed-allocation-manager.hpp"
 
 #include <tr1/memory>
@@ -54,17 +65,10 @@
 #include <string>
 
 
-#include "lib/test/test-helper.hpp"  /////////////////TODO remove this
-using lib::test::showSizeof;
-
-using std::cout;    //////////////////////////////////TODO remove this
-using std::endl;
 
 
 namespace control {
   
-//  using lumiera::Symbol;
-//  using std::tr1::shared_ptr;
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::Tuple;
   using lumiera::typelist::BuildTupleAccessor;
@@ -72,9 +76,8 @@ namespace control {
   using lumiera::typelist::FunErasure;
   using lumiera::typelist::StoreFunction;
   using lumiera::typelist::NullType;
-
+  
   using util::unConst;
-
   using std::tr1::function;
   using std::ostream;
   using std::string;
@@ -118,6 +121,7 @@ namespace control {
   
   
   
+  /** Helper for accessing an individual function parameter */
   template
     < typename TY
     , class BASE
@@ -260,9 +264,7 @@ namespace control {
       friend bool operator== (Closure const& c1, Closure const& c2)  { return compare (c1.params_, c2.params_); }
       friend bool operator!= (Closure const& c1, Closure const& c2)  { return ! (c1 == c2); }
     };
-    
-    
-  ////////////////TODO currently just fleshing  out the API....
+  
   
   
   
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 3d952fe80..16b494102 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -28,7 +28,7 @@
  ** \em defining the concrete operations to be encapsulated into a command. To
  ** create a command, you need to provide three functors (for the actual operation,
  ** the undo operation and for capturing undo state prior to invoking the operation).
- ** Besides, you provide a \em binding, thus creating a closue out of these three
+ ** Besides, you provide a \em binding, thus creating a closure out of these three
  ** function objects and a set of actual parameters. This closure effectively is 
  ** the command, which in a last step can be either dispatched, stored or 
  ** invoked immediately.
@@ -49,6 +49,7 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
+#include "include/logging.h"
 #include "include/symbol.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/command-impl.hpp"                   /////TODO: any chance to get rid of this import here??
@@ -57,11 +58,12 @@
 #include "proc/control/command-mutation.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
+#include "lib/bool-checkable.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelist-util.hpp"
 #include "lib/meta/tuple.hpp"
-#include "lib/bool-checkable.hpp"
+#include "lib/util.hpp"
 
 #include <tr1/memory>
 #include <tr1/functional>
@@ -71,9 +73,10 @@
 
 namespace control {
   
-  using lumiera::Symbol;
   using std::tr1::shared_ptr;
   using std::tr1::function;
+  using lumiera::Symbol;
+  using util::cStr;
   
   using lumiera::typelist::FunctionSignature;
   using lumiera::typelist::FunctionTypedef;
@@ -82,7 +85,7 @@ namespace control {
   using lumiera::typelist::Tuple;
   
   
-  namespace stage { ///< helpers for the building up a command definition
+  namespace stage { ///< helpers for building up a command definition
     
     
     
@@ -99,7 +102,7 @@ namespace control {
         CompletedDefinition (Command& definedCommand)
           : prototype_(definedCommand)
           {
-                    
+            TRACE (command_dbg, "Completed definition of %s.", cStr(prototype_));
           }
         
         typedef HandlingPattern::ID PattID;
@@ -144,9 +147,7 @@ namespace control {
           , operFunctor_(commandOperation)
           , captFunctor_(undoCapOperation)
           , undoFunctor_()
-          {
-            cout << showSizeof(undoCapOperation) << endl;
-          }
+          { }
         
         
         CompletedDefinition<SIG>
@@ -182,8 +183,8 @@ namespace control {
     
     
     
-  
-  
+    
+    
     template<typename SIG>
     struct BasicDefinition
       {
@@ -238,7 +239,9 @@ namespace control {
       CommandDef (Symbol cmdID)
         : id_(cmdID)
         , prototype_(Command::fetchDef(cmdID))
-        { }
+        {
+          TRACE (command_dbg, "starting CommandDef('%s')...", cmdID);
+        }
       
       template<typename SIG>
       stage::BasicDefinition<SIG>
@@ -252,7 +255,6 @@ namespace control {
       bool isValid()  const;
     };
   
-  ////////////////TODO currently just fleshing  out the API....
   
   
   
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 92a5c876b..bfc5b66af 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -22,7 +22,7 @@
 
 
 /** @file command-mutation.hpp
- ** Core of a Proc-Layer command: functor containing the actual operation to be executed.
+ ** Core of a Proc-Layer command: functor containing the operation to be executed.
  ** Each command holds two of these functors: one representing the actual operation
  ** and one to undo the effect of this operation. The latter involves the capturing
  ** and storing of a "memento" value behind the scenes. But towards Command, the
@@ -34,7 +34,7 @@
  ** Mutation objects are to be created based on a concrete function object, which then
  ** gets embedded into a type erasure container, thus disposing the specific type information.
  ** Moreover, building on this lib::OpaqueHolder yields a fixed size storage for Mutation objects,
- ** allowing them to be embedded immediately within the Command instance.
+ ** allowing them to be embedded immediately within the CommandImpl frame.
  ** 
  ** Later on, any command needs to be made ready for execution by binding it to a specific
  ** execution environment, which especially includes the target objects to be mutated by the
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index fba0ad032..9dd5206a9 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -80,7 +80,7 @@ namespace control {
       
       /** register a command (Frontend) under the given ID
        *  @return either the new command, or an already existing
-       *          command registered under the given ID*/ 
+       *          command registered under the given ID  */ 
       Command
       track (Symbol cmdID, Command const& commandHandle)
         {
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index eca322e58..ec3303063 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -22,7 +22,16 @@
 
 
 /** @file command.cpp 
- ** //TODO 
+ ** Implementation of the command frontend. 
+ ** Within this file, the implementation level of the command frontend
+ ** is linked to the implementation of the command registry. Client code
+ ** is shielded from those implementation classes and need only include
+ ** command.hpp
+ ** 
+ ** More specifically, the actual number and type of arguments and the
+ ** concrete functions implementing the command operation are known only
+ ** at the time of the command definition; this detailed type information
+ ** is erased afterwards, allowing client code to use a simple frontend.
  ** 
  ** @see command.hpp
  ** @see command-registry.hpp
@@ -38,9 +47,6 @@
 #include "proc/control/command-impl.hpp"
 #include "proc/control/command-registry.hpp"
 #include "proc/control/handling-pattern.hpp"
-//#include "proc/mobject/mobject-ref.hpp"
-//#include "proc/mobject/mobject.hpp"
-//#include "proc/mobject/placement.hpp"
 
 #include <boost/format.hpp>
 #include <sstream>
@@ -68,11 +74,11 @@ namespace control {
   lumiera::Singleton<CommandRegistry> CommandRegistry::instance;
   
   
-
+  
   Command::~Command() { }
   
   
-
+  
   /** */
   Command 
   Command::get (Symbol cmdID)
@@ -248,7 +254,7 @@ namespace control {
     
     return repr.str();
   }
-
+  
   
   
   
@@ -295,7 +301,7 @@ namespace control {
   {
     return impl().setHandlingPattern(pattID);
   }
-
+  
   
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 642e8cbbe..18f4ca36e 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -22,8 +22,26 @@
 
 
 /** @file command.hpp
- ** //TODO 
- **
+ ** Proc-Layer command frontend.
+ ** A \b command is a functor, which can be invoked according to a pre-defined HandlingPattern.
+ ** Most notably, command invocation can be scheduled and logged with the serialiser, and the effect
+ ** of any command invocation can be \em undone later on by invoking the "undo operation" defined
+ ** alongside with the command's operation. The command operation is defined through a C/C++ function
+ ** and may receive an arbitrary number and type of arguments. After setting up such a CommandDef ,
+ ** it can be referred for use through a symbolic ID. Before being able to invoke the command, concrete
+ ** function arguments need to be provided (this is called "binding" or "closing the function arguments").
+ ** These function arguments are stored within the command definition and remain opaque to the client code
+ ** actually invoking the command. Behind the scenes, there is a CommandRegistry, holding an index of the
+ ** registered commands and managing the storage for command definitions and arguments. The actual 
+ ** Command object used by client code is a small, copyable and ref-counting handle to this 
+ ** stored definition backend.
+ ** 
+ ** //TODO maybe summarise how UNDO works?  
+ ** 
+ ** @see command-def.hpp
+ ** @see command-use1-test.cpp
+ ** @see command-use2-test.cpp
+ ** @see command-use3-test.cpp
  ** @see ProcDispatcher
  ** @see Session
  **
@@ -35,15 +53,15 @@
 #define CONTROL_COMMAND_H
 
 #include "pre.hpp"
+#include "lib/error.hpp"
 #include "include/symbol.hpp"
 #include "proc/control/command-binding.hpp"
-#include "proc/control/command-mutation.hpp"         /////TODO: do we need to expose this here?
-#include "proc/control/command-closure.hpp"
+#include "proc/control/argument-erasure.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "lib/bool-checkable.hpp"
+#include "lib/meta/tuple.hpp"
 #include "lib/handle.hpp"
 
-//#include <tr1/memory>
 #include <string>
 
 ///////////////////////////////////////////TODO: define an C-API representation here, make the header multilingual!
@@ -55,14 +73,16 @@ namespace control {
   using std::string;
   using lumiera::Symbol;
   using std::tr1::shared_ptr;
+  using lumiera::typelist::Tuple;
+  
   
   LUMIERA_ERROR_DECLARE (UNBOUND_ARGUMENTS);  ///< Command functor not yet usable, because arguments aren't bound
   LUMIERA_ERROR_DECLARE (INVALID_COMMAND);    ///< Unknown or insufficiently defined command
   LUMIERA_ERROR_DECLARE (DUPLICATE_COMMAND);  ///< Attempt to redefine an already existing command definition
   LUMIERA_ERROR_DECLARE (INVALID_ARGUMENTS);  ///< Arguments provided for binding doesn't match stored command function parameters
-
   
-
+  
+  
   typedef void* FuncPtr;
   
   class CommandDef;
@@ -70,12 +90,23 @@ namespace control {
   
   
   /**
-   * @todo Type-comment
+   *  Handle object representing a single Command instance to be used by client code.
+   *  Commands are accessed \link #get through a symbolic ID \endlink; there need to be
+   *  a CommandDef somewhere to specify the actual operation and to define, how the
+   *  effect of the command can be undone. Moreover, the command's definition 
+   *  refers to a HandlingPattern, which describes how the command is actually
+   *  to be executed (the default is to schedule it within the ProcDispatcher)
+   *  
+   *  Client code usually just
+   *  - creates a command instance by referring to a command ID
+   *  - maybe binds to concrete arguments (e.g. a target object)
+   *  - triggers command execution through operator()
+   *  - maybe checks the return value for errors
    */
   class Command
     : public com::ArgumentBinder<Command    // accepts arbitrary bind(..) calls (with runtime check)
            , lib::Handle<CommandImpl>      //  actually implemented as ref counting Handle
-           >
+           >                              //
     {
       typedef lib::Handle<CommandImpl> _Handle;
       
@@ -177,7 +208,7 @@ namespace control {
       return ! (c1 == c2); 
     }
   
-
+  
   
   
 } // namespace control
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index 7b3d94d2b..b692aafae 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -146,7 +146,7 @@ namespace control {
     
     /** access the singleton instance for a given ID */
     HandlingPattern const&
-    getPatternInstance (HandlingPattern::ID id)
+    getPatternInstance (size_t id)
     {
       REQUIRE (id < patternTable.size());
       return patternTable[id] ();

From 8925c9a73bd549974eb69af223e553e7e25b4ed1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 10 Aug 2009 01:33:26 +0200
Subject: [PATCH 247/368] see ticket 205

---
 src/proc/control/command-impl.hpp     | 5 +++++
 src/proc/control/command-mutation.hpp | 1 +
 2 files changed, 6 insertions(+)

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 60141b0b0..58c906315 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -132,6 +132,11 @@ namespace control {
       setArguments (Arguments& args)
         {
           pClo_->bindArguments(args);
+          
+          TODO ("this will break when re-binding to new arguments");
+          
+          do_  .close(*pClo_);
+          undo_.close(*pClo_);
         }
       
       
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index bfc5b66af..3238b44ce 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -103,6 +103,7 @@ namespace control {
       virtual Mutation&
       close (CmdClosure& cmdClosure)
         {
+          ///////////////////////////////////////////////////////////////////////////////TODO we need a better approach; this breaks when re-binding
           REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
           REQUIRE (func_, "Param error: not bound to a valid function");
           func_ = cmdClosure.closeArguments(func_);

From 0d4d3f25dca8423ab6a379b820005affe5db4d7e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 11 Aug 2009 06:32:29 +0200
Subject: [PATCH 248/368] implement mising diagnostics

---
 src/proc/control/command-impl.hpp      | 19 +++++++++----------
 src/proc/control/handling-pattern.hpp  |  3 +++
 src/proc/control/handling-patterns.hpp | 18 ++++++++++++++++++
 3 files changed, 30 insertions(+), 10 deletions(-)

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 58c906315..5aa4ce533 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -163,31 +163,30 @@ namespace control {
       /* === diagnostics === */
       
       bool
-      isValid()  const
+      isValid()  const    ///< validity self-check: is basically usable.
         {
-          UNIMPLEMENTED ("command validity self check");
+          return bool(pClo_) 
+              && HandlingPattern::get(defaultPatt_).isValid();
         }
       
       bool
-      canExec()  const
+      canExec()  const    ///< state check: sufficiently defined to be invoked 
         {
-          UNIMPLEMENTED ("state check: sufficiently defined to be invoked");
+          return isValid()
+              && *pClo_ && do_;
         }
       
       bool
-      canUndo()  const
+      canUndo()  const    ///< state check: has undo state been captured? 
         {
-          UNIMPLEMENTED ("state check: has undo state been captured?");
+          return isValid() && undo_;
         }
       
       
       
       
     protected:
-//     static Command& fetchDef (Symbol cmdID);
-     
-//     friend class CommandDef;
-
+      
     };
   ////////////////TODO currently just fleshing  out the API....
   
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 67b326c81..09fad5b65 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -77,6 +77,7 @@ namespace control {
    * @todo Type-comment
    */
   class HandlingPattern
+    : public lib::BoolCheckable<HandlingPattern>
     {
       
     public:
@@ -106,6 +107,7 @@ namespace control {
       HandlingPattern const& howtoUNDO()  const;
       
       
+      virtual bool isValid()  const  =0;
       
     protected:
       
@@ -114,6 +116,7 @@ namespace control {
       virtual HandlingPattern const& defineUNDO()  const  =0;
       
       
+      
     };
   ////////////////TODO currently just fleshing  out the API....
   
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index b692aafae..f4f86313a 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -85,6 +85,12 @@ namespace control {
           {
             UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
           }
+        
+        bool
+        isValid()  const
+          {
+            UNIMPLEMENTED ("is this pattern currently able to handle commands?");
+          }
       };
     
     
@@ -107,6 +113,12 @@ namespace control {
           {
             UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
           }
+        
+        bool
+        isValid()  const
+          {
+            UNIMPLEMENTED ("is this pattern currently able to handle commands?");
+          }
       };
     
     
@@ -129,6 +141,12 @@ namespace control {
           {
             UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
           }
+        
+        bool
+        isValid()  const
+          {
+            UNIMPLEMENTED ("is this pattern currently able to handle commands?");
+          }
       };
     
     

From a845a4d2345f1bee0c91197096f170b21ec1b386 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 11 Aug 2009 08:35:37 +0200
Subject: [PATCH 249/368] unit test covering the cmd registry

---
 src/proc/control/command-impl.hpp             |   2 +-
 src/proc/control/handling-patterns.hpp        |   2 +-
 tests/45controller.tests                      |   5 +
 tests/components/Makefile.am                  |   1 +
 .../proc/control/command-registry-test.cpp    | 258 ++++++++++++++++++
 5 files changed, 266 insertions(+), 2 deletions(-)
 create mode 100644 tests/components/proc/control/command-registry-test.cpp

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 5aa4ce533..bb580693f 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -183,7 +183,7 @@ namespace control {
         }
       
       
-      
+      ////////////////////////////////////////////////////////////////////////////////////TODO comparisons
       
     protected:
       
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index f4f86313a..4892504af 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -163,7 +163,7 @@ namespace control {
     
     
     /** access the singleton instance for a given ID */
-    HandlingPattern const&
+    inline HandlingPattern const&
     getPatternInstance (size_t id)
     {
       REQUIRE (id < patternTable.size());
diff --git a/tests/45controller.tests b/tests/45controller.tests
index f8ea6c8e6..bc3409cc1 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -56,6 +56,11 @@ return: 0
 END
 
 
+PLANNED "Command index and allocation" CommandRegistry_test <<END
+return: 0
+END
+
+
 PLANNED "Command usage aspects I"  CommandUse1_test <<END
 return: 0
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 31c5a46e3..65f3ce2c9 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -53,6 +53,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-use1-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use2-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use3-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-registry-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
new file mode 100644
index 000000000..13dcb257c
--- /dev/null
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -0,0 +1,258 @@
+/*
+  CommandRegistry(Test)  -  verify command registration and allocation
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command.hpp"
+#include "proc/control/command-registry.hpp"
+#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+#include "include/symbol.hpp"
+#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+#include <tr1/functional>
+//#include <boost/ref.hpp>
+//#include <boost/format.hpp>
+//#include <iostream>
+//#include <cstdlib>
+//#include <string>
+
+
+namespace control {
+namespace test    {
+
+
+//  using boost::format;
+//  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+  using std::tr1::function;
+//  using std::tr1::bind;
+//  using std::string;
+  //using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+  using util::isSameObject;
+//  using util::contains;
+
+//  using session::test::TestClip;
+  using lumiera::Symbol;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  namespace { // test data and helpers...
+  
+    Symbol TEST_CMD  = "test.command1.1";
+    Symbol TEST_CMD2 = "test.command1.2";
+  }
+  
+  
+  
+  /*******************************************************************************
+   * @test verify sane behaviour of the relevant operations on the CommandRegistry
+   *       interface. Add/remove a command instance to the index, allocate an
+   *       CommandImpl frame and verify it is removed properly on ref count zero.
+   * @note this test covers the internal bits of functionality,
+   *       not the behaviour of the (integrated) command framework 
+   * 
+   * @todo planned but not implemented as of 8/09   see also Ticket #217
+   *        
+   * @see Command
+   * @see CommandRegistry
+   * @see command.cpp
+   * @see command-use1-test.cpp
+   */
+  class CommandRegistry_test : public Test
+    {
+
+      uint cnt_defs;
+      uint cnt_inst;
+
+      
+      virtual void
+      run (Arg) 
+        {
+          CommandRegistry& registry = CommandRegistry::instance();
+          ASSERT (&registry);
+          
+          cnt_defs = registry.index_size();
+          cnt_inst = registry.instance_count();
+          
+          // prepare a command definition (prototype)
+          CommandDef (TEST_CMD)
+              .operation (command1::operate)
+              .captureUndo (command1::capture)
+              .undoOperation (command1::undoIt)
+              .bind(123);
+          
+          // this command definition is
+          // represented internally by a prototype instance
+          ASSERT (1+cnt_inst == registry.instance_count());
+          cnt_inst++;
+
+          UNIMPLEMENTED ("cover all relevant API functions");
+          checkRegistration (registry);
+          checkAllocation(registry);
+          
+          ASSERT (cnt_inst == registry.instance_count());
+          ASSERT (cnt_defs == registry.index_size());
+          
+          Command::remove (TEST_CMD);
+          ASSERT (--cnt_inst == registry.instance_count());
+        }
+      
+      
+      void
+      checkRegistration (CommandRegistry& registry)
+        {
+          ASSERT (cnt_inst == registry.instance_count());
+          
+          Command cmd1 = registry.queryIndex (TEST_CMD);
+          ASSERT (cmd1);
+          ASSERT (string(TEST_CMD) == registry.findDefinition(cmd1));
+          
+          Command nonexistant = registry.queryIndex("miraculous");
+          ASSERT (!nonexistant);
+          
+          // now create a clone, registered under a different ID
+          Command cmd2 = cmd1.storeDef(TEST_CMD2);
+          ASSERT (cmd2 == cmd1);
+          cmd2.bind(54321);
+          ASSERT (cmd2 != cmd1);
+          
+          // this created exactly one additional instance allocation:
+          ASSERT (1+cnt_inst == registry.instance_count());
+          
+          
+          Command cmdX = registry.queryIndex(TEST_CMD2);
+          ASSERT (cmdX == cmd2);
+          ASSERT (cmdX != cmd1);
+          
+          ASSERT (registry.remove(TEST_CMD2));
+          ASSERT (!registry.queryIndex(TEST_CMD2));
+          ASSERT (cnt_inst == registry.instance_count());
+          
+          // create a new registration..
+          cmdX = registry.track(TEST_CMD, cmd2);  // but "accidentally" use an existing ID
+          ASSERT (cmdX == cmd1);                  // Oops, we got the existing registration...
+          
+          cmdX = registry.track(TEST_CMD2, cmd2);
+          ASSERT (registry.queryIndex(TEST_CMD2));
+          ASSERT (cmdX == cmd2);
+          ASSERT (cmdX != cmd1);
+          
+          ASSERT (1+cnt_inst == registry.instance_count());
+          
+          ASSERT (string(TEST_CMD2) == registry.findDefinition(cmdX));
+          
+          ASSERT ( registry.remove(TEST_CMD2));
+          ASSERT (!registry.remove("miraculous"));
+          
+          ASSERT (!registry.queryIndex(TEST_CMD2));
+          ASSERT ( registry.queryIndex(TEST_CMD));
+          
+          ASSERT (cnt_inst == registry.instance_count());
+        }
+      
+      
+      void
+      checkAllocation (CommandRegistry& registry)
+        {
+          // simulate what normally happens within a CommandDef
+          typedef void Sig_oper(int);
+          typedef long Sig_capt(int);
+          typedef void Sig_undo(int,long);
+          
+          function<Sig_oper> o_Fun (command1::operate);
+          function<Sig_capt> c_Fun (command1::capture);
+          function<Sig_undo> u_Fun (command1::undoIt);
+          
+          ASSERT (o_Fun && c_Fun && u_Fun);
+          ASSERT (cnt_inst == registry.instance_count());
+          
+          // when the CommandDef is complete, it issues the
+          // allocation call to the registry behind the scenes....
+          
+          typedef shared_ptr<CommandImpl> PImpl;
+          
+          PImpl pImpl = registry.newCommandImpl(o_Fun,c_Fun,u_Fun);
+          ASSERT (1+cnt_inst == registry.instance_count());
+          
+          ASSERT (pImpl);
+          ASSERT (pImpl->isValid());
+          ASSERT (1 == pImpl.use_count());   // no magic involved, we hold the only instance
+          
+          PImpl clone = registry.createCloneImpl(*pImpl);
+          ASSERT (clone->isValid());
+          ASSERT (1 == clone.use_count());
+          ASSERT (1 == pImpl.use_count());
+          ASSERT (2+cnt_inst == registry.instance_count());
+          
+          ASSERT (!isSameObject (*pImpl, *clone));
+          ASSERT (*pImpl == *clone);
+          
+                                ///////////////////////////////////////////////TODO: maybe do a simulated command lifecycle here?
+          ASSERT (!pImpl->canExec());
+          typedef Types<int> ArgType;
+          TypedArguments<Tuple<ArgType> > arg (Tuple<ArgType>(98765));
+          pImpl->setArguments(arg);
+          ASSERT (pImpl->canExec());
+          
+          ASSERT (*pImpl != *clone);  // this proves the clone has indeed a separate identity
+          ASSERT (!clone->canExec());
+          
+          // discard the first clone and overwrite with a new one
+          clone = registry.createCloneImpl(*pImpl);
+          ASSERT (2+cnt_inst == registry.instance_count());
+          ASSERT (*pImpl == *clone);
+          ASSERT (clone->canExec());
+          
+          clone.reset();
+          pImpl.reset();
+          // corresponding allocation slots cleared automatically
+          ASSERT (cnt_inst == registry.instance_count());
+        }
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandRegistry_test, "function controller");
+      
+      
+}} // namespace control::test

From 4acb42d2720b0530fff48ee99c46e6343aaf0803 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 19 Aug 2009 15:36:03 +0200
Subject: [PATCH 250/368] autotools fixes...

---
 src/lib/Makefile.am          | 9 ++++-----
 src/proc/Makefile.am         | 4 ++--
 tests/components/Makefile.am | 2 +-
 tests/lib/Makefile.am        | 1 +
 4 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index 76c72be62..f5ff19566 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -66,8 +66,7 @@ noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/resourcecollector.h		\
 	$(liblumiera_la_srcdir)/ppmpl.h				\
 	$(liblumiera_la_srcdir)/allocationcluster.hpp		\
-	$(liblumiera_la_srcdir)/scopedholdertransfer.hpp	\
-	$(liblumiera_la_srcdir)/scopedholder.hpp		\
+	$(liblumiera_la_srcdir)/scoped-holder.hpp		\
 	$(liblumiera_la_srcdir)/lifecycleregistry.hpp		\
 	$(liblumiera_la_srcdir)/nobug-init.hpp			\
 	$(liblumiera_la_srcdir)/factory.hpp			\
@@ -77,8 +76,8 @@ noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/singletonpreconfigure.hpp	\
 	$(liblumiera_la_srcdir)/lumitime.hpp			\
 	$(liblumiera_la_srcdir)/visitor.hpp			\
-	$(liblumiera_la_srcdir)/visitordispatcher.hpp		\
-	$(liblumiera_la_srcdir)/visitorpolicies.hpp		\
+	$(liblumiera_la_srcdir)/visitor-dispatcher.hpp		\
+	$(liblumiera_la_srcdir)/visitor-policies.hpp		\
 	$(liblumiera_la_srcdir)/sync.hpp			\
 	$(liblumiera_la_srcdir)/p.hpp				\
 	$(liblumiera_la_srcdir)/query.hpp			\
@@ -87,7 +86,7 @@ noinst_HEADERS +=						\
 	$(liblumiera_la_srcdir)/meta/typelist.hpp		\
 	$(liblumiera_la_srcdir)/meta/configflags.hpp		\
 	$(liblumiera_la_srcdir)/meta/generator.hpp		\
-	$(liblumiera_la_srcdir)/meta/typelistutil.hpp		\
+	$(liblumiera_la_srcdir)/meta/typelist-util.hpp		\
 	$(liblumiera_la_srcdir)/util.hpp			\
 	$(liblumiera_la_srcdir)/observable-list.hpp		\
 	$(liblumiera_la_srcdir)/sync.hpp			\
diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 8480e0703..d9988c42f 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -121,6 +121,7 @@ liblumiproccontrol_la_CXXFLAGS = $(AM_CXXFLAGS) -Wall -Wextra
 
 liblumiproccontrol_la_SOURCES =					\
 	$(liblumiproccontrol_la_srcdir)/command.cpp		\
+	$(liblumiproccontrol_la_srcdir)/command-impl.cpp	\
 	$(liblumiproccontrol_la_srcdir)/handling-pattern.cpp	\
 	$(liblumiproccontrol_la_srcdir)/proc-dispatcher.cpp	\
 	$(liblumiproccontrol_la_srcdir)/pathmanager.cpp		\
@@ -149,7 +150,7 @@ liblumiprocmobjectsession_la_SOURCES =					\
 	$(liblumiprocmobjectsession_la_srcdir)/abstractmo.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/allocation.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/auto.cpp			\
-	$(liblumiprocmobjectsession_la_srcdir)/bindingl.cpp		\
+	$(liblumiprocmobjectsession_la_srcdir)/binding.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/clip.cpp			\
 	$(liblumiprocmobjectsession_la_srcdir)/compoundclip.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/constraint.cpp		\
@@ -237,7 +238,6 @@ noinst_HEADERS +=							\
 	$(liblumiproc_la_srcdir)/mobject/session/fixture.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/session/locatingpin.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/session/plug.hpp		\
-	$(liblumiproc_la_srcdir)/mobject/session/sessionimpl.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/session/defsregistry.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/explicitplacement.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/mobject.hpp			\
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 65f3ce2c9..560e8b1f5 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -80,7 +80,7 @@ test_components_SOURCES =							\
 noinst_HEADERS +=							\
 	$(testcomponents_srcdir)/backend/mediaaccessmock.hpp		\
 	$(testcomponents_srcdir)/proc/asset/testclipasset.hpp		\
-	$(testcomponents_srcdir)/proc/asset/assetdiagnostics.hpp	\
+	$(testcomponents_srcdir)/proc/asset/asset-diagnostics.hpp	\
 	$(testcomponents_srcdir)/proc/asset/testasset.hpp		\
 	$(testcomponents_srcdir)/proc/mobject/session/testclip.hpp	\
 	$(testcomponents_srcdir)/proc/mobject/session/testsession1.hpp
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index ab9a73ecf..8b24e0266 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -76,6 +76,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/sync-classlock-test.cpp		\
 	$(testlib_srcdir)/sync-locking-test.cpp			\
 	$(testlib_srcdir)/sync-waiting-test.cpp			\
+	$(testlib_srcdir)/timewrappertest.cpp			\
 	$(testlib_srcdir)/thread-wrapper-test.cpp		\
 	$(testlib_srcdir)/thread-wrapper-join-test.cpp		\
 	$(testlib_srcdir)/test/cmdlinewrappertest.cpp		\

From a1ab90d4354ae898280e40d111a0a8856a7e1f01 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 19 Aug 2009 15:36:17 +0200
Subject: [PATCH 251/368] disabled these tests for now, still WIP

---
 tests/45controller.tests      | 4 ++--
 tests/lib/timewrappertest.cpp | 5 ++++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/tests/45controller.tests b/tests/45controller.tests
index bc3409cc1..6aa5603a4 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -7,7 +7,7 @@ PLANNED "CommandBasic_test" CommandBasic_test <<END
 END
 
 
-TEST "Argument & Memento handling" CommandArgument_test <<END
+PLANNED "Argument & Memento handling" CommandArgument_test <<END
 out: Command-State. arguments=unbound, ·noUNDO·.
 out: capture state...
 out: Command-State. arguments=Closure\(\), ·noUNDO·.
@@ -35,7 +35,7 @@ out: RESET...undoIt\(time=00:..:....00\)----memento-:START...doIt\( Time=00:..:.
 END
 
 
-TEST "Command functor and UNDO functor" CommandMutation_test <<END
+PLANNED "Command functor and UNDO functor" CommandMutation_test <<END
 out: Mutation\(untied\)
 out: param values: Closure\(23\)
 out: Mutation\(Closure\(23\)\)
diff --git a/tests/lib/timewrappertest.cpp b/tests/lib/timewrappertest.cpp
index ec426a274..05f5a7250 100644
--- a/tests/lib/timewrappertest.cpp
+++ b/tests/lib/timewrappertest.cpp
@@ -52,7 +52,10 @@ namespace lumiera {
         virtual void
         run (Arg arg) 
           {
-            int64_t refval= isnil(arg)?  1 : lexical_cast<int64_t> (arg[1]);
+//          int64_t refval= isnil(arg)?  1 : lexical_cast<int64_t> (arg[1]);
+//          //// fails for an unknown reason..!
+
+            int64_t refval = 1;
             
             Time ref (refval);
             

From 08d4be3149a1c3729c638607a0901beab7ca13f2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 21 Aug 2009 02:42:11 +0200
Subject: [PATCH 252/368] Fixes for building on 32bit system

---
 src/lib/lumitime.cpp     | 2 +-
 tests/45controller.tests | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/lib/lumitime.cpp b/src/lib/lumitime.cpp
index 29facef22..fb798d476 100644
--- a/src/lib/lumitime.cpp
+++ b/src/lib/lumitime.cpp
@@ -73,7 +73,7 @@ namespace lumiera {
   int
   Time::getHours()  const
   {
-    return (t_ / (60L * 60 * GAVL_TIME_SCALE)); 
+    return (t_ / (gavl_time_t(60) * 60 * GAVL_TIME_SCALE)); 
   }
   
   
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 6aa5603a4..8e2a25dcf 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -45,7 +45,7 @@ END
 
 TEST "build argument accepting function" AcceptArgumentTuple_test <<END
 out: sizeof\( .+control.+TestClass.+ \) =   1
-out: sizeof\( .+control.+TestClass.+lumiera.Time.+ \) =  ( 8)|(16)
+out: sizeof\( .+control.+TestClass.+lumiera.Time.+ \) =  (12)|(16)
 out: 00:..:..\.000
 return: 0
 END

From 151d17e4de596a093105a1f97970c5cfd93f7e2c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 27 Aug 2009 16:21:21 +0200
Subject: [PATCH 253/368] rename and reenable cast in TimeWrapper_test;
 couldn't find the reason for the previous failure

---
 tests/40components.tests        |   2 +-
 tests/lib/Makefile.am           |   2 +-
 tests/lib/time-wrapper-test.cpp | 173 +++++++++++++++++++++++++++++++
 tests/lib/timewrappertest.cpp   | 178 --------------------------------
 4 files changed, 175 insertions(+), 180 deletions(-)
 create mode 100644 tests/lib/time-wrapper-test.cpp
 delete mode 100644 tests/lib/timewrappertest.cpp

diff --git a/tests/40components.tests b/tests/40components.tests
index 2a76eae74..31533b2b4 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -442,7 +442,7 @@ return: 0
 END
 
 
-TEST "Time Wrapper" TimeWrapper_test <<END
+TEST "Time Wrapper" TimeWrapper_test  <<END
 out: ..:..:..\....
 return: 0
 END
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 8b24e0266..fdc8cd443 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -76,7 +76,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/sync-classlock-test.cpp		\
 	$(testlib_srcdir)/sync-locking-test.cpp			\
 	$(testlib_srcdir)/sync-waiting-test.cpp			\
-	$(testlib_srcdir)/timewrappertest.cpp			\
+	$(testlib_srcdir)/time-wrapper-test.cpp			\
 	$(testlib_srcdir)/thread-wrapper-test.cpp		\
 	$(testlib_srcdir)/thread-wrapper-join-test.cpp		\
 	$(testlib_srcdir)/test/cmdlinewrappertest.cpp		\
diff --git a/tests/lib/time-wrapper-test.cpp b/tests/lib/time-wrapper-test.cpp
new file mode 100644
index 000000000..cec91bd79
--- /dev/null
+++ b/tests/lib/time-wrapper-test.cpp
@@ -0,0 +1,173 @@
+/*
+  TimeWrapper(Test)  -  working with gavl_time_t values in C++...
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+
+#include "lib/util.hpp"
+#include <boost/lexical_cast.hpp>
+#include <iostream>
+#include <cstdlib>
+
+using boost::lexical_cast;
+using util::isnil;
+using std::rand;
+using std::cout;
+using std::endl;
+
+
+#include "lib/lumitime.hpp"
+#include "lib/lumitime-fmt.hpp"
+
+
+
+namespace lumiera{
+namespace test   {
+  
+  
+  /********************************************
+   * @test sanity of the C++ time wrapper.
+   */
+  class TimeWrapper_test : public Test
+    {
+      virtual void
+      run (Arg arg) 
+        {
+          long refval= isnil(arg)?  1 : lexical_cast<long> (arg[1]);
+          
+          Time ref (refval);
+          
+          checkBasics (ref);
+          checkComparisons (ref);
+          checkComponentAccess();
+        } 
+      
+      
+      void
+      checkBasics (Time const& ref)
+        {
+          Time zero;
+          Time one (1);
+          Time max (Time::MAX);
+          Time min (Time::MIN);
+          
+          Time val (ref);
+          
+          val += Time(2);
+          val *= 2;
+          ASSERT (zero == (val - 2*(ref + Time(2))) );
+          
+          val = ref;
+          ASSERT (zero == (val - ref));
+        }
+      
+      
+      void
+      checkComparisons (Time const& ref)
+        {
+          Time zero;
+          Time max (Time::MAX);
+          Time min (Time::MIN);
+          
+          ASSERT (zero == Time(0));
+          ASSERT (min < zero);
+          ASSERT (max > zero);
+          
+          Time val (ref);
+          ASSERT ( (val == ref) );
+          ASSERT (!(val != ref) );
+          ASSERT ( (val >= ref) );
+          ASSERT ( (val <= ref) );
+          ASSERT (!(val <  ref) );
+          ASSERT (!(val >  ref) );
+          
+          val += Time(2);
+          ASSERT (!(val == ref) );
+          ASSERT ( (val != ref) );
+          ASSERT ( (val >= ref) );
+          ASSERT (!(val <= ref) );
+          ASSERT (!(val <  ref) );
+          ASSERT ( (val >  ref) );
+          
+          gavl_time_t gat(val);
+          ASSERT (!(gat == ref) );
+          ASSERT ( (gat != ref) );
+          ASSERT ( (gat >= ref) );
+          ASSERT (!(gat <= ref) );
+          ASSERT (!(gat <  ref) );
+          ASSERT ( (gat >  ref) );
+          
+          ASSERT ( (val == gat) );
+          ASSERT (!(val != gat) );
+          ASSERT ( (val >= gat) );
+          ASSERT ( (val <= gat) );
+          ASSERT (!(val <  gat) );
+          ASSERT (!(val >  gat) );
+        }
+      
+      
+      void
+      checkComponentAccess()
+        {
+          int millis = rand() % 1000;
+          int secs   = rand() % 60;
+          int mins   = rand() % 60;
+          int hours  = rand() % 100;
+          
+          Time time(millis,secs,mins,hours);
+          ASSERT (millis == time.getMillis());
+          ASSERT (secs   == time.getSecs());
+          ASSERT (mins   == time.getMins());
+          ASSERT (hours  == time.getHours());
+          cout << time << endl;
+          
+          Time t2(2008,0);
+          cout << t2 << endl;
+          ASSERT ( 8 == t2.getMillis());
+          ASSERT ( 2 == t2.getSecs());
+          ASSERT ( 0 == t2.getMins());
+          ASSERT ( 0 == t2.getHours());
+          
+          Time t3(2008,88);
+          cout << t3 << endl;
+          ASSERT ( 8 == t3.getMillis());
+          ASSERT (30 == t3.getSecs());
+          ASSERT ( 1 == t3.getMins());
+          ASSERT ( 0 == t3.getHours());
+          
+          Time t4(2008,118,58);
+          cout << t4 << endl;
+          ASSERT ( 8 == t4.getMillis());
+          ASSERT ( 0 == t4.getSecs());
+          ASSERT ( 0 == t4.getMins());
+          ASSERT ( 1 == t4.getHours());
+        }
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (TimeWrapper_test, "unit common");
+  
+  
+  
+}} // namespace lumiera::test
diff --git a/tests/lib/timewrappertest.cpp b/tests/lib/timewrappertest.cpp
deleted file mode 100644
index 05f5a7250..000000000
--- a/tests/lib/timewrappertest.cpp
+++ /dev/null
@@ -1,178 +0,0 @@
-/*
-  TimeWrapper(Test)  -  working with gavl_time_t values in C++...
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "lib/test/run.hpp"
-
-#include "lib/util.hpp"
-#include <boost/lexical_cast.hpp>
-#include <iostream>
-#include <cstdlib>
-
-using boost::lexical_cast;
-using util::isnil;
-using std::rand;
-using std::cout;
-using std::endl;
-
-
-#include "lib/lumitime.hpp"
-#include "lib/lumitime-fmt.hpp"
-
-
-
-namespace lumiera {
-  namespace test {
-    
-    
-    /********************************************
-     * @test sanity of the C++ time wrapper.
-     */
-    class TimeWrapper_test : public Test
-      {
-        virtual void
-        run (Arg arg) 
-          {
-//          int64_t refval= isnil(arg)?  1 : lexical_cast<int64_t> (arg[1]);
-//          //// fails for an unknown reason..!
-
-            int64_t refval = 1;
-            
-            Time ref (refval);
-            
-            checkBasics (ref);
-            checkComparisons (ref);
-            checkComponentAccess();
-          } 
-        
-        
-        void
-        checkBasics (Time const& ref)
-          {
-            Time zero;
-            Time one (1);
-            Time max (Time::MAX);
-            Time min (Time::MIN);
-            
-            Time val (ref);
-            
-            val += Time(2);
-            val *= 2;
-            ASSERT (zero == (val - 2*(ref + Time(2))) );
-            
-            val = ref;
-            ASSERT (zero == (val - ref));
-          }
-        
-        
-        void
-        checkComparisons (Time const& ref)
-          {
-            Time zero;
-            Time max (Time::MAX);
-            Time min (Time::MIN);
-            
-            ASSERT (zero == Time(0));
-            ASSERT (min < zero);
-            ASSERT (max > zero);
-            
-            Time val (ref);
-            ASSERT ( (val == ref) );
-            ASSERT (!(val != ref) );
-            ASSERT ( (val >= ref) );
-            ASSERT ( (val <= ref) );
-            ASSERT (!(val <  ref) );
-            ASSERT (!(val >  ref) );
-            
-            val += Time(2);
-            ASSERT (!(val == ref) );
-            ASSERT ( (val != ref) );
-            ASSERT ( (val >= ref) );
-            ASSERT (!(val <= ref) );
-            ASSERT (!(val <  ref) );
-            ASSERT ( (val >  ref) );
-            
-            gavl_time_t gat(val);
-            ASSERT (!(gat == ref) );
-            ASSERT ( (gat != ref) );
-            ASSERT ( (gat >= ref) );
-            ASSERT (!(gat <= ref) );
-            ASSERT (!(gat <  ref) );
-            ASSERT ( (gat >  ref) );
-            
-            ASSERT ( (val == gat) );
-            ASSERT (!(val != gat) );
-            ASSERT ( (val >= gat) );
-            ASSERT ( (val <= gat) );
-            ASSERT (!(val <  gat) );
-            ASSERT (!(val >  gat) );
-          }
-        
-        
-        void
-        checkComponentAccess()
-          {
-            int millis = rand() % 1000;
-            int secs   = rand() % 60;
-            int mins   = rand() % 60;
-            int hours  = rand() % 100;
-            
-            Time time(millis,secs,mins,hours);
-            ASSERT (millis == time.getMillis());
-            ASSERT (secs   == time.getSecs());
-            ASSERT (mins   == time.getMins());
-            ASSERT (hours  == time.getHours());
-            cout << time << endl;
-            
-            Time t2(2008,0);
-            cout << t2 << endl;
-            ASSERT ( 8 == t2.getMillis());
-            ASSERT ( 2 == t2.getSecs());
-            ASSERT ( 0 == t2.getMins());
-            ASSERT ( 0 == t2.getHours());
-            
-            Time t3(2008,88);
-            cout << t3 << endl;
-            ASSERT ( 8 == t3.getMillis());
-            ASSERT (30 == t3.getSecs());
-            ASSERT ( 1 == t3.getMins());
-            ASSERT ( 0 == t3.getHours());
-            
-            Time t4(2008,118,58);
-            cout << t4 << endl;
-            ASSERT ( 8 == t4.getMillis());
-            ASSERT ( 0 == t4.getSecs());
-            ASSERT ( 0 == t4.getMins());
-            ASSERT ( 1 == t4.getHours());
-          }
-
-      };
-    
-    
-    /** Register this test class... */
-    LAUNCHER (TimeWrapper_test, "unit common");
-    
-    
-    
-  } // namespace test
-
-} // namespace lumiera

From 1533e5bd0db07ce0bc3d765641901492d5c66c2e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 28 Aug 2009 20:33:20 +0200
Subject: [PATCH 254/368] fix a problem with formatting arbitrary types;
 reneable the broken tests

---
 src/lib/format.hpp               | 42 +++++++++++++++++++++++++++++---
 src/lib/meta/trait.hpp           | 24 ++++++++++++++++++
 tests/40components.tests         |  3 +++
 tests/45controller.tests         |  4 +--
 tests/lib/format-helper-test.cpp |  4 +++
 5 files changed, 72 insertions(+), 5 deletions(-)

diff --git a/src/lib/format.hpp b/src/lib/format.hpp
index a7856e183..9b472dd82 100644
--- a/src/lib/format.hpp
+++ b/src/lib/format.hpp
@@ -39,6 +39,7 @@
 #include <string>
 #include <cstring>
 #include <typeinfo>
+#include <boost/lexical_cast.hpp>
 #include <boost/utility/enable_if.hpp>
 
 
@@ -46,6 +47,7 @@
 namespace util {
   
   using lumiera::typelist::can_ToString;
+  using lumiera::typelist::can_lexical2string;
   using lumiera::Symbol;
   using boost::enable_if;
   using boost::disable_if;
@@ -70,11 +72,36 @@ namespace util {
     {
       return "";
     }
+    
+    
+    
+    template<typename X>
+    inline string
+    invoke_indirect2string (     typename enable_if< can_lexical2string<X>,
+                            X >::type const& val)
+    {
+      try        { return boost::lexical_cast<string> (val); }
+      catch(...) { return ""; }
+    }
+    
+    template<typename X>
+    inline string
+    invoke_indirect2string (     typename disable_if< can_lexical2string<X>,
+                            X >::type const&)
+    {
+      return "";
+    }
   }
   
   
   
-  /** try to get an object converted to string */
+  /** try to get an object converted to string.
+   *  An custom/standard conversion to string is used,
+   *  if applicable; otherwise, some standard types can be
+   *  converted by a lexical_cast (based on operator<< ).
+   *  Otherwise, either the fallback string is used, or just
+   *  a string denoting the (mangled) type.
+   */
   template<typename TY>
   inline string
   str ( TY const& val
@@ -86,8 +113,17 @@ namespace util {
       return string(prefix) + invoke_2string<TY>(val);
     
     else
-      return fallback? fallback
-                     : tyStr(val);
+      {
+        if (can_lexical2string<TY>::value)
+          {
+            string res (invoke_indirect2string<TY> (val));
+            if ("" != res)
+              return string(prefix) + res;
+          }
+      
+        return fallback? fallback
+                       : tyStr(val);
+      }
   }
   
   
diff --git a/src/lib/meta/trait.hpp b/src/lib/meta/trait.hpp
index 8e0348e9b..608888561 100644
--- a/src/lib/meta/trait.hpp
+++ b/src/lib/meta/trait.hpp
@@ -28,11 +28,17 @@
 #include "lib/meta/util.hpp"
 
 #include <boost/type_traits/is_convertible.hpp>
+#include <boost/type_traits/is_arithmetic.hpp>
+#include <boost/utility/enable_if.hpp>
 #include <string>
 
   
 namespace lumiera {
 namespace typelist {
+
+  using boost::enable_if;
+  using boost::is_arithmetic;
+  
   
   /** Trait template for detecting if a type can be converted to string.
    *  For example, this allows to write specialisations with the help of
@@ -46,6 +52,24 @@ namespace typelist {
     };
   
   
+  /** Trait template for guarding \c lexical_cast<..> expressions.
+   *  Such an expression won't even compile for some types, because of
+   *  missing or ambiguous output operator(s).
+   *  Ideally, there would be some automatic detection (relying on the
+   *  existence of an operator<< for the given type. But I couldn't make
+   *  this work, so I fell back on just declaring types which are known
+   *  to work with lexical_cast to string
+   *  @note this compile-time trait can't predict if such an conversion
+   *        to string will be successful at runtime; indeed it may throw,
+   *        so you should additionally guard the invocation with try-catch!
+   */
+  template<typename X>
+  struct can_lexical2string
+    {
+      enum { value = is_arithmetic<X>::value
+           };
+    };
+  
   
 }} // namespace lumiera::typelist
 #endif
diff --git a/tests/40components.tests b/tests/40components.tests
index 31533b2b4..0439391c2 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -240,6 +240,9 @@ out: «..util.test.Reticent.»
 out: <no comment>
 out: ^hey Joe!
 out: ^he says: hey Joe!
+out: ^the truth: 0
+out: ^just a number: 1.234e\+56
+out: ^12345X
 return: 0
 END
 
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 8e2a25dcf..060fd131c 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -7,7 +7,7 @@ PLANNED "CommandBasic_test" CommandBasic_test <<END
 END
 
 
-PLANNED "Argument & Memento handling" CommandArgument_test <<END
+TEST "Argument & Memento handling" CommandArgument_test <<END
 out: Command-State. arguments=unbound, ·noUNDO·.
 out: capture state...
 out: Command-State. arguments=Closure\(\), ·noUNDO·.
@@ -35,7 +35,7 @@ out: RESET...undoIt\(time=00:..:....00\)----memento-:START...doIt\( Time=00:..:.
 END
 
 
-PLANNED "Command functor and UNDO functor" CommandMutation_test <<END
+TEST "Command functor and UNDO functor" CommandMutation_test <<END
 out: Mutation\(untied\)
 out: param values: Closure\(23\)
 out: Mutation\(Closure\(23\)\)
diff --git a/tests/lib/format-helper-test.cpp b/tests/lib/format-helper-test.cpp
index 7b35d420a..6e4c82c1c 100644
--- a/tests/lib/format-helper-test.cpp
+++ b/tests/lib/format-helper-test.cpp
@@ -75,6 +75,10 @@ namespace test {
           
           cout << str (chatterer) << endl;
           cout << str (chatterer, "he says: ", "<no comment>") << endl;
+          
+          cout << str (false, "the truth: ") << endl;
+          cout << str (12.34e55, "just a number: ") << endl;
+          cout << str (short(12)) << str (345L) << str ('X') << endl;
         }
       
       

From 5c7e0d1870449a2716c2a77c5d21f77b94d1b3eb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 28 Aug 2009 23:00:53 +0200
Subject: [PATCH 255/368] fix (test output definition)

---
 tests/40components.tests | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/40components.tests b/tests/40components.tests
index 0439391c2..b301b262d 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -241,7 +241,7 @@ out: <no comment>
 out: ^hey Joe!
 out: ^he says: hey Joe!
 out: ^the truth: 0
-out: ^just a number: 1.234e\+56
+out: ^just a number: 1.234.*e\+56
 out: ^12345X
 return: 0
 END

From 45c04b44632c81d819feb8e4d648a8e500ad07b4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 29 Aug 2009 02:16:28 +0200
Subject: [PATCH 256/368] re-visit the command impl allocation; add a
 quick-n-dirty implementation based on heap allocation

---
 src/lib/allocationcluster.cpp                 |  8 ++---
 src/lib/allocationcluster.hpp                 | 30 ++++++++---------
 src/proc/control/command-registry.hpp         |  6 ++--
 src/proc/control/typed-allocation-manager.hpp | 32 ++++++++++++-------
 4 files changed, 43 insertions(+), 33 deletions(-)

diff --git a/src/lib/allocationcluster.cpp b/src/lib/allocationcluster.cpp
index 8dcd5da6e..ae283e62f 100644
--- a/src/lib/allocationcluster.cpp
+++ b/src/lib/allocationcluster.cpp
@@ -83,7 +83,7 @@ namespace lib {
   void
   AllocationCluster::MemoryManager::reset (TypeInfo info)
   {
-    Lock instance();
+    Lock sync(this);
     
     if (0 < mem_.size()) purge();
     type_ = info;
@@ -98,7 +98,7 @@ namespace lib {
   void
   AllocationCluster::MemoryManager::purge()
   {
-    Lock instance();
+    Lock sync(this);
     
     REQUIRE (type_.killIt, "we need a deleter function");
     REQUIRE (0 < type_.allocSize, "allocation size unknown");
@@ -122,7 +122,7 @@ namespace lib {
   inline void*
   AllocationCluster::MemoryManager::allocate()
   {
-    Lock instance();
+    Lock sync(this);
     
     REQUIRE (0 < type_.allocSize);
     REQUIRE (top_ <= mem_.size());
@@ -142,7 +142,7 @@ namespace lib {
   inline void
   AllocationCluster::MemoryManager::commit (void* pendingAlloc)
   {
-    Lock instance();
+    Lock sync(this);
     
     REQUIRE (pendingAlloc);
     ASSERT (top_ < mem_.size());
diff --git a/src/lib/allocationcluster.hpp b/src/lib/allocationcluster.hpp
index be99f7329..304405d58 100644
--- a/src/lib/allocationcluster.hpp
+++ b/src/lib/allocationcluster.hpp
@@ -197,21 +197,21 @@ namespace lib {
   //-----implementation-details------------------------
   
   struct AllocationCluster::TypeInfo
-        {
-          size_t allocSize;
-          void (*killIt)(void*);  ///< deleter function
-          
-          template<class TY>
-          TypeInfo(TY*)
-            : allocSize(sizeof(TY)),
-              killIt(&TypeSlot<TY>::kill)
-            { }
-          
-          TypeInfo()  ///< denotes "unknown" type
-            : allocSize(0),
-              killIt(0)
-            { }  
-        };
+    {
+      size_t allocSize;
+      void (*killIt)(void*);  ///< deleter function
+      
+      template<class TY>
+      TypeInfo(TY*)
+        : allocSize(sizeof(TY)),
+          killIt(&TypeSlot<TY>::kill)
+        { }
+      
+      TypeInfo()  ///< denotes "unknown" type
+        : allocSize(0),
+          killIt(0)
+        { }  
+    };
   
   
   
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 9dd5206a9..1075b2f2d 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -142,9 +142,9 @@ namespace control {
       
       
       /** set up a new command implementation frame
-       *  @return pointer to a newly created CommandImpl, allocated 
-       *          through the registry. The caller is responsible for
-       *          deallocating this frame by calling #killCommandImpl 
+       *  @return shared-ptr owning a newly created CommandImpl, allocated 
+       *          through the registry and wired internally to invoke 
+       *          TypedAllocationManager#destroyElement for cleanup. 
        */
       template< typename SIG_OPER    ///< signature of the command operation
               , typename SIG_CAPT    ///< signature for capturing undo state
diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
index 397bc0e9f..4c91048d6 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -54,6 +54,9 @@
  ** there is a facility allowing to create ref-counting handles and smart-pointers,
  ** which are internally tied to this memory manager through a deleter function.
  ** 
+ ** @todo using a quick-n-dirty heap allocation implementation for now (8/09),
+ **       but should write a custom allocator based on cehteh's mpool!
+ ** 
  ** @see CommandRegistry
  ** @see AllocationCluster (another custom allocation scheme, which could be united)
  **
@@ -66,30 +69,35 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
-//#include "lib/singleton.hpp"
-//#include "lib/sync.hpp"
 #include "lib/format.hpp"
 #include "include/logging.h"
-//#include "lib/bool-checkable.hpp"
 
 
 #include <tr1/memory>
-//#include <iostream>
-//#include <string>
 
 
 
 namespace control {
   
   using std::tr1::shared_ptr;
-//  using std::ostream;
-//  using std::string;
   
   
   
   
   /**
-   * TODO type comment
+   * Foundation for a custom allocation manager,
+   * tracking the created objects by smart-ptrs.
+   * The public interface provides forwarding functions
+   * to invoke the ctor of the objects to be created, thereby
+   * placing them into the storage maintained by a low-level
+   * allocator or pooled storage manager. The created smart-ptr
+   * owns the new object and is wired internally to #releaseSlot.
+   * Subclasses may also directly allocate and de-allocate 
+   * such a (typed) storage slot.
+   * 
+   * @todo currently (as of 8/09) the low-level pooled allocator
+   *       isn't implemented; instead we do just heap allocations.
+   *       see Ticket 231
    */
   class TypedAllocationManager
     {
@@ -259,8 +267,8 @@ namespace control {
       Slot<XX>
       allocateSlot ()
         {
-          UNIMPLEMENTED ("redirect to the corresponding pool allocator");
-          void* space = 0;
+          TODO ("redirect to the corresponding pool allocator");
+          void* space = new char[sizeof(XX)];
           return Slot<XX> (this, space);
         }
       
@@ -268,7 +276,9 @@ namespace control {
       void
       releaseSlot (void* entry)
         {
-          UNIMPLEMENTED ("redirect to the corresponding pool allocator");
+          TODO ("redirect to the corresponding pool allocator");
+          typedef char Storage[sizeof(XX)];
+          delete[] reinterpret_cast<Storage*> (entry);
         }
       
       

From 236e267af14886ed3d67ca765548e1d2368f0d68 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 29 Aug 2009 03:10:34 +0200
Subject: [PATCH 257/368] basic coverage for TypedAllocationManager

---
 src/proc/control/typed-allocation-manager.hpp |   4 +-
 tests/40components.tests                      |   5 +
 tests/lib/Makefile.am                         |   1 +
 tests/lib/typed-allocation-manager-test.cpp   | 159 ++++++++++++++++++
 4 files changed, 167 insertions(+), 2 deletions(-)
 create mode 100644 tests/lib/typed-allocation-manager-test.cpp

diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
index 4c91048d6..cdc04cc03 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -77,7 +77,7 @@
 
 
 
-namespace control {
+namespace control { ////////////////////////////////////////////////////////////TODO: should go into namespace lib
   
   using std::tr1::shared_ptr;
   
@@ -106,7 +106,7 @@ namespace control {
     public:
 
       /** this is an ABC */
-      virtual ~TypedAllocationManager() {}
+      virtual ~TypedAllocationManager() {}   ////////////////////////////////////TODO: seems superfluous? We don't have any extension points (and this is a good thing!)
       
       
       
diff --git a/tests/40components.tests b/tests/40components.tests
index b301b262d..35bb2ba1e 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -824,6 +824,11 @@ return: 0
 END
 
 
+TEST "TypedAllocationManager_test" TypedAllocationManager_test <<END
+return: 0
+END
+
+
 TEST "VectorTransfer_test" VectorTransfer_test <<END
 return: 0
 END
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index fdc8cd443..024d593cd 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -82,6 +82,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/test/cmdlinewrappertest.cpp		\
 	$(testlib_srcdir)/test/testoptiontest.cpp		\
 	$(testlib_srcdir)/test/test-helper-test.cpp		\
+	$(testlib_srcdir)/typed-allocation-manager-test.cpp	\
 	$(testlib_srcdir)/vectortransfertest.cpp		\
 	$(testlib_srcdir)/visitingtoolconcept.cpp		\
 	$(testlib_srcdir)/visitingtoolextendedtest.cpp		\
diff --git a/tests/lib/typed-allocation-manager-test.cpp b/tests/lib/typed-allocation-manager-test.cpp
new file mode 100644
index 000000000..09c5254e8
--- /dev/null
+++ b/tests/lib/typed-allocation-manager-test.cpp
@@ -0,0 +1,159 @@
+/*
+  TypedAllocationManager(Test)  -  check interface to pooled allocations
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/control/command.hpp"
+#include "proc/control/typed-allocation-manager.hpp"
+//#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+//#include "include/symbol.hpp"
+#include "lib/util.hpp"
+
+
+#include <tr1/memory>
+//#include <boost/ref.hpp>
+//#include <boost/format.hpp>
+//#include <iostream>
+#include <cstdlib>
+//#include <string>
+
+
+namespace control {
+namespace test    {
+
+
+//  using boost::format;
+//  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+  using std::tr1::shared_ptr;
+//  using std::tr1::bind;
+//  using std::string;
+  using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+  using util::isSameObject;
+//  using util::contains;
+
+//  using session::test::TestClip;
+//  using lumiera::Symbol;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  namespace { // test data and helpers...
+  
+    long checksum_ = 0;
+    
+    /**
+     * Yet-another ctor/dtor-tracking test dummy object....
+     */
+    template<uint siz>
+    class DummyObj
+      {
+        char crap_[siz];
+        
+      public:
+        DummyObj()
+          {
+            REQUIRE (siz);
+            for (uint i=0; i<siz; ++i)
+              checksum_ += (crap_[i] = rand() % 128);
+          }
+        
+       ~DummyObj()
+          {
+            for (uint i=0; i<siz; ++i)
+              checksum_ -= crap_[i];
+          }
+      };
+  }
+  
+  
+  
+  /***************************************************************************************
+   * @test cover the basic implementation of a custom allocator, delegating to mpool.
+   *       TypedAllocationManager is a base class, used e.g. to build the CommandRegistry.
+   * 
+   * @todo planned but not implemented as of 8/09   see also Ticket #217
+   *        
+   * @see CommandRegistry
+   * @see command-registry-test.cpp
+   * @see allocationclustertest.cpp
+   */
+  class TypedAllocationManager_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          REQUIRE (0 == checksum_);
+          
+          TypedAllocationManager allocator;
+          
+          typedef shared_ptr<DummyObj<1> >  PD1;
+          typedef shared_ptr<DummyObj<22> > PD22;
+          ASSERT (sizeof(DummyObj<1>) != sizeof(DummyObj<22>));
+          
+            {
+              PD1  pD11 = allocator.create<DummyObj<1> >();
+              PD1  pD12 = allocator.create<DummyObj<1> >();
+              PD22 pD21 = allocator.create<DummyObj<22> >();
+              PD22 pD22 = allocator.create<DummyObj<22> >();
+              ASSERT (pD11);
+              ASSERT (pD12);
+              ASSERT (pD21);
+              ASSERT (pD22);
+              ASSERT (1 == pD11.use_count());
+              ASSERT (1 == pD12.use_count());
+              ASSERT (1 == pD21.use_count());
+              ASSERT (1 == pD22.use_count());
+              ASSERT (!isSameObject (*pD11, *pD12));
+              ASSERT (!isSameObject (*pD11, *pD21));
+              ASSERT (!isSameObject (*pD11, *pD22));
+              ASSERT (!isSameObject (*pD12, *pD21));
+              ASSERT (!isSameObject (*pD12, *pD22));
+              ASSERT (!isSameObject (*pD21, *pD22));
+              
+              PD22 pD2x = pD21;
+              ASSERT (pD2x);
+              ASSERT (2 == pD21.use_count());
+              ASSERT (2 == pD2x.use_count());
+              ASSERT (isSameObject (*pD21, *pD2x));
+              
+            }
+          
+          ASSERT (0 == checksum_);
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (TypedAllocationManager_test, "unit common");
+  
+  
+}} // namespace control::test

From 1b4aa98cdffb726683c5b2df9b070196d5f11070 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 7 Oct 2008 04:28:13 +0200
Subject: [PATCH 258/368] use the new stream type definitions to get ahead with
 the builder work

---
 .../renderstate.hpp => lib/refarray.hpp}      | 39 ++++++-------
 src/proc/engine/buffhandle.hpp                |  4 +-
 src/proc/engine/procnode.hpp                  | 15 ++---
 src/proc/mobject/builder/renderstate.hpp      | 55 +++++++++++++++++++
 src/proc/state.hpp                            | 26 ++++-----
 .../components/proc/engine/bufftabletest.cpp  |  4 +-
 6 files changed, 95 insertions(+), 48 deletions(-)
 rename src/{proc/control/renderstate.hpp => lib/refarray.hpp} (56%)
 create mode 100644 src/proc/mobject/builder/renderstate.hpp

diff --git a/src/proc/control/renderstate.hpp b/src/lib/refarray.hpp
similarity index 56%
rename from src/proc/control/renderstate.hpp
rename to src/lib/refarray.hpp
index d62e56628..d4efc126a 100644
--- a/src/proc/control/renderstate.hpp
+++ b/src/lib/refarray.hpp
@@ -1,5 +1,5 @@
 /*
-  RENDERSTATE.hpp  -  renderengine state manager
+  REFARRAY.hpp  -  abstraction providing array-like access to a list of references
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,33 +21,28 @@
 */
 
 
-#ifndef CONTROL_RENDERSTATE_H
-#define CONTROL_RENDERSTATE_H
-
-#include "proc/state.hpp"
+#ifndef LIB_REFARRAY_H
+#define LIB_REFARRAY_H
 
 
 
-namespace control {
-  
-  typedef proc_interface::State State;
-  
+
+namespace lib {
   
   /**
-   * Encapsulates the logic used to get a "current render process"
-   * in accordance to the currently applicable controller settings.
-   * The provided StateProxy serves to hold any mutalbe state used
-   * in the render process, so the rest of the render engine 
-   * can be stateless.
-   * @todo probably the state management will work different (6/08)
+   * Abstraction: Array of const references.
+   * Typically the return type is an interface, 
+   * and the Implementation wraps some datastructure
+   * holding subclasses.
    */
-  class RenderState
+  template<class E>
+  struct RefArray
     {
-    public:
-      State& getRenderProcess () ;
+      virtual E const& operator[] (uint i)  const =0;
+      virtual size_t size()  const =0;
+      virtual ~RefArray() {}
     };
-
-
-
-} // namespace control
+  
+  
+} // namespace lib
 #endif
diff --git a/src/proc/engine/buffhandle.hpp b/src/proc/engine/buffhandle.hpp
index ece9bf365..76d1acacf 100644
--- a/src/proc/engine/buffhandle.hpp
+++ b/src/proc/engine/buffhandle.hpp
@@ -54,7 +54,7 @@ namespace engine {
   struct BuffHandle
     {
       typedef lumiera::StreamType::ImplFacade::DataBuffer Buff;
-      typedef Buff* PBuff;//////TODO define the Buffer type(s)
+      typedef Buff* PBuff;
       
       PBuff 
       operator->() const 
@@ -81,7 +81,7 @@ namespace engine {
    */
   struct BufferDescriptor
     {
-      char typeID_; ///////TODO define the Buffer type(s)
+      lumiera::StreamType& sType_;
     };
   
   
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 4889c0041..b62f7947e 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -45,6 +45,7 @@
 #include "proc/common.hpp"
 #include "proc/state.hpp"
 #include "proc/mobject/parameter.hpp"
+#include "lib/refarray.hpp"
 
 #include <vector>
 
@@ -60,12 +61,6 @@ namespace engine {
   
   typedef ProcNode* PNode;
   
-  template<class E>
-  struct RefArray    ///< @todo need an implementation and then probably move it into library
-    {
-      virtual E const& operator[] (uint i)  const =0;
-      virtual ~RefArray() {}
-    };
   
   /**
    * Interface: Description of the input and output ports,
@@ -79,16 +74,16 @@ namespace engine {
       virtual uint getNrI()  const =0;           ///////////TODO: indeed need a virtual function??
       virtual uint getNrO()  const =0;
       
-      RefArray<ChannelDescriptor>& out;
-      RefArray<InChanDescriptor>&  in;
+      lib::RefArray<ChannelDescriptor>& out;
+      lib::RefArray<InChanDescriptor>&  in;
       
       typedef void (ProcFunc) (BuffHandle::PBuff, uint);
       
       ProcFunc* processFunction;
       
     protected:
-      WiringDescriptor (RefArray<ChannelDescriptor>& o, 
-                        RefArray<InChanDescriptor>& i,
+      WiringDescriptor (lib::RefArray<ChannelDescriptor>& o, 
+                        lib::RefArray<InChanDescriptor>& i,
                         ProcFunc pFunc)
         : out(o), in(i),
           processFunction(pFunc)
diff --git a/src/proc/mobject/builder/renderstate.hpp b/src/proc/mobject/builder/renderstate.hpp
new file mode 100644
index 000000000..6e99a99b1
--- /dev/null
+++ b/src/proc/mobject/builder/renderstate.hpp
@@ -0,0 +1,55 @@
+/*
+  RENDERSTATE.hpp  -  renderengine state management
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef MOBJECT_BUILDER_RENDERSTATE_H
+#define MOBJECT_BUILDER_RENDERSTATE_H
+
+#include "proc/state.hpp"
+
+
+
+namespace mobject {
+  namespace builder {
+    
+    typedef proc_interface::State State;
+    
+    
+    /**
+     * Encapsulates the logic used to get a "render process".
+     * The provided StateProxy serves to hold any mutalbe state used
+     * in the render process, so the rest of the render engine 
+     * can be stateless.
+     * @todo probably the state management will work different (6/08)
+     */
+    class RenderState
+      {
+      public:
+        State& getRenderProcess () ;
+      };
+  
+  
+  
+  } // namespace mobject::session
+
+} // namespace mobject
+#endif
diff --git a/src/proc/state.hpp b/src/proc/state.hpp
index e021d5890..a20bc9cee 100644
--- a/src/proc/state.hpp
+++ b/src/proc/state.hpp
@@ -43,19 +43,6 @@ namespace engine {
   
   class State
     {
-    protected:
-      virtual ~State() {};
-      
-      /** resolves to the State object currently "in charge".
-       *  Intended as a performance shortcut to avoid calling
-       *  up through a chain of virtual functions when deep down
-       *  in chained ProcNode::pull() calls. This allows derived
-       *  classes to proxy the state interface.
-       */ 
-      virtual State& getCurrentImplementation () =0;
-      
-      friend class engine::StateAdapter;
-      
     public:
       /** allocate a new writable buffer with type and size according to
        *  the BufferDescriptor. The actual provider of this buffer depends
@@ -86,6 +73,19 @@ namespace engine {
       /** necessary for creating a local BuffTableChunk */
       virtual BuffTableStorage& getBuffTableStorage()  =0; 
       
+      
+    protected:
+      virtual ~State() {};
+      
+      /** resolves to the State object currently "in charge".
+       *  Intended as a performance shortcut to avoid calling
+       *  up through a chain of virtual functions when deep down
+       *  in chained ProcNode::pull() calls. This allows derived
+       *  classes to proxy the state interface.
+       */ 
+      virtual State& getCurrentImplementation () =0;
+      
+      friend class engine::StateAdapter;
     };
   
 } // namespace engine
diff --git a/tests/components/proc/engine/bufftabletest.cpp b/tests/components/proc/engine/bufftabletest.cpp
index 4806d5bb6..d50a95336 100644
--- a/tests/components/proc/engine/bufftabletest.cpp
+++ b/tests/components/proc/engine/bufftabletest.cpp
@@ -26,6 +26,7 @@
 
 #include "proc/engine/procnode.hpp"
 #include "proc/engine/bufftable.hpp"
+#include "lib/refarray.hpp"
 
 #include <boost/scoped_ptr.hpp>
 #include <iostream>
@@ -49,10 +50,11 @@ namespace engine {
       
       /** just some crap to pass in as ctor argument... */
       template<class E>
-      struct DummyArray : RefArray<E>
+      struct DummyArray : lib::RefArray<E>
         {
           E decoy;
           E const& operator[] (uint)  const  { return decoy;}
+          size_t size()               const  { return CHUNK_MAX;}
         };
       DummyArray<ChannelDescriptor> dummy1;
       DummyArray<InChanDescriptor>  dummy2;

From 1c388287c9cc38a5a1af7318253e2401c0bc10bb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 7 Oct 2008 05:16:02 +0200
Subject: [PATCH 259/368] simple vector wrapping implementation of the RefArray
 interface

---
 src/lib/refarrayimpl.hpp      |  69 ++++++++++++++++++++++
 tests/40components.tests      |   5 ++
 tests/common/refarraytest.cpp | 108 ++++++++++++++++++++++++++++++++++
 3 files changed, 182 insertions(+)
 create mode 100644 src/lib/refarrayimpl.hpp
 create mode 100644 tests/common/refarraytest.cpp

diff --git a/src/lib/refarrayimpl.hpp b/src/lib/refarrayimpl.hpp
new file mode 100644
index 000000000..c0ea481d8
--- /dev/null
+++ b/src/lib/refarrayimpl.hpp
@@ -0,0 +1,69 @@
+/*
+  REFARRAYIMPL.hpp  -  some implementations of the ref-array interface
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef LIB_REFARRAYIMPL_H
+#define LIB_REFARRAYIMPL_H
+
+
+#include "lib/refarray.hpp"
+#include "proc/nobugcfg.hpp"
+
+#include <vector>
+using std::vector;
+
+
+
+namespace lib {
+  
+  /**
+   * Wrap a vector holding objects of a subtype
+   * and provide array-like access using the interface type.
+   */
+  template<class E, class IM = E>
+  class RefArrayVectorWrapper
+    : public RefArray<E>
+    {
+      typedef vector<IM> const& Tab;
+      Tab table_;
+      
+    public:
+      
+      RefArrayVectorWrapper (Tab toWrap)
+        : table_(toWrap)
+        { }
+      
+      virtual size_t size()  const
+        {
+          return table_.size();
+        }
+      
+      virtual E const& operator[] (uint i)  const 
+        {
+          REQUIRE (i < size());
+          return table_[i];
+        }
+    };
+  
+  
+} // namespace lib
+#endif
diff --git a/tests/40components.tests b/tests/40components.tests
index b301b262d..ab40bd9e4 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -308,6 +308,11 @@ out: ::0::1::2::3::4::5::6::7::8::9::10::11::12::13::14::15::16::17::18::19
 END
 
 
+TEST "RefArray_test" RefArray_test  <<END
+return: 0
+END
+
+
 TEST "RemoveFromSet_test" RemoveFromSet_test <<END
 out: removed  nothing  ---> \[ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
 out: removed 0 ---> \[ 1, 2, 3, 4, 5, 6, 7, 8, 9, \]
diff --git a/tests/common/refarraytest.cpp b/tests/common/refarraytest.cpp
new file mode 100644
index 000000000..84ec954c2
--- /dev/null
+++ b/tests/common/refarraytest.cpp
@@ -0,0 +1,108 @@
+/*
+  RefArray(Test)  -  unittest for wrapping with array-of-refs access
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "common/test/run.hpp"
+#include "common/util.hpp"
+
+#include "lib/refarrayimpl.hpp"
+
+//#include <boost/lexical_cast.hpp>
+//#include <boost/format.hpp>
+#include <iostream>
+#include <vector>
+
+//using boost::lexical_cast;
+//using boost::format;
+//using util::isnil;
+//using std::string;
+using test::Test;
+using std::cout;
+using std::vector;
+
+
+namespace lib {
+  namespace test {
+    
+    namespace { // test types
+    
+      struct I
+        {
+          virtual int op(int i)  const =0;
+          virtual ~I() {}
+        };
+      
+      struct Sub1 : I
+        {
+          int op (int i) { return i+1; }
+        };
+      
+      struct Sub2 : I
+        {
+          const char* letterz_; 
+          Sub2() : letterz_("ABCDEFGHIJKLMNOPQRSTUVWXYZ") {}
+          
+          int op (int i)  const { return (int)letterz_[i % 26]; }
+        };
+      
+    } // (END) test types
+    
+    
+    
+    
+    
+    
+    
+    /*******************************************************************
+     * @test build a wrapper providing RefArray access to a given vector
+     * @see refarrayimpl.hpp
+     */
+    class RefArray_test : public Test
+      {
+        
+        virtual void
+        run (Arg arg) 
+          {
+            vector<Sub2> subz(10);
+            RefArrayVectorWrapper<I,Sub2> subWrapz (subz);
+            
+            RefArray<I> & rArr (subWrapz);
+            
+            ASSERT (subWrapz.size()==subz.size());
+            ASSERT (INSTANCEOF(I, &rArr[0]));
+            for (size_t i=0; i<subz.size(); ++i)
+              ASSERT (rArr[i].op(i) == subz[i].op(i));
+          }
+
+        
+      };
+    
+      
+    
+    /** Register this test class... */
+    LAUNCHER (RefArray_test, "unit common");
+    
+    
+    
+  } // namespace test
+
+} // namespace lib

From 8c6b6c5192c5c9f065218ec5a2e2afe74f7d00de Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 9 Oct 2008 05:23:24 +0200
Subject: [PATCH 260/368] WIP further RefArray implementations

---
 src/lib/refarray.hpp         |  2 +-
 src/lib/refarrayimpl.hpp     | 81 ++++++++++++++++++++++++++++++++++++
 src/proc/engine/procnode.hpp |  2 +-
 3 files changed, 83 insertions(+), 2 deletions(-)

diff --git a/src/lib/refarray.hpp b/src/lib/refarray.hpp
index d4efc126a..ac1457949 100644
--- a/src/lib/refarray.hpp
+++ b/src/lib/refarray.hpp
@@ -38,7 +38,7 @@ namespace lib {
   template<class E>
   struct RefArray
     {
-      virtual E const& operator[] (uint i)  const =0;
+      virtual E const& operator[] (uint i)  const =0;   ///////////////////TODO use size_t
       virtual size_t size()  const =0;
       virtual ~RefArray() {}
     };
diff --git a/src/lib/refarrayimpl.hpp b/src/lib/refarrayimpl.hpp
index c0ea481d8..cfc53e9aa 100644
--- a/src/lib/refarrayimpl.hpp
+++ b/src/lib/refarrayimpl.hpp
@@ -65,5 +65,86 @@ namespace lib {
     };
   
   
+  /**
+   * This variation of the wrapper actually \em is
+   * a vector, but can act as a RefArray
+   */
+  template<class E, class IM = E>
+  class RefArrayVector
+    : public vector<IM>,
+      public RefArrayVectorWrapper<E,IM>
+    {
+      typedef RefArrayVectorWrapper<E,IM> Wrap;
+      typedef vector<IM> Vect;
+      typedef typename Vect::size_type Size_t;
+      typedef typename Vect::value_type Val_t;
+      
+    public:
+      RefArrayVector()                                   : Vect(),    Wrap(*this) {}
+      RefArrayVector(Size_t n, Val_t const& v = Val_t()) : Vect(n,v), Wrap(*this) {}
+      RefArrayVector(Vect const& ref)                    : Vect(ref), Wrap(*this) {}
+      
+      using Vect::size;
+      using Wrap::operator[];
+    };
+  
+  
+  /**
+   * RefArray implementation based on a fixed sized array,
+   * i.e. the storage is embedded. Embedded value type
+   * either needs to be default- or copy-constructible.
+   */
+  template<class E, size_t n, class IM = E>
+  class RefArrayTable
+    : public RefArray<E>
+    {
+      IM array_[n];
+      
+    public:
+      RefArrayTable()
+        {
+          size_t i=0;
+          try
+            {
+              while (i<n)  new(&array_[i++]) IM();
+            }
+          catch(...) { cleanup(i); throw; }
+        }
+      
+      template<class FAC>
+      RefArrayTable(FAC& factory)
+        {
+          size_t i=0;
+          try
+            {
+              while (i<n)  new(&array_[i]) IM (factory(i++));
+            }
+          catch(...) { cleanup(i); throw; }
+        }
+      
+      ~RefArrayTable() { cleanup(); }
+      
+    private:
+      void cleanup(size_t top=n) throw()
+        {
+          while (top) array_[--top].~IM();
+        }
+      
+      
+    public: //----RefArray-Interface----------
+      
+      virtual size_t size()  const
+        { 
+          return n; 
+        }
+      
+      virtual E const& operator[] (uint i)  const 
+        {
+          REQUIRE (i < size());
+          return array_[i];
+        }
+
+    };
+  
 } // namespace lib
 #endif
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index b62f7947e..10b3ad548 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -91,7 +91,7 @@ namespace engine {
       
       /** the wiring-dependent part of the node operation.
        *  Includes the creation of a one-way state object on the stack
-       *  holding the actual buffer pointers and issuing the recrusive pull() calls
+       *  holding the actual buffer pointers and issuing the recursive pull() calls
        *  @see NodeWiring#callDown default implementation
        */
       virtual BuffHandle  callDown (State& currentProcess, uint requiredOutputNr)  const =0; 

From 563d88c955b474a241b7d0fa046ae9284630f731 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Oct 2008 23:41:05 +0200
Subject: [PATCH 261/368] clean up unneccessary import

---
 tests/components/proc/engine/bufftabletest.cpp               | 5 ++---
 .../components/proc/mobject/session/defsmanagerimpltest.cpp  | 1 -
 tests/components/proc/mobject/session/defsmanagertest.cpp    | 1 -
 .../components/proc/mobject/session/defsregistryimpltest.cpp | 5 ++---
 tests/lib/query/querydiagnostics.hpp                         | 1 -
 tests/lib/query/queryutilstest.cpp                           | 1 -
 6 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/tests/components/proc/engine/bufftabletest.cpp b/tests/components/proc/engine/bufftabletest.cpp
index d50a95336..db110c3df 100644
--- a/tests/components/proc/engine/bufftabletest.cpp
+++ b/tests/components/proc/engine/bufftabletest.cpp
@@ -30,7 +30,6 @@
 
 #include <boost/scoped_ptr.hpp>
 #include <iostream>
-#include <cstdlib>
 #include <ctime>
 
 using test::Test;
@@ -106,7 +105,7 @@ namespace engine {
       bool
       consistencyCheck (BuffTable const& b, WiringDescriptor const& num, void* lastLevel)
       {
-        return (b.outHandle == lastLevel )  // storage is allocated continously
+        return (b.outHandle == lastLevel )  // storage is allocated continuously
             && (b.outBuff   <= b.inBuff  )  // input slots are behind the output slots
             && (b.outHandle <= b.inHandle)
             && (b.inBuff   == &b.outBuff  [num.getNrO()])
@@ -126,7 +125,7 @@ namespace engine {
      *       allocating a chunk out of a global buffer table storage.
      *       After returning, each allocation should be cleanly
      *       deallocated and the internal level in the storage vector
-     *       should have dopped to zero again.
+     *       should have doped to zero again.
      */
     class BuffTable_test : public Test
       {
diff --git a/tests/components/proc/mobject/session/defsmanagerimpltest.cpp b/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
index 97741b5e9..89cbc4368 100644
--- a/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
+++ b/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
@@ -33,7 +33,6 @@
 #include "proc/mobject/session.hpp"
 
 #include <boost/format.hpp>
-#include <cstdlib>
 
 using boost::format;
 using util::isnil;
diff --git a/tests/components/proc/mobject/session/defsmanagertest.cpp b/tests/components/proc/mobject/session/defsmanagertest.cpp
index 0573859ab..fcc66cfdc 100644
--- a/tests/components/proc/mobject/session/defsmanagertest.cpp
+++ b/tests/components/proc/mobject/session/defsmanagertest.cpp
@@ -34,7 +34,6 @@
 #include "proc/mobject/session.hpp"
 
 #include <boost/format.hpp>
-#include <cstdlib>
 
 using boost::format;
 using util::isnil;
diff --git a/tests/components/proc/mobject/session/defsregistryimpltest.cpp b/tests/components/proc/mobject/session/defsregistryimpltest.cpp
index b625cddab..87ccce09c 100644
--- a/tests/components/proc/mobject/session/defsregistryimpltest.cpp
+++ b/tests/components/proc/mobject/session/defsregistryimpltest.cpp
@@ -33,7 +33,6 @@
 
 #include <boost/scoped_ptr.hpp>
 #include <boost/format.hpp>
-#include <cstdlib>
 #include <map>
 
 using lumiera::P;
@@ -216,7 +215,7 @@ namespace mobject {
               ASSERT (!j.hasNext());
               
               // calling with an arbitrary (registered) query
-              // yields the corresponding object at start of the ennumeration
+              // yields the corresponding object at start of the enumeration
               j = reg_->candidates(ps.begin()->first);
               ASSERT ( *j == ps.begin()->second);
               
@@ -257,7 +256,7 @@ namespace mobject {
               ASSERT (!i.hasNext());
               
               ASSERT (!reg_->put (o2, q5));  // trying to (re)register o2 with a existing query
-                                             // counts as failure (nothing chages)
+                                             // counts as failure (nothing changes)
               i = reg_->candidates(q5);
               ASSERT ( *i++ == o1); // direct match
               ASSERT ( *i++ == o1);
diff --git a/tests/lib/query/querydiagnostics.hpp b/tests/lib/query/querydiagnostics.hpp
index 54545d841..47d73283f 100644
--- a/tests/lib/query/querydiagnostics.hpp
+++ b/tests/lib/query/querydiagnostics.hpp
@@ -26,7 +26,6 @@
 
 
 #include <boost/format.hpp>
-#include <cstdlib>
 
 using boost::format;
 using std::string;
diff --git a/tests/lib/query/queryutilstest.cpp b/tests/lib/query/queryutilstest.cpp
index f7691edf0..6f642ea49 100644
--- a/tests/lib/query/queryutilstest.cpp
+++ b/tests/lib/query/queryutilstest.cpp
@@ -30,7 +30,6 @@
 
 #include <tr1/functional>
 #include <iostream>
-#include <cstdlib>
 
 using lumiera::Query;
 using util::Cmdline;

From ba05a6b13566914b9f3a67088cd59ec42f99249c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 12 Oct 2008 23:52:19 +0200
Subject: [PATCH 262/368] test coverage for the more exotic RefArray impls

---
 src/lib/refarray.hpp          |   3 +-
 src/lib/refarrayimpl.hpp      |  50 ++++++-----
 tests/common/refarraytest.cpp | 161 ++++++++++++++++++++++++++++++----
 3 files changed, 173 insertions(+), 41 deletions(-)

diff --git a/src/lib/refarray.hpp b/src/lib/refarray.hpp
index ac1457949..fa0015393 100644
--- a/src/lib/refarray.hpp
+++ b/src/lib/refarray.hpp
@@ -25,6 +25,7 @@
 #define LIB_REFARRAY_H
 
 
+#include <boost/noncopyable.hpp>
 
 
 namespace lib {
@@ -36,7 +37,7 @@ namespace lib {
    * holding subclasses.
    */
   template<class E>
-  struct RefArray
+  struct RefArray : boost::noncopyable
     {
       virtual E const& operator[] (uint i)  const =0;   ///////////////////TODO use size_t
       virtual size_t size()  const =0;
diff --git a/src/lib/refarrayimpl.hpp b/src/lib/refarrayimpl.hpp
index cfc53e9aa..1ddc5fb72 100644
--- a/src/lib/refarrayimpl.hpp
+++ b/src/lib/refarrayimpl.hpp
@@ -39,9 +39,9 @@ namespace lib {
    * Wrap a vector holding objects of a subtype
    * and provide array-like access using the interface type.
    */
-  template<class E, class IM = E>
+  template<class B, class IM = B>
   class RefArrayVectorWrapper
-    : public RefArray<E>
+    : public RefArray<B>
     {
       typedef vector<IM> const& Tab;
       Tab table_;
@@ -57,7 +57,7 @@ namespace lib {
           return table_.size();
         }
       
-      virtual E const& operator[] (uint i)  const 
+      virtual B const& operator[] (uint i)  const 
         {
           REQUIRE (i < size());
           return table_[i];
@@ -69,20 +69,20 @@ namespace lib {
    * This variation of the wrapper actually \em is
    * a vector, but can act as a RefArray
    */
-  template<class E, class IM = E>
+  template<class B, class IM = B>
   class RefArrayVector
     : public vector<IM>,
-      public RefArrayVectorWrapper<E,IM>
+      public RefArrayVectorWrapper<B,IM>
     {
-      typedef RefArrayVectorWrapper<E,IM> Wrap;
-      typedef vector<IM> Vect;
+      typedef RefArrayVectorWrapper<B,IM> Wrap;
+      typedef vector<IM>                 Vect;
       typedef typename Vect::size_type Size_t;
       typedef typename Vect::value_type Val_t;
       
     public:
-      RefArrayVector()                                   : Vect(),    Wrap(*this) {}
-      RefArrayVector(Size_t n, Val_t const& v = Val_t()) : Vect(n,v), Wrap(*this) {}
-      RefArrayVector(Vect const& ref)                    : Vect(ref), Wrap(*this) {}
+      RefArrayVector()                                   : Vect(),    Wrap((Vect&)*this) {}
+      RefArrayVector(Size_t n, Val_t const& v = Val_t()) : Vect(n,v), Wrap((Vect&)*this) {}
+      RefArrayVector(Vect const& ref)                    : Vect(ref), Wrap((Vect&)*this) {}
       
       using Vect::size;
       using Wrap::operator[];
@@ -90,34 +90,40 @@ namespace lib {
   
   
   /**
-   * RefArray implementation based on a fixed sized array,
-   * i.e. the storage is embedded. Embedded value type
-   * either needs to be default- or copy-constructible.
+   * RefArray implementation based on a fix sized array,
+   * i.e. the storage is embedded. Embedded subclass obj
+   * either need to be default constructible or be
+   * placed directly by a factory
    */
-  template<class E, size_t n, class IM = E>
+  template<class B, size_t n, class IM = B>
   class RefArrayTable
-    : public RefArray<E>
+    : public RefArray<B>
     {
-      IM array_[n];
+      char storage_[n*sizeof(IM)];
+      IM* array_;
       
     public:
-      RefArrayTable()
+      RefArrayTable() ///< objects created in-place by default ctor
+        : array_ (reinterpret_cast<IM*> (&storage_))
         {
           size_t i=0;
           try
             {
-              while (i<n)  new(&array_[i++]) IM();
+              while (i<n)
+                new(&array_[i++]) IM();
             }
           catch(...) { cleanup(i); throw; }
         }
       
       template<class FAC>
-      RefArrayTable(FAC& factory)
+      RefArrayTable(FAC& factory) ///< objects created in-place by factory
+        : array_ (reinterpret_cast<IM*> (&storage_))
         {
           size_t i=0;
           try
             {
-              while (i<n)  new(&array_[i]) IM (factory(i++));
+              while (i<n)
+                factory(&array_[i++]);
             }
           catch(...) { cleanup(i); throw; }
         }
@@ -131,14 +137,14 @@ namespace lib {
         }
       
       
-    public: //----RefArray-Interface----------
+    public: //-----RefArray-Interface------------
       
       virtual size_t size()  const
         { 
           return n; 
         }
       
-      virtual E const& operator[] (uint i)  const 
+      virtual B const& operator[] (uint i)  const 
         {
           REQUIRE (i < size());
           return array_[i];
diff --git a/tests/common/refarraytest.cpp b/tests/common/refarraytest.cpp
index 84ec954c2..324fd615b 100644
--- a/tests/common/refarraytest.cpp
+++ b/tests/common/refarraytest.cpp
@@ -26,18 +26,11 @@
 
 #include "lib/refarrayimpl.hpp"
 
-//#include <boost/lexical_cast.hpp>
-//#include <boost/format.hpp>
-#include <iostream>
 #include <vector>
 
-//using boost::lexical_cast;
-//using boost::format;
-//using util::isnil;
-//using std::string;
-using test::Test;
-using std::cout;
+using ::test::Test;
 using std::vector;
+using std::rand;
 
 
 namespace lib {
@@ -53,7 +46,11 @@ namespace lib {
       
       struct Sub1 : I
         {
-          int op (int i) { return i+1; }
+          int offs_;
+          
+          Sub1 (int o=1) : offs_(o) {}
+          
+          int op (int i)  const { return i+offs_; }
         };
       
       struct Sub2 : I
@@ -64,6 +61,30 @@ namespace lib {
           int op (int i)  const { return (int)letterz_[i % 26]; }
         };
       
+      struct Sub3 : I
+        {
+          int id_;
+          static long sum;
+          static long trigger;
+          
+          Sub3(int id) : id_(id)
+            { 
+              sum +=id_;
+              if ( id_ == trigger )
+                throw trigger; // fail while in construction
+            }
+          ~Sub3()
+            { 
+              sum -=id_;
+            }
+          
+          int op (int i)  const { return i + id_; }
+        };
+      
+      long Sub3::sum = 0;
+      long Sub3::trigger = -1;
+      
+      
     } // (END) test types
     
     
@@ -80,23 +101,127 @@ namespace lib {
       {
         
         virtual void
-        run (Arg arg) 
+        run (Arg arg)
+          {
+            checkWrapper();
+            checkVector();
+            checkTable();
+            checkTable_inplaceCreation();
+            checkTable_errorHandling();
+          }
+        
+        
+        void
+        checkWrapper()
           {
             vector<Sub2> subz(10);
-            RefArrayVectorWrapper<I,Sub2> subWrapz (subz);
+            RefArrayVectorWrapper<I,Sub2> subWrap (subz);
             
-            RefArray<I> & rArr (subWrapz);
+            RefArray<I> & rArr (subWrap);
             
-            ASSERT (subWrapz.size()==subz.size());
+            ASSERT (subWrap.size()==subz.size());
             ASSERT (INSTANCEOF(I, &rArr[0]));
-            for (size_t i=0; i<subz.size(); ++i)
-              ASSERT (rArr[i].op(i) == subz[i].op(i));
+            for (size_t i=0; i<rArr.size(); ++i)
+              {
+                ASSERT (&rArr[i] == &subz[i]);
+                ASSERT (rArr[i].op(i) == subz[i].op(i));
+              }
           }
-
         
+        void
+        checkVector()
+          {
+            RefArrayVector<I,Sub2> subz(10);
+            
+            vector<Sub2> & vect (subz);
+            RefArray<I> & rArr (subz);
+            
+            ASSERT (vect.size()==subz.size());
+            ASSERT (INSTANCEOF(I, &rArr[0]));
+            for (size_t i=0; i<rArr.size(); ++i)
+              {
+                ASSERT (&rArr[i] == &vect[i]);
+                ASSERT (rArr[i].op(i) == vect[i].op(i));
+              }
+          }
+        
+        
+#define ADR(OBJ) (ulong)&(OBJ)
+        
+        void
+        checkTable()
+          {
+            RefArrayTable<I,20,Sub1> tab;  
+            // creates 20 Sub1-objects in-place
+            // which are indeed located within the object
+            ASSERT (sizeof(tab) >= 20 * sizeof(Sub1));
+            ASSERT (ADR(tab) < ADR(tab[19]) && ADR(tab[19]) < ADR(tab) + sizeof(tab));
+            
+            RefArray<I> & rArr (tab);
+            
+            ASSERT (20 == tab.size());
+            ASSERT (INSTANCEOF(I, &rArr[0]));
+            for (size_t i=0; i<rArr.size(); ++i)
+              {
+                ASSERT (i*sizeof(Sub1) == ADR(rArr[i]) - ADR(rArr[0]) ); // indeed array-like storage
+                ASSERT (int(i+1) == rArr[i].op(i));                     //  check the known result
+              }
+          }
+        
+        template<class SUB>
+        struct Fac ///< fabricating a series of subclass instances with varying ctor parameter
+          {
+            int offset_;
+            Fac ( ) : offset_ (0) {}
+            
+            void operator() (void* place)
+              {
+                ASSERT (place);
+                new (place) SUB (offset_++); // note: varying ctor parameter
+              }
+          };
+        
+        
+        void 
+        checkTable_inplaceCreation()
+          {
+            Fac<Sub1> theFact;
+            RefArrayTable<I,30,Sub1> tab (theFact);
+            RefArray<I> & rArr (tab);
+            ASSERT (30 == tab.size());
+            for (size_t i=0; i<rArr.size(); ++i)
+              ASSERT (int(i+i) == rArr[i].op(i)); // each one has gotten another offset ctor parameter
+          }
+        
+        
+        void 
+        checkTable_errorHandling()
+          {
+            for (uint i=0; i<500; ++i)
+              {
+                Sub3::sum = 0;
+                Sub3::trigger = (rand() % 50);  // when hitting the trigger Sub3 throws
+                try
+                  {
+                    {
+                      Fac<Sub3> factory;
+                      RefArrayTable<I,30,Sub3> table (factory);
+                      ASSERT (Sub3::sum == (29+1)*29/2);
+                    }
+                    ASSERT (Sub3::sum == 0);
+                  }
+                
+                catch(long id)
+                  {
+                    ASSERT (id == Sub3::trigger);
+                    ASSERT (Sub3::sum == id);
+                    // meaning: all objects have been cleaned up,
+                    // with the exception of the one hitting the trigger
+              }   }
+          }
       };
     
-      
+    
     
     /** Register this test class... */
     LAUNCHER (RefArray_test, "unit common");

From 06000769e2c0e630fe0a51857f752b195d83d7c6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 13 Oct 2008 04:33:10 +0200
Subject: [PATCH 263/368] re-read the code concerning the pull()-call, fix
 obvious mismatches, comment, plan...

---
 src/lib/frameid.hpp                           |  4 +--
 src/lib/refarray.hpp                          |  7 +++--
 src/lib/refarrayimpl.hpp                      | 30 +++++++++++++++----
 src/proc/engine/buffhandle.hpp                |  2 +-
 src/proc/engine/nodefactory.cpp               |  2 +-
 src/proc/engine/nodefactory.hpp               |  2 +-
 src/proc/engine/nodeinvocation.hpp            |  8 ++---
 src/proc/engine/nodeoperation.hpp             | 29 ++++++++++++++----
 src/proc/engine/nodewiring.cpp                | 14 +++------
 src/proc/engine/nodewiring.hpp                | 12 ++++----
 src/proc/engine/nodewiringconfig.hpp          |  2 +-
 src/proc/engine/procnode.hpp                  | 11 +++----
 src/proc/mobject/builder/operationpoint.hpp   |  2 +-
 tests/common/refarraytest.cpp                 |  8 ++++-
 .../components/proc/engine/bufftabletest.cpp  |  4 +--
 15 files changed, 88 insertions(+), 49 deletions(-)

diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp
index 8f961b959..f9e32b525 100644
--- a/src/lib/frameid.hpp
+++ b/src/lib/frameid.hpp
@@ -45,8 +45,8 @@ namespace lumiera
       FrameID(long dum=0) : dummy(dum) {}
       operator long () { return dummy; }
       
-      bool operator<  (const FrameID& of)  const { return dummy <  of.dummy; }
-      bool operator== (const FrameID& of)  const { return dummy == of.dummy; }
+      bool operator<  (const FrameID& other)  const { return dummy <  other.dummy; }
+      bool operator== (const FrameID& other)  const { return dummy == other.dummy; }
     };
     
   
diff --git a/src/lib/refarray.hpp b/src/lib/refarray.hpp
index fa0015393..69aa42112 100644
--- a/src/lib/refarray.hpp
+++ b/src/lib/refarray.hpp
@@ -36,11 +36,12 @@ namespace lib {
    * and the Implementation wraps some datastructure
    * holding subclasses.
    */
-  template<class E>
+  template<class T>
   struct RefArray : boost::noncopyable
     {
-      virtual E const& operator[] (uint i)  const =0;   ///////////////////TODO use size_t
-      virtual size_t size()  const =0;
+      virtual T const& operator[] (size_t i)  const =0;
+      virtual size_t size()                   const =0;
+      
       virtual ~RefArray() {}
     };
   
diff --git a/src/lib/refarrayimpl.hpp b/src/lib/refarrayimpl.hpp
index 1ddc5fb72..65108d763 100644
--- a/src/lib/refarrayimpl.hpp
+++ b/src/lib/refarrayimpl.hpp
@@ -20,6 +20,23 @@
  
 */
 
+/** @file refarrayimpl.hpp
+ ** Some (library-) implementations of the RefArray interface.
+ **
+ ** Being an array-like object exposing just a const ref, it is typically used
+ ** on interfaces, and the type of the array "elements" usually is a ABC or interface.
+ ** The actual implementation usually holds a subclass, and is either based on a vector,
+ ** or a fixed storage contained within the implementation. The only price to pay is
+ ** that of an virtual call on element access.
+ ** 
+ ** For advanced use it would be possible to have a pointer-array or even an embedded
+ ** storage of variant-records, able to hold a mixture of subclasses. (the latter cases
+ ** will be implemented when needed).
+ **
+ ** @see refarraytest.cpp
+ ** 
+ */
+
 
 #ifndef LIB_REFARRAYIMPL_H
 #define LIB_REFARRAYIMPL_H
@@ -36,8 +53,8 @@ using std::vector;
 namespace lib {
   
   /**
-   * Wrap a vector holding objects of a subtype
-   * and provide array-like access using the interface type.
+   * Wrap a vector holding objects of a subtype and
+   * provide array-like access using the interface type.
    */
   template<class B, class IM = B>
   class RefArrayVectorWrapper
@@ -57,7 +74,7 @@ namespace lib {
           return table_.size();
         }
       
-      virtual B const& operator[] (uint i)  const 
+      virtual B const& operator[] (size_t i)  const 
         {
           REQUIRE (i < size());
           return table_[i];
@@ -66,8 +83,8 @@ namespace lib {
   
   
   /**
-   * This variation of the wrapper actually \em is
-   * a vector, but can act as a RefArray
+   * This variation of the wrapper actually
+   *  \em is a vector, but can act as a RefArray
    */
   template<class B, class IM = B>
   class RefArrayVector
@@ -89,6 +106,7 @@ namespace lib {
     };
   
   
+  
   /**
    * RefArray implementation based on a fix sized array,
    * i.e. the storage is embedded. Embedded subclass obj
@@ -144,7 +162,7 @@ namespace lib {
           return n; 
         }
       
-      virtual B const& operator[] (uint i)  const 
+      virtual B const& operator[] (size_t i)  const 
         {
           REQUIRE (i < size());
           return array_[i];
diff --git a/src/proc/engine/buffhandle.hpp b/src/proc/engine/buffhandle.hpp
index 76d1acacf..d078bc7f1 100644
--- a/src/proc/engine/buffhandle.hpp
+++ b/src/proc/engine/buffhandle.hpp
@@ -27,7 +27,7 @@
  ** different "buffer providers" (for example the frame cache). For accessing those buffers,
  ** the node needs to keep a table of buffer pointers, and for releasing the buffers later
  ** on, we need some handles. The usage pattern of those buffer pointer tables is stack-like,
- ** thus it makes sense to utilize a single large buffer pointer array per pull() calldown
+ ** thus it makes sense to utilise a single large buffer pointer array per pull() calldown
  ** sequence and dynamically claim small chunks for each node.
  **
  ** @see nodeoperation.hpp
diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index d439232f3..9d5169d92 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -1,5 +1,5 @@
 /*
-  NodeFactory  -  Interface for creating processing nodes of variouos kinds
+  NodeFactory  -  Interface for creating processing nodes of various kinds
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp
index 7abae3340..6c495d419 100644
--- a/src/proc/engine/nodefactory.hpp
+++ b/src/proc/engine/nodefactory.hpp
@@ -1,5 +1,5 @@
 /*
-  NODEFACTORY.hpp  -  Interface for creating processing nodes of variouos kinds
+  NODEFACTORY.hpp  -  Interface for creating processing nodes of various kinds
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index 33801eb4f..8ca6f4406 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -21,14 +21,14 @@
 */
 
 /** @file nodeinvocation.hpp
- ** Organize the state related to the invocation of s single ProcNode::pull() call
+ ** Organise the state related to the invocation of s single ProcNode::pull() call
  ** This header defines part of the "glue" which holds together the render node network
  ** and enables to pull result frames from the nodes. Doing so requires some invocation
  ** local state to be maintained, especially a table of buffers used to carry out the
  ** calculations. Further, getting the input buffers filled requires to issue recursive
  ** \c pull() calls, which on the whole creates a stack-like assembly of local invocation
  ** state.
- ** The actual steps to be carried out for a \c pull() call are dependant on the configuration
+ ** The actual steps to be carried out for a \c pull() call are dependent on the configuration
  ** of the node to pull. Each node has been preconfigured by the builder with a WiringDescriptor
  ** and a concrete type of a StateAdapter. The actual sequence of steps is defined in the header
  ** nodeoperation.hpp out of a set of basic operation steps. These steps all use the passed in
@@ -179,14 +179,14 @@ namespace engine {
    * The real invocation context state implementation. It is created
    * by the NodeWiring (WiringDescriptor) of the processing node which
    * is pulled by this invocation, hereby using the internal configuration
-   * information to guide the selecton of the real call sequence 
+   * information to guide the selection of the real call sequence 
    * 
    * \par assembling the call sequence implementation
    * Each ProcNode#pull() call creates such a StateAdapter subclass on the stack,
    * with a concrete type according to the WiringDescriptor of the node to pull.
    * This concrete type encodes a calculation Strategy, which is assembled
    * as a chain of policy templates on top of OperationBase. For each of the
-   * possible configuratons we define such a chain (see bottom of nodeoperation.hpp).
+   * possible configurations we define such a chain (see bottom of nodeoperation.hpp).
    * The WiringFactory defined in nodewiring.cpp actually drives the instantiation
    * of all those possible combinations.
    */
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index e206a811b..10f1393ce 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -39,9 +39,9 @@
  ** StateAdapter, the predecessor nodes are pulled. The way these operations are carried out is encoded
  ** in the actual type of Strategy, which is defined at the bottom of this header. Each Strategy is a chain
  ** of elementary operations invoking each other (\c NEXT::step(invocation) ). Notably, all those possible
- ** configurations are pre-build while compiling (it's a small number below 32 configuration instance).
+ ** configurations are pre-built while compiling (it's a small number below 32 configuration instance).
  ** To be able to select the Strategy for each configuration, we need a Factory (ConfigSelector defined in
- ** nodewiringconfig). which is actually instantiated and used in nodewiring.cpp, which is the object
+ ** nodewiringconfig.hpp). which is actually instantiated and used in nodewiring.cpp, which is the object
  ** file holding all those instantiations. 
  **
  ** @see engine::ProcNode
@@ -65,6 +65,7 @@
 
 #include "lib/meta/util.hpp"
 #include "lib/meta/configflags.hpp"
+#include "lib/frameid.hpp"
 
 
 
@@ -74,13 +75,29 @@ namespace engine {
     
     
     /**
-     * Collection of functions used to build up the invocation sequence.
+     * Base class of all concrete invocation sequences.
+     * Could contain a collection of functions used to build up the invocation sequence.
+     * Currently contains just a marker used to detect the existence of an concrete
+     * definition/specialisation for a given specific configuration.
      */
     class OperationBase
       {
         typedef lumiera::Yes_t is_defined;
+        
+        
+        FrameID const&
+        genFrameID (Invocation& ivo)
+          {
+            TODO ("how to represent FrameIDs");
+            //////TODO: decide how to organise generating FrameIDs.
+            //////  who knows the actual time? probably it's encapsulated in State.
+            //////  besides, Invocation knows the output channel and can access the type
+            //////
+            UNIMPLEMENTED ("generate FrameID for current calculation situation");
+          }
       };
-      
+    
+    
     template<class NEXT>
     struct QueryCache : NEXT
       {
@@ -128,7 +145,7 @@ namespace engine {
                   *(inH[i] = this->pullPredecessor(ivo,i)); // invoke predecessor
                 // now Input #i is ready...
               }
-            return NEXT::step (ivo); // note: passing down a ref to the ProcessInvocation
+            return NEXT::step (ivo);
           }
       };
     
@@ -231,6 +248,8 @@ namespace engine {
     
     
     
+    
+    /* =============================================================== */
     /* === declare the possible Assembly of these elementary steps === */
     
     enum Cases
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index 8dab297b7..ca6f1c622 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -52,14 +52,9 @@ namespace engine {
     /** filter those configurations which actually define a wiring strategy */
     typedef Filter<AllConfigs::List, Instantiation<Strategy>::Test> PossibleConfigs;
     
-  } // namespace config
-  
-  
-  
-  
-  namespace { // internal: setting up a factory for each required configuration
     
-    using config::ConfigSelector;
+    
+    // internal details: setting up a factory for each required configuration
     
     class Alloc {}; ///////////////TODO
     
@@ -91,7 +86,7 @@ namespace engine {
     
     typedef WiringDescriptor& (FunctionType)(void);
     
-    typedef ConfigSelector< WiringDescriptorFactory  ///< Factory template
+    typedef ConfigSelector< WiringDescriptorFactory  ///< Factory template to instantiate 
                           , FunctionType            ///<  function signature of the Factory
                           , Alloc&                 ///<   allocator fed to all factories
                           > WiringSelector;
@@ -106,7 +101,7 @@ namespace engine {
           { }
       };
   
-  } // (END) internals
+  } // (END) internals (namespace config)
   
   
   /////////////////////////////TODO: define the ctor
@@ -132,7 +127,6 @@ namespace engine {
     size_t config = 13;  /////////////////////////////////////////TODO
 //    return pImpl_->selector[config]();
   }
-  // BlockAlloc<NodeWiring< StateAdapter< Config<cache, process, inplace> > > >::fabricate();
   
   
 } // namespace engine
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 6ad582efc..2733073de 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -37,13 +37,13 @@ namespace engine {
 
   class WiringFactory;
   
-  namespace { class WiringFactoryImpl; }  ////TODO: better use a named implementation namespace! (produces warings on gcc 4.3)
+  namespace config { class WiringFactoryImpl; }
   
   
   /**
    * Actual implementation of the link between nodes,
    * also acting as "track switch" for the execution path
-   * choosen while operating the node network for rendering.
+   * chosen while operating the node network for rendering.
    * @param STATE Invocation state object controlling the
    *        behaviour of callDown() while rendering.
    * @see StateAdapter
@@ -65,10 +65,10 @@ namespace engine {
       
     protected:
       virtual BuffHandle
-      callDown (State& currentProcess, uint requiredOutputNr)  const 
+      callDown (State& currentProcess, uint requestedOutputNr)  const 
         {
-          STATE thisStep (currentProcess, *this);
-          return thisStep.retrieve (requiredOutputNr); // fetch or calculate results
+          STATE thisStep (currentProcess, *this, requestedOutputNr);
+          return thisStep.retrieve (); // fetch or calculate results
         }
       
     };
@@ -77,7 +77,7 @@ namespace engine {
     
   class WiringFactory
     {
-      boost::scoped_ptr<WiringFactoryImpl> pImpl_;
+      boost::scoped_ptr<config::WiringFactoryImpl> pImpl_;
       
     public:
       WiringDescriptor&
diff --git a/src/proc/engine/nodewiringconfig.hpp b/src/proc/engine/nodewiringconfig.hpp
index 56a7d1618..65c2369c7 100644
--- a/src/proc/engine/nodewiringconfig.hpp
+++ b/src/proc/engine/nodewiringconfig.hpp
@@ -111,7 +111,7 @@ namespace engine {
         typedef std::tr1::function<FUNC> FacFunction;
         
         template<class FAC>
-        struct FactoryHolder 
+        struct FactoryHolder ///< impl type erasure
           : private FAC,
             public FacFunction
           {
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 10b3ad548..d192278f2 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -74,6 +74,7 @@ namespace engine {
       virtual uint getNrI()  const =0;           ///////////TODO: indeed need a virtual function??
       virtual uint getNrO()  const =0;
       
+                                               /////////////TODO: Questions: is "in" used? can "in" and "out" be the same type? how and when to place the actual chan descriptors?
       lib::RefArray<ChannelDescriptor>& out;
       lib::RefArray<InChanDescriptor>&  in;
       
@@ -130,19 +131,19 @@ namespace engine {
       /** Engine Core operation: render and pull output from this node.
        *  On return, currentProcess will hold onto output buffer(s) 
        *  containing the calculated result frames. In case this node
-       *  calculates a multi channel output, only one channel can be 
+       *  calculates a multichannel output, only one channel can be 
        *  retrieved by such a \c pull() call, but you can expect data
        *  of the other channels to be processed and fed to cache.
        *  @param currentProcess the current processing state for 
        *         managing buffers and accessing current parameter values
-       *  @param requiredOutputNr the output channel requested (in case
-       *         this node delivers more than one output channel)
+       *  @param requestedOutputNr the output channel requested
+       *         (in case this node delivers more than one output channel)
        *  @return handle to the buffer containing the calculated result. 
        */
       BuffHandle
-      pull (State& currentProcess, uint requiredOutputNr=0)  const
+      pull (State& currentProcess, uint requestedOutputNr=0)  const
         {
-          return this->wiringConfig_.callDown (currentProcess, requiredOutputNr);
+          return this->wiringConfig_.callDown (currentProcess, requestedOutputNr);
         }
       
     };
diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp
index 7324f11f8..92e57bb1b 100644
--- a/src/proc/mobject/builder/operationpoint.hpp
+++ b/src/proc/mobject/builder/operationpoint.hpp
@@ -58,7 +58,7 @@ namespace mobject {
          */
         void attach (asset::PProc const&);
         
-        /** connect the output this OperationPoint referes such as to
+        /** connect the output this OperationPoint refers such as to
          *  connect or combine with the input of the already existing
          *  nodes accessible via the target OperationPoint. 
          */
diff --git a/tests/common/refarraytest.cpp b/tests/common/refarraytest.cpp
index 324fd615b..1b9735926 100644
--- a/tests/common/refarraytest.cpp
+++ b/tests/common/refarraytest.cpp
@@ -94,7 +94,13 @@ namespace lib {
     
     
     /*******************************************************************
-     * @test build a wrapper providing RefArray access to a given vector
+     * @test build several wrappers, each based on a different storage,
+     * all providing RefArray access to a given vector. The rationale
+     * is to expose just the interface.
+     * - RefArrayVectorWrapper is a ref to an existing vector
+     * - RefArrayVector subclasses std::vector
+     * - RefArrayTable holds a fix sized table, i.e. embedded storage  
+     * 
      * @see refarrayimpl.hpp
      */
     class RefArray_test : public Test
diff --git a/tests/components/proc/engine/bufftabletest.cpp b/tests/components/proc/engine/bufftabletest.cpp
index db110c3df..58ed64a4d 100644
--- a/tests/components/proc/engine/bufftabletest.cpp
+++ b/tests/components/proc/engine/bufftabletest.cpp
@@ -52,8 +52,8 @@ namespace engine {
       struct DummyArray : lib::RefArray<E>
         {
           E decoy;
-          E const& operator[] (uint)  const  { return decoy;}
-          size_t size()               const  { return CHUNK_MAX;}
+          E const& operator[] (size_t)  const  { return decoy; }
+          size_t size()                 const  { return CHUNK_MAX;}
         };
       DummyArray<ChannelDescriptor> dummy1;
       DummyArray<InChanDescriptor>  dummy2;

From 4214284d359359dbe7f9ed2b770f707897a04b49 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 14 Oct 2008 05:33:48 +0200
Subject: [PATCH 264/368] accessing the frameID from within the pull() call

---
 src/lib/frameid.hpp                           | 36 +++++++++++++++----
 src/proc/engine/nodeinvocation.hpp            | 15 ++++++++
 src/proc/engine/nodeoperation.hpp             | 13 +------
 src/proc/engine/procnode.hpp                  |  9 +++--
 src/proc/state.hpp                            | 12 +++++++
 .../components/proc/engine/bufftabletest.cpp  |  2 +-
 wiki/renderengine.html                        | 12 ++++++-
 7 files changed, 77 insertions(+), 22 deletions(-)

diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp
index f9e32b525..ce70f16d0 100644
--- a/src/lib/frameid.hpp
+++ b/src/lib/frameid.hpp
@@ -26,10 +26,34 @@
 
 
 
-namespace lumiera
-  {
-
-
+namespace lumiera {
+  
+  
+  /**
+   * Identification tuple for denoting render nodes unambiguously.
+   * 
+   * @todo currently (10/08) this is a dummy implementation. We'll find out
+   *       what is needed once the outline of the render engine is complete.
+   */
+  struct NodeID
+    {
+      /////////TODO: include the segment?
+      ulong id;
+      ulong generation;
+      ulong childSum;
+      
+      NodeID()
+        : id (++currID),
+          generation(0),
+          childSum(0)
+        { }
+      
+      static ulong currID;
+    };
+  
+  ulong NodeID::currID (0);
+  
+  
   /**
    * Identification tuple for addressing frames unambiguously.
    * 
@@ -48,9 +72,9 @@ namespace lumiera
       bool operator<  (const FrameID& other)  const { return dummy <  other.dummy; }
       bool operator== (const FrameID& other)  const { return dummy == other.dummy; }
     };
-    
   
-
+  
+  
    
 } // namespace lumiera
 #endif
diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index 8ca6f4406..2b551c7f0 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -151,6 +151,21 @@ namespace engine {
         }
       
       
+    public:
+      /** specialised version filling in the additional information, i.e
+       *  the concrete node id and the channel number in question */
+      virtual FrameID const&
+      genFrameID ()
+        {
+          return current_.genFrameID(wiring.nodeID, outNr);
+        }
+      
+      virtual FrameID const&
+      genFrameID (NodeID const& nID, uint chanNo)
+        {
+          return current_.genFrameID (nID,chanNo);
+        }
+      
     };
     
     
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index 10f1393ce..e19670f5a 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -85,16 +85,6 @@ namespace engine {
         typedef lumiera::Yes_t is_defined;
         
         
-        FrameID const&
-        genFrameID (Invocation& ivo)
-          {
-            TODO ("how to represent FrameIDs");
-            //////TODO: decide how to organise generating FrameIDs.
-            //////  who knows the actual time? probably it's encapsulated in State.
-            //////  besides, Invocation knows the output channel and can access the type
-            //////
-            UNIMPLEMENTED ("generate FrameID for current calculation situation");
-          }
       };
     
     
@@ -104,8 +94,7 @@ namespace engine {
         BuffHandle
         step (Invocation& ivo)
           {
-            BuffHandle fetched = ivo.fetch (
-                                   this->genFrameID (ivo));
+            BuffHandle fetched = ivo.fetch (ivo.genFrameID());
             if (fetched)
               return fetched;
             else
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index d192278f2..47bdb0180 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -45,6 +45,7 @@
 #include "proc/common.hpp"
 #include "proc/state.hpp"
 #include "proc/mobject/parameter.hpp"
+#include "common/frameid.hpp"
 #include "lib/refarray.hpp"
 
 #include <vector>
@@ -55,6 +56,7 @@ namespace engine {
 
   using std::vector;
   using proc_interface::State;
+  using lumiera::NodeID;
   
   class ProcNode;
   class NodeFactory;
@@ -82,12 +84,15 @@ namespace engine {
       
       ProcFunc* processFunction;
       
+      NodeID const& nodeID;
+      
     protected:
       WiringDescriptor (lib::RefArray<ChannelDescriptor>& o, 
                         lib::RefArray<InChanDescriptor>& i,
-                        ProcFunc pFunc)
+                        ProcFunc pFunc, NodeID const& nID)
         : out(o), in(i),
-          processFunction(pFunc)
+          processFunction(pFunc),
+          nodeID(nID)
         { }  
       
       /** the wiring-dependent part of the node operation.
diff --git a/src/proc/state.hpp b/src/proc/state.hpp
index a20bc9cee..0f4e182c9 100644
--- a/src/proc/state.hpp
+++ b/src/proc/state.hpp
@@ -37,6 +37,7 @@
 namespace engine { 
   
   using lumiera::FrameID;
+  using lumiera::NodeID;
 
   class StateAdapter;
   class BuffTableStorage;
@@ -63,6 +64,17 @@ namespace engine {
        */
       virtual void is_calculated (BuffHandle const&)  =0;
       
+      /** generate (or calculate) an ID denoting a media data frame
+       *  appearing at the given position in the render network,
+       *  for the time point this rendering process is currently 
+       *  calculating data for.
+       *  @param NodeID the unique identification of a specific node
+       *  @param chanNo the number of the output channel of this node
+       *  @return a complete FrameID which unambiguously denotes this
+       *        specific frame and can be used for caching 
+       */
+      virtual FrameID const& genFrameID (NodeID const&, uint chanNo)  =0;
+      
       /** try to fetch an existing buffer containing the denoted frame from
        *  a cache or similar backing system (e.g. peer over the network).
        *  @return either a handle to a readonly buffer, or a null handle
diff --git a/tests/components/proc/engine/bufftabletest.cpp b/tests/components/proc/engine/bufftabletest.cpp
index 58ed64a4d..3e71372b7 100644
--- a/tests/components/proc/engine/bufftabletest.cpp
+++ b/tests/components/proc/engine/bufftabletest.cpp
@@ -67,7 +67,7 @@ namespace engine {
           uint ii,oo;
           
           MockSizeRequest()
-            : WiringDescriptor(dummy1,dummy2,0),
+            : WiringDescriptor(dummy1,dummy2,0,NodeID()),
               ii(rand() % CHUNK_MAX),
               oo(rand() % CHUNK_MAX)
             { }
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 1972e98c8..3b0048fe3 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1606,6 +1606,7 @@ Finally, this example shows an ''automation'' data set controlling some paramete
 * [[how to handle »attached placement«|AttachedPlacementProblem]]
 * working out the [[basic building situations|BuilderPrimitives]] and [[mechanics of rendering|RenderMechanics]]
 * how to classify and [[describe media stream types|StreamType]] and how to [[use them|StreamTypeUse]]
+* the [[identification of frames and nodes|NodeFrameNumbering]]
 * the relation of [[Project, Timelines and Sequences|TimelineSequences]]
 * how to [[start the GUI|GuiStart]] and how to [[communicate|GuiCommunication]]
 * build the first LayerSeparationInterfaces
@@ -2215,6 +2216,13 @@ So, when creating a clip out of such a compound media asset, the clip has to be
 <div title="NodeCreaterTool" modifier="Ichthyostega" created="200712100626" tags="def" changecount="1">
 <pre>NodeCreaterTool is a [[visiting tool|VisitorUse]] used as second step in the [[Builder]]. Starting out from a [[Fixture]], the builder first [[divides the Timeline into segments|SegmentationTool]] and then processes each segment with the NodeCreaterTool to build a render nodes network (Render Engine) for this part of the timeline. While visiting individual Objects and Placements, the NodeCreaterTool creates and wires the necessary [[nodes|ProcNode]]</pre>
 </div>
+<div title="NodeFrameNumbering" modifier="Ichthyostega" created="200810140254" tags="spec draft" changecount="2">
+<pre>!Problem of Frame identification
+
+!Problem of Node numbering
+In the most general case the render network may be just a DAG (not just a tree). Especially, multiple exit points may lead down to the same node, and following each of this possible paths the node may be at a different depth on each. This rules out a simple counter starting from the exit level, leaving us with the possibility of either employing a rather convoluted addressing scheme or using arbitrary ID numbers.
+</pre>
+</div>
 <div title="NodeOperationProtocol" modifier="Ichthyostega" modified="200807072147" created="200806010251" tags="Rendering dynamic" changecount="15">
 <pre>The [[nodes|ProcNode]] are wired to form a &quot;Directed Acyclic Graph&quot;; each node knows its predecessor(s), but not its successor(s).  The RenderProcess is organized according to the ''pull principle'', thus we find an operation {{{pull()}}} at the core of this process. There is no such thing as an &quot;engine object&quot; calling nodes iteratively or table driven, rather, the nodes themselves issue recursive calls to their predecessor(s). For this to work, we need the nodes to adhere to a specific protocol:
 # Node is pulled, with a StateProxy object as parameter (encapsulating the access to the frames or buffers)
@@ -3561,7 +3569,7 @@ At first sight the link between asset and clip-MO is a simple logical relation b
 [img[Entities comprising the Render Engine|uml/fig128389.png]]
 </pre>
 </div>
-<div title="RenderImplDetails" modifier="Ichthyostega" modified="200807132338" created="200806220211" tags="Rendering impl img" changecount="20">
+<div title="RenderImplDetails" modifier="Ichthyostega" modified="200810140245" created="200806220211" tags="Rendering impl img" changecount="22">
 <pre>Below are some notes regarding details of the actual implementation of the render process and processing node operation. In the description of the [[render node operation protocol|NodeOperationProtocol]] and the [[mechanics of the render process|RenderMechanics]], these details were left out deliberately.
 
 !Layered structure of State
@@ -3573,6 +3581,8 @@ For the purpose of node operation, Buffers are identified by a //Buffer-handle,/
 !Problem of multi-channel nodes
 Some data processors simply require to work on multiple channels simultanously, while others work just on a single channel and will be replicated by the builder for each channel invoved. Thus, we are struck with the nasty situation that the node graph may go through some nodes spanning the chain of several channels. Now the decision is //not to care for this complexity within a single chain calculating a single channel.// We rely solely on the cache to avoid duplicated calculations. When a given node happens to produce multiple output buffers, we are bound to allocate them for the purpose of this nodes {{{process()}}} call, but we just &quot;let go&quot; the buffers not needed immediately for the channel acutally to be processed. For this to work, it is supposed that the builder has wired in a caching, and that the cache will hit when we touch the same node again for the other channels.
 
+Closely related to this is the problem how to number and identify nodes and thus to be able to find calculated frames in cache (&amp;rarr; [[here|NodeFrameNumbering]])
+
 !Configuration of the processing nodes
 [&gt;img[uml/fig132357.png]]
 Every node is actually decomposed into three parts

From 97ee7a95eaf3d5b920d7f9db66be6d5366467620 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 16 Oct 2008 05:07:12 +0200
Subject: [PATCH 265/368] WIP try to get grip at the actual node creation...
 determining the right context for node creation to happen

---
 src/proc/engine/buffhandle.hpp          |  2 ++
 src/proc/engine/nodewiring.cpp          |  4 +++-
 src/proc/engine/nodewiring.hpp          |  6 +++++-
 src/proc/mobject/builder/conmanager.hpp |  2 +-
 src/proc/mobject/builder/mould.hpp      |  2 +-
 wiki/renderengine.html                  | 20 ++++++++++++--------
 6 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/src/proc/engine/buffhandle.hpp b/src/proc/engine/buffhandle.hpp
index d078bc7f1..afe3470be 100644
--- a/src/proc/engine/buffhandle.hpp
+++ b/src/proc/engine/buffhandle.hpp
@@ -101,5 +101,7 @@ namespace engine {
     };
   
   
+  //////TODO: invent an input/output description pattern, which can be passed to the wiring factory
+  
 } // namespace engine
 #endif
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index ca6f1c622..864905a22 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -124,8 +124,10 @@ namespace engine {
     UNIMPLEMENTED ("build the actual wiring descriptor based on given operation options");
     
 //    Bits config (FlagInfo<Config>::CODE);
-    size_t config = 13;  /////////////////////////////////////////TODO
 //    return pImpl_->selector[config]();
+    ////
+   /////TODO: change the FunctionType to take an "input/output description pattern"
+   /////TODO: invent such a pattern ---> buffhandle.hpp
   }
   
   
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 2733073de..b6090d6e3 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -53,7 +53,7 @@ namespace engine {
   class NodeWiring
     : public WiringDescriptor
     {
-      const uint siz_;
+      const uint siz_;////////////////////////////////////TODO: this can't work! input/output desciptors are really different
       const uint nrO_; 
       
       friend class WiringFactory;
@@ -71,6 +71,10 @@ namespace engine {
           return thisStep.retrieve (); // fetch or calculate results
         }
       
+      
+      //////
+      //////TODO: push "almost everything" up into an ABC
+      //////////  and create an ctor to set up the RefArrays
     };
 
     
diff --git a/src/proc/mobject/builder/conmanager.hpp b/src/proc/mobject/builder/conmanager.hpp
index 1f3eb23b8..c992cbf59 100644
--- a/src/proc/mobject/builder/conmanager.hpp
+++ b/src/proc/mobject/builder/conmanager.hpp
@@ -34,7 +34,7 @@ namespace mobject {
      * Connection Manager: used to build the connections between render engine nodes
      * if these nodes need to cooperate besides the normal "data pull" operation. 
      * Esp. the Connection Manager knows how to wire up the effect's parameters 
-     * with the corresponding ParamProviders (autmation) in the Session.
+     * with the corresponding ParamProviders (automation) in the Session.
      * Questions regarding the possibility of a media stream connection are 
      * delegated internally to the STypeManager.
      * \par
diff --git a/src/proc/mobject/builder/mould.hpp b/src/proc/mobject/builder/mould.hpp
index be29f2b21..425e76b30 100644
--- a/src/proc/mobject/builder/mould.hpp
+++ b/src/proc/mobject/builder/mould.hpp
@@ -44,7 +44,7 @@ namespace mobject {
      * the application/execution of a single building step. Mould is 
      * conceived as the passive part, while usually the ProcPatt plays
      * the role of the active counterpart. By means of the Mould interface,
-     * the specifics  of a build situation are abstracted away, thus allowing
+     * the specifics of a build situation are abstracted away, thus allowing
      * the processing pattern to be defined as working on symbolic locations.
      * Most commonly this is "current", denoting the render node just being built.
      * <ul><li>PipeMould supports attaching an effect to a pipe</li>
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 3b0048fe3..26187b29e 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -826,14 +826,18 @@ As the builder has to create a render node network implementing most of the feat
 * any non-trivial wiring of render nodes, tracks, pipes and [[automation|Automation]] is done by the services of the [[connection manager|ConManager]]
 </pre>
 </div>
-<div title="BuilderMechanics" modifier="Ichthyostega" created="200805210256" tags="design dynamic Builder" changecount="1">
+<div title="BuilderMechanics" modifier="Ichthyostega" modified="200810160248" created="200805210256" tags="design dynamic Builder" changecount="2">
 <pre>The cooperation of several components creates a context of operation for the primary builder working tool, the [[node creator|PlanningNodeCreatorTool]]:
 * the BuilderToolFactory acts as the &quot;builder for the builder tools&quot;, i.e. we can assume to be able to retrive all needed primary tools and elementary tools from this factory, completely configured and ready to use.
 * the [[Assembler|BuilderAssembler]] has the ability to consume objects from the high level model and feed them to the node creator (which translates into a dispatch of individual operations suited to the objects to be treated). This involves some sort of scheduling or ordering of the operaions, which is the only means to direct the overall process such as to create a sensible and usable result. //This is an fundamental design decision:// the actual working tools have no hard wired knowledge of the &quot;right process&quot;, which makes the whole Builder highly configurable (&quot;open&quot;).
 * the [[connection manager|ConManager]] on the contrary is a passive service provider. Fed with [[wiring requests|WiringRequest]], he can determine if a desired connection is possible, and what steps to take to implement it; the latter recursively creates further building requests to satisfy by the assembler, and possibly new wiring requests.
 
 !!pattern of operation
-The working pattern of this builder mechanics can be described as triggering, enqueuing, priorizing, recursing and exhausting. Without the priorizing part, it would be a depth-first call graph without any context state, forcing us to have all cross reference information available at every node or element to be treated. We prefer to avoid this overhead by ordering the operations into several phases and within these phases into correlated entities with the help of a ''weighting function'' and scheduling with a ''priority queue''</pre>
+The working pattern of this builder mechanics can be described as triggering, enqueuing, priorizing, recursing and exhausting. Without the priorizing part, it would be a depth-first call graph without any context state, forcing us to have all cross reference information available at every node or element to be treated. We prefer to avoid this overhead by ordering the operations into several phases and within these phases into correlated entities with the help of a ''weighting function'' and scheduling with a ''priority queue''
+
+!!call chain
+After preparing the tools with the context state of this build process, the assembler drives the visitation process in the right order. The embedded {{{treat()}}} functions in turn use the toolkit (=the fully configured tool factory) to get the mould(s) for the individual steps they need to carry out. This involves preparing the mould (with the high-level object currently in-the-works, a suitable processing pattern and additional references), followed by operating the mould. The latter &quot;plays&quot; the processing pattern in the context of the mould, which, especially with the help of the operation point, carries out the actual building and/or connecting step. While doing so, the node factory will be invoked, which in turn invokes the wiring factory and thus pre-determines the node's prospective mode of operation when later called for rendering.
+</pre>
 </div>
 <div title="BuilderMould" modifier="Ichthyostega" modified="200805270325" created="200805260248" tags="def" changecount="2">
 <pre>The [[Builder]] uses different kinds of tools for creating a network of render nodes from a given high-level model. When breaking down this (necessarily complex) process into small manageable chunks, we arrive at [[elementary building situations|BuilderPrimitives]]. For each of these there is a specialized tool. We denote these tools as &quot;moulds&quot; because they are a rather passive holder for the objects to be attached and wired up. They are shaped according to the basic form the connections have to follow for each of these basic situations:
@@ -2123,8 +2127,8 @@ This Design strives to achieve a StrongSeparation between the low-level Structur
 {{red{let's see if this approach works...}}}
 </pre>
 </div>
-<div title="ManagementRenderNodes" modifier="Ichthyostega" modified="200810180026" created="200805280200" tags="impl decision" changecount="5">
-<pre>Contrary to the &amp;rarr;[[Assets and MObjects|ManagementAssetRelation]], the usage pattern for [[render nodes|ProcNode]] is quite simple: All nodes are created together every time a new segment of the network is being build and are all needed together until this segment is re-built, at which point they can be thrown away altogether. While it would be easy to handle the nodes automatically by smart-ptr (the creation is accessible only by use of the {{{NodeFactory}}} anyways), it //seems advisable to care for a bulk allocation/deallocation here.// The reason being not so much the amount of memory (which is expected to be moderate), but the fact the build process can be triggered repeatedly several times a second when tweaking the EDL, which could lead to fragmentation and memory pressure.
+<div title="ManagementRenderNodes" modifier="Ichthyostega" modified="200810160131" created="200805280200" tags="impl decision" changecount="5">
+<pre>Contrary to the &amp;rarr;[[Assets and MObjects|ManagementAssetRelation]], the usage pattern for [[render nodes|ProcNode]] is quite simple: All nodes are created together every time a new segment of the network is being build and all are needed together until this segment is re-built, at which point they can be thrown away altogether. While it would be easy to handle the nodes automatically by smart-ptr (the creation is accessible only by use of the {{{NodeFactory}}} anyways), it //seems advisable to care for a bulk allocation/deallocation here.// The reason being not so much the amount of memory (which is expected to be moderate), but the fact the build process can be triggered repeatedly several times a second when tweaking the EDL, which could lead to fragmentation and memory pressure.
 
 __10/2008__: the allocation mechanism can surely be improved later, but for now I am going for a simple implementation based on heap allocated objects owned by a vector or smart-ptrs. For each segment of the render nodes network, we have several families of objects, each of with will be maintained by a separate low-level memory manager (as said, for now implemented as vector of smart-ptrs). Together, they form an AllocationCluster; all objects contained in such a cluster will be destroyed together.
 </pre>
@@ -2216,11 +2220,11 @@ So, when creating a clip out of such a compound media asset, the clip has to be
 <div title="NodeCreaterTool" modifier="Ichthyostega" created="200712100626" tags="def" changecount="1">
 <pre>NodeCreaterTool is a [[visiting tool|VisitorUse]] used as second step in the [[Builder]]. Starting out from a [[Fixture]], the builder first [[divides the Timeline into segments|SegmentationTool]] and then processes each segment with the NodeCreaterTool to build a render nodes network (Render Engine) for this part of the timeline. While visiting individual Objects and Placements, the NodeCreaterTool creates and wires the necessary [[nodes|ProcNode]]</pre>
 </div>
-<div title="NodeFrameNumbering" modifier="Ichthyostega" created="200810140254" tags="spec draft" changecount="2">
+<div title="NodeFrameNumbering" modifier="Ichthyostega" modified="200810160129" created="200810140254" tags="spec draft" changecount="3">
 <pre>!Problem of Frame identification
 
 !Problem of Node numbering
-In the most general case the render network may be just a DAG (not just a tree). Especially, multiple exit points may lead down to the same node, and following each of this possible paths the node may be at a different depth on each. This rules out a simple counter starting from the exit level, leaving us with the possibility of either employing a rather convoluted addressing scheme or using arbitrary ID numbers.
+In the most general case the render network may be just a DAG (not just a tree). Especially, multiple exit points may lead down to the same node, and following each of this possible paths the node may be at a different depth on each. This rules out a simple counter starting from the exit level, leaving us with the possibility of either employing a rather convoluted addressing scheme or using arbitrary ID numbers.{{red{...which is what we do for now}}}
 </pre>
 </div>
 <div title="NodeOperationProtocol" modifier="Ichthyostega" modified="200807072147" created="200806010251" tags="Rendering dynamic" changecount="15">
@@ -3924,7 +3928,7 @@ An implementation constraint can //stand-in// for a completely specified impleme
 //Note:// there is a sort-of &quot;degraded&quot; variant just requiring some &amp;rarr; [[implementation constraint|StreamTypeImplConstraint]] to hold
 </pre>
 </div>
-<div title="StreamTypeQuery" modifier="Ichthyostega" modified="200810060525" created="200809280129" tags="spec draft" changecount="23">
+<div title="StreamTypeQuery" modifier="Ichthyostega" modified="200810020327" created="200809280129" tags="spec draft" changecount="22">
 <pre>Querying for media stream type information comes in various flavours
 * you may want to find a structural object (pipe, output, processing patten) associated with / able to deal with a certain stream type
 * you may need a StreamTypeDescriptor for an existing stream given as implementation data
@@ -3964,7 +3968,7 @@ Essentially, we need a search mechanism for impltypes and prototypes. This searc
 
 !query for an (complete) StreamType
 All situations discussed thus far can also occur wrapped into and triggered by a query for a complete type. Depending on what part is known, the missing bits will be queried. 
-Independent from these is __another Situation__ where we query for a type ''by ID''.
+Independent from these is another __Situation__ where we query for a type ''by ID''.
 * a simple symbolic ID can be found by searching through all existing stream types (Operation supported by the type registry within STypeManager)
 * a special ''classificating'' ID can be parsed into the components (media kind, prototype, impltype), resulting in sub searches for these.
 {{red{not sure if we want to support queries by symboic ID}}}...problem is the impl type, because probably the library needs to support describing any implementation type by a string. Seemingly GAVL does, but requiring it for every lib?

From 0e2b1bcf35c6a844e3dedbf2edd134ec4faec492 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 17 Oct 2008 02:42:12 +0200
Subject: [PATCH 266/368] some initial considerations how to handle Effects

---
 wiki/renderengine.html | 41 +++++++++++++++++++++++++++++++++--------
 1 file changed, 33 insertions(+), 8 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 26187b29e..74c6f350a 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -528,7 +528,7 @@ Even if the low-level memory manager(s) may use raw storage, we require that the
 &amp;rarr; see MemoryManagement
 </pre>
 </div>
-<div title="Asset" modifier="Ichthyostega" modified="200906071813" created="200708100337" tags="def classes img" changecount="16">
+<div title="Asset" modifier="Ichthyostega" modified="200810162246" created="200708100337" tags="def classes img" changecount="17">
 <pre>Asset management is a subsystem on its own. Assets are &quot;things&quot; that can be loaded into a session, like Media, Clips, Effects, Transitions. It is the &quot;bookkeeping view&quot;, while the EDL is the &quot;manipulation and process view&quot;. Some Assets can be //loaded// and a collection of Assets is saved with each Session. Besides, there is a collection of basic Assets always available by default.
 
 The Assets are important reference points holding the information needed to access external resources. For example, an Clip asset can reference a Media asset, which in turn holds the external filename from which to get the media stream. For Effects, the situation is similar. Assets thus serve two quite distinct purposes. One is to load, list, group search and browse them, and to provide an entry point to create new or get at existing MObjects in the EDL, while the other purpose is to provide attribute and property informations to the inner parts of the engine, while at the same time isolating and decoupling them from environmental details. 
@@ -545,9 +545,9 @@ Some piece of Media Data accessible at some external Location and able to be pro
 
 !Processing Asset
 Some software component able to work on media data in the Lumiera Render engine Framework. This includes all sorts of loadable effects, as well as some of the standard, internal facilities (Mask, Projector). Note that Processing Assets typically provide some attachment Point or means of communication with GUI facilities.
-* __outward interface operations__ include...
-* __inward interface operations__ include...
-&amp;rarr; ProcAsset {{red{to be defined}}}
+* __outward interface operations__ include getting name and description, investigating the media types the processor is able to handle, cause the underlying module to be acutally loaded...
+* __inward interface operations__ include resolving the actual processing function.
+&amp;rarr; ProcAsset
 
 !Structural Asset
 Some of the building blocks providing the framework for the objects placed into the current Session. Notable examples are [[processing pipes|Pipe]] within the high-level-model, Viewer attachment points, Tracks, etc.
@@ -1308,6 +1308,16 @@ Basically, each elementary operation has to record the informations necessary to
 {{red{to be defined in more detail later...}}}
 </pre>
 </div>
+<div title="EffectHandling" modifier="Ichthyostega" modified="200810170025" created="200810162300" tags="design dynamic" changecount="3">
+<pre>We have to deal with effects on various different levels. One thing is to decide if an effect is applicable, another question is to find out about variable and automatable parameters, find a module which can be used as an effect GUI and finally to access a processing function which can be executed on a buffer filled with suitable data.
+
+The effect asset (which is a [[processing asset|ProcAsset]]) provides an unified interface for loading external processing modules and querying their properties. As usual with assets, this is the &quot;bookkeeping view&quot; to start with, but we can create a //processor// from such an asset, i.e. an instance of the processing facility which can be used and wired into the model. Such a processor is an MObject and can be placed into the session (high level model); moreover it holds a concrete wiring for the various control parameters and it has an active link to the effect GUI module. As every ~MObject, it could be placed multiple times to affect several pipes, but all those different Placements would behave as being linked together (with respect to the control parameter sources and the GUI)
+
+When building the low-level model, the actual processing code is resolved and a processing function is installed into the processing node representing the effect. This step includes checking of actual [[media type information|StreamType]], which may result in selecting a specifically tailored implementation function. The parameter wiring on the other hand is //shared// between the effect ~MObject, the corresponding GUI module and all low-level processing nodes. Actually, parameters are more of a reference than actually being values: they provide a {{{getValue()}}} function, which also works with automation. This way, any parameter or automation changes are reflected immediately into the produced output.
+
+Initially, only the parameter (descriptors) are present on the effect ~MObject, while the actual [[parameter providers|ParamProvider]] are created or wired (by the ConManager) on demand.
+</pre>
+</div>
 <div title="Example1" modifier="Ichthyostega" modified="200906071812" created="200706220239" tags="example img" changecount="5">
 <pre>The &amp;raquo;Timeline&amp;laquo; is a sequence of ~MObjects -- here clips -- together with an ExplicitPlacement, locating each clip at a given time and track. (Note: I simplified the time format and wrote frame numbers to make it more clear)
 [img[Example1: Objects in the EDL/Fixture|uml/fig128773.png]]
@@ -2047,6 +2057,7 @@ The general idea is, that each facade interface actually provides access to a sp
 * it is allways //placed// in some manner, i.e. it is allways accessed via a [[Placement]]
 * {{red{and what else?}}}
 
+<<<<<<< HEAD:wiki/renderengine.html
 &amp;rarr; overview [[MObject class hierarchy|MObjects]]</pre>
 </div>
 <div title="MObjectRef" modifier="Ichthyostega" modified="200906020120" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="21">
@@ -2085,8 +2096,14 @@ Presumably, none of the both models is usable as-is; rather we try to reconstruc
 </div>
 <div title="MObjects" modifier="Ichthyostega" modified="200906071811" created="200706190636" tags="overview img" changecount="17">
 <pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects |MObject]](&amp;rarr; def) being:
+=======
+&amp;rarr; [[overview of the MObject hierarchy|MObjects]]</pre>
+</div>
+<div title="MObjects" modifier="Ichthyostega" modified="200810162229" created="200706190636" tags="overview" changecount="11">
+<pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects|MObject]] being:
+>>>>>>> some initial considerations how to handle Effects:wiki/renderengine.html
 * audio/video clips
-* effects and plugins
+* [[effects and plugins|EffectHandling]]
 * special facilities like mask and projector
 * [[Automation]] sets
 * labels and other (maybe functional) markup
@@ -2344,7 +2361,7 @@ see also: RenderEntities, [[two Examples (Object diagrams)|Examples]]
 &lt;!--}}}--&gt;
 </pre>
 </div>
-<div title="ParamProvider" modifier="Ichthyostega" modified="200805300124" created="200706220517" tags="def automation" changecount="9">
+<div title="ParamProvider" modifier="Ichthyostega" modified="200810170040" created="200706220517" tags="def automation" changecount="12">
 <pre>A ParamProvider is the counterpart for (one or many) [[Parameter]] instances. It implements the value access function made available by the Parameter object to its clients.
 
 To give a concrete example: 
@@ -2352,9 +2369,13 @@ To give a concrete example:
 * the Plugin has a Parameter Object (from which we could query the information of this parameter being a continuous float function)
 * this Parameter Object provides a getValue() function, which is internally linked (i.e. by configuration) to a //Parameter Provider//
 * the actual object implementing the ParamProvider Interface could be a Automation MObject located somewhere in the EDL and would do bezier interpolation on a given keyframe set.
-* while building the Render Engine configuration actually at work, the Builder would have to setup this link between the Plugin Parameter Object and the ParamProvider; he can do so, because he sees the link between the Automation MObject and the corresponding Effect MObject
+* Param providers are created on demand; while building the Render Engine configuration actually at work, the Builder would have to setup a link between the Plugin Parameter Object and the ParamProvider; he can do so, because he sees the link between the Automation MObject and the corresponding Effect MObject
+
+!!ParamProvider ownership and lifecycle
+Actually, ParamProvider is just an interface which is implemented either by a constant or an [[Automation]] function. In both cases, access is via direct reference, while the link to the ParamProvider is maintained by a smart-ptr, which &amp;mdash; in the case of automation may share ownership with the [[Placement]] of the automation data set.
 
 &amp;rarr; see the class diagram for [[Automation]]
+&amp;rarr; see EffectHandling
 </pre>
 </div>
 <div title="Parameter" modifier="Ichthyostega" modified="200805300124" created="200706220505" tags="def automation" changecount="1">
@@ -3219,10 +3240,14 @@ We need to work out guidelines for dealing with operations going on simultaneous
 
 While the Backend is responsible for Data access and management and for carrying out the computation intensive media opteratons, the middle Layer or ~Proc-Layer contains [[assets|Asset]] and [[Session]], i.e. the user-visible data model and provides configuration and behaviour for these entities. Besides, he is responsible for [[building and configuring|Builder]] the [[render engine|RenderEngine]] based on the current Session state.</pre>
 </div>
+<<<<<<< HEAD:wiki/renderengine.html
 <div title="ProcAsset" modifier="Ichthyostega" modified="200906071810" created="200709221343" tags="def classes img" changecount="2">
+=======
+<div title="ProcAsset" modifier="Ichthyostega" modified="200810162240" created="200709221343" tags="def classes" changecount="2">
+>>>>>>> some initial considerations how to handle Effects:wiki/renderengine.html
 <pre>All Assets of kind asset::Proc represent //processing algorithms// in the bookkeeping view. They enable loading, browsing and maybe even parametrizing all the Effects, Plugins and Codecs available for use within the Lumiera Session.
 
-Besides, they provide an important __inward interface__ for the [[ProcNode]]s, which will use these asset entries to dispatch the actual processing call when rendering. 
+Besides, they provide an __inward interface__ for the [[ProcNode]]s enabling them to dispatch the actual processing call when rendering. Actually, this interface is always accessed via an ~Effect-MObject; mostly it is investigated and queried in the build process when creating the corresponding processor nodes. &amp;rarr; see EffectHandling for details
 
 {{red{todo: the naming scheme??}}}
 

From ff8be4493c6ff6172ba3821aa97ec9a0af2488c9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 17 Oct 2008 04:29:15 +0200
Subject: [PATCH 267/368] WIP get rid of some cruft and placeholders

---
 src/proc/engine/bufftable.hpp       |  2 +-
 src/proc/engine/nodeinvocation.hpp  |  4 +--
 src/proc/engine/nodeoperation.hpp   |  2 +-
 src/proc/engine/nodewiring.hpp      |  6 -----
 src/proc/engine/procnode.cpp        | 35 --------------------------
 src/proc/engine/procnode.hpp        | 25 ++++++++----------
 src/proc/mobject/session/effect.hpp |  4 +--
 wiki/renderengine.html              | 39 +++++++++++------------------
 8 files changed, 31 insertions(+), 86 deletions(-)
 delete mode 100644 src/proc/engine/procnode.cpp

diff --git a/src/proc/engine/bufftable.hpp b/src/proc/engine/bufftable.hpp
index 2ae0fca46..e091f940c 100644
--- a/src/proc/engine/bufftable.hpp
+++ b/src/proc/engine/bufftable.hpp
@@ -133,7 +133,7 @@ namespace engine {
       
     public:
       BuffTableChunk (WiringDescriptor const& wd, BuffTableStorage& storage)
-        : siz_(wd.getNrI() + wd.getNrO()),
+        : siz_(wd.nrI + wd.nrO),
           tab_(storage.claim (siz_)),
           sto_(storage)
         {
diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index 2b551c7f0..bbe0aef93 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -132,8 +132,8 @@ namespace engine {
           buffTab(0)
         { }
       
-      const uint nrO()          const { return wiring.getNrO(); }
-      const uint nrI()          const { return wiring.getNrI(); }
+      const uint nrO()          const { return wiring.nrO; }
+      const uint nrI()          const { return wiring.nrI; }
       const uint buffTabSize()  const { return nrO()+nrI(); }
       
       /** setup the link to an externally allocated buffer table */
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index e19670f5a..c7c973977 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -197,7 +197,7 @@ namespace engine {
             
              // Invoke our own process() function,
             //  providing the array of outBuffer+inBuffer ptrs
-            ivo.wiring.processFunction (ivo.buffTab->outBuff);
+            ivo.wiring.procFunction (ivo.buffTab->outBuff);
             
             return NEXT::step (ivo);
           }
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index b6090d6e3..661cb7c46 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -53,15 +53,9 @@ namespace engine {
   class NodeWiring
     : public WiringDescriptor
     {
-      const uint siz_;////////////////////////////////////TODO: this can't work! input/output desciptors are really different
-      const uint nrO_; 
       
       friend class WiringFactory;
       
-    public:
-      virtual uint getNrI()  const { return siz_ - nrO_; }
-      virtual uint getNrO()  const { return nrO_; }
-
       
     protected:
       virtual BuffHandle
diff --git a/src/proc/engine/procnode.cpp b/src/proc/engine/procnode.cpp
deleted file mode 100644
index 984c4dece..000000000
--- a/src/proc/engine/procnode.cpp
+++ /dev/null
@@ -1,35 +0,0 @@
-/*
-  ProcNode  -  Key abstraction of the Render Engine: a Processing Node
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "proc/engine/procnode.hpp"
-#include "proc/engine/nodefactory.hpp"
-
-namespace engine {
-
-
-  /** Storage for the (single, static) ProcNode factory object.
-   */
-  NodeFactory ProcNode::create;
-
-
-} // namespace engine
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 47bdb0180..0b4d218d0 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -46,7 +46,6 @@
 #include "proc/state.hpp"
 #include "proc/mobject/parameter.hpp"
 #include "common/frameid.hpp"
-#include "lib/refarray.hpp"
 
 #include <vector>
 
@@ -71,27 +70,26 @@ namespace engine {
   class WiringDescriptor
     {
     public:
-      virtual ~WiringDescriptor() {}
+      uint nrI;
+      uint nrO;
       
-      virtual uint getNrI()  const =0;           ///////////TODO: indeed need a virtual function??
-      virtual uint getNrO()  const =0;
+      ChannelDescriptor  out[];
+      InChanDescriptor   in[];
       
-                                               /////////////TODO: Questions: is "in" used? can "in" and "out" be the same type? how and when to place the actual chan descriptors?
-      lib::RefArray<ChannelDescriptor>& out;
-      lib::RefArray<InChanDescriptor>&  in;
+      typedef void (ProcFunc) (BuffHandle::PBuff);
       
-      typedef void (ProcFunc) (BuffHandle::PBuff, uint);
-      
-      ProcFunc* processFunction;
+      ProcFunc* procFunction;
       
       NodeID const& nodeID;
       
+      virtual ~WiringDescriptor() {}
+      
     protected:
-      WiringDescriptor (lib::RefArray<ChannelDescriptor>& o, 
-                        lib::RefArray<InChanDescriptor>& i,
+      WiringDescriptor (ChannelDescriptor* o, 
+                        InChanDescriptor* i,
                         ProcFunc pFunc, NodeID const& nID)
         : out(o), in(i),
-          processFunction(pFunc),
+          procFunction(pFunc),
           nodeID(nID)
         { }  
       
@@ -131,7 +129,6 @@ namespace engine {
       
       
     public:
-      static NodeFactory create; ///////TODO: really? probably we'll rather have a NodeFactory object in the builder...
       
       /** Engine Core operation: render and pull output from this node.
        *  On return, currentProcess will hold onto output buffer(s) 
diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp
index 587cec927..7b3cb452e 100644
--- a/src/proc/mobject/session/effect.hpp
+++ b/src/proc/mobject/session/effect.hpp
@@ -39,8 +39,8 @@ namespace session {
   class Effect : public AbstractMO
     {
     protected:
-      /** Identifier of the Plugin to be used */
-      string plugID;
+      /** Identifier of the Plug-in to be used */
+      string pluginID;
       
     };
   
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 74c6f350a..8d174ed18 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -528,7 +528,7 @@ Even if the low-level memory manager(s) may use raw storage, we require that the
 &amp;rarr; see MemoryManagement
 </pre>
 </div>
-<div title="Asset" modifier="Ichthyostega" modified="200810162246" created="200708100337" tags="def classes img" changecount="17">
+<div title="Asset" modifier="Ichthyostega" modified="200906071813" created="200708100337" tags="def classes img" changecount="17">
 <pre>Asset management is a subsystem on its own. Assets are &quot;things&quot; that can be loaded into a session, like Media, Clips, Effects, Transitions. It is the &quot;bookkeeping view&quot;, while the EDL is the &quot;manipulation and process view&quot;. Some Assets can be //loaded// and a collection of Assets is saved with each Session. Besides, there is a collection of basic Assets always available by default.
 
 The Assets are important reference points holding the information needed to access external resources. For example, an Clip asset can reference a Media asset, which in turn holds the external filename from which to get the media stream. For Effects, the situation is similar. Assets thus serve two quite distinct purposes. One is to load, list, group search and browse them, and to provide an entry point to create new or get at existing MObjects in the EDL, while the other purpose is to provide attribute and property informations to the inner parts of the engine, while at the same time isolating and decoupling them from environmental details. 
@@ -811,7 +811,7 @@ With regard to the build process, the wiring of data connections translates into
 In many cases, the parameter values provided by these connections aren't frame based data, rather, the processing function needs a call interface to get the current value (value for a given time), which is provided by the parameter object. Here, the wiring needs to link to the suitable parameter instance, which is located within the high-level model (!). As an additional complication, calculating the actual parameter value may require a context data frame (typically for caching purposes to speed up the interpolation). While these parameter context data frames are completely opaque for the render node, they have to be passed in and out similar to the state needed by the node itself, and the wiring has to prepare for accessing these frames too.
 </pre>
 </div>
-<div title="Builder" modifier="Ichthyostega" modified="200805300043" created="200706220317" tags="def overview" changecount="27">
+<div title="Builder" modifier="Ichthyostega" modified="200810170221" created="200706220317" tags="def overview" changecount="28">
 <pre>The Builder takes some MObject/[[Placement]] information (called Timeline) and generates out of this a Render Engine configuration able to render this Objects. It does all decisions and retrieves the current configuration of all objects and plugins, so the Render Engine can just process them stright forward.
 
 The Builder is the central part of the [[Builder Pattern|http://en.wikipedia.org/wiki/Builder_pattern]]
@@ -819,14 +819,14 @@ The Builder is the central part of the [[Builder Pattern|http://en.wikipedia.org
 As the builder has to create a render node network implementing most of the features and wiring possible with the various MObject kinds and placement types, it is a rather complicated piece of software. In order to keep it manageable, it is broken down into several specialized sub components:
 * clients access builder functionality via the BuilderFacade
 * the [[Proc-Layer-Controller|Controller]] initiates the BuildProcess and does the overall coordination of scheduling edit operations, rebuilding the fixture and triggering the Builder
-* to carry out the building, we use several primary tools (SegmentationTool, NodeCreaterTool,...),  together with a BuilderToolKit to be supplied by the [[tool factory|BuilderToolFactory]]
+* to carry out the building, we use several primary tools (SegmentationTool, NodeCreatorTool,...),  together with a BuilderToolKit to be supplied by the [[tool factory|BuilderToolFactory]]
 * //operating the Builder// can be viewed at from two different angles, either emphasizing the [[basic building operations|BasicBuildingOperations]] employed to assemble the render node network, or focussing rather at the [[mechanics|BuilderMechanics]] of cooperating parts while processing.
 * besides, we can identify a small set of elementary situations we call [[builder primitives|BuilderPrimitives]], to be covered by the mentioned BuilderToolKit; by virtue of [[processing patterns|ProcPatt]] they form an [[interface to the rule based configuration|BuilderRulesInterface]].
 * the actual building (i.e. the application of tools to the timeline) is done by the [[Assembler|BuilderAssembler]], which is basically a collection of functions (but has a small amount of global configuration state)
 * any non-trivial wiring of render nodes, tracks, pipes and [[automation|Automation]] is done by the services of the [[connection manager|ConManager]]
 </pre>
 </div>
-<div title="BuilderMechanics" modifier="Ichthyostega" modified="200810160248" created="200805210256" tags="design dynamic Builder" changecount="2">
+<div title="BuilderMechanics" modifier="Ichthyostega" modified="200810170220" created="200805210256" tags="design dynamic Builder" changecount="3">
 <pre>The cooperation of several components creates a context of operation for the primary builder working tool, the [[node creator|PlanningNodeCreatorTool]]:
 * the BuilderToolFactory acts as the &quot;builder for the builder tools&quot;, i.e. we can assume to be able to retrive all needed primary tools and elementary tools from this factory, completely configured and ready to use.
 * the [[Assembler|BuilderAssembler]] has the ability to consume objects from the high level model and feed them to the node creator (which translates into a dispatch of individual operations suited to the objects to be treated). This involves some sort of scheduling or ordering of the operaions, which is the only means to direct the overall process such as to create a sensible and usable result. //This is an fundamental design decision:// the actual working tools have no hard wired knowledge of the &quot;right process&quot;, which makes the whole Builder highly configurable (&quot;open&quot;).
@@ -836,7 +836,7 @@ As the builder has to create a render node network implementing most of the feat
 The working pattern of this builder mechanics can be described as triggering, enqueuing, priorizing, recursing and exhausting. Without the priorizing part, it would be a depth-first call graph without any context state, forcing us to have all cross reference information available at every node or element to be treated. We prefer to avoid this overhead by ordering the operations into several phases and within these phases into correlated entities with the help of a ''weighting function'' and scheduling with a ''priority queue''
 
 !!call chain
-After preparing the tools with the context state of this build process, the assembler drives the visitation process in the right order. The embedded {{{treat()}}} functions in turn use the toolkit (=the fully configured tool factory) to get the mould(s) for the individual steps they need to carry out. This involves preparing the mould (with the high-level object currently in-the-works, a suitable processing pattern and additional references), followed by operating the mould. The latter &quot;plays&quot; the processing pattern in the context of the mould, which, especially with the help of the operation point, carries out the actual building and/or connecting step. While doing so, the node factory will be invoked, which in turn invokes the wiring factory and thus pre-determines the node's prospective mode of operation when later called for rendering.
+After preparing the tools with the context state of this build process, the assembler drives the visitation process in the right order. The functions embedded within the visitor (NodeCreatorTool) for treating specific kinds of objects in turn use the toolkit (=the fully configured tool factory) to get the mould(s) for the individual steps they need to carry out. This involves preparing the mould (with the high-level object currently in-the-works, a suitable processing pattern and additional references), followed by operating the mould. The latter &quot;plays&quot; the processing pattern in the context of the mould, which, especially with the help of the operation point, carries out the actual building and/or connecting step. While doing so, the node factory will be invoked, which in turn invokes the wiring factory and thus pre-determines the node's prospective mode of operation when later called for rendering.
 </pre>
 </div>
 <div title="BuilderMould" modifier="Ichthyostega" modified="200805270325" created="200805260248" tags="def" changecount="2">
@@ -2057,8 +2057,7 @@ The general idea is, that each facade interface actually provides access to a sp
 * it is allways //placed// in some manner, i.e. it is allways accessed via a [[Placement]]
 * {{red{and what else?}}}
 
-<<<<<<< HEAD:wiki/renderengine.html
-&amp;rarr; overview [[MObject class hierarchy|MObjects]]</pre>
+&amp;rarr; [[overview of the MObject hierarchy|MObjects]]</pre>
 </div>
 <div title="MObjectRef" modifier="Ichthyostega" modified="200906020120" created="200904242107" tags="SessionLogic GuiIntegration design draft discuss" changecount="21">
 <pre>''The Problem of referring to an [[MObject]]'' stems from the object //as a concept// encompassing a wider scope then just the current implementation instance. If the object was just a runtime entity in memory, we could use a simple (language) reference or pointer. Actually, this isn't sufficient, as the object reference will pass LayerSeparationInterfaces, will be handed over to code not written in the same implementation language, will be included in an ''UNDO'' record for the UndoManager, and thus will need to be serialized and stored permanently within the SessionStorage.
@@ -2096,12 +2095,6 @@ Presumably, none of the both models is usable as-is; rather we try to reconstruc
 </div>
 <div title="MObjects" modifier="Ichthyostega" modified="200906071811" created="200706190636" tags="overview img" changecount="17">
 <pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects |MObject]](&amp;rarr; def) being:
-=======
-&amp;rarr; [[overview of the MObject hierarchy|MObjects]]</pre>
-</div>
-<div title="MObjects" modifier="Ichthyostega" modified="200810162229" created="200706190636" tags="overview" changecount="11">
-<pre>The ~MObjects Subsystem contains everything related to the [[EDL]] and the various Media Objects placed within. It is complemented by the Asset Management (see &amp;rarr; [[Asset]]). Examples for [[MObjects|MObject]] being:
->>>>>>> some initial considerations how to handle Effects:wiki/renderengine.html
 * audio/video clips
 * [[effects and plugins|EffectHandling]]
 * special facilities like mask and projector
@@ -2145,7 +2138,7 @@ This Design strives to achieve a StrongSeparation between the low-level Structur
 </pre>
 </div>
 <div title="ManagementRenderNodes" modifier="Ichthyostega" modified="200810160131" created="200805280200" tags="impl decision" changecount="5">
-<pre>Contrary to the &amp;rarr;[[Assets and MObjects|ManagementAssetRelation]], the usage pattern for [[render nodes|ProcNode]] is quite simple: All nodes are created together every time a new segment of the network is being build and all are needed together until this segment is re-built, at which point they can be thrown away altogether. While it would be easy to handle the nodes automatically by smart-ptr (the creation is accessible only by use of the {{{NodeFactory}}} anyways), it //seems advisable to care for a bulk allocation/deallocation here.// The reason being not so much the amount of memory (which is expected to be moderate), but the fact the build process can be triggered repeatedly several times a second when tweaking the EDL, which could lead to fragmentation and memory pressure.
+<pre>Contrary to the &amp;rarr;[[Assets and MObjects|ManagementAssetRelation]], the usage pattern for [[render nodes|ProcNode]] is quite simple: All nodes are created together every time a new segment of the network is being build and will be used together until this segment is re-built, at which point they can be thrown away altogether. While it would be easy to handle the nodes automatically by smart-ptr (the creation is accessible only by use of the {{{NodeFactory}}} anyways), it //seems advisable to care for a bulk allocation/deallocation here.// The reason being not so much the amount of memory (which is expected to be moderate), but the fact the build process can be triggered repeatedly several times a second when tweaking the EDL, which could lead to fragmentation and memory pressure.
 
 __10/2008__: the allocation mechanism can surely be improved later, but for now I am going for a simple implementation based on heap allocated objects owned by a vector or smart-ptrs. For each segment of the render nodes network, we have several families of objects, each of with will be maintained by a separate low-level memory manager (as said, for now implemented as vector of smart-ptrs). Together, they form an AllocationCluster; all objects contained in such a cluster will be destroyed together.
 </pre>
@@ -2234,8 +2227,8 @@ So, when creating a clip out of such a compound media asset, the clip has to be
 * we distinguish elementay (non-compound) Clips from compound clips by concrete subtype. The builder can only handle elementary clips, because he needs to build a separate pipeline for every output channel. So the work of splitting common effect stacks for clips with several channels needs to be done when calculating the Fixture for the current EDL. The Builder expects to be able to build the render nodes corresponding to each entity found in the Fixture one by one.
 * the Builder gets at the ProcPatt (descriptor) of the underlying media for each clip and uses this description as a template to build the render pipeline. That is, the ProcPatt specifies the codec asset and maybe some additional effect assets (deinterlace, scale) necessary for feeding media data corresponding to this clip/media into the render nodes network.</pre>
 </div>
-<div title="NodeCreaterTool" modifier="Ichthyostega" created="200712100626" tags="def" changecount="1">
-<pre>NodeCreaterTool is a [[visiting tool|VisitorUse]] used as second step in the [[Builder]]. Starting out from a [[Fixture]], the builder first [[divides the Timeline into segments|SegmentationTool]] and then processes each segment with the NodeCreaterTool to build a render nodes network (Render Engine) for this part of the timeline. While visiting individual Objects and Placements, the NodeCreaterTool creates and wires the necessary [[nodes|ProcNode]]</pre>
+<div title="NodeCreatorTool" modifier="Ichthyostega" modified="200810170222" created="200712100626" tags="def" changecount="2">
+<pre>~NodeCreatorTool is a [[visiting tool|VisitorUse]] used as second step in the [[Builder]]. Starting out from a [[Fixture]], the builder first [[divides the Timeline into segments|SegmentationTool]] and then processes each segment with the NodeCreaterTool to build a render nodes network (Render Engine) for this part of the timeline. While visiting individual Objects and Placements, the NodeCreaterTool creates and wires the necessary [[nodes|ProcNode]]</pre>
 </div>
 <div title="NodeFrameNumbering" modifier="Ichthyostega" modified="200810160129" created="200810140254" tags="spec draft" changecount="3">
 <pre>!Problem of Frame identification
@@ -3077,10 +3070,10 @@ afterwards.
 &lt;&lt;tasksum end&gt;&gt;
 </pre>
 </div>
-<div title="PlanningNodeCreatorTool" modifier="Ichthyostega" modified="200802031829" created="200712090659" tags="impl Builder draft" changecount="1">
+<div title="PlanningNodeCreatorTool" modifier="Ichthyostega" modified="200810170221" created="200712090659" tags="impl Builder draft" changecount="2">
 <pre>//This page is a scrapbook for working out the implementation of the builder//
 
-* NodeCreaterTool is a [[visiting tool|VisitorUse]]
+* NodeCreatorTool is a [[visiting tool|VisitorUse]]
 * the render engine to be built is contained as state within this tool object while it is passed around
 !!!prerequisites
 * Session and ~EDLs exist.
@@ -3240,14 +3233,10 @@ We need to work out guidelines for dealing with operations going on simultaneous
 
 While the Backend is responsible for Data access and management and for carrying out the computation intensive media opteratons, the middle Layer or ~Proc-Layer contains [[assets|Asset]] and [[Session]], i.e. the user-visible data model and provides configuration and behaviour for these entities. Besides, he is responsible for [[building and configuring|Builder]] the [[render engine|RenderEngine]] based on the current Session state.</pre>
 </div>
-<<<<<<< HEAD:wiki/renderengine.html
 <div title="ProcAsset" modifier="Ichthyostega" modified="200906071810" created="200709221343" tags="def classes img" changecount="2">
-=======
-<div title="ProcAsset" modifier="Ichthyostega" modified="200810162240" created="200709221343" tags="def classes" changecount="2">
->>>>>>> some initial considerations how to handle Effects:wiki/renderengine.html
 <pre>All Assets of kind asset::Proc represent //processing algorithms// in the bookkeeping view. They enable loading, browsing and maybe even parametrizing all the Effects, Plugins and Codecs available for use within the Lumiera Session.
 
-Besides, they provide an __inward interface__ for the [[ProcNode]]s enabling them to dispatch the actual processing call when rendering. Actually, this interface is always accessed via an ~Effect-MObject; mostly it is investigated and queried in the build process when creating the corresponding processor nodes. &amp;rarr; see EffectHandling for details
+Besides, they provide an __inward interface__ for the [[ProcNode]]s, enabling them to dispatch the actual processing call while rendering. Actually, this interface is always accessed via an ~Effect-MObject; mostly it is investigated and queried in the build process when creating the corresponding processor nodes. &amp;rarr; see EffectHandling for details
 
 {{red{todo: the naming scheme??}}}
 
@@ -3953,7 +3942,7 @@ An implementation constraint can //stand-in// for a completely specified impleme
 //Note:// there is a sort-of &quot;degraded&quot; variant just requiring some &amp;rarr; [[implementation constraint|StreamTypeImplConstraint]] to hold
 </pre>
 </div>
-<div title="StreamTypeQuery" modifier="Ichthyostega" modified="200810020327" created="200809280129" tags="spec draft" changecount="22">
+<div title="StreamTypeQuery" modifier="Ichthyostega" modified="200810060525" created="200809280129" tags="spec draft" changecount="23">
 <pre>Querying for media stream type information comes in various flavours
 * you may want to find a structural object (pipe, output, processing patten) associated with / able to deal with a certain stream type
 * you may need a StreamTypeDescriptor for an existing stream given as implementation data
@@ -3993,7 +3982,7 @@ Essentially, we need a search mechanism for impltypes and prototypes. This searc
 
 !query for an (complete) StreamType
 All situations discussed thus far can also occur wrapped into and triggered by a query for a complete type. Depending on what part is known, the missing bits will be queried. 
-Independent from these is another __Situation__ where we query for a type ''by ID''.
+Independent from these is __another Situation__ where we query for a type ''by ID''.
 * a simple symbolic ID can be found by searching through all existing stream types (Operation supported by the type registry within STypeManager)
 * a special ''classificating'' ID can be parsed into the components (media kind, prototype, impltype), resulting in sub searches for these.
 {{red{not sure if we want to support queries by symboic ID}}}...problem is the impl type, because probably the library needs to support describing any implementation type by a string. Seemingly GAVL does, but requiring it for every lib?

From 25a7d75ad9c8d71e0182fc44ab07b64251b1692f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 17 Oct 2008 05:48:02 +0200
Subject: [PATCH 268/368] WIP still trying to invent chicken and egg
 together....

---
 src/proc/engine/nodefactory.cpp | 50 +++++++++++++++++++++++++++++++--
 src/proc/engine/nodewiring.cpp  |  2 +-
 src/proc/engine/nodewiring.hpp  | 39 +++++++++++++++++++++----
 src/proc/engine/procnode.hpp    | 13 ++++-----
 4 files changed, 89 insertions(+), 15 deletions(-)

diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index 9d5169d92..628e247e2 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -24,12 +24,58 @@
 #include "proc/engine/nodefactory.hpp"
 #include "proc/mobject/session/effect.hpp"
 
-namespace engine {
+#include "proc/engine/nodewiring.hpp"
 
+namespace engine {
+  
+  namespace { // Details of node fabrication
+
+    class Alloc {}; ///////////////TODO
+    
+    template<class NODE>
+    NODE &
+    makeNode ()
+    {
+      ////TODO: this is a draft how it /might/ work
+      ////TODO: of course this can't be hard wired....
+      
+      ProcNode * predecessor1, predecessor2;
+      
+      WiringInstaller setup;
+      setup.defineInput (4, predecessor1, 2);
+      setup.defineInput (2, predecessor2);
+      
+      WiringFactory* wFac;
+      
+      Alloc allocator;
+      bool doCache = (2 == 2); // find out Cache should be used for this node
+      
+      WiringDescriptor & wDesc = (*wFac)(setup,doCache);
+      
+      NODE *newNode = new(allocator()) NODE (wDesc);   // actually this line needs to be atomic
+      
+      return *newNode;
+      
+      /*
+       * Problems to be solved:
+       * - write a generic allocator, which later on can be augmented to do block wise bulk allocation
+       * - the allocator needs to keep track of the objects; actually he owns the objects
+       * - we need to access the wiring descriptor of the predecessor nodes. Which means, the code
+       *   must be in the body of NodeFactory (because the latter is friend of ProcNode and can access the wiring descriptor)
+       * - btw reconsider if this level of protection is necessary, or if the const WiringDescriptor cant be just on the public interface of ProcNode
+       * - find out how the Caching/ReadInput/InPlace detection can work
+       * - think about a sensible Ctor for NodeFactory. This one must create the WiringFactory and pass the Allocator.
+       * - all of this will be installed into the ToolFactory, i.e. it is part of the build process
+       */
+    }
+    
+  } // (END) Details of node fabrication
+  
+  
   using mobject::Placement;
   using mobject::session::Effect;
   
-
+  
   /** create a processing node able to render an effect */
   PTrafo
   NodeFactory::operator() (Placement<Effect> const&)
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index 864905a22..ccb0824a3 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -119,7 +119,7 @@ namespace engine {
    *  the new processing node to be wired up.  
    */
   WiringDescriptor&
-  WiringFactory::operator() (uint nrOut, uint nrIn, bool cache)
+  WiringFactory::operator() (WiringInstaller& setup, bool cache)
   {
     UNIMPLEMENTED ("build the actual wiring descriptor based on given operation options");
     
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 661cb7c46..c906e7329 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -27,6 +27,7 @@
 
 #include "proc/engine/procnode.hpp"
 
+#include <boost/noncopyable.hpp>
 #include <boost/scoped_ptr.hpp>
 #include <cstddef>
 
@@ -39,6 +40,28 @@ namespace engine {
   
   namespace config { class WiringFactoryImpl; }
   
+  using lib::RefArray;
+  
+  
+  /**
+   * Finding out about a concrete way of wiring up a
+   * ProcNode about to be built. Such a (temporary) setup object
+   * is used while building the low-level model. It is loaded with
+   * information concerning the intended connections to be made
+   * and then used to initialise the wiring descriptor, which
+   * in turn allows us to setup the ProcNode.  
+   */
+  class WiringInstaller : boost::noncopyable
+    {
+    public:
+      RefArray<ChannelDescriptor>& makeOutDescriptor() ;
+      RefArray<InChanDescriptor>&  makeInDescriptor() ;
+      WiringDescriptor::ProcFunc*  resolveProcessingFunction() ;
+      lumiera::NodeID const&       createNodeID() ;
+    };
+  
+  
+  
   
   /**
    * Actual implementation of the link between nodes,
@@ -54,6 +77,16 @@ namespace engine {
     : public WiringDescriptor
     {
       
+      NodeWiring(WiringInstaller& setup)
+        : WiringDescriptor(setup.makeOutDescriptor(), 
+                           setup.makeInDescriptor(),
+                           setup.resolveProcessingFunction(),
+                           setup.createNodeID())
+        {
+          nrO = out.size();
+          nrI = in.size();
+        }
+      
       friend class WiringFactory;
       
       
@@ -65,10 +98,6 @@ namespace engine {
           return thisStep.retrieve (); // fetch or calculate results
         }
       
-      
-      //////
-      //////TODO: push "almost everything" up into an ABC
-      //////////  and create an ctor to set up the RefArrays
     };
 
     
@@ -79,7 +108,7 @@ namespace engine {
       
     public:
       WiringDescriptor&
-      operator() (uint nrOut, uint nrIn, bool cache);
+      operator() (WiringInstaller& setup, bool cache);
     };
   
   
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 0b4d218d0..05bfaf8e9 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -46,6 +46,7 @@
 #include "proc/state.hpp"
 #include "proc/mobject/parameter.hpp"
 #include "common/frameid.hpp"
+#include "lib/refarray.hpp"
 
 #include <vector>
 
@@ -58,8 +59,6 @@ namespace engine {
   using lumiera::NodeID;
   
   class ProcNode;
-  class NodeFactory;
-  
   typedef ProcNode* PNode;
   
   
@@ -70,11 +69,11 @@ namespace engine {
   class WiringDescriptor
     {
     public:
-      uint nrI;
       uint nrO;
+      uint nrI;
       
-      ChannelDescriptor  out[];
-      InChanDescriptor   in[];
+      lib::RefArray<ChannelDescriptor>& out;
+      lib::RefArray<InChanDescriptor>&  in;
       
       typedef void (ProcFunc) (BuffHandle::PBuff);
       
@@ -85,8 +84,8 @@ namespace engine {
       virtual ~WiringDescriptor() {}
       
     protected:
-      WiringDescriptor (ChannelDescriptor* o, 
-                        InChanDescriptor* i,
+      WiringDescriptor (lib::RefArray<ChannelDescriptor>& o, 
+                        lib::RefArray<InChanDescriptor>& i,
                         ProcFunc pFunc, NodeID const& nID)
         : out(o), in(i),
           procFunction(pFunc),

From 091181bbbcb9ba203747171b652ce053c8e6b732 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 4 Nov 2008 02:13:37 +0100
Subject: [PATCH 269/368] spell checks (and read the code again...)

---
 src/proc/asset/proc.hpp                     | 4 ++--
 src/proc/engine/nodefactory.hpp             | 2 +-
 src/proc/mobject/builder/operationpoint.hpp | 2 +-
 src/proc/mobject/builder/wiringrequest.hpp  | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/proc/asset/proc.hpp b/src/proc/asset/proc.hpp
index 9b744f2e1..5f8099212 100644
--- a/src/proc/asset/proc.hpp
+++ b/src/proc/asset/proc.hpp
@@ -23,9 +23,9 @@
 
 /** @file proc.hpp
  ** Data processing Plugins and Codecs can be treated as a specific Kind of Asset.
- ** For the different <i>Kinds</i> of Assets, we use sub-intefaces inheriting
+ ** For the different <i>Kinds</i> of Assets, we use sub-interfaces inheriting
  ** from the general Asset interface. To be able to get asset::Proc instances
- ** directly from the AssetManager, we define a specialization of the Asset ID.
+ ** directly from the AssetManager, we define a specialisation of the Asset ID.
  **
  ** @see asset.hpp for explanation
  ** @see ProcFactory creating concrete asset::Proc instances
diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp
index 6c495d419..5850d4ae4 100644
--- a/src/proc/engine/nodefactory.hpp
+++ b/src/proc/engine/nodefactory.hpp
@@ -47,7 +47,7 @@ namespace engine {
   using std::vector;
   
   class Trafo;
-  typedef Trafo* PTrafo;    ///< @note ProcNode is handled by pointer and bulk allocated/dealocated 
+  typedef Trafo* PTrafo;    ///< @note ProcNode is handled by pointer and bulk allocated/deallocated 
 
 
   /**
diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp
index 92e57bb1b..963a322b5 100644
--- a/src/proc/mobject/builder/operationpoint.hpp
+++ b/src/proc/mobject/builder/operationpoint.hpp
@@ -24,7 +24,7 @@
 #ifndef MOBJECT_BUILDER_OPERATIONPOINT_H
 #define MOBJECT_BUILDER_OPERATIONPOINT_H
 
-#include "proc/engine/procnode.hpp"
+#include "proc/engine/procnode.hpp"         /////TODO can we get rid of this header here?
 #include "lib/query.hpp"
 
 #include <vector>
diff --git a/src/proc/mobject/builder/wiringrequest.hpp b/src/proc/mobject/builder/wiringrequest.hpp
index 1190daccb..6e39cb562 100644
--- a/src/proc/mobject/builder/wiringrequest.hpp
+++ b/src/proc/mobject/builder/wiringrequest.hpp
@@ -32,7 +32,7 @@ namespace mobject {
     
     /**
      * A stateful value object denoting the wish to establish a link or connection
-     * between two entities. Used to organize the proper working of the build process.
+     * between two entities. Used to organise the proper working of the build process.
      * Wiring requests are first to be checked and can be deemed impossible to 
      * satisfy. Internally, wiring requests contain specific information about
      * the objects to be connected. This information is exposed only to the

From 2b3fd7ef1b614c3c662dfba4f283b6c610a94685 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 4 Nov 2008 04:13:50 +0100
Subject: [PATCH 270/368] WIP backbone of the builder

---
 src/proc/mobject/builder/nodecreatortool.hpp  | 22 +++--
 src/proc/mobject/builder/operationpoint.cpp   | 96 +++++++++++++++++++
 src/proc/mobject/builder/operationpoint.hpp   | 10 +-
 src/proc/mobject/builder/segmentationtool.hpp |  5 +
 src/proc/mobject/builder/toolfactory.cpp      | 68 +++++++++++--
 src/proc/mobject/builder/toolfactory.hpp      | 31 ++++--
 src/proc/mobject/session/edl.hpp              | 14 ++-
 src/proc/mobject/session/fixture.hpp          | 14 ++-
 8 files changed, 225 insertions(+), 35 deletions(-)
 create mode 100644 src/proc/mobject/builder/operationpoint.cpp

diff --git a/src/proc/mobject/builder/nodecreatortool.hpp b/src/proc/mobject/builder/nodecreatortool.hpp
index e37d0d14f..0c99cd2f9 100644
--- a/src/proc/mobject/builder/nodecreatortool.hpp
+++ b/src/proc/mobject/builder/nodecreatortool.hpp
@@ -28,6 +28,7 @@
 #include "proc/mobject/builder/applicablebuildertargettypes.hpp"
 
 #include "proc/engine/processor.hpp"
+#include "proc/mobject/builder/toolfactory.hpp"
 
 
 
@@ -36,10 +37,9 @@ namespace mobject {
 
 
 
-    // TODO: define Lifecycle...
 
     /**
-     * This Tool implementation plays the central role in the buld process:
+     * This Tool implementation plays the central role in the build process:
      * given a MObject from Session, it is able to attach ProcNodes to the 
      * render engine under construction such as to reflect the properties 
      * of the MObject in the actual render.
@@ -47,6 +47,19 @@ namespace mobject {
     class NodeCreatorTool 
       : public ApplicableBuilderTargetTypes<NodeCreatorTool>
       {
+        ToolFactory& toolKit_;
+        
+        /** holds the Processor (Render Engine Element)
+         *  to be built by the current build step */
+        engine::Processor& proc_;
+        
+        
+        NodeCreatorTool (ToolFactory& tofa, engine::Processor& proc)
+          : toolKit_(tofa),
+            proc_(proc)
+          { }
+        
+        friend class ToolFactory;
         
       public:
         virtual void treat (mobject::session::Clip& clip) ;
@@ -55,11 +68,6 @@ namespace mobject {
         virtual void treat (mobject::Buildable& something) ;
 
 
-      protected:
-        /** holds the Processor (Render Engine Element)
-         *  to be built by the current build step 
-         */
-        engine::Processor* proc;
 
       };
 
diff --git a/src/proc/mobject/builder/operationpoint.cpp b/src/proc/mobject/builder/operationpoint.cpp
new file mode 100644
index 000000000..b19fa967d
--- /dev/null
+++ b/src/proc/mobject/builder/operationpoint.cpp
@@ -0,0 +1,96 @@
+/*
+  OperationPoint  -  abstraction representing the point where to apply a build instruction
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "proc/mobject/builder/operationpoint.hpp"
+#include "proc/asset/media.hpp"
+#include "proc/engine/nodefactory.hpp"
+#include "common/streamtype.hpp"
+//#include "common/util.hpp"
+
+//#include <boost/ptr_container/ptr_vector.hpp>
+
+namespace mobject {
+  namespace builder {
+
+//    using util::isnil;
+    using engine::NodeFactory;
+    
+    using engine::PNode;
+    using lumiera::StreamType;
+    
+    
+    struct RefPoint
+      {
+        NodeFactory& alloc_;
+        
+        vector<PNode> sources_;
+        const StreamType * sType_;  //////TODO: maybe use the ChannelDescriptor??
+        
+        
+        /** just continue connecion chaining */
+        RefPoint (RefPoint const& pred)
+          : alloc_(pred.alloc_),
+            sources_(pred.sources_),
+            sType_(pred.sType_)
+          { }
+        
+        /** initiate a connection chain at a real source */
+        RefPoint (NodeFactory& nFactory, asset::Media srcMe)
+          : alloc_(nFactory),
+            sources_(establishMediaChannels (srcMe)),
+            sType_(0)
+          {
+            deriveSourceStreamType ();
+          }
+      };
+
+    
+    
+    OperationPoint::OperationPoint (NodeFactory& nFact,, asset::Media const& srcMe)
+      : refPoint_(new RefPoint (nFact, srcMetheTimeline))
+    { }
+    
+    
+    OperationPoint::OperationPoint (RefPoint const& sourcePoint)
+      : refPoint_(new RefPoint (sourcePoint))
+    { }
+    
+    
+    void
+    OperationPoint::attach (asset::PProc const& mediaProc)
+    {
+      UNIMPLEMENTED ("Actually-really-finally create a node corresponding to this processing asset");
+    }
+    
+    
+    void
+    OperationPoint::join (OperationPoint& target)
+    {
+      UNIMPLEMENTED ("Actually-really-finally do a mixing output connection");
+    }
+
+
+
+  } // namespace mobject::builder
+
+} // namespace mobject
diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp
index 963a322b5..28d3f9946 100644
--- a/src/proc/mobject/builder/operationpoint.hpp
+++ b/src/proc/mobject/builder/operationpoint.hpp
@@ -24,9 +24,10 @@
 #ifndef MOBJECT_BUILDER_OPERATIONPOINT_H
 #define MOBJECT_BUILDER_OPERATIONPOINT_H
 
-#include "proc/engine/procnode.hpp"         /////TODO can we get rid of this header here?
+//#include "proc/engine/procnode.hpp"         /////TODO can we get rid of this header here?
 #include "lib/query.hpp"
 
+#include <boost/scoped_ptr.hpp>
 #include <vector>
 #include <string>
 
@@ -36,6 +37,8 @@ namespace mobject {
 
     using std::vector;
     using std::string;
+    
+    struct RefPoint;
 
     /**
      * A point in the render node network under construction.
@@ -46,10 +49,7 @@ namespace mobject {
      */
     class OperationPoint
       {
-        typedef engine::PNode PNode;
-        
-        vector<PNode> refPoint_;
-        const string streamID_;
+        boost::scoped_ptr<RefPoint> refPoint_;
         
       public:
         /** create node(s) corresponding to the given Processor-Asset
diff --git a/src/proc/mobject/builder/segmentationtool.hpp b/src/proc/mobject/builder/segmentationtool.hpp
index eaf74c1c6..906e62635 100644
--- a/src/proc/mobject/builder/segmentationtool.hpp
+++ b/src/proc/mobject/builder/segmentationtool.hpp
@@ -28,6 +28,8 @@
 #include "proc/mobject/builder/applicablebuildertargettypes.hpp"
 
 #include "proc/mobject/session/segment.hpp"
+#include "proc/mobject/session/fixture.hpp"   //////TODO really on the header??
+
 
 #include <list>
 using std::list;
@@ -49,12 +51,15 @@ namespace mobject {
       : public ApplicableBuilderTargetTypes<SegmentationTool>
       {
         
+        SegmentationTool (session::Fixture &) ;
         
       public:
         void treat (mobject::session::Clip& clip) ;
         void treat (mobject::session::Effect& effect) ;
 
         void treat (mobject::Buildable& something) ;
+        
+        //////////////////////////////////////////////////////////TODO make it respond to the util::isnil test!
 
       protected:
         typedef mobject::session::Segment Segment;
diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp
index 8e1b14631..95c3627a4 100644
--- a/src/proc/mobject/builder/toolfactory.cpp
+++ b/src/proc/mobject/builder/toolfactory.cpp
@@ -22,17 +22,69 @@
 
 
 #include "proc/mobject/builder/toolfactory.hpp"
+#include "common/util.hpp"
 
-namespace mobject
-  {
-  namespace builder
+//#include <boost/ptr_container/ptr_vector.hpp>
+
+namespace mobject {
+  namespace builder {
+
+    using util::isnil;
+    
+    
+    struct BuildProcessState
+      {
+        
+        session::Fixture & fixedTimeline_;
+        std::auto_ptr<engine::Processor> procSegment_;   /////////////////TODO consider renaming Processor
+        
+        boost::scoped_ptr<SegementationTool> segmentation_;
+        boost::scoped_ptr<NodeCreatorTool> fabrication_;
+        
+        
+        BuildProcessState (session::Fixture& theTimeline)
+          : fixedTimeline_(theTimeline),
+            procSegment_(new engine::Processor())
+          { }
+        
+      };
+
+    ToolFactory::ToolFactory (session::Fixture& theTimeline)
+      : state_(new BuildProcessState (theTimeline))
     {
-
-
-
-    BuilderTool &
-    ToolFactory::configure ()
+      ENSURE (state_->fixedTimeline_.isValid());
+      ENSURE (state_->procSegment_);
+    }
+    
+    
+    SegmentationTool &
+    ToolFactory::configureSegmentation ()
     {
+      REQUIRE (state_->fixedTimeline_.isValid());
+      REQUIRE (state_->procSegment_);
+      
+      state->segmentation_.reset (new SegmentationTool (state->fixedTimeline_));
+      return *(state->segmentation_);
+    }
+    
+    
+    NodeCreatorTool &
+    ToolFactory::configureFabrication () //////////////////////TODO: should iterate in some way!
+    {
+      REQUIRE (state_->procSegment_);
+      REQUIRE (!isnil (*(state_>segmentation)));
+      
+      state->fabrication_.reset (new NodeCreatorTool(*this));
+      return *(state->fabrication_);
+    }
+    
+    
+    std::auto_ptr<engine::Processor>
+    ToolFactory::getProduct ()
+    {
+      state_->segmentation_.reset(0);
+      state_->fabrication_.reset(0);
+      return state_->procSegment_;
     }
 
 
diff --git a/src/proc/mobject/builder/toolfactory.hpp b/src/proc/mobject/builder/toolfactory.hpp
index c796d5c9e..8c0cfbfed 100644
--- a/src/proc/mobject/builder/toolfactory.hpp
+++ b/src/proc/mobject/builder/toolfactory.hpp
@@ -24,16 +24,21 @@
 #ifndef MOBJECT_BUILDER_TOOLFACTORY_H
 #define MOBJECT_BUILDER_TOOLFACTORY_H
 
-#include "proc/mobject/builder/buildertool.hpp"
+#include "proc/mobject/session/fixture.hpp"
+#include "proc/mobject/builder/segmentationtool.hpp"
+#include "proc/mobject/builder/nodecreatortool.hpp"
 #include "proc/mobject/builder/mould.hpp"
+#include "proc/engine/processor.hpp"
+
+#include <boost/scoped_ptr.hpp>
 
 
 
-namespace mobject
-  {
-  namespace builder
-    {
+namespace mobject {
+  namespace builder {
 
+    struct BuildProcessState;
+    
 
     /**
      * provides the builder with the necessary, preconfigured tools.
@@ -43,8 +48,22 @@ namespace mobject
      */
     class ToolFactory
       {
+        boost::scoped_ptr<BuildProcessState> state_;
+        
       public:
-        BuilderTool & configure () ;
+        /** prepare a builder tool kit for dealing with the given Fixture,
+         *  which is a snapshot of some timeline made explicit. */
+        ToolFactory (session::Fixture&);
+        
+        /** prepare a tool for properly segmenting the Fixture */
+        SegmentationTool &  configureSegmentation ();
+        
+        /** prepare a tool for building the processor for a single segment */
+        NodeCreatorTool &   configureFabrication ();
+        
+        /** receive the finished product of the build process; effectively
+         *  releases any other builder tool object */
+        std::auto_ptr<engine::Processor> getProduct ();
       };
 
 
diff --git a/src/proc/mobject/session/edl.hpp b/src/proc/mobject/session/edl.hpp
index d2cee9206..0e76c1a36 100644
--- a/src/proc/mobject/session/edl.hpp
+++ b/src/proc/mobject/session/edl.hpp
@@ -36,12 +36,11 @@ using proc_interface::PAsset;  // TODO better way to refer to a track?
 using std::vector;
 using std::string;
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+  namespace session {
 
-    class EDL
+    
+    class EDL  ///////////////////////////TODO is considered to be renamed as "Sequence". Should be converted to an Inteface
       {
       protected:
         Placement<Track>  track;
@@ -59,6 +58,11 @@ namespace mobject
             UNIMPLEMENTED ("what ist the 'size' of an EDL?");
             return 0;
           }
+        
+        bool isValid() { return this->validate(); }
+        
+      private:
+        virtual bool validate() =0;
       };
 
 
diff --git a/src/proc/mobject/session/fixture.hpp b/src/proc/mobject/session/fixture.hpp
index ef03c6249..821fa9acf 100644
--- a/src/proc/mobject/session/fixture.hpp
+++ b/src/proc/mobject/session/fixture.hpp
@@ -38,10 +38,8 @@ using std::tr1::shared_ptr;
 
 
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+  namespace session {
 
 
 
@@ -54,6 +52,14 @@ namespace mobject
       public:
         list<ExplicitPlacement*> & getPlaylistForRender () ;
         Auto<double>* getAutomation () ; ///< @todo: just a placeholder at the moment!!!
+        
+      private:
+        virtual bool validate() 
+          {
+            TODO ("how to validate a Fixture?");
+            return false;
+          }
+
       };
     
     

From 9269db45cc75ef9ad6eba388fdc0eeb780f69975 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 5 Nov 2008 04:39:57 +0100
Subject: [PATCH 271/368] WIP rename class Processor to RenderGraph (engine)

---
 src/proc/Makefile.am                          | 28 +++++++++----------
 src/proc/control/pathmanager.cpp              |  8 +-----
 src/proc/control/pathmanager.hpp              |  3 +-
 src/proc/engine/renderengine.cpp              | 11 ++------
 src/proc/engine/renderengine.hpp              | 12 ++++----
 .../engine/{processor.cpp => rendergraph.cpp} |  7 ++---
 .../engine/{processor.hpp => rendergraph.hpp} | 10 +++----
 src/proc/mobject/builder/nodecreatortool.hpp  |  8 +++---
 src/proc/mobject/builder/toolfactory.cpp      |  6 ++--
 src/proc/mobject/builder/toolfactory.hpp      |  6 ++--
 10 files changed, 41 insertions(+), 58 deletions(-)
 rename src/proc/engine/{processor.cpp => rendergraph.cpp} (87%)
 rename src/proc/engine/{processor.hpp => rendergraph.hpp} (82%)

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index d9988c42f..4d564794b 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -64,19 +64,19 @@ noinst_LTLIBRARIES += liblumiprocengine.la
 liblumiprocengine_la_CFLAGS = $(AM_CFLAGS) -std=gnu99 -Wall -Wextra -Werror
 liblumiprocengine_la_CXXFLAGS = $(AM_CXXFLAGS) -Wall -Wextra
 
-liblumiprocengine_la_SOURCES =						\
-	$(liblumiprocengine_la_srcdir)/buffhandle.cpp			\
-	$(liblumiprocengine_la_srcdir)/link.cpp				\
-	$(liblumiprocengine_la_srcdir)/mask.cpp				\
-	$(liblumiprocengine_la_srcdir)/nodefactory.cpp			\
-	$(liblumiprocengine_la_srcdir)/nodewiring.cpp			\
-	$(liblumiprocengine_la_srcdir)/pluginadapter.cpp		\
-	$(liblumiprocengine_la_srcdir)/processor.cpp			\
-	$(liblumiprocengine_la_srcdir)/procnode.cpp			\
-	$(liblumiprocengine_la_srcdir)/projector.cpp			\
-	$(liblumiprocengine_la_srcdir)/renderengine.cpp			\
-	$(liblumiprocengine_la_srcdir)/source.cpp			\
-	$(liblumiprocengine_la_srcdir)/stateproxy.cpp			\
+liblumiprocengine_la_SOURCES =					\
+	$(liblumiprocengine_la_srcdir)/buffhandle.cpp		\
+	$(liblumiprocengine_la_srcdir)/link.cpp			\
+	$(liblumiprocengine_la_srcdir)/mask.cpp			\
+	$(liblumiprocengine_la_srcdir)/nodefactory.cpp		\
+	$(liblumiprocengine_la_srcdir)/nodewiring.cpp		\
+	$(liblumiprocengine_la_srcdir)/pluginadapter.cpp	\
+	$(liblumiprocengine_la_srcdir)/rendergraph.cpp		\
+	$(liblumiprocengine_la_srcdir)/procnode.cpp		\
+	$(liblumiprocengine_la_srcdir)/projector.cpp		\
+	$(liblumiprocengine_la_srcdir)/renderengine.cpp		\
+	$(liblumiprocengine_la_srcdir)/source.cpp		\
+	$(liblumiprocengine_la_srcdir)/stateproxy.cpp		\
 	$(liblumiprocengine_la_srcdir)/trafo.cpp
 
 
@@ -203,7 +203,7 @@ noinst_HEADERS +=							\
 	$(liblumiproc_la_srcdir)/engine/renderengine.hpp		\
 	$(liblumiproc_la_srcdir)/engine/source.hpp			\
 	$(liblumiproc_la_srcdir)/engine/trafo.hpp			\
-	$(liblumiproc_la_srcdir)/engine/processor.hpp			\
+	$(liblumiproc_la_srcdir)/engine/rendergraph.hpp			\
 	$(liblumiproc_la_srcdir)/mobject/builder/assembler.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/builder/buildertool.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/builder/conmanager.hpp		\
diff --git a/src/proc/control/pathmanager.cpp b/src/proc/control/pathmanager.cpp
index cf2a01a25..6c2288a28 100644
--- a/src/proc/control/pathmanager.cpp
+++ b/src/proc/control/pathmanager.cpp
@@ -27,13 +27,7 @@ namespace control {
 
 
 
-  engine::Processor *
-  PathManager::buildProcessor ()
-  {
-    UNIMPLEMENTED ("build a complete processor and optimize render path");
-    return 0;//////////////////TODO
-  }
-
+  /** */
 
 
 } // namespace control
diff --git a/src/proc/control/pathmanager.hpp b/src/proc/control/pathmanager.hpp
index 355c500dd..c3057944f 100644
--- a/src/proc/control/pathmanager.hpp
+++ b/src/proc/control/pathmanager.hpp
@@ -24,7 +24,6 @@
 #ifndef CONTROL_PATHMANAGER_H
 #define CONTROL_PATHMANAGER_H
 
-#include "proc/engine/processor.hpp"
 
 
 
@@ -39,7 +38,7 @@ namespace control {
   class PathManager
     {
     public:
-      engine::Processor* buildProcessor () ;
+      // TODO: find out about public interface
       // TODO: allocation, GC??
     };
 
diff --git a/src/proc/engine/renderengine.cpp b/src/proc/engine/renderengine.cpp
index daa7084ca..25eb6257d 100644
--- a/src/proc/engine/renderengine.cpp
+++ b/src/proc/engine/renderengine.cpp
@@ -23,17 +23,10 @@
 
 #include "proc/engine/renderengine.hpp"
 
-namespace engine
-  {
+namespace engine {
 
 
-
-  /**
-   * TODO: will probably be handled differently (see Cehteh)
-   */
-  void
-  RenderEngine::play ()
-  {}
+  /** */
 
 
 
diff --git a/src/proc/engine/renderengine.hpp b/src/proc/engine/renderengine.hpp
index 121d0618c..1c361c739 100644
--- a/src/proc/engine/renderengine.hpp
+++ b/src/proc/engine/renderengine.hpp
@@ -26,7 +26,7 @@
 
 #include <list>
 
-#include "proc/engine/processor.hpp"
+#include "proc/engine/rendergraph.hpp"
 
 
 using std::list;
@@ -36,16 +36,14 @@ namespace engine
   {
 
 
-  class RenderEngine : public Processor
+  class RenderEngine : public RenderGraph
     {
     public:
-      /**
-       * TODO: will probably be handled differently (see Cehteh)
-       */
-      void play () ;
+       ///// TODO: find out about the public operations
+       // note: the play controller lives in the backend
 
     private:
-      list<Processor> renderSegments;
+      list<RenderGraph> renderSegments;
 
     };
 
diff --git a/src/proc/engine/processor.cpp b/src/proc/engine/rendergraph.cpp
similarity index 87%
rename from src/proc/engine/processor.cpp
rename to src/proc/engine/rendergraph.cpp
index 38ed34c5d..a031deb70 100644
--- a/src/proc/engine/processor.cpp
+++ b/src/proc/engine/rendergraph.cpp
@@ -1,5 +1,5 @@
 /*
-  Processor  -  a single render pipeline for one segment of the timeline
+  RenderGraph  -  render network corresponding to one segment of the timeline
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,11 +21,10 @@
 * *****************************************************/
 
 
-#include "proc/engine/processor.hpp"
+#include "proc/engine/rendergraph.hpp"
 #include "proc/state.hpp"
 
-namespace engine
-  {
+namespace engine {
 
   /** */
 
diff --git a/src/proc/engine/processor.hpp b/src/proc/engine/rendergraph.hpp
similarity index 82%
rename from src/proc/engine/processor.hpp
rename to src/proc/engine/rendergraph.hpp
index f9bb7b164..6fdb28217 100644
--- a/src/proc/engine/processor.hpp
+++ b/src/proc/engine/rendergraph.hpp
@@ -1,5 +1,5 @@
 /*
-  PROCESSOR.hpp  -  a single render pipeline for one segment of the timeline
+  RENDERGRAPH.hpp  -  render network corresponding to one segment of the timeline
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -21,8 +21,8 @@
 */
 
 
-#ifndef ENGINE_PROCESSOR_H
-#define ENGINE_PROCESSOR_H
+#ifndef ENGINE_RENDERGRAPH_H
+#define ENGINE_RENDERGRAPH_H
 
 #include "proc/common.hpp"
 #include "proc/state.hpp"
@@ -34,12 +34,12 @@ namespace engine
 
   class ExitNode;
 
-  class Processor
+  class RenderGraph
     {
     protected:
       ExitNode * output;
 
-      /** begin of the timerange covered by this processor */
+      /** begin of the timerange covered by this RenderGraph */
       lumiera::Time start;
 
       /**end (exclusive) of the timerange  */
diff --git a/src/proc/mobject/builder/nodecreatortool.hpp b/src/proc/mobject/builder/nodecreatortool.hpp
index 0c99cd2f9..f39fefb61 100644
--- a/src/proc/mobject/builder/nodecreatortool.hpp
+++ b/src/proc/mobject/builder/nodecreatortool.hpp
@@ -27,7 +27,7 @@
 
 #include "proc/mobject/builder/applicablebuildertargettypes.hpp"
 
-#include "proc/engine/processor.hpp"
+#include "proc/engine/rendergraph.hpp"
 #include "proc/mobject/builder/toolfactory.hpp"
 
 
@@ -49,12 +49,12 @@ namespace mobject {
       {
         ToolFactory& toolKit_;
         
-        /** holds the Processor (Render Engine Element)
+        /** holds the RenderGraph (Render Engine Element)
          *  to be built by the current build step */
-        engine::Processor& proc_;
+        engine::RenderGraph& proc_;
         
         
-        NodeCreatorTool (ToolFactory& tofa, engine::Processor& proc)
+        NodeCreatorTool (ToolFactory& tofa, engine::RenderGraph& proc)
           : toolKit_(tofa),
             proc_(proc)
           { }
diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp
index 95c3627a4..79a305142 100644
--- a/src/proc/mobject/builder/toolfactory.cpp
+++ b/src/proc/mobject/builder/toolfactory.cpp
@@ -36,7 +36,7 @@ namespace mobject {
       {
         
         session::Fixture & fixedTimeline_;
-        std::auto_ptr<engine::Processor> procSegment_;   /////////////////TODO consider renaming Processor
+        std::auto_ptr<engine::RenderGraph> procSegment_;
         
         boost::scoped_ptr<SegementationTool> segmentation_;
         boost::scoped_ptr<NodeCreatorTool> fabrication_;
@@ -44,7 +44,7 @@ namespace mobject {
         
         BuildProcessState (session::Fixture& theTimeline)
           : fixedTimeline_(theTimeline),
-            procSegment_(new engine::Processor())
+            procSegment_(new engine::RenderGraph())
           { }
         
       };
@@ -79,7 +79,7 @@ namespace mobject {
     }
     
     
-    std::auto_ptr<engine::Processor>
+    std::auto_ptr<engine::RenderGraph>
     ToolFactory::getProduct ()
     {
       state_->segmentation_.reset(0);
diff --git a/src/proc/mobject/builder/toolfactory.hpp b/src/proc/mobject/builder/toolfactory.hpp
index 8c0cfbfed..aac40e827 100644
--- a/src/proc/mobject/builder/toolfactory.hpp
+++ b/src/proc/mobject/builder/toolfactory.hpp
@@ -28,7 +28,7 @@
 #include "proc/mobject/builder/segmentationtool.hpp"
 #include "proc/mobject/builder/nodecreatortool.hpp"
 #include "proc/mobject/builder/mould.hpp"
-#include "proc/engine/processor.hpp"
+#include "proc/engine/rendergraph.hpp"
 
 #include <boost/scoped_ptr.hpp>
 
@@ -58,12 +58,12 @@ namespace mobject {
         /** prepare a tool for properly segmenting the Fixture */
         SegmentationTool &  configureSegmentation ();
         
-        /** prepare a tool for building the processor for a single segment */
+        /** prepare a tool for building the render engine (graph) for a single segment */
         NodeCreatorTool &   configureFabrication ();
         
         /** receive the finished product of the build process; effectively
          *  releases any other builder tool object */
-        std::auto_ptr<engine::Processor> getProduct ();
+        std::auto_ptr<engine::RenderGraph> getProduct ();
       };
 
 

From 3ef03bc3c021af8d2c73a506f8b4237cb9320bbf Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 5 Nov 2008 05:03:03 +0100
Subject: [PATCH 272/368] WIP adjust fixture, segments and segmentation

---
 src/proc/Makefile.am                          |  4 +-
 src/proc/mobject/builder/segmentationtool.hpp |  9 ++-
 src/proc/mobject/session/fixture.cpp          |  8 +--
 src/proc/mobject/session/fixture.hpp          |  9 ++-
 src/proc/mobject/session/segment.cpp          | 13 +---
 src/proc/mobject/session/segment.hpp          | 20 +++----
 src/proc/mobject/session/segmentation.cpp     | 36 +++++++++++
 src/proc/mobject/session/segmentation.hpp     | 60 +++++++++++++++++++
 8 files changed, 124 insertions(+), 35 deletions(-)
 create mode 100644 src/proc/mobject/session/segmentation.cpp
 create mode 100644 src/proc/mobject/session/segmentation.hpp

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 4d564794b..2882546c2 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -71,9 +71,9 @@ liblumiprocengine_la_SOURCES =					\
 	$(liblumiprocengine_la_srcdir)/nodefactory.cpp		\
 	$(liblumiprocengine_la_srcdir)/nodewiring.cpp		\
 	$(liblumiprocengine_la_srcdir)/pluginadapter.cpp	\
-	$(liblumiprocengine_la_srcdir)/rendergraph.cpp		\
 	$(liblumiprocengine_la_srcdir)/procnode.cpp		\
 	$(liblumiprocengine_la_srcdir)/projector.cpp		\
+	$(liblumiprocengine_la_srcdir)/rendergraph.cpp		\
 	$(liblumiprocengine_la_srcdir)/renderengine.cpp		\
 	$(liblumiprocengine_la_srcdir)/source.cpp		\
 	$(liblumiprocengine_la_srcdir)/stateproxy.cpp		\
@@ -161,6 +161,7 @@ liblumiprocmobjectsession_la_SOURCES =					\
 	$(liblumiprocmobjectsession_la_srcdir)/meta.cpp			\
 	$(liblumiprocmobjectsession_la_srcdir)/relativelocation.cpp	\
 	$(liblumiprocmobjectsession_la_srcdir)/segment.cpp		\
+	$(liblumiprocmobjectsession_la_srcdir)/segmentation.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/simpleclip.cpp		\
 	$(liblumiprocmobjectsession_la_srcdir)/plug.cpp			\
 	$(liblumiprocmobjectsession_la_srcdir)/session-impl.cpp		\
@@ -229,6 +230,7 @@ noinst_HEADERS +=							\
 	$(liblumiproc_la_srcdir)/mobject/session/simpleclip.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/session/mobjectfactory.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/session/segment.hpp		\
+	$(liblumiproc_la_srcdir)/mobject/session/segmentation.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/session/track.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/session/wish.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/session/clip.hpp		\
diff --git a/src/proc/mobject/builder/segmentationtool.hpp b/src/proc/mobject/builder/segmentationtool.hpp
index 906e62635..8e55518d1 100644
--- a/src/proc/mobject/builder/segmentationtool.hpp
+++ b/src/proc/mobject/builder/segmentationtool.hpp
@@ -27,7 +27,7 @@
 
 #include "proc/mobject/builder/applicablebuildertargettypes.hpp"
 
-#include "proc/mobject/session/segment.hpp"
+#include "proc/mobject/session/segmentation.hpp"
 #include "proc/mobject/session/fixture.hpp"   //////TODO really on the header??
 
 
@@ -42,7 +42,7 @@ namespace mobject {
 
     /**
      * Tool implementation for deriving a partitioning of the current 
-     * timeline, such that each segement has a constant configuration. 
+     * timeline, such that each Segment has a constant configuration. 
      * "Constant" means here, that any remaining changes over time
      * can be represented by automation solely, without the need 
      * to change the node connections.
@@ -61,12 +61,11 @@ namespace mobject {
         
         //////////////////////////////////////////////////////////TODO make it respond to the util::isnil test!
 
-      protected:
+      private:
         typedef mobject::session::Segment Segment;
 
         /** Partitioning of the Timeline to be created by this tool. */
-        list<Segment*> segments;
-        // TODO handle alloc!!!!
+        session::Segmentation& segments_;
 
       };
 
diff --git a/src/proc/mobject/session/fixture.cpp b/src/proc/mobject/session/fixture.cpp
index 2ff3b1612..d4c40162d 100644
--- a/src/proc/mobject/session/fixture.cpp
+++ b/src/proc/mobject/session/fixture.cpp
@@ -24,14 +24,12 @@
 #include "proc/mobject/session/fixture.hpp"
 #include "include/logging.h"
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+  namespace session {
 
 
 
-    list<ExplicitPlacement*> &
+    list<ExplicitPlacement> &
     Fixture::getPlaylistForRender ()
     {
       UNIMPLEMENTED ("get Playlist For Render");
diff --git a/src/proc/mobject/session/fixture.hpp b/src/proc/mobject/session/fixture.hpp
index 821fa9acf..b4d98c04a 100644
--- a/src/proc/mobject/session/fixture.hpp
+++ b/src/proc/mobject/session/fixture.hpp
@@ -25,9 +25,10 @@
 #define MOBJECT_SESSION_FIXTURE_H
 
 #include <list>
-#include <tr1/memory>
+#include <boost/scoped_ptr.hpp>
 
 #include "proc/mobject/session/edl.hpp"
+#include "proc/mobject/session/segmentation.hpp"
 #include "proc/mobject/session/track.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 #include "proc/mobject/session/auto.hpp"
@@ -46,11 +47,13 @@ namespace mobject {
     class Fixture : public EDL
       {
       protected:
-        list<ExplicitPlacement*> timeline;
+        list<ExplicitPlacement> content_;
+        boost::scoped_ptr<Segmentation> partitioning_;
 
+        /////////////TODO: who creates this?
 
       public:
-        list<ExplicitPlacement*> & getPlaylistForRender () ;
+        list<ExplicitPlacement> & getPlaylistForRender () ;
         Auto<double>* getAutomation () ; ///< @todo: just a placeholder at the moment!!!
         
       private:
diff --git a/src/proc/mobject/session/segment.cpp b/src/proc/mobject/session/segment.cpp
index 3c34896ab..45c593c67 100644
--- a/src/proc/mobject/session/segment.cpp
+++ b/src/proc/mobject/session/segment.cpp
@@ -1,5 +1,5 @@
 /*
-  Segment  -  Segment of the Timeline.
+  Segment  -  Segment of the timeline for rendering.
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -23,17 +23,10 @@
 #include "proc/mobject/session/segment.hpp"
 #include "proc/mobject/explicitplacement.hpp"
 
-// Used at the moment (7/07) for partitioning the timeline/fixture into segments
-// to be rendered by a specialized render node network for each, without the need
-// to change any connections within a given segment.
-// Note this concept may be superfluos alltogether; is a draft and the real
-// use still needs to be worked out...
 
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+  namespace session {
 
     /** */
 
diff --git a/src/proc/mobject/session/segment.hpp b/src/proc/mobject/session/segment.hpp
index 72b25fcbc..66f03b9bc 100644
--- a/src/proc/mobject/session/segment.hpp
+++ b/src/proc/mobject/session/segment.hpp
@@ -1,5 +1,5 @@
 /*
-  SEGMENT.hpp  -  Segment of the Timeline.
+  SEGMENT.hpp  -  Segment of the timeline for rendering.
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -33,18 +33,15 @@
 using std::list;
 
 
-namespace mobject
-  {
-  namespace session
-    {
+namespace mobject {
+  namespace session {
 
 
     /**
-     * Used at the moment (7/07) for partitioning the timeline/fixture into segments
-     * to be rendered by a specialized render node network for each, without the need
-     * to change any connections within a given segment.
-     * Note this concept may be superfluos alltogether; is a draft and the real
-     * use still needs to be worked out...
+     * For the purpose of building and rendering, the fixture (for each timeline) 
+     * is partitioned such that each segment is <i>structurally constant</i>. 
+     * For each segment there is a RenderGraph (unit of the render engine) which
+     * is able to render all ExitNodes for this segment.
      */
     class Segment
       {
@@ -57,8 +54,9 @@ namespace mobject
         Time length;
 
         /** relevant MObjects comprising this segment. */
-        list<ExplicitPlacement *> elements;
+        list<ExplicitPlacement> elements;
         // TODO: actually necessary??
+        // TODO: ownership??
 
       };
 
diff --git a/src/proc/mobject/session/segmentation.cpp b/src/proc/mobject/session/segmentation.cpp
new file mode 100644
index 000000000..f19b8041b
--- /dev/null
+++ b/src/proc/mobject/session/segmentation.cpp
@@ -0,0 +1,36 @@
+/*
+  Segementation  -  Partitioning of a timeline for organising the render graph.
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+#include "proc/mobject/session/segmentation.hpp"
+
+
+
+namespace mobject {
+  namespace session {
+
+    /** */
+
+
+
+  } // namespace mobject::session
+
+} // namespace mobject
diff --git a/src/proc/mobject/session/segmentation.hpp b/src/proc/mobject/session/segmentation.hpp
new file mode 100644
index 000000000..4f4096a4e
--- /dev/null
+++ b/src/proc/mobject/session/segmentation.hpp
@@ -0,0 +1,60 @@
+/*
+  SEGMENTATION.hpp  -  Partitioning of a timeline for organising the render graph.
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef MOBJECT_SESSION_SEGMENTATION_H
+#define MOBJECT_SESSION_SEGMENTATION_H
+
+
+#include "proc/mobject/session/segment.hpp"
+
+#include <list>
+
+using std::list;
+
+
+namespace mobject {
+  namespace session {
+
+
+    /**
+     * For the purpose of building and rendering, the fixture (for each timeline) 
+     * is partitioned such that each segment is <i>structurally constant</i>. 
+     * The Segmentation defines and maintains this partitioning. Further,
+     * it is the general entry point for accessing the correct part of the engine
+     * responsible for a given timeline time point.
+     * @see SegmentationTool actually calculating the Segmentation
+     */
+    class Segmentation
+      {
+
+        /** segments of the engine in ordered sequence. */
+        list<Segement> segments_;
+
+      };
+
+
+
+  } // namespace mobject::session
+
+} // namespace mobject
+#endif

From 592c79b839932a496a5624e10b78f45f50cb4b06 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 20 Dec 2008 05:59:55 +0100
Subject: [PATCH 273/368] FIX after rebase... still WIP

---
 src/proc/engine/procnode.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 05bfaf8e9..392576c41 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -45,7 +45,7 @@
 #include "proc/common.hpp"
 #include "proc/state.hpp"
 #include "proc/mobject/parameter.hpp"
-#include "common/frameid.hpp"
+#include "lib/frameid.hpp"
 #include "lib/refarray.hpp"
 
 #include <vector>

From 6da18f76c0c6428262ec96437eb43d09672a5680 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 29 Aug 2009 16:13:42 +0200
Subject: [PATCH 274/368] re-read the code, some cleanup, define Tickets...

---
 src/proc/engine/nodefactory.cpp          |   6 +-
 src/proc/engine/nodeoperation.hpp        |   4 +-
 src/proc/engine/nodewiring-config.hpp    | 181 ++++++++++++++++++++++
 src/proc/engine/nodewiring.cpp           |   2 +-
 src/proc/engine/nodewiringconfig.hpp     | 183 -----------------------
 src/proc/engine/procnode.hpp             |   8 +-
 src/proc/mobject/builder/toolfactory.cpp | 122 +++++++--------
 src/proc/mobject/builder/toolfactory.hpp |  71 +++++----
 tests/lib/meta/config-flags-test.cpp     |   4 +-
 tests/lib/meta/typelist-manip-test.cpp   |   2 +-
 10 files changed, 290 insertions(+), 293 deletions(-)
 create mode 100644 src/proc/engine/nodewiring-config.hpp
 delete mode 100644 src/proc/engine/nodewiringconfig.hpp

diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index 628e247e2..580fd3a90 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -57,9 +57,9 @@ namespace engine {
       return *newNode;
       
       /*
-       * Problems to be solved:
-       * - write a generic allocator, which later on can be augmented to do block wise bulk allocation
-       * - the allocator needs to keep track of the objects; actually he owns the objects
+       * Problems to be solved:                                                                        /////////////TODO: see Ticket #247
+       * - write a generic allocator, which later on can be augmented to do block wise bulk allocation /////////////DONE: AllocationCluster
+       * - the allocator needs to keep track of the objects; actually he owns the objects              /////////////DONE
        * - we need to access the wiring descriptor of the predecessor nodes. Which means, the code
        *   must be in the body of NodeFactory (because the latter is friend of ProcNode and can access the wiring descriptor)
        * - btw reconsider if this level of protection is necessary, or if the const WiringDescriptor cant be just on the public interface of ProcNode
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index c7c973977..9ab36e93c 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -41,14 +41,14 @@
  ** of elementary operations invoking each other (\c NEXT::step(invocation) ). Notably, all those possible
  ** configurations are pre-built while compiling (it's a small number below 32 configuration instance).
  ** To be able to select the Strategy for each configuration, we need a Factory (ConfigSelector defined in
- ** nodewiringconfig.hpp). which is actually instantiated and used in nodewiring.cpp, which is the object
+ ** nodewiring-config.hpp). which is actually instantiated and used in nodewiring.cpp, which is the object
  ** file holding all those instantiations. 
  **
  ** @see engine::ProcNode
  ** @see engine::Invocation
  ** @see engine::State
  ** @see engine::NodeFactory
- ** @see nodewiringconfig.hpp
+ ** @see nodewiring-config.hpp
  ** @see nodewiring.hpp interface for building/wiring the nodes
  **
  */
diff --git a/src/proc/engine/nodewiring-config.hpp b/src/proc/engine/nodewiring-config.hpp
new file mode 100644
index 000000000..981c1e177
--- /dev/null
+++ b/src/proc/engine/nodewiring-config.hpp
@@ -0,0 +1,181 @@
+/*
+  NODEWIRING-CONFIG.hpp  -  Helper for representing and selecting the wiring case
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file nodewiring-config.hpp
+ ** Sometimes we need to choose a different implementation for dealing with
+ ** some special cases. While for simple cases, just testing a flag or using a
+ ** switch statement will do the job, matters get more difficult when we have to
+ ** employ a completely different execution path for each of the different cases,
+ ** while using a set of common building blocks.
+ ** \par
+ ** In the Lumiera render engine, right on the critical path, we need some glue code
+ ** for invoking the predecessor nodes when pulling a given processing node. The actual
+ ** sequence is quite dependent on the specific situation each node is wired up, regarding
+ ** buffer allocation, cache querying and the possible support for GPU processing and
+ ** render farms. The solution is to define specialisations of a Strategy template
+ ** using the specific configuration as template argument. Based on these, we can 
+ ** create a collection of factories, which in turn will build the internal wiring
+ ** for the individual ProcNode instances in accordance to the situation determined
+ ** for this node, expressed as a set of flags. As a net result, each node has an 
+ ** individual configuration (as opposed to creating a lot of hand-written individual
+ ** ProcNode subclasses), but parts of this configuration assembly is done already at
+ ** compile time, allowing for additional checks by typing and for possible optimisation.
+ ** 
+ ** @see proc::engine::config::Strategy
+ ** @see nodewiring.hpp
+ ** @see configflags.hpp
+ ** 
+ */
+
+
+#ifndef ENGINE_NODEWIRING_CONFIG_H
+#define ENGINE_NODEWIRING_CONFIG_H
+
+
+#include "lib/util.hpp"
+#include "lib/meta/configflags.hpp"
+
+#include <tr1/functional>
+#include <bitset>
+#include <map>
+
+
+namespace engine {
+namespace config {
+  
+  using lumiera::typelist::FlagInfo;
+  using util::contains;
+  
+  using lumiera::typelist::CONFIG_FLAGS_MAX;
+  
+  
+  /**
+   * Helper for fabricating ProcNode Wiring configurations.
+   * This object builds a table of factories, holding one factory
+   * for each possible node configuration. Provided with the desired
+   * configuration encoded as bits, the related factory can be invoked,
+   * thus producing a product object for the given configuration.
+   * 
+   * \par implementation notes
+   * The actual factory class is templated, so it will be defined
+   * at the use site of ConfigSelector. Moreover, this factory
+   * usually expects an ctor argument, which will be fed through
+   * when creating the ConfigSelector instance. This is one of
+   * the reasons why we go through all these complicated factory
+   * building: this ctor argument usually brings in a reference
+   * to the actual memory allocator. Thus we have to rebuild the
+   * ConfigSelector each time we switch and rebuild the ProcNode
+   * factories, which in turn happens each time we use a new
+   * bulk allocation memory block -- typically for each separate
+   * segment of the Timeline and processing node graph.
+   * 
+   * Now the selection of the possible flag configurations, for which
+   * Factory instances are created in the table, is governed by the
+   * type parameter of the ConfigSelector ctor. This type parameter
+   * needs to be a Typelist of Typelists, each representing a flag
+   * configuration. The intention is to to drive this selection by
+   * the use of template metaprogramming for extracting all
+   * currently defined StateProxy object configurations.
+   * @todo as the factories live only within the enclosed table (map)
+   *       we could allocate them in-place. Unfortunately this is
+   *       non-trivial, because the STL containers employ
+   *       value semantics and thus do a copy even on insert.
+   *       Thus, for now we use a shared_ptr to hold the factory
+   *       heap allocated. ---> see Ticket #248
+   */
+  template< template<class CONF> class Factory
+          , typename FUNC       ///< common function type of all Factory instances
+          , typename PAR       ///<  ctor parameter of the Factories
+          >
+  class ConfigSelector
+    {
+      typedef std::tr1::function<FUNC> FacFunction;
+      
+      template<class FAC>
+      struct FactoryHolder ///< impl type erasure
+        : private FAC,
+          public FacFunction
+        {
+          FactoryHolder(PAR p) 
+            : FAC(p),
+              FacFunction( static_cast<FAC&>(*this))
+            { }  
+        };
+      
+      
+      typedef std::tr1::shared_ptr<FacFunction> PFunc;
+      typedef std::map<size_t, PFunc> ConfigTable;
+      
+      ConfigTable possibleConfig_; ///< Table of factories
+      
+      /** Helper: a visitor usable with FlagInfo */
+      struct FactoryTableBuilder
+        {
+          PAR ctor_param_;
+          ConfigTable& factories_;
+          
+          FactoryTableBuilder (ConfigTable& tab, PAR p)
+            : ctor_param_(p), 
+              factories_(tab) { }
+          
+          
+          /* === visitation interface === */
+          
+          typedef void Ret;
+          
+          template<class CONF>
+          void
+          visit (size_t code)
+            {
+              PFunc pFactory (new FactoryHolder<Factory<CONF> > (ctor_param_));
+              factories_[code] = pFactory;
+            }
+          
+          void done()  {}
+        };
+      
+    public:
+      template<class CONFS>
+      ConfigSelector(CONFS const&, PAR factory_ctor_param)
+        {
+          FactoryTableBuilder buildTable(this->possibleConfig_,
+                                         factory_ctor_param );
+          // store a new Factory instance
+          // for each possible Flag-Configuration  
+          FlagInfo<CONFS>::accept (buildTable);
+        }
+      
+      FacFunction&
+      operator[] (size_t configFlags) ///< retrieve the factory corresponding to the given config
+        {
+          if (contains (possibleConfig_, configFlags))
+            return *possibleConfig_[configFlags];
+          else
+            throw lumiera::error::Invalid("ConfigSelector: No preconfigured factory for config-bits="
+                                         +std::bitset<CONFIG_FLAGS_MAX>(configFlags).to_string());
+        }
+    };
+  
+  
+  
+}} // namespace engine::config
+#endif
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index ccb0824a3..7b827c9fc 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -24,7 +24,7 @@
 #include "proc/engine/procnode.hpp"
 #include "proc/engine/nodewiring.hpp"
 #include "proc/engine/nodeoperation.hpp"
-#include "proc/engine/nodewiringconfig.hpp"
+#include "proc/engine/nodewiring-config.hpp"
 
 #include "lib/meta/typelist-util.hpp"
 
diff --git a/src/proc/engine/nodewiringconfig.hpp b/src/proc/engine/nodewiringconfig.hpp
deleted file mode 100644
index 65c2369c7..000000000
--- a/src/proc/engine/nodewiringconfig.hpp
+++ /dev/null
@@ -1,183 +0,0 @@
-/*
-  NODEWIRINGCONFIG.hpp  -  Helper for representing and selecting the wiring case
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-*/
-
-/** @file nodewiringconfig.hpp
- ** Sometimes we need to choose a different implementation for dealing with
- ** some special cases. While for simple cases, just testing a flag or using a
- ** switch statement will do the job, matters get more difficult when we have to
- ** employ a completely different execution path for each of the different cases,
- ** while using a set of common building blocks. 
- ** \par
- ** In the Lumiera render engine, right on the critical path, we need some glue code
- ** for invoking the predecessor nodes when pulling a given processing node. The actual
- ** sequence is quite dependent on the specific situation each node is wired up, regarding
- ** buffer allocation, cache querying and the possible support for GPU processing and 
- ** render farms. The solution is to define specialisations of a Strategy template
- ** using the specific configuration as template argument. Based on these, we can 
- ** create a collection of factories, which in turn will build the internal wiring
- ** for the individual ProcNode instances in accordance to the situation determined
- ** for this node, expressed as a set of flags. As a net result, each node has an 
- ** individual configuration (as opposed to creating a lot of hand-written individual
- ** ProcNode subclasses), but parts of this configuration assembly is done already at
- ** compile time, allowing for additional checks by typing and for possible optimisation.
- ** 
- ** @see proc::engine::config::Strategy
- ** @see nodewiring.hpp
- ** @see configflags.hpp
- ** 
- */
-
-
-#ifndef ENGINE_NODEWIRINGCONFIG_H
-#define ENGINE_NODEWIRINGCONFIG_H
-
-
-#include "lib/util.hpp"
-#include "lib/meta/configflags.hpp"
-
-#include <tr1/functional>
-#include <bitset>
-#include <map>
-
-
-namespace engine {
-  namespace config {
-  
-    using lumiera::typelist::FlagInfo;
-    using util::contains;
-    
-    using lumiera::typelist::CONFIG_FLAGS_MAX;
-    
-    
-    /**
-     * Helper for fabricating ProcNode Wiring configurations.
-     * This object builds a table of factories, holding one factory
-     * for each possible node configuration. Provided with the desired
-     * configuration encoded as bits, the related factory can be invoked,
-     * thus producing a product object for the given configuration.
-     * 
-     * \par implementation notes
-     * The actual factory class is templated, so it will be defined
-     * at the use site of ConfigSelector. Moreover, this factory
-     * usually expects an ctor argument, which will be fed through
-     * when creating the ConfigSelector instance. This is one of
-     * the reasons why we go through all these complicated factory
-     * building: this ctor argument usually brings in a reference
-     * to the actual memory allocator. Thus we have to rebuild the
-     * ConfigSelector each time we switch and rebuild the ProcNode
-     * factories, which in turn happens each time we use a new
-     * bulk allocation memory block -- typically for each separate
-     * segment of the Timeline and processing node graph.
-     * 
-     * Now the selection of the possible flag configurations, for which
-     * Factory instances are created in the table, is governed by the
-     * type parameter of the ConfigSelector ctor. This type parameter
-     * needs to be a Typelist of Typelists, each representing a flag
-     * configuration. The intention is to to drive this selection by
-     * the use of template metaprogramming for extracting all
-     * currently defined StateProxy object configurations.
-     * @todo as the factories live only within the enclosed table (map)
-     *       we could allocate them in-place. Unfortunately this is 
-     *       non-trivial, because the STL containers employ
-     *       value semantics and thus do a copy even on insert.
-     *       Thus, for now we use a shared_ptr to hold the factory
-     *       heap allocated.
-     */
-    template< template<class CONF> class Factory
-            , typename FUNC       ///< common function type of all Factory instances
-            , typename PAR       ///<  ctor parameter of the Factories
-            >
-    class ConfigSelector
-      {
-        typedef std::tr1::function<FUNC> FacFunction;
-        
-        template<class FAC>
-        struct FactoryHolder ///< impl type erasure
-          : private FAC,
-            public FacFunction
-          {
-            FactoryHolder(PAR p) 
-              : FAC(p),
-                FacFunction( static_cast<FAC&>(*this))
-              { }  
-          };
-        
-        
-        typedef std::tr1::shared_ptr<FacFunction> PFunc;
-        typedef std::map<size_t, PFunc> ConfigTable;
-        
-        ConfigTable possibleConfig_; ///< Table of factories
-        
-        /** Helper: a visitor usable with FlagInfo */
-        struct FactoryTableBuilder
-          {
-            PAR ctor_param_;
-            ConfigTable& factories_;
-            
-            FactoryTableBuilder (ConfigTable& tab, PAR p)
-              : ctor_param_(p), 
-                factories_(tab) { }
-            
-            
-            /* === visitation interface === */
-            
-            typedef void Ret;
-            
-            template<class CONF>
-            void
-            visit (size_t code)
-              {
-                PFunc pFactory (new FactoryHolder<Factory<CONF> > (ctor_param_));
-                factories_[code] = pFactory;
-              }
-            
-            void done()  {}
-          };
-        
-      public:
-        template<class CONFS>
-        ConfigSelector(CONFS const&, PAR factory_ctor_param)
-          {
-            FactoryTableBuilder buildTable(this->possibleConfig_,
-                                           factory_ctor_param );
-            // store a new Factory instance
-            // for each possible Flag-Configuration  
-            FlagInfo<CONFS>::accept (buildTable);
-          }
-        
-        FacFunction&
-        operator[] (size_t configFlags) ///< retrieve the factory corresponding to the given config
-          {
-            if (contains (possibleConfig_, configFlags))
-              return *possibleConfig_[configFlags];
-            else
-              throw lumiera::error::Invalid("ConfigSelector: No preconfigured factory for config-bits="
-                                           +std::bitset<CONFIG_FLAGS_MAX>(configFlags).to_string());
-          }
-      };
-    
-    
-    
-  } // namespace config
-  
-} // namespace engine
-#endif
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 392576c41..2d95bd7cb 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -31,7 +31,7 @@
  **
  ** By using the builder interface, concrete node and wiring descriptor classes are created,
  ** based on some templates. These concrete classes form the "glue" to tie the node network
- ** together and contain much of the operation beahviour in a hard wired fashion.
+ ** together and contain much of the operation behaviour in a hard wired fashion.
  **
  ** @see nodefactory.hpp
  ** @see operationpoint.hpp
@@ -130,16 +130,16 @@ namespace engine {
     public:
       
       /** Engine Core operation: render and pull output from this node.
-       *  On return, currentProcess will hold onto output buffer(s) 
+       *  On return, currentProcess will hold onto output buffer(s)
        *  containing the calculated result frames. In case this node
-       *  calculates a multichannel output, only one channel can be 
+       *  calculates a multichannel output, only one channel can be
        *  retrieved by such a \c pull() call, but you can expect data
        *  of the other channels to be processed and fed to cache.
        *  @param currentProcess the current processing state for 
        *         managing buffers and accessing current parameter values
        *  @param requestedOutputNr the output channel requested
        *         (in case this node delivers more than one output channel)
-       *  @return handle to the buffer containing the calculated result. 
+       *  @return handle to the buffer containing the calculated result.
        */
       BuffHandle
       pull (State& currentProcess, uint requestedOutputNr=0)  const
diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp
index 79a305142..278580754 100644
--- a/src/proc/mobject/builder/toolfactory.cpp
+++ b/src/proc/mobject/builder/toolfactory.cpp
@@ -22,73 +22,73 @@
 
 
 #include "proc/mobject/builder/toolfactory.hpp"
-#include "common/util.hpp"
+#include "lib/util.hpp"
 
 //#include <boost/ptr_container/ptr_vector.hpp>
 
 namespace mobject {
-  namespace builder {
-
-    using util::isnil;
-    
-    
-    struct BuildProcessState
-      {
-        
-        session::Fixture & fixedTimeline_;
-        std::auto_ptr<engine::RenderGraph> procSegment_;
-        
-        boost::scoped_ptr<SegementationTool> segmentation_;
-        boost::scoped_ptr<NodeCreatorTool> fabrication_;
-        
-        
-        BuildProcessState (session::Fixture& theTimeline)
-          : fixedTimeline_(theTimeline),
-            procSegment_(new engine::RenderGraph())
-          { }
-        
-      };
-
-    ToolFactory::ToolFactory (session::Fixture& theTimeline)
-      : state_(new BuildProcessState (theTimeline))
+namespace builder {
+  
+  using util::isnil;
+  using std::auto_ptr;
+  using boost::scoped_ptr;
+  
+  
+  struct BuildProcessState
     {
-      ENSURE (state_->fixedTimeline_.isValid());
-      ENSURE (state_->procSegment_);
-    }
-    
-    
-    SegmentationTool &
-    ToolFactory::configureSegmentation ()
-    {
-      REQUIRE (state_->fixedTimeline_.isValid());
-      REQUIRE (state_->procSegment_);
       
-      state->segmentation_.reset (new SegmentationTool (state->fixedTimeline_));
-      return *(state->segmentation_);
-    }
-    
-    
-    NodeCreatorTool &
-    ToolFactory::configureFabrication () //////////////////////TODO: should iterate in some way!
-    {
-      REQUIRE (state_->procSegment_);
-      REQUIRE (!isnil (*(state_>segmentation)));
+      session::Fixture & fixedTimeline_;
+      auto_ptr<engine::RenderGraph> procSegment_;
       
-      state->fabrication_.reset (new NodeCreatorTool(*this));
-      return *(state->fabrication_);
-    }
+      scoped_ptr<SegementationTool> segmentation_;
+      scoped_ptr<NodeCreatorTool> fabrication_;
+      
+      
+      BuildProcessState (session::Fixture& theTimeline)
+        : fixedTimeline_(theTimeline),
+          procSegment_(new engine::RenderGraph())
+        { }
+      
+    };
+  
+  ToolFactory::ToolFactory (session::Fixture& theTimeline)
+    : state_(new BuildProcessState (theTimeline))
+  {
+    ENSURE (state_->fixedTimeline_.isValid());
+    ENSURE (state_->procSegment_);
+  }
+  
+  
+  SegmentationTool &
+  ToolFactory::configureSegmentation ()
+  {
+    REQUIRE (state_->fixedTimeline_.isValid());
+    REQUIRE (state_->procSegment_);
     
+    state->segmentation_.reset (new SegmentationTool (state->fixedTimeline_));
+    return *(state->segmentation_);
+  }
+  
+  
+  NodeCreatorTool &
+  ToolFactory::configureFabrication () //////////////////////TODO: should iterate in some way!
+  {
+    REQUIRE (state_->procSegment_);
+    REQUIRE (!isnil (*(state_>segmentation)));
     
-    std::auto_ptr<engine::RenderGraph>
-    ToolFactory::getProduct ()
-    {
-      state_->segmentation_.reset(0);
-      state_->fabrication_.reset(0);
-      return state_->procSegment_;
-    }
-
-
-
-  } // namespace mobject::builder
-
-} // namespace mobject
+    state->fabrication_.reset (new NodeCreatorTool(*this));
+    return *(state->fabrication_);
+  }
+  
+  
+  auto_ptr<engine::RenderGraph>
+  ToolFactory::getProduct ()
+  {
+    state_->segmentation_.reset(0);
+    state_->fabrication_.reset(0);
+    return state_->procSegment_;
+  }
+  
+  
+  
+}} // namespace mobject::builder
diff --git a/src/proc/mobject/builder/toolfactory.hpp b/src/proc/mobject/builder/toolfactory.hpp
index aac40e827..b283bea60 100644
--- a/src/proc/mobject/builder/toolfactory.hpp
+++ b/src/proc/mobject/builder/toolfactory.hpp
@@ -31,44 +31,43 @@
 #include "proc/engine/rendergraph.hpp"
 
 #include <boost/scoped_ptr.hpp>
+#include <memory>
 
 
 
 namespace mobject {
-  namespace builder {
-
-    struct BuildProcessState;
-    
-
-    /**
-     * provides the builder with the necessary, preconfigured tools.
-     * Dedicated to a single build process, it holds the internal state
-     * of this process and thus serves to coordinate and link together all
-     * the individual parts fabricated by using the various tools. 
-     */
-    class ToolFactory
-      {
-        boost::scoped_ptr<BuildProcessState> state_;
-        
-      public:
-        /** prepare a builder tool kit for dealing with the given Fixture,
-         *  which is a snapshot of some timeline made explicit. */
-        ToolFactory (session::Fixture&);
-        
-        /** prepare a tool for properly segmenting the Fixture */
-        SegmentationTool &  configureSegmentation ();
-        
-        /** prepare a tool for building the render engine (graph) for a single segment */
-        NodeCreatorTool &   configureFabrication ();
-        
-        /** receive the finished product of the build process; effectively
-         *  releases any other builder tool object */
-        std::auto_ptr<engine::RenderGraph> getProduct ();
-      };
-
-
-
-  } // namespace mobject::builder
-
-} // namespace mobject
+namespace builder {
+  
+  struct BuildProcessState;
+  
+  
+  /**
+   * provides the builder with the necessary, preconfigured tools.
+   * Dedicated to a single build process, it holds the internal state
+   * of this process and thus serves to coordinate and link together all
+   * the individual parts fabricated by using the various tools.
+   */
+  class ToolFactory
+    {
+      boost::scoped_ptr<BuildProcessState> state_;
+      
+    public:
+      /** prepare a builder tool kit for dealing with the given Fixture,
+       *  which is a snapshot of some timeline made explicit. */
+      ToolFactory (session::Fixture&);
+      
+      /** prepare a tool for properly segmenting the Fixture */
+      SegmentationTool &  configureSegmentation ();
+      
+      /** prepare a tool for building the render engine (graph) for a single segment */
+      NodeCreatorTool &   configureFabrication ();
+      
+      /** receive the finished product of the build process; effectively
+       *  releases any other builder tool object */
+      std::auto_ptr<engine::RenderGraph> getProduct ();
+    };
+  
+  
+  
+}} // namespace mobject::builder
 #endif
diff --git a/tests/lib/meta/config-flags-test.cpp b/tests/lib/meta/config-flags-test.cpp
index fd1e085ed..1d11a244d 100644
--- a/tests/lib/meta/config-flags-test.cpp
+++ b/tests/lib/meta/config-flags-test.cpp
@@ -32,7 +32,7 @@
  **
  ** @see configflags.hpp
  ** @see typelistmanip.hpp
- ** @see nodewiringconfig.hpp real world usage example
+ ** @see nodewiring-config.hpp real world usage example
  **
  */
 
@@ -43,7 +43,7 @@
 #include "lib/meta/typelist-util.hpp"
 #include "lib/meta/configflags.hpp"
 #include "meta/typelist-diagnostics.hpp"
-#include "proc/engine/nodewiringconfig.hpp"
+#include "proc/engine/nodewiring-config.hpp"
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
diff --git a/tests/lib/meta/typelist-manip-test.cpp b/tests/lib/meta/typelist-manip-test.cpp
index a7e37f18b..0f28ca961 100644
--- a/tests/lib/meta/typelist-manip-test.cpp
+++ b/tests/lib/meta/typelist-manip-test.cpp
@@ -33,7 +33,7 @@
  **
  ** @see typelist-test.cpp
  ** @see typelist-util.hpp
- ** @see nodewiringconfig.hpp real world usage example
+ ** @see nodewiring-config.hpp real world usage example
  **
  */
 

From 99310dc0af8864b4d593548f02d9b1e8702c1f30 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 29 Aug 2009 18:33:46 +0200
Subject: [PATCH 275/368] WIP: continue with considerations how actually to
 build and wire an individual ProcNode

---
 src/proc/engine/nodefactory.cpp             |   7 +-
 src/proc/engine/nodefactory.hpp             |  16 ++-
 src/proc/engine/nodewiring.cpp              |  14 ++-
 src/proc/engine/nodewiring.hpp              |   2 +-
 src/proc/mobject/builder/operationpoint.cpp | 126 ++++++++++----------
 src/proc/mobject/builder/operationpoint.hpp |  72 ++++++-----
 wiki/renderengine.html                      |   4 +-
 7 files changed, 121 insertions(+), 120 deletions(-)

diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index 580fd3a90..55ee297cc 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -23,6 +23,7 @@
 
 #include "proc/engine/nodefactory.hpp"
 #include "proc/mobject/session/effect.hpp"
+#include "lib/allocationcluster.hpp"
 
 #include "proc/engine/nodewiring.hpp"
 
@@ -30,7 +31,7 @@ namespace engine {
   
   namespace { // Details of node fabrication
 
-    class Alloc {}; ///////////////TODO
+    using lib::AllocationCluster;
     
     template<class NODE>
     NODE &
@@ -47,12 +48,12 @@ namespace engine {
       
       WiringFactory* wFac;
       
-      Alloc allocator;
+      AllocationCluster allocator;
       bool doCache = (2 == 2); // find out Cache should be used for this node
       
       WiringDescriptor & wDesc = (*wFac)(setup,doCache);
       
-      NODE *newNode = new(allocator()) NODE (wDesc);   // actually this line needs to be atomic
+      NODE* newNode = allocator.create<NODE> (wDesc);
       
       return *newNode;
       
diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp
index 5850d4ae4..112f2ccc7 100644
--- a/src/proc/engine/nodefactory.hpp
+++ b/src/proc/engine/nodefactory.hpp
@@ -30,16 +30,14 @@
 
 
 namespace mobject {
-  namespace session {
+namespace session {
   
-    class Clip;
-    class Effect;
-    typedef Placement<Effect> PEffect;
-    // TODO: class Transition;
-
-  } // namespace mobject::session
-
-} // namespace mobject
+  class Clip;
+  class Effect;
+  typedef Placement<Effect> PEffect;
+  // TODO: class Transition;
+  
+}} // namespace mobject::session
 
 
 namespace engine {
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index 7b827c9fc..d4b50a6cf 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -25,6 +25,7 @@
 #include "proc/engine/nodewiring.hpp"
 #include "proc/engine/nodeoperation.hpp"
 #include "proc/engine/nodewiring-config.hpp"
+#include "lib/allocationcluster.hpp"
 
 #include "lib/meta/typelist-util.hpp"
 
@@ -40,6 +41,8 @@ namespace engine {
     using lumiera::typelist::Apply;
     using lumiera::typelist::Filter;
     
+    using lib::AllocationCluster;
+    
     
     typedef Flags<CACHING,PROCESS,INPLACE>::Tuple AllFlags;
     
@@ -56,16 +59,15 @@ namespace engine {
     
     // internal details: setting up a factory for each required configuration
     
-    class Alloc {}; ///////////////TODO
     
     
     template<class CONF>
     class WiringDescriptorFactory
       {
-        Alloc& alloc_;
+        AllocationCluster& alloc_;
         
       public:
-        WiringDescriptorFactory(Alloc& a) 
+        WiringDescriptorFactory(AllocationCluster& a) 
         : alloc_(a) {}
         
         WiringDescriptor&
@@ -79,6 +81,7 @@ namespace engine {
             
             typedef NodeWiring<InvocationStateType> Product;
             
+            ///////////////////////////////////////////////////////////////////////////////TODO: how to get the WiringInstaller here????
             Product * dummy (0);
             return *dummy;
           }
@@ -88,7 +91,7 @@ namespace engine {
     
     typedef ConfigSelector< WiringDescriptorFactory  ///< Factory template to instantiate 
                           , FunctionType            ///<  function signature of the Factory
-                          , Alloc&                 ///<   allocator fed to all factories
+                          , AllocationCluster&     ///<   allocator fed to all factories
                           > WiringSelector;
     
     
@@ -122,6 +125,9 @@ namespace engine {
   WiringFactory::operator() (WiringInstaller& setup, bool cache)
   {
     UNIMPLEMENTED ("build the actual wiring descriptor based on given operation options");
+
+            ///////////////////////////////////////////////////////////////////////////////TODO: how to get the WiringInstaller into the factory????
+    
     
 //    Bits config (FlagInfo<Config>::CODE);
 //    return pImpl_->selector[config]();
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index c906e7329..3f7474e3c 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -108,7 +108,7 @@ namespace engine {
       
     public:
       WiringDescriptor&
-      operator() (WiringInstaller& setup, bool cache);
+      operator() (WiringInstaller& setup, bool cache);  //////////////////TODO: of course this will accept *all* the relevant flags (not only "cache")
     };
   
   
diff --git a/src/proc/mobject/builder/operationpoint.cpp b/src/proc/mobject/builder/operationpoint.cpp
index b19fa967d..d08635fe5 100644
--- a/src/proc/mobject/builder/operationpoint.cpp
+++ b/src/proc/mobject/builder/operationpoint.cpp
@@ -24,73 +24,71 @@
 #include "proc/mobject/builder/operationpoint.hpp"
 #include "proc/asset/media.hpp"
 #include "proc/engine/nodefactory.hpp"
-#include "common/streamtype.hpp"
+#include "lib/streamtype.hpp"
 //#include "common/util.hpp"
 
 //#include <boost/ptr_container/ptr_vector.hpp>
 
 namespace mobject {
-  namespace builder {
-
-//    using util::isnil;
-    using engine::NodeFactory;
-    
-    using engine::PNode;
-    using lumiera::StreamType;
-    
-    
-    struct RefPoint
-      {
-        NodeFactory& alloc_;
-        
-        vector<PNode> sources_;
-        const StreamType * sType_;  //////TODO: maybe use the ChannelDescriptor??
-        
-        
-        /** just continue connecion chaining */
-        RefPoint (RefPoint const& pred)
-          : alloc_(pred.alloc_),
-            sources_(pred.sources_),
-            sType_(pred.sType_)
-          { }
-        
-        /** initiate a connection chain at a real source */
-        RefPoint (NodeFactory& nFactory, asset::Media srcMe)
-          : alloc_(nFactory),
-            sources_(establishMediaChannels (srcMe)),
-            sType_(0)
-          {
-            deriveSourceStreamType ();
-          }
-      };
-
-    
-    
-    OperationPoint::OperationPoint (NodeFactory& nFact,, asset::Media const& srcMe)
-      : refPoint_(new RefPoint (nFact, srcMetheTimeline))
-    { }
-    
-    
-    OperationPoint::OperationPoint (RefPoint const& sourcePoint)
-      : refPoint_(new RefPoint (sourcePoint))
-    { }
-    
-    
-    void
-    OperationPoint::attach (asset::PProc const& mediaProc)
+namespace builder {
+  
+//  using util::isnil;
+  using engine::NodeFactory;
+  
+  using engine::PNode;
+  using lumiera::StreamType;
+  
+  
+  struct RefPoint
     {
-      UNIMPLEMENTED ("Actually-really-finally create a node corresponding to this processing asset");
-    }
-    
-    
-    void
-    OperationPoint::join (OperationPoint& target)
-    {
-      UNIMPLEMENTED ("Actually-really-finally do a mixing output connection");
-    }
-
-
-
-  } // namespace mobject::builder
-
-} // namespace mobject
+      NodeFactory& alloc_;
+      
+      vector<PNode> sources_;
+      const StreamType * sType_;  //////TODO: maybe use the ChannelDescriptor??
+      
+      
+      /** just continue connection chaining */
+      RefPoint (RefPoint const& pred)
+        : alloc_(pred.alloc_),
+          sources_(pred.sources_),
+          sType_(pred.sType_)
+        { }
+      
+      /** initiate a connection chain at a real source */
+      RefPoint (NodeFactory& nFactory, asset::Media srcMedia)
+        : alloc_(nFactory),
+          sources_(establishMediaChannels (srcMedia)),
+          sType_(0)
+        {
+          deriveSourceStreamType ();
+        }
+    };
+  
+  
+  
+  OperationPoint::OperationPoint (NodeFactory& nFact,, asset::Media const& srcMedia)
+    : refPoint_(new RefPoint (nFact, srcMedia))
+  { }
+  
+  
+  OperationPoint::OperationPoint (RefPoint const& sourcePoint)
+    : refPoint_(new RefPoint (sourcePoint))
+  { }
+  
+  
+  void
+  OperationPoint::attach (asset::PProc const& mediaProc)
+  {
+    UNIMPLEMENTED ("Actually-really-finally create a node corresponding to this processing asset");
+  }
+  
+  
+  void
+  OperationPoint::join (OperationPoint& target)
+  {
+    UNIMPLEMENTED ("Actually-really-finally do a mixing output connection");
+  }
+  
+  
+  
+}} // namespace mobject::builder
diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp
index 28d3f9946..2e24d63fe 100644
--- a/src/proc/mobject/builder/operationpoint.hpp
+++ b/src/proc/mobject/builder/operationpoint.hpp
@@ -33,41 +33,39 @@
 
 
 namespace mobject {
-  namespace builder {
-
-    using std::vector;
-    using std::string;
-    
-    struct RefPoint;
-
-    /**
-     * A point in the render node network under construction.
-     * By means of this unspecific reference, a ProcPatt is able
-     * to deal with this location and to execute a single elementary
-     * building operation denoted by a BuildInstruct at this point.
-     * Usually, the actual point is retrieved from a Mould
-     */
-    class OperationPoint
-      {
-        boost::scoped_ptr<RefPoint> refPoint_;
-        
-      public:
-        /** create node(s) corresponding to the given Processor-Asset
-         *  and wire them as a successor to this OperationPoint; then
-         *  move this point to refer to the resulting new exit node(s)
-         */
-        void attach (asset::PProc const&);
-        
-        /** connect the output this OperationPoint refers such as to
-         *  connect or combine with the input of the already existing
-         *  nodes accessible via the target OperationPoint. 
-         */
-        void join (OperationPoint& target);
-      };
-
-
-
-  } // namespace mobject::builder
-
-} // namespace mobject
+namespace builder {
+  
+  using std::vector;
+  using std::string;
+  
+  struct RefPoint;
+  
+  /**
+   * A point in the render node network under construction.
+   * By means of this unspecific reference, a ProcPatt is able
+   * to deal with this location and to execute a single elementary
+   * building operation denoted by a BuildInstruct at this point.
+   * Usually, the actual point is retrieved from a Mould
+   */
+  class OperationPoint
+    {
+      boost::scoped_ptr<RefPoint> refPoint_;
+      
+    public:
+      /** create node(s) corresponding to the given Processor-Asset
+       *  and wire them as a successor to this OperationPoint; then
+       *  move this point to refer to the resulting new exit node(s)
+       */
+      void attach (asset::PProc const&);
+      
+      /** connect the output this OperationPoint refers such as to
+       *  connect or combine with the input of the already existing
+       *  nodes accessible via the target OperationPoint.
+       */
+      void join (OperationPoint& target);
+    };
+  
+  
+  
+}} // namespace mobject::builder
 #endif
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 8d174ed18..e6f1a9e5c 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -2298,8 +2298,8 @@ But because I know the opinions on this topc are varying (users tend to be delig
 My proposed aproach is to treat OpenGL as a separate video raw data type, requiring separete and specialized [[Processing Nodes|ProcNode]] for all calculations. Thus the Builder could connect OpenGL nodes if it is possible to cover the whole render path for preview and fall back to the normal ~ProcNodes for all relevant renders
 </pre>
 </div>
-<div title="OperationPoint" modifier="Ichthyostega" modified="200806050155" created="200805270334" tags="def impl" changecount="5">
-<pre>A low-level abstraction within the [[Builder]] &amp;mdash; it serves to encapsulate the details of making multi-channel connections between the render nodes: In some cases, a node can handle N channels internally, while in other cases we need to replicate the node N times and wire each channel individually.
+<div title="OperationPoint" modifier="Ichthyostega" modified="200908291632" created="200805270334" tags="def impl Builder" changecount="7">
+<pre>A low-level abstraction within the [[Builder]] &amp;mdash; it serves to encapsulate the details of making multi-channel connections between the render nodes: In some cases, a node can handle N channels internally, while in other cases we need to replicate the node N times and wire each channel individually. As it stands, the OperationPoint marks the ''borderline between high-level and low-level model'': it is invoked in terms of ~MObjects and other entities of the high-level view, but internally it manages to create ProcNode and similar entities of the low-level model.
 
 The operation point is provided by the current BuilderMould and used by the [[processing pattern|ProcPatt]] executing within this mould and conducting the current build step. The operation point's interface allows //to abstract//&amp;nbsp; these details, as well as to //gain additional control//&amp;nbsp; if necessary (e.g. addressing only one of the channels). The most prominent build instruction used within the processing patterns (which is the instruction {{{&quot;attach&quot;}}}) relies on the aforementioned //approach of abstracted handling,// letting the operation point determine automatically how to make the connection.
 

From 209765def5ae4276b67d84d9db6f358c787ded0f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 30 Aug 2009 14:11:14 +0200
Subject: [PATCH 276/368] WIP: correct indentation, add some comments...

---
 src/lib/meta/configflags.hpp          | 298 ++++++++--------
 src/proc/engine/nodeoperation.hpp     | 488 +++++++++++++-------------
 src/proc/engine/nodewiring-config.hpp |   7 +-
 src/proc/engine/nodewiring.cpp        |   5 +
 tests/lib/meta/config-flags-test.cpp  |   5 +-
 5 files changed, 405 insertions(+), 398 deletions(-)

diff --git a/src/lib/meta/configflags.hpp b/src/lib/meta/configflags.hpp
index f0f27012c..82d49bfc5 100644
--- a/src/lib/meta/configflags.hpp
+++ b/src/lib/meta/configflags.hpp
@@ -31,12 +31,12 @@
  ** to generate, filter and process those configurations. The final goal is to
  ** automatically generate a factory which is able to deliver objects
  ** configured according to the situation encoded in the flags.
- **
+ ** 
  ** @note currently there is an inherent limitation to configurations defined by
  ** a maximum of 5 independent flags. While it is easy to increase this limit,
  ** you should consider that the final goal is to generate template instantiations,
  ** which would lead to more and more code bloat with growing number of possible
- ** combination.
+ ** combinations.
  ** 
  ** @see proc::engine::config::Strategy usage example
  ** @see proc::engine::config::ConfigSelector 
@@ -53,153 +53,151 @@
 
 
 namespace lumiera {
-  namespace typelist {
-    
-    const size_t CONFIG_FLAGS_MAX = 5;
-
-    
-    template<char bit> struct Flag    { typedef Flag     ID; };
-    template<>         struct Flag<0> { typedef NullType ID; };
-    
-    
-    template< char f1=0
-            , char f2=0
-            , char f3=0
-            , char f4=0
-            , char f5=0
-            >
-    struct Flags        
-      { 
-        typedef typename Types< typename Flag<f1>::ID
-                              , typename Flag<f2>::ID
-                              , typename Flag<f3>::ID
-                              , typename Flag<f4>::ID
-                              , typename Flag<f5>::ID
-                              >::List       
-                              Tuple;
-        typedef Tuple List;
-      };
-    
-    
-    template< char f1=0
-            , char f2=0
-            , char f3=0
-            , char f4=0
-            , char f5=0
-            >
-    struct Config      ///< distinct type representing a configuration
-      { 
-        typedef typename Flags<f1,f2,f3,f4,f5>::Tuple  Flags;
-        typedef Flags List;
-      };
-    
-    
-    
-    template<char Fl, class CONF> 
-    struct ConfigSetFlag;       ///< set (prepend) the Flag to the given config
-    
-    template< char Fl
-            , char f1
-            , char f2
-            , char f3
-            , char f4
-            , char IGN
-            >
-    struct ConfigSetFlag<Fl, Config<f1,f2,f3,f4,IGN> >
-      {
-        typedef typelist::Config<Fl,f1,f2,f3,f4> Config;
-      };
-    
-    
-    
-    /** build a configuration type from a list-of-flags */
-    template<class FLAGS, class CONF=typelist::Config<> >
-    struct BuildConfigFromFlags
-      {
-        typedef CONF Config;
-        typedef Config Type;
-      };
-    template<char Fl, class FLAGS, class CONF>
-    struct BuildConfigFromFlags< Node<Flag<Fl>,FLAGS>, CONF>
-      { 
-        typedef typename ConfigSetFlag< Fl
-                                      , typename BuildConfigFromFlags<FLAGS,CONF>::Config
-                                      >::Config Config;
-        typedef Config Type;
-      };
-    
-    /** create a configuration type for the given list-of-flags */
-    template<class FLAGS>
-    struct DefineConfigByFlags : BuildConfigFromFlags<FLAGS> { };    
-    
-    
-    namespace {
-      /** helper comparing enum values and chars (flags) */
-      template<char ii, char jj>
-      struct maxC
-      {
-        enum{ VAL = ii < jj? jj : ii };
-      };
-    }
-    
-    
-    /** 
-     * Helper for calculating values and for
-     * invoking runtime code based on a given FlagTuple.
-     * Can also be used on a Typelist of several Configs.
-     * The latter case is typically used to invoke an operation
-     * while enumerating all Flag-Configurations defined in Code.
-     * An example would be to build (at runtime) an dispatcher table.
-     * Explanation: For the Case covering a List of Configs, we provide
-     * a templated visitation function, which can accept a functor object
-     * to be invoked on each Configuration. 
-     */
-    template<class FLAGS>
-    struct FlagInfo;
-    
-    template<char ff, class FLAGS>
-    struct FlagInfo<Node<Flag<ff>, FLAGS> >
-      {
-        enum{ BITS = maxC< ff,  FlagInfo<FLAGS>::BITS> ::VAL
-            , CODE =  (1<<ff) | FlagInfo<FLAGS>::CODE
-            }; 
-      };
-    
-    template<>
-    struct FlagInfo<NullType>
-      {
-        enum{ BITS = 0
-            , CODE = 0
-            };
-        
-        template<class FUNC>
-        static typename FUNC::Ret
-        accept (FUNC& functor)
-          {
-            return functor.done();
-          }
-      };
-    
-    template<class CONF, class TAIL>
-    struct FlagInfo<Node<CONF, TAIL> >
-      {
-        typedef typename CONF::Flags ThisFlags;
-        enum{ 
-              BITS = maxC< FlagInfo<ThisFlags>::BITS, FlagInfo<TAIL>::BITS > ::VAL
-            };
-        
-        template<class FUNC>
-        static typename FUNC::Ret
-        accept (FUNC& functor)
-          {
-            functor.template visit<CONF>(FlagInfo<ThisFlags>::CODE);
-            return FlagInfo<TAIL>::accept (functor);
-          }
-      };
-    
-    
-    
-  } // namespace typelist
+namespace typelist{
   
-} // namespace lumiera
+  const size_t CONFIG_FLAGS_MAX = 5;
+  
+  
+  template<char bit> struct Flag    { typedef Flag     ID; };
+  template<>         struct Flag<0> { typedef NullType ID; };
+  
+  
+  template< char f1=0
+          , char f2=0
+          , char f3=0
+          , char f4=0
+          , char f5=0
+          >
+  struct Flags
+    { 
+      typedef typename Types< typename Flag<f1>::ID
+                            , typename Flag<f2>::ID
+                            , typename Flag<f3>::ID
+                            , typename Flag<f4>::ID
+                            , typename Flag<f5>::ID
+                            >::List
+                            Tuple;
+      typedef Tuple List;
+    };
+  
+  
+  template< char f1=0
+          , char f2=0
+          , char f3=0
+          , char f4=0
+          , char f5=0
+          >
+  struct Config      ///< distinct type representing a configuration
+    { 
+      typedef typename Flags<f1,f2,f3,f4,f5>::Tuple  Flags;
+      typedef Flags List;
+    };
+  
+  
+  
+  template<char Fl, class CONF> 
+  struct ConfigSetFlag;       ///< set (prepend) the Flag to the given config
+  
+  template< char Fl
+          , char f1
+          , char f2
+          , char f3
+          , char f4
+          , char IGN
+          >
+  struct ConfigSetFlag<Fl, Config<f1,f2,f3,f4,IGN> >
+    {
+      typedef typelist::Config<Fl,f1,f2,f3,f4> Config;
+    };
+  
+  
+  
+  /** build a configuration type from a list-of-flags */
+  template<class FLAGS, class CONF=typelist::Config<> >
+  struct BuildConfigFromFlags
+    {
+      typedef CONF Config;
+      typedef Config Type;
+    };
+  template<char Fl, class FLAGS, class CONF>
+  struct BuildConfigFromFlags< Node<Flag<Fl>,FLAGS>, CONF>
+    { 
+      typedef typename ConfigSetFlag< Fl
+                                    , typename BuildConfigFromFlags<FLAGS,CONF>::Config
+                                    >::Config Config;
+      typedef Config Type;
+    };
+  
+  /** create a configuration type for the given list-of-flags */
+  template<class FLAGS>
+  struct DefineConfigByFlags : BuildConfigFromFlags<FLAGS> { };
+  
+  
+  namespace {
+    /** helper comparing enum values and chars (flags) */
+    template<char ii, char jj>
+    struct maxC
+    {
+      enum{ VAL = ii < jj? jj : ii };
+    };
+  }
+  
+  
+  /**
+   * Helper for calculating values and for
+   * invoking runtime code based on a given FlagTuple.
+   * Can also be used on a Typelist of several Configs.
+   * The latter case is typically used to invoke an operation
+   * while enumerating all Flag-Configurations defined in Code.
+   * An example would be to build (at runtime) an dispatcher table.
+   * Explanation: For the Case covering a List of Configs, we provide
+   * a templated visitation function, which can accept a functor object
+   * to be invoked on each Configuration.
+   */
+  template<class FLAGS>
+  struct FlagInfo;
+  
+  template<char ff, class FLAGS>
+  struct FlagInfo<Node<Flag<ff>, FLAGS> >
+    {
+      enum{ BITS = maxC< ff,  FlagInfo<FLAGS>::BITS> ::VAL
+          , CODE =  (1<<ff) | FlagInfo<FLAGS>::CODE
+          }; 
+    };
+  
+  template<>
+  struct FlagInfo<NullType>
+    {
+      enum{ BITS = 0
+          , CODE = 0
+          };
+      
+      template<class FUNC>
+      static typename FUNC::Ret
+      accept (FUNC& functor)
+        {
+          return functor.done();
+        }
+    };
+  
+  template<class CONF, class TAIL>
+  struct FlagInfo<Node<CONF, TAIL> >
+    {
+      typedef typename CONF::Flags ThisFlags;
+      enum{ 
+            BITS = maxC< FlagInfo<ThisFlags>::BITS, FlagInfo<TAIL>::BITS > ::VAL
+          };
+      
+      template<class FUNC>
+      static typename FUNC::Ret
+      accept (FUNC& functor)
+        {
+          functor.template visit<CONF>(FlagInfo<ThisFlags>::CODE);
+          return FlagInfo<TAIL>::accept (functor);
+        }
+    };
+  
+  
+  
+}} // namespace lumiera::typelist
 #endif
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index 9ab36e93c..d3a36067d 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -26,7 +26,7 @@
  ** and enables to pull a result frames from the nodes. Especially, the aspect of
  ** buffer management and cache query is covered here. Each node has been preconfigured by
  ** the builder with a WiringDescriptor and a concrete type of a StateAdapter, including
- ** a specific Configuration, because the node can be built to 
+ ** a specific Configuration, because the node can be built to
  ** - participate in the Caching or ignore the cache
  ** - actually process a result or just pull frames from a source
  ** - employ in-Place calculations or use separate in/out buffers
@@ -42,15 +42,15 @@
  ** configurations are pre-built while compiling (it's a small number below 32 configuration instance).
  ** To be able to select the Strategy for each configuration, we need a Factory (ConfigSelector defined in
  ** nodewiring-config.hpp). which is actually instantiated and used in nodewiring.cpp, which is the object
- ** file holding all those instantiations. 
- **
+ ** file holding all those instantiations.
+ ** 
  ** @see engine::ProcNode
  ** @see engine::Invocation
  ** @see engine::State
  ** @see engine::NodeFactory
  ** @see nodewiring-config.hpp
  ** @see nodewiring.hpp interface for building/wiring the nodes
- **
+ ** 
  */
 
 #ifndef ENGINE_NODEOPERATION_H
@@ -71,249 +71,249 @@
 
 
 namespace engine {
-  namespace config {
-    
-    
-    /**
-     * Base class of all concrete invocation sequences.
-     * Could contain a collection of functions used to build up the invocation sequence.
-     * Currently contains just a marker used to detect the existence of an concrete
-     * definition/specialisation for a given specific configuration.
-     */
-    class OperationBase
-      {
-        typedef lumiera::Yes_t is_defined;
-        
-        
-      };
-    
-    
-    template<class NEXT>
-    struct QueryCache : NEXT
-      {
-        BuffHandle
-        step (Invocation& ivo)
-          {
-            BuffHandle fetched = ivo.fetch (ivo.genFrameID());
-            if (fetched)
-              return fetched;
-            else
-              return NEXT::step (ivo);
-          }
-      };
-    
-    
-    template<class NEXT>
-    struct AllocBufferTable : NEXT
-      {
-        BuffHandle
-        step (Invocation& ivo)
-          {
-            BuffTableChunk buffTab (ivo.wiring, ivo.getBuffTableStorage());
-            ivo.setBuffTab(&buffTab);
-            ASSERT (ivo.buffTab);
-            ASSERT (ivo.buffTab_isConsistent());
-            
-            return NEXT::step (ivo);
-          }
-      };
-    
-    
-    template<class NEXT>
-    struct PullInput : NEXT
-      {
-        BuffHandle
-        step (Invocation& ivo)
-          {
-            BuffHandle        *   inH = ivo.buffTab->inHandle;
-            BuffHandle::PBuff *inBuff = ivo.buffTab->inBuff;
-            
-            for (uint i = 0; i < ivo.nrI(); ++i )
-              {
-                inBuff[i] =
-                  *(inH[i] = this->pullPredecessor(ivo,i)); // invoke predecessor
-                // now Input #i is ready...
-              }
-            return NEXT::step (ivo);
-          }
-      };
-    
-    
-    template<class NEXT>
-    struct ReadSource : NEXT
-      {
-        BuffHandle
-        step (Invocation& ivo)
-          {
-            BuffHandle           *inH  = ivo.buffTab->inHandle;
-            BuffHandle           *outH = ivo.buffTab->outHandle;
-            BuffHandle::PBuff *inBuff  = ivo.buffTab->inBuff;
-            BuffHandle::PBuff *outBuff = ivo.buffTab->outBuff;
-            
-            ASSERT (ivo.nrO() == ivo.nrI() );
-            
-            for (uint i = 0; i < ivo.nrI(); ++i )
-              {
-                inBuff[i] = outBuff[i] =
-                  *(inH[i] = outH[i] = this->getSource(ivo,i));
-                // now Input #i is ready...
-              }
-            return NEXT::step (ivo);
-          }
-      };
-    
-    
-    template<class NEXT>
-    struct AllocOutput : NEXT
-      {
-        BuffHandle 
-        step (Invocation& ivo)
-          {
-            ASSERT (ivo.buffTab);
-            ASSERT (ivo.nrO() < ivo.buffTabSize());
-            BuffHandle           *outH = ivo.buffTab->outHandle;
-            BuffHandle::PBuff *outBuff = ivo.buffTab->outBuff;
-            
-            for (uint i = 0; i < ivo.nrO(); ++i )
-              {
-                outBuff[i] =
-                   *(outH[i] = ivo.allocateBuffer (ivo.wiring.out[i].bufferType));
-                // now Output buffer for channel #i is available...
-              }
-            return NEXT::step (ivo);
-          }
-      };
-    
-    
-    template<class NEXT>
-    struct ProcessData : NEXT
-      {
-        BuffHandle 
-        step (Invocation& ivo)
-          {
-            ASSERT (ivo.buffTab);
-            ASSERT (ivo.buffTab_isConsistent());
-            ASSERT (this->validateBuffers(ivo));
-            
-             // Invoke our own process() function,
-            //  providing the array of outBuffer+inBuffer ptrs
-            ivo.wiring.procFunction (ivo.buffTab->outBuff);
-            
-            return NEXT::step (ivo);
-          }
-      };
-    
-    template<class NEXT>
-    struct FeedCache : NEXT
-      {
-        BuffHandle 
-        step (Invocation& ivo)
-          {
-            for (uint i = 0; i < ivo.nrO(); ++i )
-              {
-                // declare all Outputs as finished
-                ivo.is_calculated(ivo.buffTab->outHandle[i]);
-              }
-            
-            return NEXT::step (ivo);
-          }
-      };
-    
-    template<class NEXT>
-    struct ReleaseBuffers : NEXT                     /////////////////TODO: couldn't this be done automatically by BuffTab's dtor??
-      {                                             /////////////////       this would require BuffHandle to be a smart ref....
-        BuffHandle 
-        step (Invocation& ivo)
-          {
-            // all buffers besides the required Output no longer needed
-            this->releaseBuffers(ivo.buffTab->outHandle, 
-                                 ivo.buffTabSize(), 
-                                 ivo.outNr);
-            
-            return ivo.buffTab->outHandle[ivo.outNr];
-          }
-      };
-    
-    
-    
-    
-    
-    /* =============================================================== */
-    /* === declare the possible Assembly of these elementary steps === */
-    
-    enum Cases
-      { 
-        CACHING = 1,
-        PROCESS,
-        INPLACE,
-        
-        NOT_SET   = 0,
-        NUM_Cases = INPLACE
-      };
-    
-    
-    
-    template<char CACHE_Fl=0, char INPLACE_Fl=0>
-    struct SelectBuffProvider;
-    
-    template<> struct SelectBuffProvider<CACHING>         { typedef AllocBufferFromCache  Type; };
-    template<> struct SelectBuffProvider<NOT_SET,INPLACE> { typedef AllocBufferFromParent Type; };
-    template<> struct SelectBuffProvider<CACHING,INPLACE> { typedef AllocBufferFromCache  Type; };
-    template<> struct SelectBuffProvider<>                { typedef AllocBufferFromParent Type; };
+namespace config {
   
-    
-    template<class Config>
-    struct Strategy ;
   
-    using lumiera::typelist::Config;
-    
-    template<char INPLACE>
-    struct Strategy< Config<CACHING,PROCESS,INPLACE> >
-      : QueryCache<
-         AllocBufferTable<
-          PullInput<
-           AllocOutput<
-            ProcessData<
-             FeedCache<
-              ReleaseBuffers< 
-               OperationBase > > > > > > >
-      { };
-    
-    template<char INPLACE>
-    struct Strategy< Config<PROCESS,INPLACE> >
-      : AllocBufferTable<
-         PullInput<
-          AllocOutput<
-           ProcessData<
+  /**
+   * Base class of all concrete invocation sequences.
+   * Could contain a collection of functions used to build up the invocation sequence.
+   * Currently contains just a marker used to detect the existence of an concrete
+   * definition/specialisation for a given specific configuration.
+   */
+  class OperationBase
+    {
+      typedef lumiera::Yes_t is_defined;
+      
+      
+    };
+  
+  
+  template<class NEXT>
+  struct QueryCache : NEXT
+    {
+      BuffHandle
+      step (Invocation& ivo)
+        {
+          BuffHandle fetched = ivo.fetch (ivo.genFrameID());
+          if (fetched)
+            return fetched;
+          else
+            return NEXT::step (ivo);
+        }
+    };
+  
+  
+  template<class NEXT>
+  struct AllocBufferTable : NEXT
+    {
+      BuffHandle
+      step (Invocation& ivo)
+        {
+          BuffTableChunk buffTab (ivo.wiring, ivo.getBuffTableStorage());
+          ivo.setBuffTab(&buffTab);
+          ASSERT (ivo.buffTab);
+          ASSERT (ivo.buffTab_isConsistent());
+          
+          return NEXT::step (ivo);
+        }
+    };
+  
+  
+  template<class NEXT>
+  struct PullInput : NEXT
+    {
+      BuffHandle
+      step (Invocation& ivo)
+        {
+          BuffHandle        *   inH = ivo.buffTab->inHandle;
+          BuffHandle::PBuff *inBuff = ivo.buffTab->inBuff;
+          
+          for (uint i = 0; i < ivo.nrI(); ++i )
+            {
+              inBuff[i] =
+                *(inH[i] = this->pullPredecessor(ivo,i)); // invoke predecessor
+              // now Input #i is ready...
+            }
+          return NEXT::step (ivo);
+        }
+    };
+  
+  
+  template<class NEXT>
+  struct ReadSource : NEXT
+    {
+      BuffHandle
+      step (Invocation& ivo)
+        {
+          BuffHandle           *inH  = ivo.buffTab->inHandle;
+          BuffHandle           *outH = ivo.buffTab->outHandle;
+          BuffHandle::PBuff *inBuff  = ivo.buffTab->inBuff;
+          BuffHandle::PBuff *outBuff = ivo.buffTab->outBuff;
+          
+          ASSERT (ivo.nrO() == ivo.nrI() );
+          
+          for (uint i = 0; i < ivo.nrI(); ++i )
+            {
+              inBuff[i] = outBuff[i] =
+                *(inH[i] = outH[i] = this->getSource(ivo,i));
+              // now Input #i is ready...
+            }
+          return NEXT::step (ivo);
+        }
+    };
+  
+  
+  template<class NEXT>
+  struct AllocOutput : NEXT
+    {
+      BuffHandle 
+      step (Invocation& ivo)
+        {
+          ASSERT (ivo.buffTab);
+          ASSERT (ivo.nrO() < ivo.buffTabSize());
+          BuffHandle           *outH = ivo.buffTab->outHandle;
+          BuffHandle::PBuff *outBuff = ivo.buffTab->outBuff;
+          
+          for (uint i = 0; i < ivo.nrO(); ++i )
+            {
+              outBuff[i] =
+                 *(outH[i] = ivo.allocateBuffer (ivo.wiring.out[i].bufferType));
+              // now Output buffer for channel #i is available...
+            }
+          return NEXT::step (ivo);
+        }
+    };
+  
+  
+  template<class NEXT>
+  struct ProcessData : NEXT
+    {
+      BuffHandle 
+      step (Invocation& ivo)
+        {
+          ASSERT (ivo.buffTab);
+          ASSERT (ivo.buffTab_isConsistent());
+          ASSERT (this->validateBuffers(ivo));
+          
+           // Invoke our own process() function,
+          //  providing the array of outBuffer+inBuffer ptrs
+          ivo.wiring.procFunction (ivo.buffTab->outBuff);
+          
+          return NEXT::step (ivo);
+        }
+    };
+  
+  template<class NEXT>
+  struct FeedCache : NEXT
+    {
+      BuffHandle 
+      step (Invocation& ivo)
+        {
+          for (uint i = 0; i < ivo.nrO(); ++i )
+            {
+              // declare all Outputs as finished
+              ivo.is_calculated(ivo.buffTab->outHandle[i]);
+            }
+          
+          return NEXT::step (ivo);
+        }
+    };
+  
+  template<class NEXT>
+  struct ReleaseBuffers : NEXT                     /////////////////TODO: couldn't this be done automatically by BuffTab's dtor??
+    {                                             /////////////////       this would require BuffHandle to be a smart ref....
+      BuffHandle 
+      step (Invocation& ivo)
+        {
+          // all buffers besides the required Output no longer needed
+          this->releaseBuffers(ivo.buffTab->outHandle,
+                               ivo.buffTabSize(),
+                               ivo.outNr);
+          
+          return ivo.buffTab->outHandle[ivo.outNr];
+        }
+    };
+  
+  
+  
+  
+  
+  /* =============================================================== */
+  /* === declare the possible Assembly of these elementary steps === */
+  
+  enum Cases
+    { 
+      CACHING = 1,
+      PROCESS,
+      INPLACE,
+      
+      NOT_SET   = 0,
+      NUM_Cases = INPLACE
+    };
+  
+  
+  
+  template< char CACHE_Fl   =NOT_SET
+          , char INPLACE_Fl =NOT_SET
+          >
+  struct SelectBuffProvider;
+  
+  template<> struct SelectBuffProvider<CACHING>         { typedef AllocBufferFromCache  Type; };
+  template<> struct SelectBuffProvider<NOT_SET,INPLACE> { typedef AllocBufferFromParent Type; };
+  template<> struct SelectBuffProvider<CACHING,INPLACE> { typedef AllocBufferFromCache  Type; };
+  template<> struct SelectBuffProvider<>                { typedef AllocBufferFromParent Type; };
+  
+  
+  template<class Config>
+  struct Strategy ;
+  
+  using lumiera::typelist::Config;
+  
+  template<char INPLACE>
+  struct Strategy< Config<CACHING,PROCESS,INPLACE> >
+    : QueryCache<
+       AllocBufferTable<
+        PullInput<
+         AllocOutput<
+          ProcessData<
+           FeedCache<
             ReleaseBuffers< 
-             OperationBase > > > > >
-      { };
-    
-    template<>
-    struct Strategy< Config<> >
-      : AllocBufferTable<
-         ReadSource<
+             OperationBase > > > > > > >
+    { };
+  
+  template<char INPLACE>
+  struct Strategy< Config<PROCESS,INPLACE> >
+    : AllocBufferTable<
+       PullInput<
+        AllocOutput<
+         ProcessData<
           ReleaseBuffers< 
-           OperationBase > > >  
-      { };
-    
-    template<>
-    struct Strategy< Config<INPLACE> > : Strategy< Config<> >  { };
-    
-    template<>
-    struct Strategy< Config<CACHING> >
-      : AllocBufferTable<
-         ReadSource<
-          AllocOutput<
-           ProcessData<                       // wiring_.processFunction is supposed to do just buffer copying here 
-            ReleaseBuffers< 
-             OperationBase > > > > >  
-      { };
-    
-    
-    
-    
-  } // namespace config
+           OperationBase > > > > >
+    { };
   
-} // namespace engine
+  template<>
+  struct Strategy< Config<> >
+    : AllocBufferTable<
+       ReadSource<
+        ReleaseBuffers< 
+         OperationBase > > >  
+    { };
+  
+  template<>
+  struct Strategy< Config<INPLACE> > : Strategy< Config<> >  { };
+  
+  template<>
+  struct Strategy< Config<CACHING> >
+    : AllocBufferTable<
+       ReadSource<
+        AllocOutput<
+         ProcessData<                       // wiring_.processFunction is supposed to do just buffer copying here 
+          ReleaseBuffers< 
+           OperationBase > > > > >  
+    { };
+  
+  
+  
+  
+}} // namespace engine::config
 #endif
diff --git a/src/proc/engine/nodewiring-config.hpp b/src/proc/engine/nodewiring-config.hpp
index 981c1e177..d1063f8da 100644
--- a/src/proc/engine/nodewiring-config.hpp
+++ b/src/proc/engine/nodewiring-config.hpp
@@ -117,7 +117,7 @@ namespace config {
         {
           FactoryHolder(PAR p) 
             : FAC(p),
-              FacFunction( static_cast<FAC&>(*this))
+              FacFunction (static_cast<FAC&> (*this))
             { }  
         };
       
@@ -127,7 +127,9 @@ namespace config {
       
       ConfigTable possibleConfig_; ///< Table of factories
       
-      /** Helper: a visitor usable with FlagInfo */
+      
+      /** Helper: a visitor usable with FlagInfo.
+       *  Used to create a factory for each config */
       struct FactoryTableBuilder
         {
           PAR ctor_param_;
@@ -153,6 +155,7 @@ namespace config {
           void done()  {}
         };
       
+      
     public:
       template<class CONFS>
       ConfigSelector(CONFS const&, PAR factory_ctor_param)
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index d4b50a6cf..551566acc 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -61,6 +61,10 @@ namespace engine {
     
     
     
+    /**
+     * Fabricating a WiringDescriptor
+     * tailored for a specific node wiring situation.
+     */
     template<class CONF>
     class WiringDescriptorFactory
       {
@@ -138,3 +142,4 @@ namespace engine {
   
   
 } // namespace engine
+    /** preconfigured table of all possible factories */
diff --git a/tests/lib/meta/config-flags-test.cpp b/tests/lib/meta/config-flags-test.cpp
index 1d11a244d..a7cbcbe13 100644
--- a/tests/lib/meta/config-flags-test.cpp
+++ b/tests/lib/meta/config-flags-test.cpp
@@ -230,7 +230,8 @@ namespace test {
           
             struct TestVisitor
               {
-                string result;
+                string result;  ///< metafunction result
+                
                 TestVisitor() : result ("TestVisitor application:\n") {}
                 
                 /* === visitation interface === */
@@ -319,7 +320,7 @@ namespace test {
               catch (lumiera::error::Invalid& err)
                 {
                   cout << err.what() << "\n";
-                  lumiera_error (); // reset errorflag
+                  lumiera_error (); // reset error flag
                 }
             }
           

From 2a54f92a9815b63984c658c7fdc2037ca4e879fb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 30 Aug 2009 14:50:40 +0200
Subject: [PATCH 277/368] WIP: implement creation of concrete wiring descriptor

---
 src/proc/engine/nodefactory.cpp |  2 +-
 src/proc/engine/nodewiring.cpp  | 54 +++++++++++++++++++++------------
 src/proc/engine/nodewiring.hpp  | 10 ++++--
 3 files changed, 43 insertions(+), 23 deletions(-)

diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index 55ee297cc..abdbc4a01 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -42,7 +42,7 @@ namespace engine {
       
       ProcNode * predecessor1, predecessor2;
       
-      WiringInstaller setup;
+      WiringSituation setup;
       setup.defineInput (4, predecessor1, 2);
       setup.defineInput (2, predecessor2);
       
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index 551566acc..84e52c4be 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -25,7 +25,6 @@
 #include "proc/engine/nodewiring.hpp"
 #include "proc/engine/nodeoperation.hpp"
 #include "proc/engine/nodewiring-config.hpp"
-#include "lib/allocationcluster.hpp"
 
 #include "lib/meta/typelist-util.hpp"
 
@@ -56,6 +55,12 @@ namespace engine {
     typedef Filter<AllConfigs::List, Instantiation<Strategy>::Test> PossibleConfigs;
     
     
+    #define PICK_FLAG(_FLAG_) config::FlagInfo<CONF>::CODE & (_FLAG_)
+    
+    template<class CONF>
+    struct UseBufferProvider
+      : config::SelectBuffProvider< PICK_FLAG (CACHING), PICK_FLAG (INPLACE) >
+      { };
     
     // internal details: setting up a factory for each required configuration
     
@@ -70,31 +75,32 @@ namespace engine {
       {
         AllocationCluster& alloc_;
         
+        /* ==== pick actual wiring code ==== */
+        typedef Strategy<CONF> Strategy;
+        typedef typename UseBufferProvider<CONF>::Type BuffProvider;
+        typedef ActualInvocationProcess<Strategy, BuffProvider> InvocationStateType;
+        
+        // the concrete implementation of the glue code...
+        typedef NodeWiring<InvocationStateType> ActualWiring;
+        
+        
       public:
         WiringDescriptorFactory(AllocationCluster& a) 
         : alloc_(a) {}
         
         WiringDescriptor&
-        operator() ()  
+        operator() (WiringSituation const& intendedWiring)  
           { 
-            /////////////////////////////////////////////TODO
-            
-            typedef config::Strategy<CONF> Strategy;
-            typedef typename config::SelectBuffProvider<>::Type BuffProvider; ////////////////////////TODO: how to extract the required flags from CONF??
-            typedef ActualInvocationProcess<Strategy, BuffProvider> InvocationStateType;
-            
-            typedef NodeWiring<InvocationStateType> Product;
-            
-            ///////////////////////////////////////////////////////////////////////////////TODO: how to get the WiringInstaller here????
-            Product * dummy (0);
-            return *dummy;
+            return alloc_.create<ActualWiring> (intendedWiring);
           }
       };
     
-    typedef WiringDescriptor& (FunctionType)(void);
+    /** invocation signature of the factories */
+    typedef WiringDescriptor& (FunctionType)(WiringSituation const&);
     
+    /** preconfigured table of all possible factories */
     typedef ConfigSelector< WiringDescriptorFactory  ///< Factory template to instantiate 
-                          , FunctionType            ///<  function signature of the Factory
+                          , FunctionType            ///<  function signature of the Factories
                           , AllocationCluster&     ///<   allocator fed to all factories
                           > WiringSelector;
     
@@ -111,9 +117,20 @@ namespace engine {
   } // (END) internals (namespace config)
   
   
-  /////////////////////////////TODO: define the ctor
   
   
+  /** As the WiringFactory (an all the embedded factories
+   *  for the specific wiring situations) use the AllocationCluster
+   *  of the current build process, we need to create a new instance
+   *  for each newly built segment of the low-level model.
+   */
+  WiringFactory::WiringFactory (lib::AllocationCluster& a)
+    : alloc_(a),
+      pImpl_(new config::WiringFactoryImpl (alloc_))
+    { }
+      
+
+  
   /** create and configure a concrete wiring descriptor to tie
    *  a ProcNode to its predecessor nodes. This includes selecting
    *  the actual StateProxy type, configuring it out of some operation
@@ -126,11 +143,11 @@ namespace engine {
    *  the new processing node to be wired up.  
    */
   WiringDescriptor&
-  WiringFactory::operator() (WiringInstaller& setup, bool cache)
+  WiringFactory::operator() (WiringSituation& setup, bool cache)
   {
     UNIMPLEMENTED ("build the actual wiring descriptor based on given operation options");
 
-            ///////////////////////////////////////////////////////////////////////////////TODO: how to get the WiringInstaller into the factory????
+            ///////////////////////////////////////////////////////////////////////////////TODO: how to get the WiringSituation into the factory????
     
     
 //    Bits config (FlagInfo<Config>::CODE);
@@ -142,4 +159,3 @@ namespace engine {
   
   
 } // namespace engine
-    /** preconfigured table of all possible factories */
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 3f7474e3c..160625205 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -26,6 +26,7 @@
 
 
 #include "proc/engine/procnode.hpp"
+#include "lib/allocationcluster.hpp"
 
 #include <boost/noncopyable.hpp>
 #include <boost/scoped_ptr.hpp>
@@ -51,7 +52,7 @@ namespace engine {
    * and then used to initialise the wiring descriptor, which
    * in turn allows us to setup the ProcNode.  
    */
-  class WiringInstaller : boost::noncopyable
+  class WiringSituation : boost::noncopyable
     {
     public:
       RefArray<ChannelDescriptor>& makeOutDescriptor() ;
@@ -77,7 +78,7 @@ namespace engine {
     : public WiringDescriptor
     {
       
-      NodeWiring(WiringInstaller& setup)
+      NodeWiring(WiringSituation& setup)
         : WiringDescriptor(setup.makeOutDescriptor(), 
                            setup.makeInDescriptor(),
                            setup.resolveProcessingFunction(),
@@ -104,11 +105,14 @@ namespace engine {
     
   class WiringFactory
     {
+      lib::AllocationCluster& alloc_;
       boost::scoped_ptr<config::WiringFactoryImpl> pImpl_;
       
     public:
+      WiringFactory (lib::AllocationCluster& a);
+      
       WiringDescriptor&
-      operator() (WiringInstaller& setup, bool cache);  //////////////////TODO: of course this will accept *all* the relevant flags (not only "cache")
+      operator() (WiringSituation& setup, bool cache);  //////////////////TODO: of course this will accept *all* the relevant flags (not only "cache")
     };
   
   

From 5bfdf73f7df71f192b94c1a4c3ceaa6ea0ef1735 Mon Sep 17 00:00:00 2001
From: Joel Holdsworth <joel@airwebreathe.org.uk>
Date: Sun, 30 Aug 2009 16:26:27 +0100
Subject: [PATCH 278/368] Replaced gavl_time_ts with lumiera::Times

---
 src/gui/gtk-lumiera.hpp                       |  1 +
 src/gui/widgets/timeline-widget.cpp           |  5 ++--
 src/gui/widgets/timeline-widget.hpp           |  6 ++---
 src/gui/widgets/timeline/timeline-body.cpp    |  5 ++--
 .../widgets/timeline/timeline-ibeam-tool.cpp  |  5 ++--
 .../widgets/timeline/timeline-ibeam-tool.hpp  |  2 +-
 src/gui/widgets/timeline/timeline-ruler.cpp   |  3 ++-
 src/gui/widgets/timeline/timeline-ruler.hpp   |  2 +-
 src/gui/widgets/timeline/timeline-state.cpp   | 23 ++++++++--------
 src/gui/widgets/timeline/timeline-state.hpp   | 26 +++++++++----------
 .../widgets/timeline/timeline-view-window.cpp | 19 +++++++-------
 .../widgets/timeline/timeline-view-window.hpp | 10 +++----
 12 files changed, 57 insertions(+), 50 deletions(-)

diff --git a/src/gui/gtk-lumiera.hpp b/src/gui/gtk-lumiera.hpp
index 3a9b17159..fec25c9b3 100644
--- a/src/gui/gtk-lumiera.hpp
+++ b/src/gui/gtk-lumiera.hpp
@@ -39,6 +39,7 @@
 #include <boost/scoped_ptr.hpp>
 #include <boost/enable_shared_from_this.hpp>
 #include "lib/util.hpp"
+#include "lib/lumitime.hpp"
 
 #include "window-manager.hpp"
 
diff --git a/src/gui/widgets/timeline-widget.cpp b/src/gui/widgets/timeline-widget.cpp
index f4922c03e..721467536 100644
--- a/src/gui/widgets/timeline-widget.cpp
+++ b/src/gui/widgets/timeline-widget.cpp
@@ -30,6 +30,7 @@ using namespace std;
 using namespace boost;
 using namespace util;
 using namespace gui::widgets::timeline;
+using namespace lumiera;
 
 namespace gui {
 namespace widgets {
@@ -157,7 +158,7 @@ TimelineWidget::get_hovering_track() const
 
 /* ===== Signals ===== */
 
-sigc::signal<void, gavl_time_t>
+sigc::signal<void, lumiera::Time>
 TimelineWidget::mouse_hover_signal() const
 {
   return mouseHoverSignal;
@@ -187,7 +188,7 @@ TimelineWidget::on_scroll()
 {
   if(state)
     state->get_view_window().set_time_offset(
-      horizontalAdjustment.get_value());
+      Time((gavl_time_t)horizontalAdjustment.get_value()));
 }
   
 void
diff --git a/src/gui/widgets/timeline-widget.hpp b/src/gui/widgets/timeline-widget.hpp
index 4ce4d9e72..41e368947 100644
--- a/src/gui/widgets/timeline-widget.hpp
+++ b/src/gui/widgets/timeline-widget.hpp
@@ -106,7 +106,7 @@ public:
   
 public:
   /* ===== Signals ===== */
-  sigc::signal<void, gavl_time_t> mouse_hover_signal() const;
+  sigc::signal<void, lumiera::Time> mouse_hover_signal() const;
   
   sigc::signal<void> playback_period_drag_released_signal() const;
   
@@ -264,7 +264,7 @@ protected:
   Gtk::VScrollbar verticalScroll;
   
   // Signals
-  sigc::signal<void, gavl_time_t> mouseHoverSignal;
+  sigc::signal<void, lumiera::Time> mouseHoverSignal;
   sigc::signal<void> playbackPeriodDragReleasedSignal;
   sigc::signal<void, boost::shared_ptr<timeline::Track> >
     hoveringTrackChangedSignal;
@@ -277,7 +277,7 @@ public:
   /**
    * The maximum scale for timeline display.
    * @remarks At MaxScale, every pixel on the timeline is equivalent
-   * to 30000000 gavl_time_t increments.
+   * to 30000000 lumiera::Time increments.
    */ 
   static const int64_t MaxScale;
   
diff --git a/src/gui/widgets/timeline/timeline-body.cpp b/src/gui/widgets/timeline/timeline-body.cpp
index b3077f00d..44eb9a472 100644
--- a/src/gui/widgets/timeline/timeline-body.cpp
+++ b/src/gui/widgets/timeline/timeline-body.cpp
@@ -34,6 +34,7 @@
 using namespace Gtk;
 using namespace std;
 using namespace boost;
+using namespace lumiera;
 
 namespace gui {
 namespace widgets {
@@ -255,8 +256,8 @@ TimelineBody::on_motion_notify_event(GdkEventMotion *event)
             TimelineViewWindow &window = view_window();
             
             const int64_t scale = window.get_time_scale();
-            gavl_time_t offset = beginShiftTimeOffset +
-              (int64_t)(mouseDownX - event->x) * scale;
+            Time offset(beginShiftTimeOffset +
+              (int64_t)(mouseDownX - event->x) * scale);
             window.set_time_offset(offset);
             
             set_vertical_offset((int)(mouseDownY - event->y) +
diff --git a/src/gui/widgets/timeline/timeline-ibeam-tool.cpp b/src/gui/widgets/timeline/timeline-ibeam-tool.cpp
index 5aa9a3883..7e243ef7c 100644
--- a/src/gui/widgets/timeline/timeline-ibeam-tool.cpp
+++ b/src/gui/widgets/timeline/timeline-ibeam-tool.cpp
@@ -25,6 +25,7 @@
 
 using namespace boost;
 using namespace gui::widgets;
+using namespace lumiera;
 
 namespace gui {
 namespace widgets {
@@ -95,7 +96,7 @@ IBeamTool::on_button_press_event(GdkEventButton* event)
   
   if(event->button == 1)
     {
-      const gavl_time_t time =
+      const Time time =
         state->get_view_window().x_to_time(event->x);
       
       if(is_mouse_in_start_drag_zone())
@@ -187,7 +188,7 @@ IBeamTool::set_leading_x(const int x)
   shared_ptr<TimelineState> state = get_state();
 
   const bool set_playback_period = dragType == Selection;
-  const gavl_time_t time = state->get_view_window().x_to_time(x);
+  const Time time = state->get_view_window().x_to_time(x);
   if(time > pinnedDragTime)
     state->set_selection(pinnedDragTime, time, set_playback_period);
   else
diff --git a/src/gui/widgets/timeline/timeline-ibeam-tool.hpp b/src/gui/widgets/timeline/timeline-ibeam-tool.hpp
index b1ee49378..5d05b14ba 100644
--- a/src/gui/widgets/timeline/timeline-ibeam-tool.hpp
+++ b/src/gui/widgets/timeline/timeline-ibeam-tool.hpp
@@ -164,7 +164,7 @@ private:
    * the mouse, the other is pinned. pinnedDragTime specifies the time
    * of that point.
    */
-  gavl_time_t pinnedDragTime;
+  lumiera::Time pinnedDragTime;
   
   /**
    * This connection is used to represent the timer which causes scroll
diff --git a/src/gui/widgets/timeline/timeline-ruler.cpp b/src/gui/widgets/timeline/timeline-ruler.cpp
index 23d3103ac..cce311007 100644
--- a/src/gui/widgets/timeline/timeline-ruler.cpp
+++ b/src/gui/widgets/timeline/timeline-ruler.cpp
@@ -37,6 +37,7 @@ using namespace boost;
 using namespace gui;
 using namespace gui::widgets;
 using namespace gui::widgets::timeline;
+using namespace lumiera;
 
 namespace gui {
 namespace widgets {
@@ -235,7 +236,7 @@ TimelineRuler::set_leading_x(const int x)
   
   if(state)
     {
-      const gavl_time_t time = view_window().x_to_time(x);
+      const Time time = view_window().x_to_time(x);
       if(time > pinnedDragTime)
         state->set_playback_period(pinnedDragTime, time);
       else
diff --git a/src/gui/widgets/timeline/timeline-ruler.hpp b/src/gui/widgets/timeline/timeline-ruler.hpp
index 11f5be709..e47038ab1 100644
--- a/src/gui/widgets/timeline/timeline-ruler.hpp
+++ b/src/gui/widgets/timeline/timeline-ruler.hpp
@@ -198,7 +198,7 @@ private:
    * the mouse, the other is pinned. pinnedDragTime specifies the time
    * of that point.
    */
-  gavl_time_t pinnedDragTime;
+  lumiera::Time pinnedDragTime;
   
   // Indicated values
   /**
diff --git a/src/gui/widgets/timeline/timeline-state.cpp b/src/gui/widgets/timeline/timeline-state.cpp
index c15f095b5..e6a6e92c5 100644
--- a/src/gui/widgets/timeline/timeline-state.cpp
+++ b/src/gui/widgets/timeline/timeline-state.cpp
@@ -25,6 +25,7 @@
 using namespace boost;
 using namespace Gtk;
 using namespace sigc;
+using namespace lumiera;
 
 namespace gui {
 namespace widgets {
@@ -33,17 +34,17 @@ namespace timeline {
 TimelineState::TimelineState(
   boost::shared_ptr<model::Sequence> source_sequence) :
   sequence(source_sequence),
-  viewWindow(0, 1),
+  viewWindow(Time(0), 1),
   selectionStart(0),
   selectionEnd(0),
   playbackPeriodStart(0),
   playbackPeriodEnd(0),
-  playbackPoint(GAVL_TIME_UNDEFINED)
+  playbackPoint(Time(GAVL_TIME_UNDEFINED))
 {
   REQUIRE(sequence);
   
   viewWindow.set_time_scale(GAVL_TIME_SCALE / 200);
-  set_selection(2000000, 4000000);
+  set_selection(Time(2000000), Time(4000000));
 }
 
 boost::shared_ptr<model::Sequence>
@@ -58,20 +59,20 @@ TimelineState::get_view_window()
   return viewWindow;
 }
 
-gavl_time_t
+Time
 TimelineState::get_selection_start() const
 {
   return selectionStart;
 }
 
-gavl_time_t
+Time
 TimelineState::get_selection_end() const
 {
   return selectionEnd;
 }
 
 void
-TimelineState::set_selection(gavl_time_t start, gavl_time_t end,
+TimelineState::set_selection(Time start, Time end,
   bool reset_playback_period)
 {    
   if(start < end)
@@ -95,20 +96,20 @@ TimelineState::set_selection(gavl_time_t start, gavl_time_t end,
   selectionChangedSignal.emit();
 }
 
-gavl_time_t
+Time
 TimelineState::get_playback_period_start() const
 {
   return playbackPeriodStart;
 }
   
-gavl_time_t
+Time
 TimelineState::get_playback_period_end() const
 {
   return playbackPeriodEnd;
 }
   
 void
-TimelineState::set_playback_period(gavl_time_t start, gavl_time_t end)
+TimelineState::set_playback_period(Time start, Time end)
 {
   
   if(start < end)
@@ -127,13 +128,13 @@ TimelineState::set_playback_period(gavl_time_t start, gavl_time_t end)
 }
 
 void
-TimelineState::set_playback_point(gavl_time_t point)
+TimelineState::set_playback_point(Time point)
 {
   playbackPoint = point;
   playbackChangedSignal.emit();
 }
 
-gavl_time_t
+Time
 TimelineState::get_playback_point() const
 {
   return playbackPoint;
diff --git a/src/gui/widgets/timeline/timeline-state.hpp b/src/gui/widgets/timeline/timeline-state.hpp
index 2c9c07043..431173240 100644
--- a/src/gui/widgets/timeline/timeline-state.hpp
+++ b/src/gui/widgets/timeline/timeline-state.hpp
@@ -70,12 +70,12 @@ public:
   /**
    * Gets the time at which the selection begins.
    */
-  gavl_time_t get_selection_start() const;
+  lumiera::Time get_selection_start() const;
   
   /**
    * Gets the time at which the selection begins.
    */
-  gavl_time_t get_selection_end() const;
+  lumiera::Time get_selection_end() const;
   
   /**
    * Sets the period of the selection.
@@ -84,39 +84,39 @@ public:
    * @param reset_playback_period Specifies whether to set the playback
    * period to the same as this new selection.
    */
-  void set_selection(gavl_time_t start, gavl_time_t end,
+  void set_selection(lumiera::Time start, lumiera::Time end,
     bool reset_playback_period = true);
   
   /**
    * Gets the time at which the playback period begins.
    */
-  gavl_time_t get_playback_period_start() const;
+  lumiera::Time get_playback_period_start() const;
   
   /**
    * Gets the time at which the playback period ends.
    */
-  gavl_time_t get_playback_period_end() const;
+  lumiera::Time get_playback_period_end() const;
   
   /**
    * Sets the playback period.
    * @param start The start time.
    * @param end The end time.
    */
-  void set_playback_period(gavl_time_t start, gavl_time_t end);
+  void set_playback_period(lumiera::Time start, lumiera::Time end);
   
   /**
    * Sets the time which is currenty being played back.
    * @param point The time index being played. This value may be
    * GAVL_TIME_UNDEFINED, if there is no playback point.
    */
-  void set_playback_point(gavl_time_t point);
+  void set_playback_point(lumiera::Time point);
   
   /**
    * Gets the current playback point.
    * @return The time index of the playback point. This value may be
    * GAVL_TIME_UNDEFINED, if there is no playback point.
    */
-  gavl_time_t get_playback_point() const;
+  lumiera::Time get_playback_point() const;
   
   /**
    * A signal to notify when the selected period has changed.
@@ -150,27 +150,27 @@ private:
   /**
    * The start time of the selection period.
    **/
-  gavl_time_t selectionStart;
+  lumiera::Time selectionStart;
   
   /**
    * The end time of the selection period.
    **/
-  gavl_time_t selectionEnd;
+  lumiera::Time selectionEnd;
   
   /**
    * The start time of the playback period.
    **/
-  gavl_time_t playbackPeriodStart;
+  lumiera::Time playbackPeriodStart;
   
   /**
    * The end time of the playback period.
    **/
-  gavl_time_t playbackPeriodEnd;
+  lumiera::Time playbackPeriodEnd;
   
   /**
    * The time of the playback point.
    **/
-  gavl_time_t playbackPoint;
+  lumiera::Time playbackPoint;
   
   // Signals
   
diff --git a/src/gui/widgets/timeline/timeline-view-window.cpp b/src/gui/widgets/timeline/timeline-view-window.cpp
index 3eb469b7e..e5283a24a 100644
--- a/src/gui/widgets/timeline/timeline-view-window.cpp
+++ b/src/gui/widgets/timeline/timeline-view-window.cpp
@@ -25,26 +25,27 @@
 
 using namespace Gtk;
 using namespace gui::widgets;
+using namespace lumiera;
 
 namespace gui {
 namespace widgets {
 namespace timeline {
 
 TimelineViewWindow::TimelineViewWindow(
-  gavl_time_t offset, int64_t scale) :
+  Time offset, int64_t scale) :
   timeOffset(offset),
   timeScale(scale)
 {
 }
 
-gavl_time_t
+Time
 TimelineViewWindow::get_time_offset() const
 {
   return timeOffset;
 }
 
 void
-TimelineViewWindow::set_time_offset(gavl_time_t offset)
+TimelineViewWindow::set_time_offset(Time offset)
 {
   timeOffset = offset;
   changedSignal.emit();
@@ -80,8 +81,8 @@ TimelineViewWindow::zoom_view(int point, int zoom_size)
     new_time_scale = TimelineWidget::MaxScale;
   
   // The view must be shifted so that the zoom is centred on the cursor
-  set_time_offset(get_time_offset() +
-    (timeScale - new_time_scale) * point);
+  set_time_offset(Time((gavl_time_t)get_time_offset() +
+    (timeScale - new_time_scale) * point));
     
   // Apply the new scale
   set_time_scale(new_time_scale);
@@ -90,8 +91,8 @@ TimelineViewWindow::zoom_view(int point, int zoom_size)
 void
 TimelineViewWindow::shift_view(int view_width, int shift_size)
 {
-  set_time_offset(get_time_offset() +
-    shift_size * timeScale * view_width / 256);
+  set_time_offset(Time((gavl_time_t)get_time_offset() +
+    shift_size * timeScale * view_width / 256));
 }
 
 int
@@ -100,10 +101,10 @@ TimelineViewWindow::time_to_x(gavl_time_t time) const
   return (int)((time - timeOffset) / timeScale);
 }
 
-gavl_time_t
+Time
 TimelineViewWindow::x_to_time(int x) const
 {
-  return (gavl_time_t)((int64_t)x * timeScale + timeOffset);
+  return Time((gavl_time_t)((int64_t)x * timeScale + timeOffset));
 }
 
 sigc::signal<void>
diff --git a/src/gui/widgets/timeline/timeline-view-window.hpp b/src/gui/widgets/timeline/timeline-view-window.hpp
index d1e1039ad..8689b6ce6 100644
--- a/src/gui/widgets/timeline/timeline-view-window.hpp
+++ b/src/gui/widgets/timeline/timeline-view-window.hpp
@@ -50,19 +50,19 @@ public:
    * @param offset The initial view offset.
    * @param scale The initial scale.
    **/
-  TimelineViewWindow(gavl_time_t offset, int64_t scale);
+  TimelineViewWindow(lumiera::Time offset, int64_t scale);
     
   /**
    * Gets the time offset. This is the time value displaid at the
    * left-hand edge of the timeline body area.
    */
-  gavl_time_t get_time_offset() const;
+  lumiera::Time get_time_offset() const;
 
   /**
    * Sets the time offset. This is the time value displaid at the
    * left-hand edge of the timeline body area.
    */
-  void set_time_offset(gavl_time_t time_offset);
+  void set_time_offset(lumiera::Time time_offset);
   
   /**
    * Gets the time scale value.
@@ -108,7 +108,7 @@ public:
    * the timeline body) to convert.
    * @return Returns the time at the coordinate.
    **/
-  gavl_time_t x_to_time(int x) const;
+  lumiera::Time x_to_time(int x) const;
   
   /**
    * A signal to indicate that the scale or offset have been changed.
@@ -116,7 +116,7 @@ public:
   sigc::signal<void> changed_signal() const; 
 
 private:
-  gavl_time_t timeOffset;
+  lumiera::Time timeOffset;
   int64_t timeScale;
   
   sigc::signal<void> changedSignal;

From c89726e2d8288ae4f06669e078c830a9fb9742a8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 31 Aug 2009 00:49:08 +0200
Subject: [PATCH 279/368] WIP set up some new tests for brainstorming...

---
 tests/46engine.tests                          |  14 +-
 tests/components/Makefile.am                  |   7 +-
 .../proc/engine/buff-table-test.cpp           | 179 +++++++++++++++++
 .../components/proc/engine/bufftabletest.cpp  | 181 ------------------
 .../proc/engine/node-basic-test.cpp           |  59 ++++++
 .../proc/engine/node-fabrication-test.cpp     |  59 ++++++
 .../proc/engine/node-operation-test.cpp       |  59 ++++++
 ...ourcenodetest.cpp => node-source-test.cpp} |  52 +++--
 8 files changed, 398 insertions(+), 212 deletions(-)
 create mode 100644 tests/components/proc/engine/buff-table-test.cpp
 delete mode 100644 tests/components/proc/engine/bufftabletest.cpp
 create mode 100644 tests/components/proc/engine/node-basic-test.cpp
 create mode 100644 tests/components/proc/engine/node-fabrication-test.cpp
 create mode 100644 tests/components/proc/engine/node-operation-test.cpp
 rename tests/components/proc/engine/{sourcenodetest.cpp => node-source-test.cpp} (64%)

diff --git a/tests/46engine.tests b/tests/46engine.tests
index f2059ab32..b5464d3e0 100644
--- a/tests/46engine.tests
+++ b/tests/46engine.tests
@@ -7,5 +7,17 @@ return: 0
 END
 
 
-PLANNED "SourceNode_test" SourceNode_test <<END
+PLANNED "Proc Node basics" NodeBasic_test <<END
+END
+
+
+PLANNED "Proc Node fabrication" NodeFabrication_test <<END
+END
+
+
+PLANNED "Proc Node operation modes" NodeOperation_test <<END
+END
+
+
+PLANNED "source reading Node" NodeSource_test <<END
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 560e8b1f5..616989f55 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -56,8 +56,11 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-registry-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
-	$(testcomponents_srcdir)/proc/engine/bufftabletest.cpp			\
-	$(testcomponents_srcdir)/proc/engine/sourcenodetest.cpp         	\
+	$(testcomponents_srcdir)/proc/engine/buff-table-test.cpp		\
+	$(testcomponents_srcdir)/proc/engine/node-basic-test.cpp         	\
+	$(testcomponents_srcdir)/proc/engine/node-fabrication-test.cpp         	\
+	$(testcomponents_srcdir)/proc/engine/node-operation-test.cpp         	\
+	$(testcomponents_srcdir)/proc/engine/node-source-test.cpp         	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildertooltest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/builder/buildsegmenttest.cpp	\
 	$(testcomponents_srcdir)/proc/mobject/controller/rendersegmenttest.cpp	\
diff --git a/tests/components/proc/engine/buff-table-test.cpp b/tests/components/proc/engine/buff-table-test.cpp
new file mode 100644
index 000000000..fc55457b0
--- /dev/null
+++ b/tests/components/proc/engine/buff-table-test.cpp
@@ -0,0 +1,179 @@
+/*
+  BuffTable(Test)  -  check consistency of buffer table chunk allocation
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/error.hpp"
+
+#include "proc/engine/procnode.hpp"
+#include "proc/engine/bufftable.hpp"
+#include "lib/refarray.hpp"
+
+#include <boost/scoped_ptr.hpp>
+#include <iostream>
+#include <ctime>
+
+using test::Test;
+using std::cout;
+using std::rand;
+
+
+namespace engine{
+namespace test  {
+
+  namespace { // used internally
+    
+    const uint TABLE_SIZ = 100000;
+    const uint CHUNK_MAX = 8000;
+    const uint WIDTH_MAX = 3;
+    
+    
+    /** just some crap to pass in as ctor argument... */
+    template<class E>
+    struct DummyArray : lib::RefArray<E>
+      {
+        E decoy;
+        E const& operator[] (size_t)  const  { return decoy; }
+        size_t size()                 const  { return CHUNK_MAX;}
+      };
+    DummyArray<ChannelDescriptor> dummy1;
+    DummyArray<InChanDescriptor>  dummy2;
+    
+    
+    /** a "hijacked" WiringDescriptor requesting
+     *  a random number of inputs and outputs */
+    struct MockSizeRequest
+      : WiringDescriptor
+      {
+        uint ii,oo;
+        
+        MockSizeRequest()
+          : WiringDescriptor(dummy1,dummy2,0,NodeID()),
+            ii(rand() % CHUNK_MAX),
+            oo(rand() % CHUNK_MAX)
+          { }
+        
+        virtual uint getNrI()  const { return ii; }
+        virtual uint getNrO()  const { return oo; }
+        
+        virtual BuffHandle callDown (State&, uint) const
+        { throw lumiera::Error("not intended to be called"); }
+      };
+    
+    
+    
+    void*
+    detect_start_level (BuffTableStorage& sto)
+    {
+      return BuffTableChunk(MockSizeRequest(), sto ).outHandle;
+    }       // address of first available storage element
+    
+    
+    inline void*
+    first_behind (BuffTable const& thisChunk, const uint nrI)
+    {
+      return &thisChunk.inHandle[nrI];
+    }
+    
+    
+    inline bool
+    not_within(void* candidate, void* lower, void* upper)
+    {
+      return (candidate < lower) || (upper <= candidate);
+    }
+    
+    
+    bool
+    consistencyCheck (BuffTable const& b, WiringDescriptor const& num, void* lastLevel)
+    {
+      return (b.outHandle == lastLevel )  // storage is allocated continuously
+          && (b.outBuff   <= b.inBuff  )  // input slots are behind the output slots
+          && (b.outHandle <= b.inHandle)
+          && (b.inBuff   == &b.outBuff  [num.getNrO()])
+          && (b.inHandle == &b.outHandle[num.getNrO()])
+          && (not_within(b.outBuff, b.outHandle, &b.inHandle[num.getNrO()])) // storage doesn't overlap
+          && (not_within(b.inBuff,  b.outHandle, &b.inHandle[num.getNrO()]))
+          && (not_within(b.outHandle, b.outBuff, &b.inBuff[num.getNrO()]))
+          && (not_within(b.inHandle,  b.outBuff, &b.inBuff[num.getNrO()]))
+           ;
+    }
+  } // (End) internal defs
+  
+  
+  
+  /*******************************************************************
+   * @test create a random pattern of recursive invocations, each
+   *       allocating a chunk out of a global buffer table storage.
+   *       After returning, each allocation should be cleanly
+   *       deallocated and the internal level in the storage vector
+   *       should have doped to zero again.
+   */
+  class BuffTable_test : public Test
+    {
+      typedef boost::scoped_ptr<BuffTableStorage> PSto;
+      
+      PSto pStorage;
+      ulong counter;
+      
+      virtual void run(Arg) 
+        {
+           counter = 0;
+           std::srand (time (NULL));
+           
+           // allocate storage block to be used chunk wise
+           pStorage.reset (new BuffTableStorage (TABLE_SIZ));
+           
+           invocation (0, detect_start_level(*pStorage));
+           
+           pStorage.reset(0);  // dtor throws assertion error if corrupted
+           
+           cout << "BuffTable chunks allocated: "<<counter<< "\n";
+        }
+      
+      
+      /** recurse down randomly
+       *  until exhausting storage
+       */
+      void invocation (uint consumed, void* lastLevel)
+        {
+          MockSizeRequest numbers;
+          consumed += numbers.getNrI()+numbers.getNrO();
+          if (TABLE_SIZ <= consumed)
+            return; // end recursion
+          
+          ++counter;
+          BuffTableChunk thisChunk (numbers, *pStorage);
+          ASSERT (consistencyCheck (thisChunk, numbers, lastLevel));
+          
+          uint nrBranches ( 1 + (rand() % WIDTH_MAX));
+          while (nrBranches--)
+            invocation (consumed, first_behind (thisChunk,numbers.getNrI()));
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (BuffTable_test, "unit engine");
+  
+  
+  
+}} // namespace engine::test
diff --git a/tests/components/proc/engine/bufftabletest.cpp b/tests/components/proc/engine/bufftabletest.cpp
deleted file mode 100644
index 3e71372b7..000000000
--- a/tests/components/proc/engine/bufftabletest.cpp
+++ /dev/null
@@ -1,181 +0,0 @@
-/*
-  BuffTable(Test)  -  check consistency of buffer table chunk allocation
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-* *****************************************************/
-
-
-#include "lib/test/run.hpp"
-#include "lib/error.hpp"
-
-#include "proc/engine/procnode.hpp"
-#include "proc/engine/bufftable.hpp"
-#include "lib/refarray.hpp"
-
-#include <boost/scoped_ptr.hpp>
-#include <iostream>
-#include <ctime>
-
-using test::Test;
-using std::cout;
-using std::rand;
-
-
-namespace engine {
-  namespace test {
-  
-    namespace { // used internally
-      
-      const uint TABLE_SIZ = 100000;
-      const uint CHUNK_MAX = 8000;
-      const uint WIDTH_MAX = 3;
-      
-      
-      /** just some crap to pass in as ctor argument... */
-      template<class E>
-      struct DummyArray : lib::RefArray<E>
-        {
-          E decoy;
-          E const& operator[] (size_t)  const  { return decoy; }
-          size_t size()                 const  { return CHUNK_MAX;}
-        };
-      DummyArray<ChannelDescriptor> dummy1;
-      DummyArray<InChanDescriptor>  dummy2;
-      
-      
-      /** a "hijacked" WiringDescriptor requesting
-       *  a random number of inputs and outputs */
-      struct MockSizeRequest
-        : WiringDescriptor
-        {
-          uint ii,oo;
-          
-          MockSizeRequest()
-            : WiringDescriptor(dummy1,dummy2,0,NodeID()),
-              ii(rand() % CHUNK_MAX),
-              oo(rand() % CHUNK_MAX)
-            { }
-          
-          virtual uint getNrI()  const { return ii; }
-          virtual uint getNrO()  const { return oo; }
-          
-          virtual BuffHandle callDown (State&, uint) const
-          { throw lumiera::Error("not intended to be called"); }
-        };
-      
-      
-      
-      void*
-      detect_start_level (BuffTableStorage& sto)
-      {
-        return BuffTableChunk(MockSizeRequest(), sto ).outHandle;
-      }       // address of first available storage element
-      
-      
-      inline void*
-      first_behind (BuffTable const& thisChunk, const uint nrI)
-      {
-        return &thisChunk.inHandle[nrI];
-      }
-      
-      
-      inline bool
-      not_within(void* candidate, void* lower, void* upper)
-      {
-        return (candidate < lower) || (upper <= candidate);
-      }
-      
-      
-      bool
-      consistencyCheck (BuffTable const& b, WiringDescriptor const& num, void* lastLevel)
-      {
-        return (b.outHandle == lastLevel )  // storage is allocated continuously
-            && (b.outBuff   <= b.inBuff  )  // input slots are behind the output slots
-            && (b.outHandle <= b.inHandle)
-            && (b.inBuff   == &b.outBuff  [num.getNrO()])
-            && (b.inHandle == &b.outHandle[num.getNrO()])
-            && (not_within(b.outBuff, b.outHandle, &b.inHandle[num.getNrO()])) // storage doesn't overlap
-            && (not_within(b.inBuff,  b.outHandle, &b.inHandle[num.getNrO()]))
-            && (not_within(b.outHandle, b.outBuff, &b.inBuff[num.getNrO()]))
-            && (not_within(b.inHandle,  b.outBuff, &b.inBuff[num.getNrO()]))
-             ;
-      }
-    } // (End) internal defs
-    
-    
-    
-    /*******************************************************************
-     * @test create a random pattern of recursive invocations, each
-     *       allocating a chunk out of a global buffer table storage.
-     *       After returning, each allocation should be cleanly
-     *       deallocated and the internal level in the storage vector
-     *       should have doped to zero again.
-     */
-    class BuffTable_test : public Test
-      {
-        typedef boost::scoped_ptr<BuffTableStorage> PSto;
-        
-        PSto pStorage;
-        ulong counter;
-        
-        virtual void run(Arg) 
-          {
-             counter = 0;
-             std::srand (time (NULL));
-             
-             // allocate storage block to be used chunk wise
-             pStorage.reset (new BuffTableStorage (TABLE_SIZ));
-             
-             invocation (0, detect_start_level(*pStorage));
-             
-             pStorage.reset(0);  // dtor throws assertion error if corrupted
-             
-             cout << "BuffTable chunks allocated: "<<counter<< "\n";
-          }
-        
-        
-        /** recurse down randomly
-         *  until exhausting storage 
-         */
-        void invocation (uint consumed, void* lastLevel)
-          {
-            MockSizeRequest numbers;
-            consumed += numbers.getNrI()+numbers.getNrO();
-            if (TABLE_SIZ <= consumed)
-              return; // end recursion
-            
-            ++counter;
-            BuffTableChunk thisChunk (numbers, *pStorage);
-            ASSERT (consistencyCheck (thisChunk, numbers, lastLevel));
-            
-            uint nrBranches ( 1 + (rand() % WIDTH_MAX));
-            while (nrBranches--)
-              invocation (consumed, first_behind (thisChunk,numbers.getNrI()));
-          }
-      };
-    
-    
-    /** Register this test class... */
-    LAUNCHER (BuffTable_test, "unit engine");
-    
-    
-    
-  } // namespace test
-
-} // namespace engine
diff --git a/tests/components/proc/engine/node-basic-test.cpp b/tests/components/proc/engine/node-basic-test.cpp
new file mode 100644
index 000000000..7581ea41e
--- /dev/null
+++ b/tests/components/proc/engine/node-basic-test.cpp
@@ -0,0 +1,59 @@
+/*
+  NodeBasic(Test)  -  unit test covering render node basic lifecycle and usage
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/factory.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+#include <iostream>
+
+//using boost::format;
+using std::string;
+using std::cout;
+
+
+namespace engine{
+namespace test  {
+  
+  
+  
+  
+  /*******************************************************************
+   * @test basic render node properties and behaviour.
+   */
+  class NodeBasic_test : public Test
+    {
+      virtual void run(Arg) 
+        {
+          UNIMPLEMENTED ("build a simple render node and then activate it");
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (NodeBasic_test, "unit engine");
+  
+  
+  
+}} // namespace engine::test
diff --git a/tests/components/proc/engine/node-fabrication-test.cpp b/tests/components/proc/engine/node-fabrication-test.cpp
new file mode 100644
index 000000000..5827a77df
--- /dev/null
+++ b/tests/components/proc/engine/node-fabrication-test.cpp
@@ -0,0 +1,59 @@
+/*
+  NodeFabrication(Test)  -  building render nodes
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/factory.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+#include <iostream>
+
+//using boost::format;
+using std::string;
+using std::cout;
+
+
+namespace engine{
+namespace test  {
+  
+  
+  
+  
+  /*******************************************************************
+   * @test creating and wiring various kinds of render nodes.
+   */
+  class NodeFabrication_test : public Test
+    {
+      virtual void run(Arg) 
+        {
+          UNIMPLEMENTED ("build and wire some render nodes");
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (NodeFabrication_test, "unit engine");
+  
+  
+  
+}} // namespace engine::test
diff --git a/tests/components/proc/engine/node-operation-test.cpp b/tests/components/proc/engine/node-operation-test.cpp
new file mode 100644
index 000000000..f83c3eaf5
--- /dev/null
+++ b/tests/components/proc/engine/node-operation-test.cpp
@@ -0,0 +1,59 @@
+/*
+  NodeOperation(Test)  -  verify proper render node operation and calldown
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/factory.hpp"
+//#include "lib/util.hpp"
+
+//#include <boost/format.hpp>
+#include <iostream>
+
+//using boost::format;
+using std::string;
+using std::cout;
+
+
+namespace engine{
+namespace test  {
+  
+  
+  
+  
+  /*******************************************************************
+   * @test check render node operation modes and collaboration.
+   */
+  class NodeOperation_test : public Test
+    {
+      virtual void run(Arg) 
+        {
+          UNIMPLEMENTED ("operate some render nodes as linked together");
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (NodeOperation_test, "unit engine");
+  
+  
+  
+}} // namespace engine::test
diff --git a/tests/components/proc/engine/sourcenodetest.cpp b/tests/components/proc/engine/node-source-test.cpp
similarity index 64%
rename from tests/components/proc/engine/sourcenodetest.cpp
rename to tests/components/proc/engine/node-source-test.cpp
index 47530f894..7a3b52f23 100644
--- a/tests/components/proc/engine/sourcenodetest.cpp
+++ b/tests/components/proc/engine/node-source-test.cpp
@@ -1,5 +1,5 @@
 /*
-  SourceNode(Test)  -  unit test of the source reading render node
+  NodeSource(Test)  -  unit test of the source reading render node
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
@@ -33,31 +33,27 @@ using std::string;
 using std::cout;
 
 
-namespace engine
-  {
-  namespace test
+namespace engine{
+namespace test  {
+  
+  
+  
+  
+  /*******************************************************************
+   * @test the source reading render node.
+   */
+  class NodeSource_test : public Test
     {
-    
-    
-    
-    
-    /*******************************************************************
-     * @test the source reading render node.
-     */
-    class SourceNode_test : public Test
-      {
-        virtual void run(Arg) 
-          {
-            UNIMPLEMENTED ("render node pulling source data from backend");
-          } 
-      };
-    
-    
-    /** Register this test class... */
-    LAUNCHER (SourceNode_test, "unit engine");
-    
-    
-    
-  } // namespace test
-
-} // namespace engine
+      virtual void run(Arg) 
+        {
+          UNIMPLEMENTED ("render node pulling source data from backend");
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (NodeSource_test, "unit engine");
+  
+  
+  
+}} // namespace engine::test

From ddb8805a73cde3409863e1050b32202ebfa17540 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 31 Aug 2009 01:32:53 +0200
Subject: [PATCH 280/368] WIP attempt to nail down a very simple example...

---
 src/proc/engine/nodeinvocation.hpp            |  2 +-
 src/proc/engine/render-invocation.hpp         | 84 +++++++++++++++++++
 .../proc/engine/node-basic-test.cpp           | 45 +++++++++-
 wiki/renderengine.html                        |  6 +-
 4 files changed, 130 insertions(+), 7 deletions(-)
 create mode 100644 src/proc/engine/render-invocation.hpp

diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index bbe0aef93..849e5ca30 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -1,5 +1,5 @@
 /*
-  NODEINVOCATION.hpp  -  Organize the invocation state within a single pull() call
+  NODEINVOCATION.hpp  -  Organise the invocation state within a single pull() call
  
   Copyright (C)         Lumiera.org
     2008,               Hermann Vosseler <Ichthyostega@web.de>
diff --git a/src/proc/engine/render-invocation.hpp b/src/proc/engine/render-invocation.hpp
new file mode 100644
index 000000000..963df8058
--- /dev/null
+++ b/src/proc/engine/render-invocation.hpp
@@ -0,0 +1,84 @@
+/*
+  RENDER-INVOCATION.hpp  -  initiate the rendering of a single frame
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file render-invocation.hpp
+ ** Initiate a single calculation unit within the renderengine.
+ ** Usually, this will cause the rendering of a single frame or sub-frame.
+ **
+ ** @see engine::ProcNode
+ ** @see State
+ ** @see node-basic-test.cpp
+ **
+ */
+
+#ifndef ENGINE_RENDER_INVOCATION_H
+#define ENGINE_RENDER_INVOCATION_H
+
+
+#include "proc/state.hpp"
+//#include "proc/engine/procnode.hpp"
+//#include "proc/engine/buffhandle.hpp"
+//#include "proc/engine/bufftable.hpp"
+
+
+
+
+namespace engine {
+  
+  
+  /**
+   * TODO: type comment
+   */
+  class RenderInvocation
+    : public State
+    {
+    protected:
+//      State& parent_;
+//      State& current_;
+      
+      RenderInvocation()
+        { }
+      
+      virtual State& getCurrentImplementation () { return current_; }
+      
+      
+      
+    public: /* === proxying the State interface === */
+      
+//      virtual void releaseBuffer (BuffHandle& bh)       { current_.releaseBuffer (bh); }
+      
+//      virtual void is_calculated (BuffHandle const& bh) { current_.is_calculated (bh); }
+      
+//      virtual BuffHandle fetch (FrameID const& fID)     { return current_.fetch (fID); }
+      
+      // note: allocateBuffer()  is chosen specifically based on the actual node wiring
+      
+    };
+  
+  ///////////////////////////////////TODO: currently just fleshing out the API
+  
+  
+  
+  
+  
+} // namespace engine
+#endif
diff --git a/tests/components/proc/engine/node-basic-test.cpp b/tests/components/proc/engine/node-basic-test.cpp
index 7581ea41e..bf36e3bf6 100644
--- a/tests/components/proc/engine/node-basic-test.cpp
+++ b/tests/components/proc/engine/node-basic-test.cpp
@@ -24,20 +24,45 @@
 #include "lib/test/run.hpp"
 //#include "lib/factory.hpp"
 //#include "lib/util.hpp"
+#include "proc/engine/nodefactory.hpp"
+#include "proc/engine/nodewiring.hpp"
+#include "proc/engine/render-invocation.hpp"
+#include "proc/mobject/session/effect.hpp"
+#include "lib/allocationcluster.hpp"
 
 //#include <boost/format.hpp>
-#include <iostream>
+//#include <iostream>
 
 //using boost::format;
-using std::string;
-using std::cout;
+//using std::string;
+//using std::cout;
 
 
 namespace engine{
 namespace test  {
   
+  using lib::AllocationCluster;
+  using mobject::session::PEffect;
   
   
+  namespace { // Test fixture
+    
+    /**
+     * Mock State/Invocation object.
+     * Used as a replacement for the real RenderInvocation,
+     * so the test can verify that calculations are actually
+     * happening in correct order.
+     */
+    class TestContext
+      : public RenderInvocation
+      {
+        
+        //////////////TODO: facility to verify the right access operations get called
+        
+      };
+  
+  }
+  
   
   /*******************************************************************
    * @test basic render node properties and behaviour.
@@ -47,6 +72,20 @@ namespace test  {
       virtual void run(Arg) 
         {
           UNIMPLEMENTED ("build a simple render node and then activate it");
+          
+          AllocationCluster alloc;
+          NodeFactory nodeFab(alloc);
+          
+          PEffect pEffect;  /////////////////TODO how to get an simple Effect MObject for Tests???
+          WiringSituation setup;
+          
+          ProcNode* pNode = nodeFab (pEffect, setup);
+          ASSERT (pNode);
+          
+          TestContext simulatedInvocation;
+          pNode->pull(simulatedInvocation, 0);
+          
+          // ASSERT we got calculated data in the result buffer
         } 
     };
   
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index e6f1a9e5c..0e51d4faa 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -3877,9 +3877,9 @@ Consequently, as we can't get away with an fixed Enum of all stream prototypes,
 NTSC and PAL video, video versus digitized film, HD video versus SD video, 3D versus flat video, cinemascope versus 4:3, stereophonic versus monaural, periphonic versus panoramic sound, Ambisonics versus 5.1, dolby versus linear PCM...
 </pre>
 </div>
-<div title="StreamType" modifier="Ichthyostega" modified="200809280108" created="200808060244" tags="spec discuss draft" changecount="9">
+<div title="StreamType" modifier="Ichthyostega" modified="200908302143" created="200808060244" tags="spec discuss draft" changecount="11">
 <pre>//how to classify and describe media streams//
-Media data is understood to appear structured as stream(s) over time. While there may be an inherent internal structuring, at a given perspective ''any stream is a unit and homogeneous''. In the context of digital media data processing, streams are always ''quantized'', which means they appear as a temporal sequence of data chunks called ''frames''.
+Media data is supposed to appear structured as stream(s) over time. While there may be an inherent internal structuring, at a given perspective ''any stream is a unit and homogeneous''. In the context of digital media data processing, streams are always ''quantized'', which means they appear as a temporal sequence of data chunks called ''frames''.
 
 ! Terminology
 * __Media__ is comprised of a set of streams or channels
@@ -3900,7 +3900,7 @@ A stream type is denoted by a StreamTypeID, which is an identifier, acting as an
 Within the Proc-Layer, media streams are treated largely in a similar manner. But, looking closer, note everything can be connected together, while on the other hand there may be some classes of media streams which can be considered //equivalent// in most respects. Thus, it seems reasonable to separate the distinction between various media streams into several levels
 * Each media belongs to a fundamental ''kind'' of media, examples being __Video__, __Image__, __Audio__, __MIDI__,... Media streams of different kind can be considered somewhat &quot;completely separate&quot; &amp;mdash; just the handling of each of those media kinds follows a common //generic pattern// augmented with specialisations. Basically, it is //impossible to connect// media streams of different kind. Under some circumstances there may be the possibility of a //transformation// though. For example, a still image can be incorporated into video, sound may be visualized, MIDI may control a sound synthesizer.
 * Below the level of distinct kinds of media streams, within every kind we have an open ended collection of ''prototypes'', which, when compared directly, may each be quite distinct and different, but which may be //rendered//&amp;nbsp; into each other. For example, we have stereoscopic (3D) video and we have the common flat video lacking depth information, we have several spatial audio systems (Ambisonics, Wave Field Synthesis), we have panorama simulating sound systems (5.1, 7.1,...), we have common stereophonic and monaural audio. It is considered important to retain some openness and configurability within this level of distinction, which means this classification should better be done by rules then by setting up a fixed property table. For example, it may be desirable for some production to distinguish between digitized film and video NTSC and PAL, while in another production everything is just &quot;video&quot; and can be converted automatically. The most noticeable consequence of such a distinction is that any Bus or [[Pipe]] is always limited to a media stream of a single prototype. (&amp;rarr; [[more|StreamPrototype]])
-* Besides the distinction by prototypes, there are the various media ''implementation types''. This classification is not necessarily hierarchically related to the prototype classification, while in practice commonly there will be some sort of dependency. For example, both stereophonic and monaural audio may be implemented as 96kHz 24bit PCM with just a different number of channel streams, as well we may have a dedicated stereo audio stream with two channels multiplexed into a single stream. For dealing with media streams of various implementation type, we need //library// routines, which also yield a //type classification system.// Most notably, for raw sound and video data we use the [[GAVL]] library, which defines a classification system for buffers and streams.
+* Besides the distinction by prototypes, there are the various media ''implementation types''. This classification is not necessarily hierarchically related to the prototype classification, while in practice commonly there will be some sort of dependency. For example, both stereophonic and monaural audio may be implemented as 96kHz 24bit PCM with just a different number of channel streams, but we may as well get a dedicated stereo audio stream with two channels multiplexed into a single stream. For dealing with media streams of various implementation type, we need //library// routines, which also yield a //type classification system.// Most notably, for raw sound and video data we use the [[GAVL]] library, which defines a classification system for buffers and streams.
 * Besides the type classification detailed thus far, we introduce an ''intention tag''. This is a synthetic classification owned by Lumiera and used for internal wiring decisions. Currently (8/08), we recognize the following intention tags: __Source__, __Raw__, __Intermediary__ and __Target__. Only media streams tagged as __Raw__ can be processed.
 
 !! Media handling requirements involving stream type classification

From 83067aa318139bfe5cda709c8c3a4f5a60ed3982 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 31 Aug 2009 12:16:47 +0200
Subject: [PATCH 281/368] WIP: ...to do so, some considerations regarding the
 entrance point..

---
 src/lib/streamtype.hpp                |  2 +-
 src/proc/Makefile.am                  |  1 +
 src/proc/engine/buffhandle.hpp        |  2 +-
 src/proc/engine/nodeinvocation.hpp    |  4 +-
 src/proc/engine/render-invocation.cpp | 86 +++++++++++++++++++++++++++
 src/proc/engine/render-invocation.hpp | 17 ++++--
 src/proc/state.hpp                    | 14 ++++-
 7 files changed, 114 insertions(+), 12 deletions(-)
 create mode 100644 src/proc/engine/render-invocation.cpp

diff --git a/src/lib/streamtype.hpp b/src/lib/streamtype.hpp
index fe5bbeb41..bde5e8e94 100644
--- a/src/lib/streamtype.hpp
+++ b/src/lib/streamtype.hpp
@@ -125,7 +125,7 @@ namespace lumiera {
   
   
   /**
-   * Special case of an implementation type being only partialiy specified
+   * Special case of an implementation type being only partially specified
    * Besides requiring some aspect of the implementation type, there is the
    * promise to fill in defaults to build a complete implementation type
    * if necessary.
diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 2882546c2..848f595d2 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -77,6 +77,7 @@ liblumiprocengine_la_SOURCES =					\
 	$(liblumiprocengine_la_srcdir)/renderengine.cpp		\
 	$(liblumiprocengine_la_srcdir)/source.cpp		\
 	$(liblumiprocengine_la_srcdir)/stateproxy.cpp		\
+	$(liblumiprocengine_la_srcdir)/render-invocation.cpp	\
 	$(liblumiprocengine_la_srcdir)/trafo.cpp
 
 
diff --git a/src/proc/engine/buffhandle.hpp b/src/proc/engine/buffhandle.hpp
index afe3470be..40a5d1996 100644
--- a/src/proc/engine/buffhandle.hpp
+++ b/src/proc/engine/buffhandle.hpp
@@ -68,7 +68,7 @@ namespace engine {
           return *pBuffer_;
         }
       
-    protected:
+    private:
       PBuff pBuffer_; 
       long sourceID_;
     };
diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index 849e5ca30..13dbbd383 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -88,7 +88,7 @@ namespace engine {
       
       
       
-    public: /* === proxying the State interface === */
+    private: /* === proxying the State interface === */
       
       virtual void releaseBuffer (BuffHandle& bh)       { current_.releaseBuffer (bh); }
       
@@ -176,7 +176,7 @@ namespace engine {
           : Invocation(sta, w, outCh) {}
         
         virtual BuffHandle
-        allocateBuffer (BufferDescriptor const& bd) { return parent_.allocateBuffer(bd); }
+        allocateBuffer (BufferDescriptor const& bd) { return parent_.allocateBuffer(bd); }          ////////////TODO: actually implement the "allocate from parent" logic!
       };
     
     struct AllocBufferFromCache   ///< using the global current State, which will delegate to Cache
diff --git a/src/proc/engine/render-invocation.cpp b/src/proc/engine/render-invocation.cpp
new file mode 100644
index 000000000..0fae10cfe
--- /dev/null
+++ b/src/proc/engine/render-invocation.cpp
@@ -0,0 +1,86 @@
+/*
+  RenderInvocation  -  Interface for creating processing nodes of various kinds
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "proc/engine/render-invocation.hpp"
+
+namespace engine {
+  
+  namespace { // Details...
+
+    
+  } // (END) Details...
+  
+  
+//  using mobject::Placement;
+//  using mobject::session::Effect;
+  
+  
+  /** @internal */
+  BuffHandle
+  RenderInvocation::allocateBuffer (BufferDescriptor const&)
+  {
+    UNIMPLEMENTED ("allocate a suitable buffer to hold a frame of the denoted type");
+  }
+  
+  
+      
+  void
+  RenderInvocation::releaseBuffer (BuffHandle& bh)
+  {
+    UNIMPLEMENTED ("free a buffer");
+  }
+  
+  
+      
+  BuffHandle
+  RenderInvocation::fetch (FrameID const& fID)
+  {
+    UNIMPLEMENTED ("fetch a buffer with input data");
+  }
+  
+  
+      
+  void
+  RenderInvocation::is_calculated (BuffHandle const& bh)
+  {
+    UNIMPLEMENTED ("declare a buffer as fully calculated and done");
+  }
+  
+  
+      
+  FrameID const&
+  RenderInvocation::genFrameID (NodeID const&, uint chanNo)
+  {
+    UNIMPLEMENTED ("derive/generate an ID to denote this specific fame+Node position in the graph");
+  }
+  
+  
+
+  BuffTableStorage&
+  RenderInvocation::getBuffTableStorage() /////////////TODO need somehow to denote the specific storage requirements
+  {
+    UNIMPLEMENTED ("allocate a chunk of storage suitable for holding the buffer pointer tables");
+  }
+  
+  
+} // namespace engine
diff --git a/src/proc/engine/render-invocation.hpp b/src/proc/engine/render-invocation.hpp
index 963df8058..d26d87c4f 100644
--- a/src/proc/engine/render-invocation.hpp
+++ b/src/proc/engine/render-invocation.hpp
@@ -58,19 +58,24 @@ namespace engine {
       RenderInvocation()
         { }
       
-      virtual State& getCurrentImplementation () { return current_; }
       
       
+    private: /* === top-level implementation of the State interface === */
       
-    public: /* === proxying the State interface === */
+      BuffHandle allocateBuffer (BufferDescriptor const&);
       
-//      virtual void releaseBuffer (BuffHandle& bh)       { current_.releaseBuffer (bh); }
+      void releaseBuffer (BuffHandle& bh);
       
-//      virtual void is_calculated (BuffHandle const& bh) { current_.is_calculated (bh); }
+      BuffHandle fetch (FrameID const& fID);
       
-//      virtual BuffHandle fetch (FrameID const& fID)     { return current_.fetch (fID); }
+      void is_calculated (BuffHandle const& bh);
       
-      // note: allocateBuffer()  is chosen specifically based on the actual node wiring
+      FrameID const& genFrameID (NodeID const&, uint chanNo);
+
+      BuffTableStorage& getBuffTableStorage();
+      
+      virtual State& getCurrentImplementation () { return *this; }
+  
       
     };
   
diff --git a/src/proc/state.hpp b/src/proc/state.hpp
index 0f4e182c9..a37e85933 100644
--- a/src/proc/state.hpp
+++ b/src/proc/state.hpp
@@ -42,6 +42,16 @@ namespace engine {
   class StateAdapter;
   class BuffTableStorage;
   
+  
+  /**
+   * Abstraction denoting the state of a currently ongoing render/calculation
+   * process, as it is tied to the supporting facilities of the backend.
+   * An State (subclass) instance is the sole connection for the render node
+   * to invoke services of the backend needed to carry out the calculations.
+   * 
+   * @see engine::RenderInvocation top-level entrance point
+   * @see nodeinvocation.hpp impl. used from \em within the nodes
+   */
   class State
     {
     public:
@@ -75,8 +85,8 @@ namespace engine {
        */
       virtual FrameID const& genFrameID (NodeID const&, uint chanNo)  =0;
       
-      /** try to fetch an existing buffer containing the denoted frame from
-       *  a cache or similar backing system (e.g. peer over the network).
+      /** try to fetch an existing buffer containing the denoted frame
+       *  from a cache or similar backing system (e.g. network peer).
        *  @return either a handle to a readonly buffer, or a null handle
        *  @note the client is responsible for not modifying the provided data
        */

From 391181e699b20c891203838d45445e104b47cffd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 4 Sep 2009 01:59:44 +0200
Subject: [PATCH 282/368] WIP some further musing about how to do a simple
 invocation for unit testing ProcNode

---
 src/proc/engine/buffhandle.hpp                | 19 +++++-
 src/proc/engine/nodeoperation.hpp             |  2 +
 src/proc/engine/nodewiring.cpp                |  2 +-
 src/proc/engine/nodewiring.hpp                |  5 +-
 src/proc/engine/procnode.hpp                  |  8 ++-
 src/proc/engine/render-invocation.cpp         | 58 +++++--------------
 src/proc/engine/render-invocation.hpp         | 41 +++++--------
 src/proc/engine/stateproxy.cpp                | 57 +++++++++++++++++-
 src/proc/engine/stateproxy.hpp                | 16 ++++-
 .../proc/engine/node-basic-test.cpp           |  8 ++-
 wiki/renderengine.html                        |  4 +-
 11 files changed, 136 insertions(+), 84 deletions(-)

diff --git a/src/proc/engine/buffhandle.hpp b/src/proc/engine/buffhandle.hpp
index 40a5d1996..c2602cc96 100644
--- a/src/proc/engine/buffhandle.hpp
+++ b/src/proc/engine/buffhandle.hpp
@@ -41,6 +41,7 @@
 
 #include "lib/error.hpp"
 #include "lib/streamtype.hpp"
+#include "lib/bool-checkable.hpp"
 
 
 namespace engine {
@@ -52,22 +53,36 @@ namespace engine {
    * The real buffer pointer can be retrieved by dereferencing this smart-handle class.
    */
   struct BuffHandle
+    : lib::BoolCheckable<BuffHandle>
     {
       typedef lumiera::StreamType::ImplFacade::DataBuffer Buff;
       typedef Buff* PBuff;
       
       PBuff 
-      operator->() const 
+      operator->()  const 
         { 
           return pBuffer_; 
         }
       Buff&
-      operator* () const
+      operator* ()  const
         {
           ENSURE (pBuffer_);
           return *pBuffer_;
         }
       
+      bool
+      isValid()  const
+        {
+          return pBuffer_;
+        }
+      
+      
+      //////////////////////TODO: the whole logic how to create a BuffHandle needs to be solved in a more clever way. --> Ticket 249
+      BuffHandle()
+        : pBuffer_(0),
+          sourceID_(0)
+        { }
+      
     private:
       PBuff pBuffer_; 
       long sourceID_;
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index d3a36067d..838b9a31f 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -203,6 +203,7 @@ namespace config {
         }
     };
   
+  
   template<class NEXT>
   struct FeedCache : NEXT
     {
@@ -219,6 +220,7 @@ namespace config {
         }
     };
   
+  
   template<class NEXT>
   struct ReleaseBuffers : NEXT                     /////////////////TODO: couldn't this be done automatically by BuffTab's dtor??
     {                                             /////////////////       this would require BuffHandle to be a smart ref....
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index 84e52c4be..41b212af5 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -133,7 +133,7 @@ namespace engine {
   
   /** create and configure a concrete wiring descriptor to tie
    *  a ProcNode to its predecessor nodes. This includes selecting
-   *  the actual StateProxy type, configuring it out of some operation
+   *  the actual StateAdapter type, configuring it out of some operation
    *  control templates (policy classes). Compiling this operator function
    *  actually drives the necessary template instantiations for all cases
    *  encountered while building the node network.
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 160625205..354b5d0fa 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -83,10 +83,7 @@ namespace engine {
                            setup.makeInDescriptor(),
                            setup.resolveProcessingFunction(),
                            setup.createNodeID())
-        {
-          nrO = out.size();
-          nrI = in.size();
-        }
+        { }
       
       friend class WiringFactory;
       
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 2d95bd7cb..000666d96 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -90,7 +90,10 @@ namespace engine {
         : out(o), in(i),
           procFunction(pFunc),
           nodeID(nID)
-        { }  
+        {
+          nrO = out.size();
+          nrI = in.size();
+        }
       
       /** the wiring-dependent part of the node operation.
        *  Includes the creation of a one-way state object on the stack
@@ -129,6 +132,9 @@ namespace engine {
       
     public:
       
+      /** output channel count */
+      uint nrO() { return wiringConfig_.nrO; }
+      
       /** Engine Core operation: render and pull output from this node.
        *  On return, currentProcess will hold onto output buffer(s)
        *  containing the calculated result frames. In case this node
diff --git a/src/proc/engine/render-invocation.cpp b/src/proc/engine/render-invocation.cpp
index 0fae10cfe..abd0ce338 100644
--- a/src/proc/engine/render-invocation.cpp
+++ b/src/proc/engine/render-invocation.cpp
@@ -22,6 +22,8 @@
 
 
 #include "proc/engine/render-invocation.hpp"
+#include "proc/engine/stateproxy.hpp"
+
 
 namespace engine {
   
@@ -35,51 +37,21 @@ namespace engine {
 //  using mobject::session::Effect;
   
   
-  /** @internal */
+  /** @note this builds a one-way off invocation state context
+   *        and then forwards the call; this may or may not cause
+   *        actual calculations, depending on the cache.
+   *  @todo for real use within the engine, the pull()-call should be
+   *        dispatched through the scheduler; of course then the call semantics
+   *        would be completely different. Maybe this invocation will be test only?  
+   */
   BuffHandle
-  RenderInvocation::allocateBuffer (BufferDescriptor const&)
+  RenderInvocation::operator[] (size_t channel)
   {
-    UNIMPLEMENTED ("allocate a suitable buffer to hold a frame of the denoted type");
-  }
-  
-  
-      
-  void
-  RenderInvocation::releaseBuffer (BuffHandle& bh)
-  {
-    UNIMPLEMENTED ("free a buffer");
-  }
-  
-  
-      
-  BuffHandle
-  RenderInvocation::fetch (FrameID const& fID)
-  {
-    UNIMPLEMENTED ("fetch a buffer with input data");
-  }
-  
-  
-      
-  void
-  RenderInvocation::is_calculated (BuffHandle const& bh)
-  {
-    UNIMPLEMENTED ("declare a buffer as fully calculated and done");
-  }
-  
-  
-      
-  FrameID const&
-  RenderInvocation::genFrameID (NodeID const&, uint chanNo)
-  {
-    UNIMPLEMENTED ("derive/generate an ID to denote this specific fame+Node position in the graph");
-  }
-  
-  
-
-  BuffTableStorage&
-  RenderInvocation::getBuffTableStorage() /////////////TODO need somehow to denote the specific storage requirements
-  {
-    UNIMPLEMENTED ("allocate a chunk of storage suitable for holding the buffer pointer tables");
+    REQUIRE (theNode_);
+    REQUIRE (channel < size());
+    
+    StateProxy invocationState;
+    return theNode_->pull(invocationState, channel);
   }
   
   
diff --git a/src/proc/engine/render-invocation.hpp b/src/proc/engine/render-invocation.hpp
index d26d87c4f..2138169cf 100644
--- a/src/proc/engine/render-invocation.hpp
+++ b/src/proc/engine/render-invocation.hpp
@@ -34,9 +34,9 @@
 #define ENGINE_RENDER_INVOCATION_H
 
 
-#include "proc/state.hpp"
-//#include "proc/engine/procnode.hpp"
-//#include "proc/engine/buffhandle.hpp"
+//#include "proc/state.hpp"
+#include "proc/engine/procnode.hpp"
+#include "proc/engine/buffhandle.hpp"
 //#include "proc/engine/bufftable.hpp"
 
 
@@ -49,34 +49,23 @@ namespace engine {
    * TODO: type comment
    */
   class RenderInvocation
-    : public State
     {
-    protected:
-//      State& parent_;
-//      State& current_;
+      ProcNode* theNode_;
       
-      RenderInvocation()
-        { }
+    public:
+      RenderInvocation (ProcNode* exitNode)
+        : theNode_(exitNode)
+        {
+          REQUIRE (theNode_);
+        }
+      
+      size_t size() { return theNode_->nrO(); }
+      
+      /** pull calculated data from the N-th node output channel */
+      BuffHandle operator[] (size_t channel);
       
       
       
-    private: /* === top-level implementation of the State interface === */
-      
-      BuffHandle allocateBuffer (BufferDescriptor const&);
-      
-      void releaseBuffer (BuffHandle& bh);
-      
-      BuffHandle fetch (FrameID const& fID);
-      
-      void is_calculated (BuffHandle const& bh);
-      
-      FrameID const& genFrameID (NodeID const&, uint chanNo);
-
-      BuffTableStorage& getBuffTableStorage();
-      
-      virtual State& getCurrentImplementation () { return *this; }
-  
-      
     };
   
   ///////////////////////////////////TODO: currently just fleshing out the API
diff --git a/src/proc/engine/stateproxy.cpp b/src/proc/engine/stateproxy.cpp
index 6e2566d3e..c8a07a429 100644
--- a/src/proc/engine/stateproxy.cpp
+++ b/src/proc/engine/stateproxy.cpp
@@ -25,8 +25,63 @@
 
 namespace engine {
   
-  /** */
   
+  namespace { // Details...
+
+    
+  } // (END) Details...
+  
+  
+//  using mobject::Placement;
+//  using mobject::session::Effect;
+  
+  
+  /** @internal */
+  BuffHandle
+  StateProxy::allocateBuffer (BufferDescriptor const&)
+  {
+    UNIMPLEMENTED ("allocate a suitable buffer to hold a frame of the denoted type");
+  }
+  
+  
+      
+  void
+  StateProxy::releaseBuffer (BuffHandle& bh)
+  {
+    UNIMPLEMENTED ("free a buffer");
+  }
+  
+  
+      
+  BuffHandle
+  StateProxy::fetch (FrameID const& fID)
+  {
+    UNIMPLEMENTED ("fetch a buffer with input data");
+  }
+  
+  
+      
+  void
+  StateProxy::is_calculated (BuffHandle const& bh)
+  {
+    UNIMPLEMENTED ("declare a buffer as fully calculated and done");
+  }
+  
+  
+      
+  FrameID const&
+  StateProxy::genFrameID (NodeID const&, uint chanNo)
+  {
+    UNIMPLEMENTED ("derive/generate an ID to denote this specific fame+Node position in the graph");
+  }
+  
+  
+
+  BuffTableStorage&
+  StateProxy::getBuffTableStorage() /////////////TODO need somehow to denote the specific storage requirements
+  {
+    UNIMPLEMENTED ("allocate a chunk of storage suitable for holding the buffer pointer tables");
+  }
   
   
 } // namespace engine
diff --git a/src/proc/engine/stateproxy.hpp b/src/proc/engine/stateproxy.hpp
index ff7d107d3..50e961ca1 100644
--- a/src/proc/engine/stateproxy.hpp
+++ b/src/proc/engine/stateproxy.hpp
@@ -35,7 +35,21 @@ namespace engine {
   class StateProxy
     : public proc_interface::State
     {
-    protected:
+      
+    private: /* === top-level implementation of the State interface === */
+      
+      BuffHandle allocateBuffer (BufferDescriptor const&);
+      
+      void releaseBuffer (BuffHandle& bh);
+      
+      BuffHandle fetch (FrameID const& fID);
+      
+      void is_calculated (BuffHandle const& bh);
+      
+      FrameID const& genFrameID (NodeID const&, uint chanNo);
+
+      BuffTableStorage& getBuffTableStorage();
+      
       virtual State& getCurrentImplementation () { return *this; }
       
     };
diff --git a/tests/components/proc/engine/node-basic-test.cpp b/tests/components/proc/engine/node-basic-test.cpp
index bf36e3bf6..3c1aee4d7 100644
--- a/tests/components/proc/engine/node-basic-test.cpp
+++ b/tests/components/proc/engine/node-basic-test.cpp
@@ -26,7 +26,8 @@
 //#include "lib/util.hpp"
 #include "proc/engine/nodefactory.hpp"
 #include "proc/engine/nodewiring.hpp"
-#include "proc/engine/render-invocation.hpp"
+#include "proc/engine/stateproxy.hpp"
+#include "proc/engine/buffhandle.hpp"
 #include "proc/mobject/session/effect.hpp"
 #include "lib/allocationcluster.hpp"
 
@@ -54,7 +55,7 @@ namespace test  {
      * happening in correct order.
      */
     class TestContext
-      : public RenderInvocation
+      : public StateProxy
       {
         
         //////////////TODO: facility to verify the right access operations get called
@@ -83,8 +84,9 @@ namespace test  {
           ASSERT (pNode);
           
           TestContext simulatedInvocation;
-          pNode->pull(simulatedInvocation, 0);
+          BuffHandle result = pNode->pull(simulatedInvocation, 0);
           
+          ASSERT (result);
           // ASSERT we got calculated data in the result buffer
         } 
     };
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 0e51d4faa..ef9aa91a0 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -2237,12 +2237,12 @@ So, when creating a clip out of such a compound media asset, the clip has to be
 In the most general case the render network may be just a DAG (not just a tree). Especially, multiple exit points may lead down to the same node, and following each of this possible paths the node may be at a different depth on each. This rules out a simple counter starting from the exit level, leaving us with the possibility of either employing a rather convoluted addressing scheme or using arbitrary ID numbers.{{red{...which is what we do for now}}}
 </pre>
 </div>
-<div title="NodeOperationProtocol" modifier="Ichthyostega" modified="200807072147" created="200806010251" tags="Rendering dynamic" changecount="15">
+<div title="NodeOperationProtocol" modifier="Ichthyostega" modified="200909031217" created="200806010251" tags="Rendering dynamic" changecount="16">
 <pre>The [[nodes|ProcNode]] are wired to form a &quot;Directed Acyclic Graph&quot;; each node knows its predecessor(s), but not its successor(s).  The RenderProcess is organized according to the ''pull principle'', thus we find an operation {{{pull()}}} at the core of this process. There is no such thing as an &quot;engine object&quot; calling nodes iteratively or table driven, rather, the nodes themselves issue recursive calls to their predecessor(s). For this to work, we need the nodes to adhere to a specific protocol:
 # Node is pulled, with a StateProxy object as parameter (encapsulating the access to the frames or buffers)
 # Node may now access current parameter values, using the state accessible via the StateProxy
 # using it's //input-output and wiring descriptor,// the Node creates a StateAdapter wrapping the StateProxy for allocating buffers and accessing the required input
-# StateAdapter first tries to get the output frames from the Cache in the Backend. In case of failure, a {{{process()}}} call is prepared by generating {{{pull()}}} call(s) for the input
+# StateAdapter might first try to get the output frames from the Cache in the Backend. In case of failure, a {{{process()}}} call is prepared by generating {{{pull()}}} call(s) for the input
 # as late as possible, typically on return, these recursive pull-calls have allocated a buffer containing the input data.
 # when input is ready prior to the {{{process()}}} call, output buffers will be allocated, either from the cache, or (if not caching) from the &quot;parent&quot; StateAdapter up the callstack.
 # after all buffers are available, the StateAdapter issues the {{{process()}}} call back to the originating node, which now may dereference the frame pointers and do its calculations

From d50d9a30f28fbed69da4f73988e4462152512130 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Fri, 4 Sep 2009 08:02:16 +0200
Subject: [PATCH 283/368] FIX: compiler warnings in mpool.c

Some gcc versions warn about type aliasing errors here, by using char*
this is fixed (and actually the right type here).
---
 src/lib/mpool.c | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index 9d28266cf..ab0aa4c64 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -47,7 +47,7 @@ typedef const mpoolcluster* const_MPoolcluster;
 struct mpoolcluster_struct
 {
   llist node;           /* all clusters */
-  void* data[];         /* bitmap and elements */
+  char data[];          /* bitmap and elements */
 };
 
 
@@ -116,7 +116,7 @@ bitmap_bit_get_nth (MPoolcluster cluster, unsigned index)
 
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
-  uintptr_t* bitmap = (uintptr_t*)cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
 
   return bitmap[quot] & ((uintptr_t)1<<rem);
 }
@@ -166,7 +166,7 @@ mpool_cluster_alloc_ (MPool self)
     return NULL;
 
   /* clear the bitmap */
-  memset (cluster->data, 0, MPOOL_BITMAP_SIZE (self->elements_per_cluster));
+  memset (&cluster->data, 0, MPOOL_BITMAP_SIZE (self->elements_per_cluster));
 
   /* initialize freelist */
   for (unsigned i = 0; i < self->elements_per_cluster; ++i)
@@ -240,7 +240,7 @@ alloc_near (MPoolcluster cluster, MPool self, void* locality)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
 
   /* the bitmap word at locality */
@@ -276,7 +276,7 @@ bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[quot] |= ((uintptr_t)1<<rem);
 
   TRACE (mpool_dbg, "set bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
@@ -295,7 +295,7 @@ bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[quot] &= ~((uintptr_t)1<<rem);
 
   TRACE (mpool_dbg, "cleared bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
@@ -403,7 +403,7 @@ find_near (MPoolcluster cluster, MPool self, void* element)
   uintptr_t quot = index>>MPOOL_DIV_SHIFT;
   uintptr_t rem = index & ~((~MPOOL_C(0))<<MPOOL_DIV_SHIFT);
 
-  uintptr_t* bitmap = (uintptr_t*)cluster->data;
+  uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   unsigned r = ~0U;
 
   /* the bitmap word at locality */

From f73cc47da6afd13b9be62c19efb9cf61b0785f3c Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Fri, 4 Sep 2009 08:53:03 +0200
Subject: [PATCH 284/368] Fix all things which broke compilation with NoBug
 200909.1

---
 src/backend/filedescriptor.c                         |  2 +-
 src/backend/mmapings.c                               |  2 +-
 src/lib/condition.h                                  |  4 ++--
 src/lib/mpool.c                                      | 11 ++++++-----
 src/lib/mutex.h                                      |  4 ++--
 src/lib/reccondition.h                               |  4 ++--
 src/lib/recmutex.h                                   |  4 ++--
 src/lib/rwlock.h                                     |  8 ++++----
 src/lib/scoped-holder.hpp                            |  4 ++--
 src/lib/test/test-helper.hpp                         |  2 +-
 tests/components/proc/asset/createassettest.cpp      |  4 ++--
 tests/components/proc/mobject/placement-ref-test.cpp |  4 ++--
 tests/lib/meta/config-flags-test.cpp                 |  2 +-
 tests/lib/scoped-holder-test.cpp                     | 10 +++++-----
 tests/lib/scopedholdertransfertest.cpp               |  2 +-
 tests/lib/subsystem-runner-test.cpp                  |  6 +++---
 tests/lib/thread-wrapper-join-test.cpp               |  4 ++--
 tests/library/test-safeclib.c                        |  4 ++--
 18 files changed, 41 insertions(+), 40 deletions(-)

diff --git a/src/backend/filedescriptor.c b/src/backend/filedescriptor.c
index 5ab30eba8..64ab6c01b 100644
--- a/src/backend/filedescriptor.c
+++ b/src/backend/filedescriptor.c
@@ -298,7 +298,7 @@ lumiera_filedescriptor_delete (LumieraFiledescriptor self, const char* name)
 
       if (self->handle && name && ((self->flags & O_RDWR) == O_RDWR))
         {
-          TRACE (filedescriptor_dbg, "truncate %s to %lld", name, self->realsize);
+          TRACE (filedescriptor_dbg, "truncate %s to %lld", name, (long long)self->realsize);
           lumiera_filehandlecache_checkout (lumiera_fhcache, self->handle);
           int dummy = ftruncate (lumiera_filehandle_handle (self->handle), self->realsize);
           (void) dummy; /* this is present to silence a warning */
diff --git a/src/backend/mmapings.c b/src/backend/mmapings.c
index ebf0c12db..3e052ce91 100644
--- a/src/backend/mmapings.c
+++ b/src/backend/mmapings.c
@@ -121,7 +121,7 @@ lumiera_mmapings_mmap_acquire (LumieraMMapings self, LumieraFile file, LList acq
       else
         {
           /* create new mmap */
-          TRACE (mmapings_dbg, "mmap not found, creating", mmap);
+          TRACE (mmapings_dbg, "mmap not found, creating");
           ret = lumiera_mmap_new (file, start, size);
 
           llist_insert_head (&self->mmaps, &ret->searchnode);
diff --git a/src/lib/condition.h b/src/lib/condition.h
index a2e02cebd..f90d079d8 100644
--- a/src/lib/condition.h
+++ b/src/lib/condition.h
@@ -52,7 +52,7 @@
          ({                                                                                     \
            lumiera_cond_section_.lock = (cnd);                                                  \
            NOBUG_IF_ALPHA(lumiera_cond_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condmutex", &lumiera_cond_section_, \
+             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condmutex",                         \
                              NOBUG_RESOURCE_WAITING, lumiera_cond_section_.rh);                 \
            if (pthread_mutex_lock (&(cnd)->cndmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
@@ -74,7 +74,7 @@
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
            lumiera_cond_section_.lock = cnd;                                                    \
            NOBUG_IF_ALPHA(lumiera_cond_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condmutex", &lumiera_cond_section_,   \
+           RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire condmutex",                           \
                            NOBUG_RESOURCE_WAITING, lumiera_cond_section_.rh);                   \
            if (pthread_mutex_lock (&(cnd)->cndmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
diff --git a/src/lib/mpool.c b/src/lib/mpool.c
index ab0aa4c64..f9b3056c6 100644
--- a/src/lib/mpool.c
+++ b/src/lib/mpool.c
@@ -22,6 +22,7 @@
 #include <stdlib.h>
 #include <stdio.h>
 #include <stdbool.h>
+#include <inttypes.h>
 #include <limits.h>
 
 #include "mpool.h"
@@ -136,7 +137,7 @@ mpool_destroy (MPool self)
                 if (bitmap_bit_get_nth ((MPoolcluster)cluster, i))
                   {
                     void* obj = cluster_element_get ((MPoolcluster)cluster, self, i);
-                    TRACE (mpool_dbg, "dtor: cluster %p: obj %p: freelist %p", cluster, obj, self->freelist);
+                    TRACE (mpool_dbg, "dtor: cluster %p: obj %p: freelist %p", cluster, obj, &self->freelist);
                     self->destroy (obj);
                   }
               }
@@ -279,7 +280,7 @@ bitmap_set_element (MPoolcluster cluster, MPool self, void* element)
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[quot] |= ((uintptr_t)1<<rem);
 
-  TRACE (mpool_dbg, "set bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
+  TRACE (mpool_dbg, "set bit %"PRIuPTR", index %"PRIuPTR", of %p is %"PRIuPTR, rem, quot, element, bitmap[quot]);
 }
 
 
@@ -298,7 +299,7 @@ bitmap_clear_element (MPoolcluster cluster, MPool self, void* element)
   uintptr_t* bitmap = (uintptr_t*)&cluster->data;
   bitmap[quot] &= ~((uintptr_t)1<<rem);
 
-  TRACE (mpool_dbg, "cleared bit %d, index %d, of %p is %p", rem, quot, element, bitmap[quot]);
+  TRACE (mpool_dbg, "cleared bit %"PRIuPTR", index %"PRIuPTR", of %p is %"PRIuPTR, rem, quot, element, bitmap[quot]);
 }
 
 
@@ -492,7 +493,7 @@ nobug_mpool_dump (const_MPool self,
 
       if (depth > 2)
         {
-          DUMP_LOG ("  clusters %p: ", self->clusters);
+          DUMP_LOG ("  clusters %p: ", &self->clusters);
           int i = 0;
           LLIST_FOREACH (&self->clusters, cluster)
             DUMP_LOG ("    %p: %u", cluster, ++i);
@@ -500,7 +501,7 @@ nobug_mpool_dump (const_MPool self,
 
       if (depth > 3)
         {
-          DUMP_LOG ("  freelist %p: ", self->freelist);
+          DUMP_LOG ("  freelist %p: ", &self->freelist);
           int i = 0;
           LLIST_FOREACH (&self->freelist, node)
             DUMP_LOG ("    %p: %u", node, ++i);
diff --git a/src/lib/mutex.h b/src/lib/mutex.h
index a76707933..cead7dec0 100644
--- a/src/lib/mutex.h
+++ b/src/lib/mutex.h
@@ -46,7 +46,7 @@
          ({                                                                                     \
            lumiera_lock_section_.lock = (mtx);                                                  \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex",                               \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_mutex_lock (&(mtx)->mutex))                                              \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
@@ -76,7 +76,7 @@
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
            lumiera_lock_section_.lock = mtx;                                                    \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex", &lumiera_lock_section_,       \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire mutex",                               \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_mutex_lock (&(mtx)->mutex))                                              \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
diff --git a/src/lib/reccondition.h b/src/lib/reccondition.h
index dcf4e33a4..8ba3479ac 100644
--- a/src/lib/reccondition.h
+++ b/src/lib/reccondition.h
@@ -50,7 +50,7 @@
          ({                                                                                             \
            lumiera_reccond_section_.lock = (cnd);                                                       \
            NOBUG_IF_ALPHA(lumiera_reccond_section_.flag = &NOBUG_FLAG(nobugflag);)                      \
-             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire reccondmutex", &lumiera_reccond_section_,   \
+             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire reccondmutex",                              \
                              NOBUG_RESOURCE_WAITING, lumiera_reccond_section_.rh);                      \
            if (pthread_mutex_lock (&(cnd)->reccndmutex))                                                \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                                \
@@ -73,7 +73,7 @@
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");                   \
            lumiera_reccond_section_.lock = (cnd);                                                       \
            NOBUG_IF_ALPHA(lumiera_reccond_section_.flag = &NOBUG_FLAG(nobugflag);)                      \
-           RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire reccondmutex", &lumiera_reccond_section_,     \
+             RESOURCE_ENTER (nobugflag, (cnd)->rh, "acquire reccondmutex",                              \
                            NOBUG_RESOURCE_WAITING, lumiera_reccond_section_.rh);                        \
            if (pthread_mutex_lock (&(cnd)->reccndmutex))                                                \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                                \
diff --git a/src/lib/recmutex.h b/src/lib/recmutex.h
index a893d3bed..ec0cea6e4 100644
--- a/src/lib/recmutex.h
+++ b/src/lib/recmutex.h
@@ -45,7 +45,7 @@
          ({                                                                                     \
            lumiera_lock_section_.lock = (mtx);                                                  \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex",                            \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
@@ -67,7 +67,7 @@
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
            lumiera_lock_section_.lock = (mtx);                                                  \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex", &lumiera_lock_section_,    \
+           RESOURCE_ENTER (nobugflag, (mtx)->rh, "acquire recmutex",                            \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_mutex_lock (&(mtx)->recmutex))                                           \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
diff --git a/src/lib/rwlock.h b/src/lib/rwlock.h
index aa0814b37..1e72347cd 100644
--- a/src/lib/rwlock.h
+++ b/src/lib/rwlock.h
@@ -55,7 +55,7 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
            lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
              RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock",                        \
-                             &lumiera_lock_section_, NOBUG_RESOURCE_WAITING,                    \
+                             NOBUG_RESOURCE_WAITING,                                            \
                              lumiera_lock_section_.rh);                                         \
            if (pthread_rwlock_rdlock (&(rwlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
@@ -78,7 +78,7 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
            lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock", &lumiera_lock_section_,  \
+           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire readlock",                          \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_rwlock_rdlock (&(rwlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
@@ -106,7 +106,7 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
            lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
              RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock",                       \
-                             &lumiera_lock_section_, NOBUG_RESOURCE_WAITING,                    \
+                             NOBUG_RESOURCE_WAITING,                                            \
                              lumiera_lock_section_.rh);                                         \
            if (pthread_rwlock_wrlock (&(rwlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
@@ -128,7 +128,7 @@ LUMIERA_ERROR_DECLARE(RWLOCK_WRLOCK);
            REQUIRE (lumiera_lock_section_old_->lock, "section prematurely unlocked");           \
            lumiera_lock_section_.lock = (rwlck);                                                \
            NOBUG_IF_ALPHA(lumiera_lock_section_.flag = &NOBUG_FLAG(nobugflag);)                 \
-           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock", &lumiera_lock_section_, \
+           RESOURCE_ENTER (nobugflag, (rwlck)->rh, "acquire writelock",                         \
                            NOBUG_RESOURCE_WAITING, lumiera_lock_section_.rh);                   \
            if (pthread_rwlock_wrlock (&(twlck)->rwlock))                                        \
              LUMIERA_DIE (LOCK_ACQUIRE);                                                        \
diff --git a/src/lib/scoped-holder.hpp b/src/lib/scoped-holder.hpp
index 0a1a1d3a8..392a36d58 100644
--- a/src/lib/scoped-holder.hpp
+++ b/src/lib/scoped-holder.hpp
@@ -117,7 +117,7 @@ namespace lib {
       transfer_control (ScopedPtrHolder& from, ScopedPtrHolder& to)
       {
         if (!from) return;
-        TRACE (test, "transfer_control<ScopedPtrHolder>... from=%x to=%x",&from, &to);
+        TRACE (test, "transfer_control<ScopedPtrHolder>... from=%p to=%p",&from, &to);
         must_be_null (to);
         to.swap(from);
       }
@@ -229,7 +229,7 @@ namespace lib {
       transfer_control (ScopedHolder& from, ScopedHolder& to)
       {
         if (!from) return;
-        TRACE (test, "transfer_control<ScopedHolder>... from=%x to=%x",&from, &to);
+        TRACE (test, "transfer_control<ScopedHolder>... from=%p to=%p",&from, &to);
         must_be_empty (to);
         to.create();
         try
diff --git a/src/lib/test/test-helper.hpp b/src/lib/test/test-helper.hpp
index 268e15cbf..ef004ec88 100644
--- a/src/lib/test/test-helper.hpp
+++ b/src/lib/test/test-helper.hpp
@@ -128,7 +128,7 @@ namespace test{
           try                             \
             {                             \
               ERRONEOUS_STATEMENT ;       \
-              NOTREACHED;                 \
+              NOTREACHED();               \
             }                             \
           catch (...)                     \
             {                             \
diff --git a/tests/components/proc/asset/createassettest.cpp b/tests/components/proc/asset/createassettest.cpp
index 70b0fa808..719b7756f 100644
--- a/tests/components/proc/asset/createassettest.cpp
+++ b/tests/components/proc/asset/createassettest.cpp
@@ -113,13 +113,13 @@ namespace asset
             try 
               { // can't be found if specifying wrong Asset kind.... 
                 aMang.getAsset (ID<asset::Proc>(mm1->getID()));
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (lumiera::error::Invalid& xxx) {ASSERT (xxx.getID()==LUMIERA_ERROR_WRONG_ASSET_KIND);}
             try 
               { // try accessing nonexistant ID 
                 aMang.getAsset (ID<Asset> (1234567890));
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (lumiera::error::Invalid& xxx) {ASSERT (xxx.getID()==LUMIERA_ERROR_UNKNOWN_ASSET_ID);}
             lumiera_error (); // reset errorflag
diff --git a/tests/components/proc/mobject/placement-ref-test.cpp b/tests/components/proc/mobject/placement-ref-test.cpp
index 37347f161..9bbe17109 100644
--- a/tests/components/proc/mobject/placement-ref-test.cpp
+++ b/tests/components/proc/mobject/placement-ref-test.cpp
@@ -154,7 +154,7 @@ namespace test    {
           try
             {
               *ref1;
-              NOTREACHED;
+              NOTREACHED();
             }
           catch (...)
             {
@@ -170,7 +170,7 @@ namespace test    {
           try
             {
               *ref2;
-              NOTREACHED;
+              NOTREACHED();
             }
           catch (...)
             {
diff --git a/tests/lib/meta/config-flags-test.cpp b/tests/lib/meta/config-flags-test.cpp
index fd1e085ed..77fb19ea6 100644
--- a/tests/lib/meta/config-flags-test.cpp
+++ b/tests/lib/meta/config-flags-test.cpp
@@ -314,7 +314,7 @@ namespace test {
               try
                 {
                   INVOKE_CONFIG_SELECTOR (23);
-                  NOTREACHED ;
+                  NOTREACHED ();
                 }
               catch (lumiera::error::Invalid& err)
                 {
diff --git a/tests/lib/scoped-holder-test.cpp b/tests/lib/scoped-holder-test.cpp
index 62011d193..6f31b0766 100644
--- a/tests/lib/scoped-holder-test.cpp
+++ b/tests/lib/scoped-holder-test.cpp
@@ -124,7 +124,7 @@ namespace test{
             try
               {
                 create_contained_object (holder);
-                NOTREACHED ;
+                NOTREACHED ();
               }
             catch (int val)
               {
@@ -160,7 +160,7 @@ namespace test{
             try
               {
                 holder2 = holder;
-                NOTREACHED ;
+                NOTREACHED ();
               }
             catch (lumiera::error::Logic&)
               {
@@ -173,7 +173,7 @@ namespace test{
             try
               {
                 holder = holder2;
-                NOTREACHED ;
+                NOTREACHED ();
               }
             catch (lumiera::error::Logic&)
               {
@@ -190,7 +190,7 @@ namespace test{
             try
               {
                 holder = holder2;
-                NOTREACHED ;
+                NOTREACHED ();
               }
             catch (lumiera::error::Logic&)
               {
@@ -203,7 +203,7 @@ namespace test{
             try
               {
                 HO holder3 (holder2);
-                NOTREACHED ;
+                NOTREACHED ();
               }
             catch (lumiera::error::Logic&)
               {
diff --git a/tests/lib/scopedholdertransfertest.cpp b/tests/lib/scopedholdertransfertest.cpp
index 274a4b31f..f92f0319b 100644
--- a/tests/lib/scopedholdertransfertest.cpp
+++ b/tests/lib/scopedholdertransfertest.cpp
@@ -199,7 +199,7 @@ namespace lib {
               try
                 {
                   create_contained_object (table[3]);
-                  NOTREACHED ;
+                  NOTREACHED ();
                 }
               catch (int val)
                 {
diff --git a/tests/lib/subsystem-runner-test.cpp b/tests/lib/subsystem-runner-test.cpp
index 648b32d0c..82e04364a 100644
--- a/tests/lib/subsystem-runner-test.cpp
+++ b/tests/lib/subsystem-runner-test.cpp
@@ -288,7 +288,7 @@ namespace lumiera {
             try 
               { 
                 runner.maybeRun (unit2);
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (lumiera::Error&)
               {
@@ -297,7 +297,7 @@ namespace lumiera {
             try 
               { 
                 runner.maybeRun (unit3);
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (lumiera::Error&)
               {
@@ -398,7 +398,7 @@ namespace lumiera {
             try 
               { 
                 runner.maybeRun (unit4);
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (lumiera::Error&)
               {
diff --git a/tests/lib/thread-wrapper-join-test.cpp b/tests/lib/thread-wrapper-join-test.cpp
index 57793d2ac..e7e80cd08 100644
--- a/tests/lib/thread-wrapper-join-test.cpp
+++ b/tests/lib/thread-wrapper-join-test.cpp
@@ -97,7 +97,7 @@ namespace backend {
             try 
               { 
                 waitingHandle.join(); // protocol error: handle wasn't passed for starting a Thread; 
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (lumiera::error::Logic& logo)
               { lumiera_error(); }
@@ -115,7 +115,7 @@ namespace backend {
                 Thread("test Thread joining-3",
                        bind (&ThreadWrapperJoin_test::theAction, this, 333),
                        waitingHandle);    // but then pass it again for another thread....
-                NOTREACHED;
+                NOTREACHED();
               }
             catch (...)
               {
diff --git a/tests/library/test-safeclib.c b/tests/library/test-safeclib.c
index a5dfa47a9..8b745928f 100644
--- a/tests/library/test-safeclib.c
+++ b/tests/library/test-safeclib.c
@@ -27,7 +27,7 @@ TESTS_BEGIN
 TEST ("allocation0")
 {
   lumiera_malloc (0);
-  NOTREACHED;
+  NOTREACHED();
 }
 
 TEST ("allocation1024")
@@ -51,7 +51,7 @@ TEST ("allocationtoobig")
   rl.rlim_max = 100*1024*1024;
   setrlimit (RLIMIT_AS, &rl);
   lumiera_malloc (200*1024*1024);
-  NOTREACHED;
+  NOTREACHED();
 }
 
 TEST ("streq")

From 8c6eaa639436fb628d4e0b988f63d5fba4fb3b19 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 4 Sep 2009 17:43:53 +0200
Subject: [PATCH 285/368] WIP WiringSituation starts to become an important
 entity on it's own

---
 src/proc/engine/nodewiring-def.hpp | 114 +++++++++++++++++++++++++++++
 src/proc/engine/nodewiring.hpp     |  33 ++-------
 2 files changed, 122 insertions(+), 25 deletions(-)
 create mode 100644 src/proc/engine/nodewiring-def.hpp

diff --git a/src/proc/engine/nodewiring-def.hpp b/src/proc/engine/nodewiring-def.hpp
new file mode 100644
index 000000000..0a025f35e
--- /dev/null
+++ b/src/proc/engine/nodewiring-def.hpp
@@ -0,0 +1,114 @@
+/*
+  NODEWIRING-DEF.hpp  -  Implementation of the node network and operation control
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file nodewiring-def.hpp
+ ** Helper for defining the desired wiring and operation mode for a render node.
+ ** During the Builder run, the render nodes network is wired up starting from the
+ ** source (generating) nodes up to the exit nodes. As the wiring is implemented through
+ ** a const engine::WiringDescriptor, when a new node gets fabricated, all of the connections
+ ** to its predecessors need to be completely settled; similarly, any informations pertaining
+ ** the desired operation mode of this node need to be available. Thus we use this temporary
+ ** information record to assemble all these informations.
+ ** 
+ ** @see proc::engine::NodeFactory
+ ** @see nodewiring.hpp
+ ** @see node-basic-test.cpp
+ ** 
+ */
+
+
+#ifndef ENGINE_NODEWIRING_DEF_H
+#define ENGINE_NODEWIRING_DEF_H
+
+
+#include "proc/engine/procnode.hpp"
+
+#include <boost/noncopyable.hpp>
+//#include <boost/scoped_ptr.hpp>
+//#include <cstddef>
+
+
+
+namespace engine {
+  
+  
+  
+  /**
+   * Finding out about a concrete way of wiring up a
+   * ProcNode about to be built. Such a (temporary) setup object
+   * is used while building the low-level model. It is loaded with
+   * information concerning the intended connections to be made
+   * and then used to initialise the wiring descriptor, which
+   * in turn allows us to setup the ProcNode.
+   * 
+   * \par intended usage pattern
+   * The goal is to describe the constellation of a new node to be built.
+   * Thus, we start with one or several existing nodes, specifying which
+   * output should go to which input pin of the yet-to-be created new node.
+   * When intending to create a source node, a default WiringSituation
+   * should be used, without adding any connection information. 
+   */
+  class WiringSituation
+    : boost::noncopyable
+    {
+    protected:
+      RefArray<ChannelDescriptor>& makeOutDescriptor() ;
+      RefArray<InChanDescriptor>&  makeInDescriptor() ;
+      WiringDescriptor::ProcFunc*  resolveProcessingFunction() ;
+      lumiera::NodeID const&       createNodeID() ;
+      
+      friend class NodeWiring;
+      
+      
+    public: /* === API for specifying the desired wiring === */
+      
+      /** A default WiringSituation doesn't specify any connections.
+       *  It can be used as-is for building a source node, or augmented
+       *  with connection informations later on.
+       */
+      WiringSituation()
+        {
+          UNIMPLEMENTED ("representation of the intended wiring");
+        }
+      
+      
+      /** Continue the wiring by hooking directly into the output
+       *  of an existing predecessor node
+       */
+      WiringSituation (PNode predecessor)
+        {
+          UNIMPLEMENTED ("wiring representation; hook up connections 1:1");
+          REQUIRE (predecessor);
+          
+          //////////////////////////TODO: see Ticket 254
+          // for_each (predecessor->outputs(), .....   see also Ticket 183 (invoking member fun in for_each)
+          
+        }
+      
+      
+      
+    };
+  
+  
+  
+} // namespace engine
+#endif
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 354b5d0fa..64b007ab3 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -27,16 +27,17 @@
 
 #include "proc/engine/procnode.hpp"
 #include "lib/allocationcluster.hpp"
+#include "proc/engine/nodewiring-def.hpp"
 
-#include <boost/noncopyable.hpp>
+//#include <boost/noncopyable.hpp>
 #include <boost/scoped_ptr.hpp>
-#include <cstddef>
+//#include <cstddef>
 
 
 
 namespace engine {
-
-
+  
+  
   class WiringFactory;
   
   namespace config { class WiringFactoryImpl; }
@@ -44,24 +45,6 @@ namespace engine {
   using lib::RefArray;
   
   
-  /**
-   * Finding out about a concrete way of wiring up a
-   * ProcNode about to be built. Such a (temporary) setup object
-   * is used while building the low-level model. It is loaded with
-   * information concerning the intended connections to be made
-   * and then used to initialise the wiring descriptor, which
-   * in turn allows us to setup the ProcNode.  
-   */
-  class WiringSituation : boost::noncopyable
-    {
-    public:
-      RefArray<ChannelDescriptor>& makeOutDescriptor() ;
-      RefArray<InChanDescriptor>&  makeInDescriptor() ;
-      WiringDescriptor::ProcFunc*  resolveProcessingFunction() ;
-      lumiera::NodeID const&       createNodeID() ;
-    };
-  
-  
   
   
   /**
@@ -97,9 +80,9 @@ namespace engine {
         }
       
     };
-
-    
-    
+  
+  
+  
   class WiringFactory
     {
       lib::AllocationCluster& alloc_;

From 32612a1a97f11c7df546643c4f4ef82d5582eaff Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 03:04:00 +0200
Subject: [PATCH 286/368] WIP: link between asset::Proc and the Build process,
 allowing to resolve the processing function

---
 src/proc/asset/effect.hpp           | 14 ++++++++++++++
 src/proc/asset/proc.hpp             |  6 ++++++
 src/proc/engine/procnode.hpp        |  3 ++-
 src/proc/mobject/session/effect.hpp |  6 +++++-
 wiki/renderengine.html              | 21 +++++++++++++++++----
 5 files changed, 44 insertions(+), 6 deletions(-)

diff --git a/src/proc/asset/effect.hpp b/src/proc/asset/effect.hpp
index 5d00e44b8..df1472a36 100644
--- a/src/proc/asset/effect.hpp
+++ b/src/proc/asset/effect.hpp
@@ -36,7 +36,21 @@ namespace asset
    */
   class Effect : public Proc
     {
+    
+    public:
+      /** resolve any plugin and configuration info
+       *  to yield the actual media data processing function.
+       *  @return a function ready to be invoked; either the 
+       *          "real thing" or a suitable placeholder.
+       *  @throw lumiera::error::Fatal if unable to provide
+       *         any usable function or placeholder. This case
+       *         can be considered exceptional and justifies a
+       *         subsystem failure.
+       */
+      ProcFunc*
+      resolveProcessor();
       
+
     };
     
     
diff --git a/src/proc/asset/proc.hpp b/src/proc/asset/proc.hpp
index 5f8099212..406270d09 100644
--- a/src/proc/asset/proc.hpp
+++ b/src/proc/asset/proc.hpp
@@ -39,6 +39,7 @@
 
 #include "proc/asset.hpp"
 #include "lib/factory.hpp"
+#include "lib/streamtype.hpp"
 
 
 
@@ -76,6 +77,11 @@ namespace asset {
           return static_cast<const ID<Proc>& > (Asset::getID()); 
         }
       
+      typedef lumiera::StreamType::ImplFacade::DataBuffer Buff;
+      typedef Buff* PBuff;
+      typedef void (ProcFunc) (PBuff);
+      
+      
     protected:
       Proc (const Asset::Ident& idi) : Asset(idi) {}  //////////////TODO
       friend class ProcFactory;
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index 000666d96..e68f35cf6 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -44,6 +44,7 @@
 
 #include "proc/common.hpp"
 #include "proc/state.hpp"
+#include "proc/asset/proc.hpp"
 #include "proc/mobject/parameter.hpp"
 #include "lib/frameid.hpp"
 #include "lib/refarray.hpp"
@@ -75,7 +76,7 @@ namespace engine {
       lib::RefArray<ChannelDescriptor>& out;
       lib::RefArray<InChanDescriptor>&  in;
       
-      typedef void (ProcFunc) (BuffHandle::PBuff);
+      typedef asset::Proc::ProcFunc ProcFunc;
       
       ProcFunc* procFunction;
       
diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp
index 7b3cb452e..967353e9a 100644
--- a/src/proc/mobject/session/effect.hpp
+++ b/src/proc/mobject/session/effect.hpp
@@ -24,9 +24,11 @@
 #ifndef MOBJECT_SESSION_EFFECT_H
 #define MOBJECT_SESSION_EFFECT_H
 
-#include <string>
 
 #include "proc/mobject/session/abstractmo.hpp"
+#include "proc/asset/effect.hpp"
+
+#include <string>
 
 
 using std::string;
@@ -42,6 +44,8 @@ namespace session {
       /** Identifier of the Plug-in to be used */
       string pluginID;
       
+    public:
+      
     };
   
   
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index ef9aa91a0..b36adb355 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -2227,8 +2227,18 @@ So, when creating a clip out of such a compound media asset, the clip has to be
 * we distinguish elementay (non-compound) Clips from compound clips by concrete subtype. The builder can only handle elementary clips, because he needs to build a separate pipeline for every output channel. So the work of splitting common effect stacks for clips with several channels needs to be done when calculating the Fixture for the current EDL. The Builder expects to be able to build the render nodes corresponding to each entity found in the Fixture one by one.
 * the Builder gets at the ProcPatt (descriptor) of the underlying media for each clip and uses this description as a template to build the render pipeline. That is, the ProcPatt specifies the codec asset and maybe some additional effect assets (deinterlace, scale) necessary for feeding media data corresponding to this clip/media into the render nodes network.</pre>
 </div>
-<div title="NodeCreatorTool" modifier="Ichthyostega" modified="200810170222" created="200712100626" tags="def" changecount="2">
-<pre>~NodeCreatorTool is a [[visiting tool|VisitorUse]] used as second step in the [[Builder]]. Starting out from a [[Fixture]], the builder first [[divides the Timeline into segments|SegmentationTool]] and then processes each segment with the NodeCreaterTool to build a render nodes network (Render Engine) for this part of the timeline. While visiting individual Objects and Placements, the NodeCreaterTool creates and wires the necessary [[nodes|ProcNode]]</pre>
+<div title="NodeConfiguration" modifier="Ichthyostega" modified="200909041807" created="200909041806" tags="spec Builder Rendering" changecount="2">
+<pre>Various aspects of the individual [[render node|ProcNode]] are subject to configuration and may influence the output quality or the behaviour of the render process.
+* the selection //what// actual implementation (plugin) to used for a formally defined &amp;raquo;[[Effect|EffectHandling]]&amp;laquo;
+* the intermediary/common StreamType to use within a [[Pipe]]
+* the render technology (CPU, hardware accelerated {{red{&amp;rarr; Future}}})
+* the ScheduleStrategy (possibly subdividing the calculation of a single frame)
+* if this node becomes a possible CachePoint or DataMigrationPoint in RenderFarm mode
+* details of picking a suitable [[operation mode|RenderImplDetails]] of the node (e.g. utilitsing &quot;in-place&quot; calculation)
+</pre>
+</div>
+<div title="NodeCreatorTool" modifier="Ichthyostega" modified="200909041744" created="200712100626" tags="def" changecount="3">
+<pre>~NodeCreatorTool is a [[visiting tool|VisitorUse]] used as second step in the [[Builder]]. Starting out from a [[Fixture]], the builder first [[divides the Timeline into segments|SegmentationTool]] and then processes each segment with the ~NodeCreatorTool to build a render nodes network (Render Engine) for this part of the timeline. While visiting individual Objects and Placements, the NodeCreaterTool creates and wires the necessary [[nodes|ProcNode]]</pre>
 </div>
 <div title="NodeFrameNumbering" modifier="Ichthyostega" modified="200810160129" created="200810140254" tags="spec draft" changecount="3">
 <pre>!Problem of Frame identification
@@ -2298,12 +2308,12 @@ But because I know the opinions on this topc are varying (users tend to be delig
 My proposed aproach is to treat OpenGL as a separate video raw data type, requiring separete and specialized [[Processing Nodes|ProcNode]] for all calculations. Thus the Builder could connect OpenGL nodes if it is possible to cover the whole render path for preview and fall back to the normal ~ProcNodes for all relevant renders
 </pre>
 </div>
-<div title="OperationPoint" modifier="Ichthyostega" modified="200908291632" created="200805270334" tags="def impl Builder" changecount="7">
+<div title="OperationPoint" modifier="Ichthyostega" modified="200909041742" created="200805270334" tags="def impl Builder" changecount="8">
 <pre>A low-level abstraction within the [[Builder]] &amp;mdash; it serves to encapsulate the details of making multi-channel connections between the render nodes: In some cases, a node can handle N channels internally, while in other cases we need to replicate the node N times and wire each channel individually. As it stands, the OperationPoint marks the ''borderline between high-level and low-level model'': it is invoked in terms of ~MObjects and other entities of the high-level view, but internally it manages to create ProcNode and similar entities of the low-level model.
 
 The operation point is provided by the current BuilderMould and used by the [[processing pattern|ProcPatt]] executing within this mould and conducting the current build step. The operation point's interface allows //to abstract//&amp;nbsp; these details, as well as to //gain additional control//&amp;nbsp; if necessary (e.g. addressing only one of the channels). The most prominent build instruction used within the processing patterns (which is the instruction {{{&quot;attach&quot;}}}) relies on the aforementioned //approach of abstracted handling,// letting the operation point determine automatically how to make the connection.
 
-This is possible because the operation point has been provided (by the mould) with informations about the media stream type to be wired, which, together with information accessible at the the [[render node interface|ProcNode]] and from the [[referred processing assets|ProcAsset]], with the help of the [[connection manager|ConManager]] allows to figure out what's possible and how to do the desired connections.
+This is possible because the operation point has been provided (by the mould) with informations about the media stream type to be wired, which, together with information accessible at the the [[render node interface|ProcNode]] and from the [[referred processing assets|ProcAsset]], with the help of the [[connection manager|ConManager]] allows to figure out what's possible and how to do the desired connections. Additionally, in the course of deciding about possible connections, the PathManager is consulted to guide strategic decisions regarding the [[render node configuration|NodeConfiguration]], possible type conversions and the rendering technology to employ.
 </pre>
 </div>
 <div title="Overview" modifier="Ichthyostega" modified="200906071810" created="200706190300" tags="overview img" changecount="13">
@@ -2879,6 +2889,9 @@ DAMAGE.
 &lt;html&gt;&lt;sub&gt;&lt;a href=&quot;javascript:;&quot; onclick=&quot;scrollAnchorVisible('Top',null, event)&quot;&gt;[Top]&lt;/sub&gt;&lt;/a&gt;&lt;/html&gt;
 ***/</pre>
 </div>
+<div title="PathManager" modifier="Ichthyostega" created="200909041748" tags="def Builder" changecount="1">
+<pre>Facility guiding decisions regarding the strategy to employ for rendering or wiring up connections. The PathManager is querried through the OperationPoint, when executing the connection steps within the Build process.</pre>
+</div>
 <div title="Pipe" modifier="Ichthyostega" modified="200804110301" created="200801062110" tags="def decision" changecount="6">
 <pre>Pipes play an central role within the Proc Layer, because for everything placed and handled within the EDL, the final goal is to get it transformed into data which can be retrieved at some pipe's exit port. Pipes are special facilities, rather like inventory, separate and not treated like all the other objects.
 We don't distinguish between &quot;input&quot; and &quot;output&quot; ports &amp;mdash; rather, pipes are thought to be ''hooks for making connections to''. By following this line of thought, each pipe has an input side and an output side and is in itself something like a ''Bus'' or ''processing chain''. Other processing entities like effects and transitions can be placed (attached) at the pipe, resulting them to be appended to form this chain. Likewise, we can place [[wiring requests|WiringRequest]] to the pipe, meaning we want it connected so to send it's output to another destination pipe. The [[Builder]] may generate further wiring requests to fulfil the placement of other entities.

From 143096579828b3aaf7387f84609cdc54663bf47f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 04:10:51 +0200
Subject: [PATCH 287/368] WIP: implementation of a node fabrication code path

---
 src/proc/asset/effect.cpp                     |  7 ++-
 src/proc/asset/effect.hpp                     | 29 +++++-----
 src/proc/asset/proc.hpp                       | 14 +++++
 src/proc/engine/buffhandle.hpp                |  4 +-
 src/proc/engine/nodefactory.cpp               | 53 ++++--------------
 src/proc/engine/nodefactory.hpp               | 23 ++++++--
 src/proc/engine/nodewiring-config.hpp         |  1 +
 src/proc/engine/nodewiring-def.hpp            | 54 +++++++++++++++++++
 src/proc/engine/nodewiring.cpp                | 32 ++++++-----
 src/proc/engine/nodewiring.hpp                |  3 +-
 src/proc/engine/procnode.hpp                  | 17 +++++-
 src/proc/mobject/session/effect.hpp           |  4 ++
 .../proc/engine/node-basic-test.cpp           | 10 +++-
 13 files changed, 163 insertions(+), 88 deletions(-)

diff --git a/src/proc/asset/effect.cpp b/src/proc/asset/effect.cpp
index e8203996e..cf795dc08 100644
--- a/src/proc/asset/effect.cpp
+++ b/src/proc/asset/effect.cpp
@@ -23,8 +23,13 @@
 
 #include "proc/asset/effect.hpp"
 
-namespace asset
+namespace asset {
+  
+  Proc::ProcFunc*
+  Effect::resolveProcessor()  const
   {
+    UNIMPLEMENTED ("do the actual resolution plugin -> callable processing function");
+  }
 
 
 
diff --git a/src/proc/asset/effect.hpp b/src/proc/asset/effect.hpp
index df1472a36..a9b470b17 100644
--- a/src/proc/asset/effect.hpp
+++ b/src/proc/asset/effect.hpp
@@ -28,8 +28,7 @@
 
 
 
-namespace asset
-  {
+namespace asset {
   
   /**
    * Effect or media processing component
@@ -38,22 +37,18 @@ namespace asset
     {
     
     public:
-      /** resolve any plugin and configuration info
-       *  to yield the actual media data processing function.
-       *  @return a function ready to be invoked; either the 
-       *          "real thing" or a suitable placeholder.
-       *  @throw lumiera::error::Fatal if unable to provide
-       *         any usable function or placeholder. This case
-       *         can be considered exceptional and justifies a
-       *         subsystem failure.
-       */
-      ProcFunc*
-      resolveProcessor();
       
-
+      
+    private:
+      /** implementation of how to resolve the corresponding plugin
+       *  to yield an actual media data processing function. */
+      ProcFunc*
+      resolveProcessor()  const;
+      
+      
     };
-    
-    
-    
+  
+  
+  
 } // namespace asset
 #endif
diff --git a/src/proc/asset/proc.hpp b/src/proc/asset/proc.hpp
index 406270d09..61ce66cbc 100644
--- a/src/proc/asset/proc.hpp
+++ b/src/proc/asset/proc.hpp
@@ -82,6 +82,20 @@ namespace asset {
       typedef void (ProcFunc) (PBuff);
       
       
+      /** resolve any plugin and configuration info
+       *  to yield the actual media data processing function.
+       *  @return a function ready to be invoked; either the 
+       *          "real thing" or a suitable placeholder.
+       *  @throw lumiera::error::Fatal if unable to provide
+       *         any usable function or placeholder. This case
+       *         can be considered exceptional and justifies a
+       *         subsystem failure.
+       */
+      virtual ProcFunc*
+      resolveProcessor()  const =0;
+      
+
+      
     protected:
       Proc (const Asset::Ident& idi) : Asset(idi) {}  //////////////TODO
       friend class ProcFactory;
diff --git a/src/proc/engine/buffhandle.hpp b/src/proc/engine/buffhandle.hpp
index c2602cc96..cdf1135e6 100644
--- a/src/proc/engine/buffhandle.hpp
+++ b/src/proc/engine/buffhandle.hpp
@@ -30,9 +30,10 @@
  ** thus it makes sense to utilise a single large buffer pointer array per pull() calldown
  ** sequence and dynamically claim small chunks for each node.
  **
+ ** @see nodewiring-def.hpp
  ** @see nodeoperation.hpp
  ** @see bufftable.hpp       storage for the buffer table
- ** @see engine::Invocation
+ ** @see engine::RenderInvocation
  */
 
 #ifndef ENGINE_BUFFHANDLE_H
@@ -116,7 +117,6 @@ namespace engine {
     };
   
   
-  //////TODO: invent an input/output description pattern, which can be passed to the wiring factory
   
 } // namespace engine
 #endif
diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index abdbc4a01..3c7299c21 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -31,45 +31,8 @@ namespace engine {
   
   namespace { // Details of node fabrication
 
-    using lib::AllocationCluster;
-    
-    template<class NODE>
-    NODE &
-    makeNode ()
-    {
-      ////TODO: this is a draft how it /might/ work
-      ////TODO: of course this can't be hard wired....
-      
-      ProcNode * predecessor1, predecessor2;
-      
-      WiringSituation setup;
-      setup.defineInput (4, predecessor1, 2);
-      setup.defineInput (2, predecessor2);
-      
-      WiringFactory* wFac;
-      
-      AllocationCluster allocator;
-      bool doCache = (2 == 2); // find out Cache should be used for this node
-      
-      WiringDescriptor & wDesc = (*wFac)(setup,doCache);
-      
-      NODE* newNode = allocator.create<NODE> (wDesc);
-      
-      return *newNode;
-      
-      /*
-       * Problems to be solved:                                                                        /////////////TODO: see Ticket #247
-       * - write a generic allocator, which later on can be augmented to do block wise bulk allocation /////////////DONE: AllocationCluster
-       * - the allocator needs to keep track of the objects; actually he owns the objects              /////////////DONE
-       * - we need to access the wiring descriptor of the predecessor nodes. Which means, the code
-       *   must be in the body of NodeFactory (because the latter is friend of ProcNode and can access the wiring descriptor)
-       * - btw reconsider if this level of protection is necessary, or if the const WiringDescriptor cant be just on the public interface of ProcNode
-       * - find out how the Caching/ReadInput/InPlace detection can work
-       * - think about a sensible Ctor for NodeFactory. This one must create the WiringFactory and pass the Allocator.
-       * - all of this will be installed into the ToolFactory, i.e. it is part of the build process
-       */
-    }
-    
+    ////////////////////////////////////////////////TODO: still needed?
+  
   } // (END) Details of node fabrication
   
   
@@ -78,10 +41,16 @@ namespace engine {
   
   
   /** create a processing node able to render an effect */
-  PTrafo
-  NodeFactory::operator() (Placement<Effect> const&)
+  PNode
+  NodeFactory::operator() (Placement<Effect> const& effect, WiringSituation& intendedWiring)
   {
-    UNIMPLEMENTED ("create proc node for Effect/Plugin");
+    intendedWiring.resolveProcessor(effect->getProcAsset());
+    WiringDescriptor& wiring = wiringFac_(intendedWiring);
+    
+    PNode newNode = alloc_.create<ProcNode> (wiring);
+    ENSURE (newNode);
+    ENSURE (newNode->isValid());
+    return newNode;
   }
 
 
diff --git a/src/proc/engine/nodefactory.hpp b/src/proc/engine/nodefactory.hpp
index 112f2ccc7..4c3d9e679 100644
--- a/src/proc/engine/nodefactory.hpp
+++ b/src/proc/engine/nodefactory.hpp
@@ -26,8 +26,12 @@
 
 #include "proc/engine/procnode.hpp"
 #include "proc/mobject/placement.hpp"
+#include "proc/engine/nodewiring.hpp"
 
 
+  ////////////////////////////////////TODO: make inclusions / forward definitions a bit more orthogonal....
+
+namespace lib { class AllocationCluster; }
 
 namespace mobject {
 namespace session {
@@ -43,9 +47,13 @@ namespace session {
 namespace engine {
 
   using std::vector;
+  using lib::AllocationCluster;
   
+  ///////////////////////////// TODO: as of 9/09, it seems no longer necessary to use any subclasses of ProcNode
   class Trafo;
-  typedef Trafo* PTrafo;    ///< @note ProcNode is handled by pointer and bulk allocated/deallocated 
+  typedef Trafo* PTrafo;    ///< @note ProcNode is handled by pointer and bulk allocated/deallocated
+  
+  class WiringSituation;
 
 
   /**
@@ -53,10 +61,17 @@ namespace engine {
    */
   class NodeFactory
     {
+      AllocationCluster& alloc_;
+      WiringFactory wiringFac_;
       
-      public:
-        
-        PTrafo  operator() (mobject::session::PEffect const&);
+    public:
+      NodeFactory (AllocationCluster& a)
+        : alloc_(a)
+        , wiringFac_(alloc_)
+        { }
+      
+      
+      PNode operator() (mobject::session::PEffect const&, WiringSituation&);
         
     };
 
diff --git a/src/proc/engine/nodewiring-config.hpp b/src/proc/engine/nodewiring-config.hpp
index d1063f8da..47d0eb395 100644
--- a/src/proc/engine/nodewiring-config.hpp
+++ b/src/proc/engine/nodewiring-config.hpp
@@ -43,6 +43,7 @@
  ** @see proc::engine::config::Strategy
  ** @see nodewiring.hpp
  ** @see configflags.hpp
+ ** @see config-flags-test.cpp
  ** 
  */
 
diff --git a/src/proc/engine/nodewiring-def.hpp b/src/proc/engine/nodewiring-def.hpp
index 0a025f35e..c5f37c2bc 100644
--- a/src/proc/engine/nodewiring-def.hpp
+++ b/src/proc/engine/nodewiring-def.hpp
@@ -41,6 +41,7 @@
 
 
 #include "proc/engine/procnode.hpp"
+#include "lib/refarray.hpp"
 
 #include <boost/noncopyable.hpp>
 //#include <boost/scoped_ptr.hpp>
@@ -50,6 +51,7 @@
 
 namespace engine {
   
+  using lib::RefArray;
   
   
   /**
@@ -70,6 +72,9 @@ namespace engine {
   class WiringSituation
     : boost::noncopyable
     {
+      long flags_;
+      asset::Proc::ProcFunc* function_;
+      
     protected:
       RefArray<ChannelDescriptor>& makeOutDescriptor() ;
       RefArray<InChanDescriptor>&  makeInDescriptor() ;
@@ -86,6 +91,8 @@ namespace engine {
        *  with connection informations later on.
        */
       WiringSituation()
+        : flags_(0)
+        , function_(0)
         {
           UNIMPLEMENTED ("representation of the intended wiring");
         }
@@ -95,6 +102,8 @@ namespace engine {
        *  of an existing predecessor node
        */
       WiringSituation (PNode predecessor)
+        : flags_(0)
+        , function_(0)
         {
           UNIMPLEMENTED ("wiring representation; hook up connections 1:1");
           REQUIRE (predecessor);
@@ -105,6 +114,51 @@ namespace engine {
         }
       
       
+      /** set up a connection leading to a specific input pin of the new node */
+      WiringSituation&
+      defineInput (uint inPin, PNode pred, uint outPin)
+        {
+          UNIMPLEMENTED ("wiring representation; define new connection");
+          return *this;
+        }
+      
+      /** set up the next input connection,
+       *  originating at a specific output pin of the predecessor */
+      WiringSituation&
+      defineInput (PNode pred, uint outPin)
+        {
+          UNIMPLEMENTED ("wiring representation; define new connection");
+          return *this;
+        }
+      
+      /** set up the next input connection to a specific input pin,
+       *  originating at a the next/sole output pin of the predecessor */
+      WiringSituation&
+      defineInput (uint inPin, PNode pred)
+        {
+          UNIMPLEMENTED ("wiring representation; define new connection");
+          return *this;
+        }
+      
+      
+      /** set detail flags regarding the desired node operation mode */
+      WiringSituation&
+      setFlag (long code)
+        {
+          flags_ |= code;
+          return *this;
+        }
+      
+      long getFlags ()  const { return flags_; }
+      
+      
+      /** trigger resolving of the actual processing function */
+      WiringSituation&
+      resolveProcessor (asset::Proc const& procAsset)
+        {
+          function_ = procAsset.resolveProcessor();
+          ENSURE (function_);
+        }
       
     };
   
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index 41b212af5..f32b02bf3 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -109,7 +109,7 @@ namespace engine {
       {
         WiringSelector selector;
         
-        WiringFactoryImpl (Alloc& alloc)
+        WiringFactoryImpl (AllocationCluster& alloc)
           : selector(config::PossibleConfigs::List(), alloc)
           { }
       };
@@ -119,42 +119,40 @@ namespace engine {
   
   
   
-  /** As the WiringFactory (an all the embedded factories
+  /** As the WiringFactory (and all the embedded factories
    *  for the specific wiring situations) use the AllocationCluster
    *  of the current build process, we need to create a new instance
    *  for each newly built segment of the low-level model.
+   *  @note As this ctor creates a WiringFactoryImpl instance, 
+   *        compiling this invocation actually drives the necessary
+   *        template instantiations for all cases encountered while
+   *        building the node network.
    */
   WiringFactory::WiringFactory (lib::AllocationCluster& a)
     : alloc_(a),
       pImpl_(new config::WiringFactoryImpl (alloc_))
     { }
+  
+  
+  WiringFactory::~WiringFactory () {}
+
       
 
   
   /** create and configure a concrete wiring descriptor to tie
    *  a ProcNode to its predecessor nodes. This includes selecting
-   *  the actual StateAdapter type, configuring it out of some operation
-   *  control templates (policy classes). Compiling this operator function
-   *  actually drives the necessary template instantiations for all cases
-   *  encountered while building the node network.
+   *  the actual StateAdapter type, configuring it based on operation
+   *  control templates (policy classes).
    *  The created WiringDescriptor object is bulk allocated similar to the ProcNode
    *  objects for a given segment of the Timeline. It should be further configured
    *  with the actual predecessor nodes pointers and can then be used to create
    *  the new processing node to be wired up.  
    */
   WiringDescriptor&
-  WiringFactory::operator() (WiringSituation& setup, bool cache)
+  WiringFactory::operator() (WiringSituation const& setup)
   {
-    UNIMPLEMENTED ("build the actual wiring descriptor based on given operation options");
-
-            ///////////////////////////////////////////////////////////////////////////////TODO: how to get the WiringSituation into the factory????
-    
-    
-//    Bits config (FlagInfo<Config>::CODE);
-//    return pImpl_->selector[config]();
-    ////
-   /////TODO: change the FunctionType to take an "input/output description pattern"
-   /////TODO: invent such a pattern ---> buffhandle.hpp
+    long config = setup.getFlags();
+    return pImpl_->selector[config] (setup);
   }
   
   
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index 64b007ab3..abc369fa2 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -90,9 +90,10 @@ namespace engine {
       
     public:
       WiringFactory (lib::AllocationCluster& a);
+     ~WiringFactory ();
       
       WiringDescriptor&
-      operator() (WiringSituation& setup, bool cache);  //////////////////TODO: of course this will accept *all* the relevant flags (not only "cache")
+      operator() (WiringSituation const& setup);
     };
   
   
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index e68f35cf6..be54a32c4 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -101,7 +101,8 @@ namespace engine {
        *  holding the actual buffer pointers and issuing the recursive pull() calls
        *  @see NodeWiring#callDown default implementation
        */
-      virtual BuffHandle  callDown (State& currentProcess, uint requiredOutputNr)  const =0; 
+      virtual BuffHandle
+      callDown (State& currentProcess, uint requiredOutputNr)  const =0; 
       
       friend class ProcNode;
       
@@ -125,17 +126,20 @@ namespace engine {
         : wiringConfig_(wd)
         { }
         
-      virtual ~ProcNode() {};
       
       friend class NodeFactory;
       
       
       
     public:
+      virtual ~ProcNode() {};  /////////////////////////TODO: do we still intend to build a hierarchy below ProcNode???
+      
+      bool isValid()  const;
       
       /** output channel count */
       uint nrO() { return wiringConfig_.nrO; }
       
+      
       /** Engine Core operation: render and pull output from this node.
        *  On return, currentProcess will hold onto output buffer(s)
        *  containing the calculated result frames. In case this node
@@ -156,5 +160,14 @@ namespace engine {
       
     };
   
+  
+  bool
+  ProcNode::isValid()  const
+  {
+    UNIMPLEMENTED ("ProcNode validity self-check");
+    return false; //////////////////////////TODO
+  }
+  
+  
 } // namespace engine
 #endif
diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp
index 967353e9a..52b21bb54 100644
--- a/src/proc/mobject/session/effect.hpp
+++ b/src/proc/mobject/session/effect.hpp
@@ -37,6 +37,8 @@ using std::string;
 namespace mobject {
 namespace session {
   
+  using asset::PProc;
+  
   
   class Effect : public AbstractMO
     {
@@ -45,6 +47,8 @@ namespace session {
       string pluginID;
       
     public:
+      /** access the underlying processing asset */
+      PProc getProcAsset ()  const;
       
     };
   
diff --git a/tests/components/proc/engine/node-basic-test.cpp b/tests/components/proc/engine/node-basic-test.cpp
index 3c1aee4d7..c3b89e802 100644
--- a/tests/components/proc/engine/node-basic-test.cpp
+++ b/tests/components/proc/engine/node-basic-test.cpp
@@ -77,9 +77,15 @@ namespace test  {
           AllocationCluster alloc;
           NodeFactory nodeFab(alloc);
           
-          PEffect pEffect;  /////////////////TODO how to get an simple Effect MObject for Tests???
-          WiringSituation setup;
+          ProcNode * testSource;  ///////////TODO: how to fabricate a test-Node???
           
+          
+          WiringSituation setup(testSource);
+          
+          setup.defineInput (4, predecessor1, 2);
+          setup.defineInput (2, predecessor2);
+          
+          PEffect pEffect;  /////////////////TODO how to get an simple Effect MObject for Tests???
           ProcNode* pNode = nodeFab (pEffect, setup);
           ASSERT (pNode);
           

From ce7c78ef8bca7f2458c9a46d5e46b3cf469c76d2 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sat, 5 Sep 2009 04:41:53 +0200
Subject: [PATCH 288/368] New test.sh version from nobug

---
 tests/test.sh | 26 +++++++++++++++++---------
 1 file changed, 17 insertions(+), 9 deletions(-)

diff --git a/tests/test.sh b/tests/test.sh
index ce4ef4dee..89de9ae54 100755
--- a/tests/test.sh
+++ b/tests/test.sh
@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #  Copyright (C)         Lumiera.org
 #    2007 - 2008,        Christian Thaeter <ct@pipapo.org>
 #
@@ -26,10 +26,11 @@
 #   stop testing on the first failure
 
 export LC_ALL=C
-NOBUG_LOGREGEX='^\(\*\*[0-9]*\*\* \)\?[0-9]\{10,\}: \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\|TODO\|PLANNED\|FIXME\|DEPRECATED\|UNIMPLEMENTED\|NOTREACHED\):'
+NOBUG_LOGREGEX='^\(\*\*[0-9]*\*\* \)\?[0-9]\{10,\}: \(TRACE\|INFO\|NOTICE\|WARNING\|ERR\|TODO\|PLANNED\|FIXME\|DEPRECATED\|UNIMPLEMENTED\):'
 
 arg0="$0"
 srcdir="$(dirname "$arg0")"
+vgsuppression_mangle='/^\(\(==\)\|\(\*\*\)[0-9]*\(==\)\|\(\*\*\)\)\|\(\(\*\*[0-9]*\*\* \)\?[0-9]\{10,\}: ECHO:\)/d;'
 
 ulimit -S -t 5 -v 524288
 valgrind=""
@@ -44,10 +45,10 @@ else
 
                 if [[ -x ".libs/vgsuppression" ]]; then
                     ./libtool --mode=execute valgrind --leak-check=yes --show-reachable=yes -q --gen-suppressions=all vgsuppression 2>&1 \
-                        | sed '/^\(==\)\|\(\*\*\)[0-9]*\(==\)\|\(\*\*\)/d;' >vgsuppression.supp
+                        | sed -e "$vgsuppression_mangle" >vgsuppression.supp
                 else
                     valgrind --leak-check=yes --show-reachable=yes -q --gen-suppressions=all ./vgsuppression 2>&1 \
-                        | sed '/^\(==\)\|\(\*\*\)[0-9]*\(==\)\|\(\*\*\)/d;' >vgsuppression.supp
+                        | sed -e "$vgsuppression_mangle" >vgsuppression.supp
                 fi
             fi
             valgrind="$(which valgrind) --leak-check=yes --show-reachable=no --suppressions=vgsuppression.supp -q $VALGRINDFLAGS"
@@ -117,6 +118,7 @@ function TEST()
         rm -f ,send_stdin
         rm -f ,expect_stdout
         rm -f ,expect_stderr
+        expect_return=0
 
 	while read -r line; do
             cmd="${line%%:*}"
@@ -125,7 +127,6 @@ function TEST()
             if [[ ! "$arg" ]]; then
                 arg='^$'
             fi
-            expect_return=0
 
             case $cmd in
             'in')
@@ -180,17 +181,24 @@ function TEST()
 
         echo -n >,testtmp
 
-        if ! test -x $TESTBIN; then
+        local CALL
+        if declare -F | grep $TESTBIN >&/dev/null; then
+            CALL=
+        elif test -x $TESTBIN; then
+            CALL="env $TESTBIN_PREFIX"
+        else
+            CALL='-'
             echo -n >,stdout
             echo "test binary '$TESTBIN' not found" >,stderr
             ((fails+=1))
+        fi
 
-        else
+        if test "$CALL" != '-'; then
 
             if test -f ,send_stdin; then
-                env $TESTBIN_PREFIX $TESTBIN "$@" <,send_stdin 2>,stderr >,stdout
+                $CALL $TESTBIN "$@" <,send_stdin 2>,stderr >,stdout
             else
-                env $TESTBIN_PREFIX $TESTBIN "$@" 2>,stderr >,stdout
+                $CALL $TESTBIN "$@" 2>,stderr >,stdout
             fi &>/dev/null
             return=$?
 

From d2acbee608b67ebeaadc4f1c8254d9ff1b542b69 Mon Sep 17 00:00:00 2001
From: Christian Thaeter <ct@pipapo.org>
Date: Sat, 5 Sep 2009 04:43:21 +0200
Subject: [PATCH 289/368] update configure to new nobug version

---
 Makefile.am  |  7 ++++---
 configure.ac | 15 ++++++---------
 2 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/Makefile.am b/Makefile.am
index ac8c0a1b4..c23c7611c 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,5 +1,5 @@
 #  Copyright (C)         Lumiera.org
-#    2007,               Christian Thaeter <ct@pipapo.org>
+#    2007, 2009          Christian Thaeter <ct@pipapo.org>
 #    2008,               Joel Holdsworth <joel@airwebreathe.org.uk>
 #
 #  This program is free software; you can redistribute it and/or
@@ -35,8 +35,9 @@ CLEANFILES =
 
 # global pre-processor flags. Per-target variables should include
 # these at the front (if possible) for consistency
-AM_CPPFLAGS = -I$(top_srcdir)/src/ \
-	$(NOBUGMT_LUMIERA_CFLAGS)
+AM_CPPFLAGS = -I$(top_srcdir)/src/ 	\
+	$(NOBUGMT_LUMIERA_CFLAGS)	\
+	$(VALGRIND_CFLAGS)
 
 # Only use subdirs if really needed, prefer the include scheme below
 #SUBDIRS +=
diff --git a/configure.ac b/configure.ac
index d69749882..cc7eee8b6 100644
--- a/configure.ac
+++ b/configure.ac
@@ -40,6 +40,7 @@ AC_PROG_CXX
 
 AC_LIBTOOL_DLOPEN
 AC_PROG_LIBTOOL
+PKG_PROG_PKG_CONFIG([0.22])
 
 #
 # test for headers
@@ -85,9 +86,6 @@ AC_ARG_ENABLE(release, AC_HELP_STRING([--enable-release], [select NoBug RELEASE
 # C headers and libraries
 AC_LANG_PUSH([C])
 
-AC_CHECK_HEADER([execinfo.h], AC_DEFINE(HAVE_EXECINFO_H))
-# there is a warning in nobug, disabled til fixed AC_CHECK_HEADER([valgrind/valgrind.h], AC_DEFINE(HAVE_VALGRIND_VALGRIND_H))
-
 AC_CHECK_LIB(dl, dlopen, [LUMIERA_PLUGIN_LIBS="$LUMIERA_PLUGIN_LIBS -ldl"],
                    [AC_MSG_ERROR([Dynamic linking not supported, report a bug])]
 )
@@ -186,15 +184,14 @@ AC_SUBST(LUMIERA_GUI_LIBS)
 AC_SUBST(LUMIERA_GUI_CFLAGS)
 
 ############## Nobug Dependancies
-PKG_CHECK_MODULES(NOBUG_LUMIERA, [nobug >= 0.3rc1],
-				 AC_DEFINE(HAVE_NOBUG_H),
-				 AC_MSG_ERROR([NoBug pkg-config metadata missing                      (http://www.pipapo.org/pipawiki/NoBug)])
-)
-PKG_CHECK_MODULES(NOBUGMT_LUMIERA, [nobugmt >= 0.3rc1],
+AC_CHECK_HEADER([execinfo.h], AC_DEFINE(HAVE_EXECINFO_H))
+PKG_CHECK_MODULES(VALGRIND, [valgrind], AC_DEFINE(HAVE_VALGRIND_H),
+                             AC_MSG_NOTICE([valgrind not found                                 (optional)]))
+
+PKG_CHECK_MODULES(NOBUGMT_LUMIERA, [nobugmt >= 200909.1],
 				 AC_DEFINE(HAVE_NOBUGMT_H),
 				 AC_MSG_ERROR([NoBug pkg-config metadata missing                      (http://www.pipapo.org/pipawiki/NoBug)])
 )
-
 # END Nobug Dependancies
 
 # Print a summary

From 1969adaf02cc281c6070e1bfb8361c5648b57709 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 18:15:58 +0200
Subject: [PATCH 290/368] Integration of Builder/NodeFactory implementation
 draft. Stubbed to pass compiler

---
 src/lib/frameid.hpp                           |  2 +-
 src/proc/engine/bufftable.hpp                 |  2 +-
 src/proc/engine/nodefactory.cpp               |  7 +-
 src/proc/engine/nodeinvocation.hpp            | 12 ++-
 src/proc/engine/nodeoperation.hpp             | 64 +++++++++-----
 src/proc/engine/nodewiring-config.hpp         |  2 +-
 src/proc/engine/nodewiring-def.hpp            | 31 +++++--
 src/proc/engine/nodewiring.cpp                | 11 +--
 src/proc/engine/nodewiring.hpp                |  8 +-
 src/proc/engine/procnode.hpp                  | 17 ++--
 src/proc/engine/rendergraph.cpp               |  8 ++
 src/proc/mobject/builder/nodecreatortool.cpp  |  7 ++
 src/proc/mobject/builder/nodecreatortool.hpp  | 86 +++++++++----------
 src/proc/mobject/builder/operationpoint.cpp   | 25 +++++-
 src/proc/mobject/builder/operationpoint.hpp   | 11 ++-
 src/proc/mobject/builder/segmentationtool.cpp | 22 +++++
 src/proc/mobject/builder/segmentationtool.hpp |  9 +-
 src/proc/mobject/builder/toolfactory.cpp      | 18 ++--
 src/proc/mobject/session/edl.cpp              |  8 ++
 src/proc/mobject/session/edl.hpp              |  3 +-
 src/proc/mobject/session/effect.cpp           |  9 +-
 src/proc/mobject/session/effect.hpp           |  3 +-
 src/proc/mobject/session/segmentation.hpp     |  2 +-
 tests/common/refarraytest.cpp                 |  4 +-
 .../proc/engine/buff-table-test.cpp           | 12 +--
 .../proc/engine/node-basic-test.cpp           | 11 ++-
 26 files changed, 256 insertions(+), 138 deletions(-)

diff --git a/src/lib/frameid.hpp b/src/lib/frameid.hpp
index ce70f16d0..1e0f2af78 100644
--- a/src/lib/frameid.hpp
+++ b/src/lib/frameid.hpp
@@ -51,7 +51,7 @@ namespace lumiera {
       static ulong currID;
     };
   
-  ulong NodeID::currID (0);
+  
   
   
   /**
diff --git a/src/proc/engine/bufftable.hpp b/src/proc/engine/bufftable.hpp
index e091f940c..7ec679f72 100644
--- a/src/proc/engine/bufftable.hpp
+++ b/src/proc/engine/bufftable.hpp
@@ -137,7 +137,7 @@ namespace engine {
           tab_(storage.claim (siz_)),
           sto_(storage)
         {
-          const uint nrO(wd.getNrO());
+          const uint nrO(wd.nrO);
           
           // Setup the public visible table locations
           this->outHandle = &tab_.first[ 0 ];
diff --git a/src/proc/engine/nodefactory.cpp b/src/proc/engine/nodefactory.cpp
index 3c7299c21..d8dbfa01d 100644
--- a/src/proc/engine/nodefactory.cpp
+++ b/src/proc/engine/nodefactory.cpp
@@ -47,10 +47,9 @@ namespace engine {
     intendedWiring.resolveProcessor(effect->getProcAsset());
     WiringDescriptor& wiring = wiringFac_(intendedWiring);
     
-    PNode newNode = alloc_.create<ProcNode> (wiring);
-    ENSURE (newNode);
-    ENSURE (newNode->isValid());
-    return newNode;
+    ProcNode& newNode = alloc_.create<ProcNode> (wiring);
+    ENSURE (newNode.isValid());
+    return &newNode;
   }
 
 
diff --git a/src/proc/engine/nodeinvocation.hpp b/src/proc/engine/nodeinvocation.hpp
index 13dbbd383..1d57280f4 100644
--- a/src/proc/engine/nodeinvocation.hpp
+++ b/src/proc/engine/nodeinvocation.hpp
@@ -88,7 +88,7 @@ namespace engine {
       
       
       
-    private: /* === proxying the State interface === */
+    public: /* === proxying the State interface === */
       
       virtual void releaseBuffer (BuffHandle& bh)       { current_.releaseBuffer (bh); }
       
@@ -96,6 +96,8 @@ namespace engine {
       
       virtual BuffHandle fetch (FrameID const& fID)     { return current_.fetch (fID); }
       
+      virtual BuffTableStorage& getBuffTableStorage()   { return current_.getBuffTableStorage(); } 
+
       // note: allocateBuffer()  is chosen specifically based on the actual node wiring
       
     };
@@ -132,9 +134,10 @@ namespace engine {
           buffTab(0)
         { }
       
-      const uint nrO()          const { return wiring.nrO; }
-      const uint nrI()          const { return wiring.nrI; }
-      const uint buffTabSize()  const { return nrO()+nrI(); }
+    public:
+      uint nrO()          const { return wiring.nrO; }
+      uint nrI()          const { return wiring.nrI; }
+      uint buffTabSize()  const { return nrO()+nrI(); }
       
       /** setup the link to an externally allocated buffer table */
       void setBuffTab (BuffTable* b) { this->buffTab = b; }
@@ -208,6 +211,7 @@ namespace engine {
   template<class Strategy, class BufferProvider>
   class ActualInvocationProcess
     : public BufferProvider
+    , private Strategy
     {
     public:
       ActualInvocationProcess (State& callingProcess, WiringDescriptor const& w, const uint outCh)
diff --git a/src/proc/engine/nodeoperation.hpp b/src/proc/engine/nodeoperation.hpp
index 838b9a31f..cc8a29137 100644
--- a/src/proc/engine/nodeoperation.hpp
+++ b/src/proc/engine/nodeoperation.hpp
@@ -76,15 +76,37 @@ namespace config {
   
   /**
    * Base class of all concrete invocation sequences.
-   * Could contain a collection of functions used to build up the invocation sequence.
-   * Currently contains just a marker used to detect the existence of an concrete
+   * Provides a collection of functions used to build up the invocation sequence.
+   * Additionally providing a marker used to detect the existence of an concrete
    * definition/specialisation for a given specific configuration.
    */
-  class OperationBase
+  struct OperationBase
     {
       typedef lumiera::Yes_t is_defined;
       
+      BuffHandle
+      getSource (Invocation& ivo, uint chanNo)
+        {
+          UNIMPLEMENTED ("retrieve source data provided by the backend/scheduler");
+        }
       
+      BuffHandle
+      pullPredecessor (Invocation& ivo, uint chanNo)
+        {
+          UNIMPLEMENTED ("invoke pull() on the denoted predecessor node");
+        }
+      
+      void
+      releaseBuffers(BuffHandle* table, uint slotCnt, uint slot_to_retain) //////////////TODO this is going to be implemented rather by smart-handle, Ticket #249
+        {
+          UNIMPLEMENTED ("release all buffers with the exception of the desired output");
+        }
+      
+      bool
+      validateBuffers (Invocation& ivo)
+        {
+          UNIMPLEMENTED ("Do a final, specifically tailored validation step on the buffers prior to invoking the procees function");
+        }
     };
   
   
@@ -130,8 +152,8 @@ namespace config {
           
           for (uint i = 0; i < ivo.nrI(); ++i )
             {
-              inBuff[i] =
-                *(inH[i] = this->pullPredecessor(ivo,i)); // invoke predecessor
+              inBuff[i] = 
+               &*(inH[i] = this->pullPredecessor(ivo,i)); // invoke predecessor
               // now Input #i is ready...
             }
           return NEXT::step (ivo);
@@ -155,7 +177,7 @@ namespace config {
           for (uint i = 0; i < ivo.nrI(); ++i )
             {
               inBuff[i] = outBuff[i] =
-                *(inH[i] = outH[i] = this->getSource(ivo,i));
+               &*(inH[i] = outH[i] = this->getSource(ivo,i));
               // now Input #i is ready...
             }
           return NEXT::step (ivo);
@@ -177,7 +199,7 @@ namespace config {
           for (uint i = 0; i < ivo.nrO(); ++i )
             {
               outBuff[i] =
-                 *(outH[i] = ivo.allocateBuffer (ivo.wiring.out[i].bufferType));
+                &*(outH[i] = ivo.allocateBuffer (ivo.wiring.out[i].bufferType));
               // now Output buffer for channel #i is available...
             }
           return NEXT::step (ivo);
@@ -197,7 +219,7 @@ namespace config {
           
            // Invoke our own process() function,
           //  providing the array of outBuffer+inBuffer ptrs
-          ivo.wiring.procFunction (ivo.buffTab->outBuff);
+          (*ivo.wiring.procFunction) (*ivo.buffTab->outBuff);
           
           return NEXT::step (ivo);
         }
@@ -254,25 +276,21 @@ namespace config {
     };
   
   
-  
-  template< char CACHE_Fl   =NOT_SET
-          , char INPLACE_Fl =NOT_SET
-          >
-  struct SelectBuffProvider;
-  
-  template<> struct SelectBuffProvider<CACHING>         { typedef AllocBufferFromCache  Type; };
-  template<> struct SelectBuffProvider<NOT_SET,INPLACE> { typedef AllocBufferFromParent Type; };
-  template<> struct SelectBuffProvider<CACHING,INPLACE> { typedef AllocBufferFromCache  Type; };
-  template<> struct SelectBuffProvider<>                { typedef AllocBufferFromParent Type; };
+  using lumiera::typelist::Config;
+                                              ///////////////////////TODO: selecting this way isn't especially readable,
+                                              ///////////////////////////: but BufferProvider selection is going to be solved differently anyway, see Ticket #249
+  template<class CONF>
+  struct SelectBuffProvider                                          { typedef AllocBufferFromParent Type; };
+  template<char PROC_ign, char INPLA_ign>
+  struct SelectBuffProvider< Config<CACHING, PROC_ign, INPLA_ign> >  { typedef AllocBufferFromCache  Type; };
   
   
   template<class Config>
   struct Strategy ;
   
-  using lumiera::typelist::Config;
   
-  template<char INPLACE>
-  struct Strategy< Config<CACHING,PROCESS,INPLACE> >
+  template<char INPLACE_ign>
+  struct Strategy< Config<CACHING,PROCESS,INPLACE_ign> >
     : QueryCache<
        AllocBufferTable<
         PullInput<
@@ -283,8 +301,8 @@ namespace config {
              OperationBase > > > > > > >
     { };
   
-  template<char INPLACE>
-  struct Strategy< Config<PROCESS,INPLACE> >
+  template<char INPLACE_ign>
+  struct Strategy< Config<PROCESS,INPLACE_ign> >
     : AllocBufferTable<
        PullInput<
         AllocOutput<
diff --git a/src/proc/engine/nodewiring-config.hpp b/src/proc/engine/nodewiring-config.hpp
index 47d0eb395..6271199fd 100644
--- a/src/proc/engine/nodewiring-config.hpp
+++ b/src/proc/engine/nodewiring-config.hpp
@@ -63,8 +63,8 @@
 namespace engine {
 namespace config {
   
-  using lumiera::typelist::FlagInfo;
   using util::contains;
+  using lumiera::typelist::FlagInfo;
   
   using lumiera::typelist::CONFIG_FLAGS_MAX;
   
diff --git a/src/proc/engine/nodewiring-def.hpp b/src/proc/engine/nodewiring-def.hpp
index c5f37c2bc..4fc4f14c2 100644
--- a/src/proc/engine/nodewiring-def.hpp
+++ b/src/proc/engine/nodewiring-def.hpp
@@ -75,13 +75,32 @@ namespace engine {
       long flags_;
       asset::Proc::ProcFunc* function_;
       
-    protected:
-      RefArray<ChannelDescriptor>& makeOutDescriptor() ;
-      RefArray<InChanDescriptor>&  makeInDescriptor() ;
-      WiringDescriptor::ProcFunc*  resolveProcessingFunction() ;
-      lumiera::NodeID const&       createNodeID() ;
+    public: /* === API for querying collected data === */
+      RefArray<ChannelDescriptor>&
+      makeOutDescriptor()  const
+        {
+          UNIMPLEMENTED ("build new output descriptors for the node under construction");  //////////TODO: where to get the information about the output channels???
+        }
+      
+      RefArray<InChanDescriptor>&
+      makeInDescriptor()   const
+        {
+          UNIMPLEMENTED ("build new input descriptors for the node under construction");
+        }
+      
+      WiringDescriptor::ProcFunc*
+      resolveProcessingFunction()  const
+        {
+          REQUIRE (function_);
+          return function_;
+        }
+      
+      lumiera::NodeID const&
+      createNodeID()  const
+        {
+          UNIMPLEMENTED ("initiate generation of a new unique node-ID"); // see rendergraph.cpp
+        }
       
-      friend class NodeWiring;
       
       
     public: /* === API for specifying the desired wiring === */
diff --git a/src/proc/engine/nodewiring.cpp b/src/proc/engine/nodewiring.cpp
index f32b02bf3..f59d620db 100644
--- a/src/proc/engine/nodewiring.cpp
+++ b/src/proc/engine/nodewiring.cpp
@@ -55,12 +55,6 @@ namespace engine {
     typedef Filter<AllConfigs::List, Instantiation<Strategy>::Test> PossibleConfigs;
     
     
-    #define PICK_FLAG(_FLAG_) config::FlagInfo<CONF>::CODE & (_FLAG_)
-    
-    template<class CONF>
-    struct UseBufferProvider
-      : config::SelectBuffProvider< PICK_FLAG (CACHING), PICK_FLAG (INPLACE) >
-      { };
     
     // internal details: setting up a factory for each required configuration
     
@@ -76,9 +70,8 @@ namespace engine {
         AllocationCluster& alloc_;
         
         /* ==== pick actual wiring code ==== */
-        typedef Strategy<CONF> Strategy;
-        typedef typename UseBufferProvider<CONF>::Type BuffProvider;
-        typedef ActualInvocationProcess<Strategy, BuffProvider> InvocationStateType;
+        typedef typename SelectBuffProvider<CONF>::Type BuffProvider;
+        typedef ActualInvocationProcess<Strategy<CONF>, BuffProvider> InvocationStateType;
         
         // the concrete implementation of the glue code...
         typedef NodeWiring<InvocationStateType> ActualWiring;
diff --git a/src/proc/engine/nodewiring.hpp b/src/proc/engine/nodewiring.hpp
index abc369fa2..7d2882d45 100644
--- a/src/proc/engine/nodewiring.hpp
+++ b/src/proc/engine/nodewiring.hpp
@@ -61,17 +61,15 @@ namespace engine {
     : public WiringDescriptor
     {
       
-      NodeWiring(WiringSituation& setup)
+    public:
+      NodeWiring(WiringSituation const& setup)
         : WiringDescriptor(setup.makeOutDescriptor(), 
                            setup.makeInDescriptor(),
                            setup.resolveProcessingFunction(),
                            setup.createNodeID())
         { }
       
-      friend class WiringFactory;
-      
-      
-    protected:
+    private:
       virtual BuffHandle
       callDown (State& currentProcess, uint requestedOutputNr)  const 
         {
diff --git a/src/proc/engine/procnode.hpp b/src/proc/engine/procnode.hpp
index be54a32c4..40bbe15f3 100644
--- a/src/proc/engine/procnode.hpp
+++ b/src/proc/engine/procnode.hpp
@@ -113,6 +113,13 @@ namespace engine {
   
   /**
    * Key abstraction of the Render Engine: A Data processing Node
+   * 
+   * @todo it's not clear as of 9/09 if ProcNode shall be an ABC/Interface
+   *       It might be used as ABC (as was the original intention) when implementing
+   *       several query/information functions. In that case, the ctor will become protected.
+   *       The alternative would be to push down these information-retrieval part into a
+   *       configurable element within WiringDescriptor, in which case we even might drop
+   *       ProcNode as a frontent entirely.
    */
   class ProcNode
     {
@@ -121,19 +128,15 @@ namespace engine {
       
       const WiringDescriptor& wiringConfig_;
       
-    protected:
+    public:
       ProcNode (WiringDescriptor const& wd)
         : wiringConfig_(wd)
         { }
-        
-      
-      friend class NodeFactory;
       
+      virtual ~ProcNode() {};  /////////////////////////TODO: do we still intend to build a hierarchy below ProcNode???
       
       
     public:
-      virtual ~ProcNode() {};  /////////////////////////TODO: do we still intend to build a hierarchy below ProcNode???
-      
       bool isValid()  const;
       
       /** output channel count */
@@ -161,7 +164,7 @@ namespace engine {
     };
   
   
-  bool
+  inline bool
   ProcNode::isValid()  const
   {
     UNIMPLEMENTED ("ProcNode validity self-check");
diff --git a/src/proc/engine/rendergraph.cpp b/src/proc/engine/rendergraph.cpp
index a031deb70..c2ab6e332 100644
--- a/src/proc/engine/rendergraph.cpp
+++ b/src/proc/engine/rendergraph.cpp
@@ -22,8 +22,16 @@
 
 
 #include "proc/engine/rendergraph.hpp"
+#include "lib/frameid.hpp"
 #include "proc/state.hpp"
 
+namespace lumiera {
+
+  /** storage for the unique node-ID counter */
+  ulong NodeID::currID (0);
+}
+
+
 namespace engine {
 
   /** */
diff --git a/src/proc/mobject/builder/nodecreatortool.cpp b/src/proc/mobject/builder/nodecreatortool.cpp
index ed24e36c2..8664a2b01 100644
--- a/src/proc/mobject/builder/nodecreatortool.cpp
+++ b/src/proc/mobject/builder/nodecreatortool.cpp
@@ -58,6 +58,13 @@ namespace mobject {
     NodeCreatorTool::treat (Auto<double>& automation)
     {
     }
+    
+    
+    void
+    NodeCreatorTool::onUnknown (Buildable& target)
+    {
+      UNIMPLEMENTED ("catch-all when partitioning timeline");  ////////TODO: verify why this gets enfoced here...
+    }
 
 
 
diff --git a/src/proc/mobject/builder/nodecreatortool.hpp b/src/proc/mobject/builder/nodecreatortool.hpp
index f39fefb61..4d3d04b9c 100644
--- a/src/proc/mobject/builder/nodecreatortool.hpp
+++ b/src/proc/mobject/builder/nodecreatortool.hpp
@@ -21,57 +21,55 @@
 */
 
 
-#ifndef MOBJECT_BUILDER_NODECREATERTOOL_H
-#define MOBJECT_BUILDER_NODECREATERTOOL_H
+#ifndef MOBJECT_BUILDER_NODECREATORTOOL_H
+#define MOBJECT_BUILDER_NODECREATORTOOL_H
 
 
 #include "proc/mobject/builder/applicablebuildertargettypes.hpp"
 
 #include "proc/engine/rendergraph.hpp"
-#include "proc/mobject/builder/toolfactory.hpp"
 
 
 
 namespace mobject {
-  namespace builder {
-
-
-
-
-    /**
-     * This Tool implementation plays the central role in the build process:
-     * given a MObject from Session, it is able to attach ProcNodes to the 
-     * render engine under construction such as to reflect the properties 
-     * of the MObject in the actual render.
-     */
-    class NodeCreatorTool 
-      : public ApplicableBuilderTargetTypes<NodeCreatorTool>
-      {
-        ToolFactory& toolKit_;
-        
-        /** holds the RenderGraph (Render Engine Element)
-         *  to be built by the current build step */
-        engine::RenderGraph& proc_;
-        
-        
-        NodeCreatorTool (ToolFactory& tofa, engine::RenderGraph& proc)
-          : toolKit_(tofa),
-            proc_(proc)
-          { }
-        
-        friend class ToolFactory;
-        
-      public:
-        virtual void treat (mobject::session::Clip& clip) ;
-        virtual void treat (mobject::session::Effect& effect) ;
-        virtual void treat (mobject::session::Auto<double>& automation) ;  //TODO: the automation-type-problem
-        virtual void treat (mobject::Buildable& something) ;
-
-
-
-      };
-
-  } // namespace mobject::builder
-
-} // namespace mobject
+namespace builder {
+  
+  class ToolFactory;
+  
+  
+  /**
+   * This Tool implementation plays the central role in the build process:
+   * given a MObject from Session, it is able to attach ProcNodes to the
+   * render engine under construction such as to reflect the properties
+   * of the MObject in the actual render.
+   */
+  class NodeCreatorTool 
+    : public ApplicableBuilderTargetTypes<NodeCreatorTool>
+    {
+      ToolFactory& toolKit_;
+      
+      /** holds the RenderGraph (Render Engine Element)
+       *  to be built by the current build step */
+      engine::RenderGraph& proc_;
+      
+      
+      NodeCreatorTool (ToolFactory& tofa, engine::RenderGraph& proc)
+        : toolKit_(tofa),
+          proc_(proc)
+        { }
+      
+      friend class ToolFactory;
+      
+    public:
+      virtual void treat (mobject::session::Clip& clip) ;
+      virtual void treat (mobject::session::Effect& effect) ;
+      virtual void treat (mobject::session::Auto<double>& automation) ;  //TODO: the automation-type-problem
+      virtual void treat (mobject::Buildable& something) ;
+      
+      void onUnknown (Buildable& target) ;             /////////TODO why doesn't the treat(Buildable) function shaddow this??
+    };
+  
+  
+  
+}} // namespace mobject::builder
 #endif
diff --git a/src/proc/mobject/builder/operationpoint.cpp b/src/proc/mobject/builder/operationpoint.cpp
index d08635fe5..5a6bbe3bf 100644
--- a/src/proc/mobject/builder/operationpoint.cpp
+++ b/src/proc/mobject/builder/operationpoint.cpp
@@ -22,7 +22,9 @@
 
 
 #include "proc/mobject/builder/operationpoint.hpp"
+#include "proc/engine/procnode.hpp"
 #include "proc/asset/media.hpp"
+#include "proc/asset/proc.hpp"
 #include "proc/engine/nodefactory.hpp"
 #include "lib/streamtype.hpp"
 //#include "common/util.hpp"
@@ -55,18 +57,33 @@ namespace builder {
         { }
       
       /** initiate a connection chain at a real source */
-      RefPoint (NodeFactory& nFactory, asset::Media srcMedia)
+      RefPoint (NodeFactory& nFactory, asset::Media const& srcMedia)
         : alloc_(nFactory),
-          sources_(establishMediaChannels (srcMedia)),
           sType_(0)
         {
+          establishMediaChannels (srcMedia);
           deriveSourceStreamType ();
         }
+      
+      
+    private:
+      void
+      establishMediaChannels (asset::Media const& srcMedia)
+        {
+          UNIMPLEMENTED ("find out about the actual channels for this stream to connect");
+        }
+      
+      void
+      deriveSourceStreamType ()
+        {
+          UNIMPLEMENTED ("calculate / decide on the effective stream type used within this pipe");
+        }
+      
     };
   
   
   
-  OperationPoint::OperationPoint (NodeFactory& nFact,, asset::Media const& srcMedia)
+  OperationPoint::OperationPoint (NodeFactory& nFact, asset::Media const& srcMedia)
     : refPoint_(new RefPoint (nFact, srcMedia))
   { }
   
@@ -77,7 +94,7 @@ namespace builder {
   
   
   void
-  OperationPoint::attach (asset::PProc const& mediaProc)
+  OperationPoint::attach (asset::Proc const& mediaProc)
   {
     UNIMPLEMENTED ("Actually-really-finally create a node corresponding to this processing asset");
   }
diff --git a/src/proc/mobject/builder/operationpoint.hpp b/src/proc/mobject/builder/operationpoint.hpp
index 2e24d63fe..329dbcebc 100644
--- a/src/proc/mobject/builder/operationpoint.hpp
+++ b/src/proc/mobject/builder/operationpoint.hpp
@@ -32,6 +32,10 @@
 #include <string>
 
 
+namespace asset { class Proc; }
+namespace asset { class Media; }
+namespace engine { class NodeFactory; }
+
 namespace mobject {
 namespace builder {
   
@@ -52,11 +56,16 @@ namespace builder {
       boost::scoped_ptr<RefPoint> refPoint_;
       
     public:
+      OperationPoint (engine::NodeFactory&, asset::Media const& srcMedia);
+      OperationPoint (RefPoint const& sourcePoint);
+      
+      
+      
       /** create node(s) corresponding to the given Processor-Asset
        *  and wire them as a successor to this OperationPoint; then
        *  move this point to refer to the resulting new exit node(s)
        */
-      void attach (asset::PProc const&);
+      void attach (asset::Proc const&);
       
       /** connect the output this OperationPoint refers such as to
        *  connect or combine with the input of the already existing
diff --git a/src/proc/mobject/builder/segmentationtool.cpp b/src/proc/mobject/builder/segmentationtool.cpp
index 7b6c29747..703f25150 100644
--- a/src/proc/mobject/builder/segmentationtool.cpp
+++ b/src/proc/mobject/builder/segmentationtool.cpp
@@ -35,24 +35,46 @@ namespace mobject {
   namespace builder {
 
 
+  
+    SegmentationTool::SegmentationTool(mobject::session::Fixture&)
+    {
+      UNIMPLEMENTED ("create new SegmentationTool");
+    }
+    
 
     void
     SegmentationTool::treat (Buildable& something)
     {
+      UNIMPLEMENTED ("??? when partitioning timeline");
     }
 
 
     void
     SegmentationTool::treat (Clip& clip)
     {
+      UNIMPLEMENTED ("consider clip when partitioning timeline");
     }
 
 
     void
     SegmentationTool::treat (Effect& effect)
     {
+      UNIMPLEMENTED ("note applied effect when partitioning timeline");
+    }
+    
+    
+    void
+    SegmentationTool::onUnknown (Buildable& target)
+    {
+      UNIMPLEMENTED ("catch-all when partitioning timeline");
     }
 
+    
+    bool
+    SegmentationTool::empty()  const
+    {
+      UNIMPLEMENTED ("detect an empty segmentation");
+    }
 
 
   } // namespace mobject::builder
diff --git a/src/proc/mobject/builder/segmentationtool.hpp b/src/proc/mobject/builder/segmentationtool.hpp
index 8e55518d1..7106874c5 100644
--- a/src/proc/mobject/builder/segmentationtool.hpp
+++ b/src/proc/mobject/builder/segmentationtool.hpp
@@ -51,21 +51,24 @@ namespace mobject {
       : public ApplicableBuilderTargetTypes<SegmentationTool>
       {
         
+      public:
         SegmentationTool (session::Fixture &) ;
         
-      public:
         void treat (mobject::session::Clip& clip) ;
         void treat (mobject::session::Effect& effect) ;
 
         void treat (mobject::Buildable& something) ;
         
-        //////////////////////////////////////////////////////////TODO make it respond to the util::isnil test!
+        void onUnknown (Buildable& target) ;             /////////TODO why doesn't the treat(Buildable) function shaddow this??
+        
+        bool empty()  const;
 
       private:
         typedef mobject::session::Segment Segment;
 
         /** Partitioning of the Timeline to be created by this tool. */
-        session::Segmentation& segments_;
+        //session::Segmentation& segments_;
+        ///////////////////////////////////////////TODO: either put it inline, or use a scopend_ptr!!!!!!!!!!
 
       };
 
diff --git a/src/proc/mobject/builder/toolfactory.cpp b/src/proc/mobject/builder/toolfactory.cpp
index 278580754..abfa8c83c 100644
--- a/src/proc/mobject/builder/toolfactory.cpp
+++ b/src/proc/mobject/builder/toolfactory.cpp
@@ -40,7 +40,7 @@ namespace builder {
       session::Fixture & fixedTimeline_;
       auto_ptr<engine::RenderGraph> procSegment_;
       
-      scoped_ptr<SegementationTool> segmentation_;
+      scoped_ptr<SegmentationTool> segmentation_;
       scoped_ptr<NodeCreatorTool> fabrication_;
       
       
@@ -55,7 +55,7 @@ namespace builder {
     : state_(new BuildProcessState (theTimeline))
   {
     ENSURE (state_->fixedTimeline_.isValid());
-    ENSURE (state_->procSegment_);
+    ENSURE (state_->procSegment_.get());
   }
   
   
@@ -63,21 +63,21 @@ namespace builder {
   ToolFactory::configureSegmentation ()
   {
     REQUIRE (state_->fixedTimeline_.isValid());
-    REQUIRE (state_->procSegment_);
+    REQUIRE (state_->procSegment_.get());
     
-    state->segmentation_.reset (new SegmentationTool (state->fixedTimeline_));
-    return *(state->segmentation_);
+    state_->segmentation_.reset (new SegmentationTool (state_->fixedTimeline_));
+    return *(state_->segmentation_);
   }
   
   
   NodeCreatorTool &
   ToolFactory::configureFabrication () //////////////////////TODO: should iterate in some way!
   {
-    REQUIRE (state_->procSegment_);
-    REQUIRE (!isnil (*(state_>segmentation)));
+    REQUIRE (state_->procSegment_.get());
+    REQUIRE (!isnil (*(state_->segmentation_)));
     
-    state->fabrication_.reset (new NodeCreatorTool(*this));
-    return *(state->fabrication_);
+    state_->fabrication_.reset (new NodeCreatorTool(*this, *state_->procSegment_));
+    return *(state_->fabrication_);
   }
   
   
diff --git a/src/proc/mobject/session/edl.cpp b/src/proc/mobject/session/edl.cpp
index dd312c479..da131eee2 100644
--- a/src/proc/mobject/session/edl.cpp
+++ b/src/proc/mobject/session/edl.cpp
@@ -73,6 +73,14 @@ namespace mobject
     {
       UNIMPLEMENTED ("serch for a given 'thing' within the EDL");
     }
+    
+    
+    bool
+    EDL::validate()
+    {
+      UNIMPLEMENTED ("self-check");
+      return false;
+    }
 
 
 
diff --git a/src/proc/mobject/session/edl.hpp b/src/proc/mobject/session/edl.hpp
index 0e76c1a36..e72b91bad 100644
--- a/src/proc/mobject/session/edl.hpp
+++ b/src/proc/mobject/session/edl.hpp
@@ -62,7 +62,8 @@ namespace mobject {
         bool isValid() { return this->validate(); }
         
       private:
-        virtual bool validate() =0;
+        virtual bool validate();
+        
       };
 
 
diff --git a/src/proc/mobject/session/effect.cpp b/src/proc/mobject/session/effect.cpp
index e83f03119..ef856c0ff 100644
--- a/src/proc/mobject/session/effect.cpp
+++ b/src/proc/mobject/session/effect.cpp
@@ -28,7 +28,14 @@ namespace mobject
   namespace session
     {
 
-    /** */
+    /**
+     * @TODO: clarify asset->mobject relation and asset dependencies; Ticket #255
+     */
+    asset::Proc const& 
+    Effect::getProcAsset() const
+    {
+      UNIMPLEMENTED ("how to access the processing asset assotiated to a given Effect-MObject");
+    }
 
 
 
diff --git a/src/proc/mobject/session/effect.hpp b/src/proc/mobject/session/effect.hpp
index 52b21bb54..6696558f1 100644
--- a/src/proc/mobject/session/effect.hpp
+++ b/src/proc/mobject/session/effect.hpp
@@ -48,7 +48,8 @@ namespace session {
       
     public:
       /** access the underlying processing asset */
-      PProc getProcAsset ()  const;
+      asset::Proc const& getProcAsset ()  const;
+                                                //////////////////////TODO: clarify asset->mobject relation and asset dependencies; Ticket #255
       
     };
   
diff --git a/src/proc/mobject/session/segmentation.hpp b/src/proc/mobject/session/segmentation.hpp
index 4f4096a4e..2decf122c 100644
--- a/src/proc/mobject/session/segmentation.hpp
+++ b/src/proc/mobject/session/segmentation.hpp
@@ -48,7 +48,7 @@ namespace mobject {
       {
 
         /** segments of the engine in ordered sequence. */
-        list<Segement> segments_;
+        list<Segment> segments_;
 
       };
 
diff --git a/tests/common/refarraytest.cpp b/tests/common/refarraytest.cpp
index 1b9735926..627a00f46 100644
--- a/tests/common/refarraytest.cpp
+++ b/tests/common/refarraytest.cpp
@@ -21,8 +21,8 @@
 * *****************************************************/
 
 
-#include "common/test/run.hpp"
-#include "common/util.hpp"
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
 
 #include "lib/refarrayimpl.hpp"
 
diff --git a/tests/components/proc/engine/buff-table-test.cpp b/tests/components/proc/engine/buff-table-test.cpp
index fc55457b0..37404eafc 100644
--- a/tests/components/proc/engine/buff-table-test.cpp
+++ b/tests/components/proc/engine/buff-table-test.cpp
@@ -108,12 +108,12 @@ namespace test  {
       return (b.outHandle == lastLevel )  // storage is allocated continuously
           && (b.outBuff   <= b.inBuff  )  // input slots are behind the output slots
           && (b.outHandle <= b.inHandle)
-          && (b.inBuff   == &b.outBuff  [num.getNrO()])
-          && (b.inHandle == &b.outHandle[num.getNrO()])
-          && (not_within(b.outBuff, b.outHandle, &b.inHandle[num.getNrO()])) // storage doesn't overlap
-          && (not_within(b.inBuff,  b.outHandle, &b.inHandle[num.getNrO()]))
-          && (not_within(b.outHandle, b.outBuff, &b.inBuff[num.getNrO()]))
-          && (not_within(b.inHandle,  b.outBuff, &b.inBuff[num.getNrO()]))
+          && (b.inBuff   == &b.outBuff  [num.nrO])
+          && (b.inHandle == &b.outHandle[num.nrO])
+          && (not_within(b.outBuff, b.outHandle, &b.inHandle[num.nrO])) // storage doesn't overlap
+          && (not_within(b.inBuff,  b.outHandle, &b.inHandle[num.nrO]))
+          && (not_within(b.outHandle, b.outBuff, &b.inBuff[num.nrO]))
+          && (not_within(b.inHandle,  b.outBuff, &b.inBuff[num.nrO]))
            ;
     }
   } // (End) internal defs
diff --git a/tests/components/proc/engine/node-basic-test.cpp b/tests/components/proc/engine/node-basic-test.cpp
index c3b89e802..c04d420c4 100644
--- a/tests/components/proc/engine/node-basic-test.cpp
+++ b/tests/components/proc/engine/node-basic-test.cpp
@@ -62,6 +62,12 @@ namespace test  {
         
       };
   
+      
+    inline PEffect
+    createTestEffectMObject()
+    {
+      UNIMPLEMENTED ("how to create a dummy Effect for tests");
+    }
   }
   
   
@@ -82,10 +88,7 @@ namespace test  {
           
           WiringSituation setup(testSource);
           
-          setup.defineInput (4, predecessor1, 2);
-          setup.defineInput (2, predecessor2);
-          
-          PEffect pEffect;  /////////////////TODO how to get an simple Effect MObject for Tests???
+          PEffect pEffect = createTestEffectMObject();
           ProcNode* pNode = nodeFab (pEffect, setup);
           ASSERT (pNode);
           

From 32fd3d7b1fb9ce43b466fb7055830ee8b2f79676 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 18:48:21 +0200
Subject: [PATCH 291/368] bump required version for SCons build too

---
 SConstruct | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/SConstruct b/SConstruct
index 9707a7b16..c2e703031 100644
--- a/SConstruct
+++ b/SConstruct
@@ -215,7 +215,7 @@ def configurePlatform(env):
     if not conf.CheckLibWithHeader('dl', 'dlfcn.h', 'C'):
         problems.append('Functions for runtime dynamic loading not available.')
     
-    if not conf.CheckPkgConfig('nobugmt', 0.3):
+    if not conf.CheckPkgConfig('nobugmt', 200909.1):
         problems.append('Did not find NoBug [http://www.pipapo.org/pipawiki/NoBug].')
     else:
         conf.env.mergeConf('nobugmt')
@@ -227,10 +227,12 @@ def configurePlatform(env):
        conf.env.Append(CCFLAGS = ' -pthread')
     
     if conf.CheckCHeader('execinfo.h'):
-       conf.env.Append(CPPFLAGS = ' -DHAS_EXECINFO_H')
+       conf.env.Append(CPPFLAGS = ' -DHAVE_EXECINFO_H')
     
     if conf.CheckCHeader('valgrind/valgrind.h'):
-        conf.env.Append(CPPFLAGS = ' -DHAS_VALGRIND_VALGIND_H')
+        conf.env.Append(CPPFLAGS = ' -DHAVE_VALGRIND_H')
+    else:
+        print 'Valgrind not found. The use of Valgrind is optional; building without.'
     
     if not conf.CheckCXXHeader('tr1/memory'):
         problems.append('We rely on the std::tr1 proposed standard extension for shared_ptr.')

From 70b4b0ad41927f781ca8e9d425987f9149f9c0c9 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 19:11:17 +0200
Subject: [PATCH 292/368] Fix some more format warnings

---
 src/common/appstate.cpp                           |  2 +-
 src/gui/dialogs/render.cpp                        |  2 +-
 src/gui/output/xvdisplayer.cpp                    |  2 +-
 src/proc/asset.cpp                                |  4 ++--
 src/proc/mobject/placement.cpp                    |  2 +-
 tests/components/proc/asset/asset-diagnostics.hpp |  2 +-
 tests/lib/allocationclustertest.cpp               |  2 +-
 tests/lib/meta/generator-test.cpp                 |  2 +-
 tests/lib/scoped-holder-test.cpp                  |  8 ++++----
 tests/lib/scopedholdertransfertest.cpp            |  6 +++---
 tests/lib/vectortransfertest.cpp                  | 12 ++++++------
 11 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/src/common/appstate.cpp b/src/common/appstate.cpp
index f20025ab2..1b949e2b0 100644
--- a/src/common/appstate.cpp
+++ b/src/common/appstate.cpp
@@ -186,7 +186,7 @@ namespace lumiera {
   AppState::abort (lumiera::Error& problem)
   {
     
-    INFO (common, "Address of Config Facade = %x", &lumiera::Config::instance());   //////////TODO: a temp hack to force configfacade.cpp to be linked into lumiera exe. 
+    INFO (common, "Address of Config Facade = %p", &lumiera::Config::instance());   //////////TODO: a temp hack to force configfacade.cpp to be linked into lumiera exe. 
     
     ERROR (common, "Aborting Lumiera after unhandled error: %s", cStr(problem.what()));
     
diff --git a/src/gui/dialogs/render.cpp b/src/gui/dialogs/render.cpp
index 64dcd23d5..88a8c41ff 100644
--- a/src/gui/dialogs/render.cpp
+++ b/src/gui/dialogs/render.cpp
@@ -94,7 +94,7 @@ void Render::on_button_browse()
   int result = dialog.run();
   INFO(gui, "%d", result);
   if(result == RESPONSE_OK)
-    INFO(gui, "%d", "RESPONSE_OK");
+    INFO(gui, "%s", "RESPONSE_OK");
 }
 
 }   // namespace dialogs
diff --git a/src/gui/output/xvdisplayer.cpp b/src/gui/output/xvdisplayer.cpp
index fe0c37d2f..5799f93dc 100644
--- a/src/gui/output/xvdisplayer.cpp
+++ b/src/gui/output/xvdisplayer.cpp
@@ -62,7 +62,7 @@ XvDisplayer::XvDisplayer( Gtk::Widget *drawing_area, int width, int height ) :
       for ( unsigned int n = 0; gotPort == false && n < count; ++n )
         {
           // Diagnostics
-          INFO(gui, "%s, %d, %d", adaptorInfo[ n ].name,
+          INFO(gui, "%s, %u, %u", adaptorInfo[ n ].name,
             adaptorInfo[ n ].base_id, adaptorInfo[ n ].num_ports - 1);
 
           for ( unsigned int port = adaptorInfo[ n ].base_id;
diff --git a/src/proc/asset.cpp b/src/proc/asset.cpp
index 77fe6ace6..3d4b8fc79 100644
--- a/src/proc/asset.cpp
+++ b/src/proc/asset.cpp
@@ -58,12 +58,12 @@ namespace asset {
   Asset::Asset (const Ident& idi) 
     : ident(idi), id(AssetManager::reg (this, idi)), enabled(true)
   {
-    TRACE (assetmem, "ctor Asset(id=%lu) :  adr=%x %s", size_t(id), this, cStr(this->ident) );
+    TRACE (assetmem, "ctor Asset(id=%lu) :  adr=%p %s", size_t(id), this, cStr(this->ident) );
   }
   
   Asset::~Asset ()
   { 
-    TRACE (assetmem, "dtor Asset(id=%lu) :  adr=%x", size_t(id), this );
+    TRACE (assetmem, "dtor Asset(id=%lu) :  adr=%p", size_t(id), this );
   }
   
 
diff --git a/src/proc/mobject/placement.cpp b/src/proc/mobject/placement.cpp
index 4af940bb4..71a930e2d 100644
--- a/src/proc/mobject/placement.cpp
+++ b/src/proc/mobject/placement.cpp
@@ -49,7 +49,7 @@ namespace mobject {
   
   Placement<MObject>::operator string ()  const 
   {
-    static format fmt("Placement<%s> %|50T.| use-cnt=%x ID(%x) adr=%x pointee=%x");
+    static format fmt("Placement<%s> %|50T.| use-cnt=%u ID(%x) adr=%p pointee=%p");
     return str(fmt % typeid(*get()).name() % use_count()
                                            % (size_t)getID() 
                                            % this 
diff --git a/tests/components/proc/asset/asset-diagnostics.hpp b/tests/components/proc/asset/asset-diagnostics.hpp
index ef135f560..2ae2a232f 100644
--- a/tests/components/proc/asset/asset-diagnostics.hpp
+++ b/tests/components/proc/asset/asset-diagnostics.hpp
@@ -59,7 +59,7 @@ namespace asset
         cout << "Asset(NULL)\n";
       else
         {
-          format fmt("%s %|50T.| id=%s  adr=%x smart-ptr=%x use-count=%d");
+          format fmt("%s %|50T.| id=%s  adr=%p smart-ptr=%p use-count=%u");
           cout << fmt % str(aa) % aa->getID() % aa.get() % &aa % (aa.use_count() - 1) << "\n";
     }   }
  
diff --git a/tests/lib/allocationclustertest.cpp b/tests/lib/allocationclustertest.cpp
index 1badb8ac9..6b07775ad 100644
--- a/tests/lib/allocationclustertest.cpp
+++ b/tests/lib/allocationclustertest.cpp
@@ -176,7 +176,7 @@ namespace lib {
             ASSERT (&ref2);
             ASSERT (&ref3);
             ASSERT (&rX);
-            TRACE (test, "sizeof( Dummy<1234> ) = %d", sizeof(rX));
+            TRACE (test, "sizeof( Dummy<1234> ) = %u", sizeof(rX));
             
             ASSERT (123==ref2.getID());
             ASSERT (3+4+5==rX.getID());
diff --git a/tests/lib/meta/generator-test.cpp b/tests/lib/meta/generator-test.cpp
index dc7abbcbe..36a98b7a6 100644
--- a/tests/lib/meta/generator-test.cpp
+++ b/tests/lib/meta/generator-test.cpp
@@ -135,7 +135,7 @@ namespace test {
               subInterface.eat (b13);
               me_can_has_more_numberz.eat();
               
-              INFO (test, "SizeOf = %i", sizeof(me_can_has_more_numberz));
+              INFO (test, "SizeOf = %u", sizeof(me_can_has_more_numberz));
             } 
         };
       
diff --git a/tests/lib/scoped-holder-test.cpp b/tests/lib/scoped-holder-test.cpp
index 6f31b0766..918e7416b 100644
--- a/tests/lib/scoped-holder-test.cpp
+++ b/tests/lib/scoped-holder-test.cpp
@@ -103,10 +103,10 @@ namespace test{
             ASSERT (rawP == &(*holder));
             ASSERT (rawP->add(-5) == holder->add(-5));
             
-            TRACE (test, "holder at %x", &holder);
-            TRACE (test, "object at %x", holder.get() );
-            TRACE (test, "size(object) = %d", sizeof(*holder));
-            TRACE (test, "size(holder) = %d", sizeof(holder));
+            TRACE (test, "holder at %p", &holder);
+            TRACE (test, "object at %p", holder.get() );
+            TRACE (test, "size(object) = %u", sizeof(*holder));
+            TRACE (test, "size(holder) = %u", sizeof(holder));
           }
           ASSERT (0==checksum);
         }
diff --git a/tests/lib/scopedholdertransfertest.cpp b/tests/lib/scopedholdertransfertest.cpp
index f92f0319b..c47cd2a76 100644
--- a/tests/lib/scopedholdertransfertest.cpp
+++ b/tests/lib/scopedholdertransfertest.cpp
@@ -52,18 +52,18 @@ namespace lib {
         public:
           FixedDummy()
             {
-              TRACE  (test, "CTOR      FixedDummy() --> this=%x val=%d", this, getVal());
+              TRACE  (test, "CTOR      FixedDummy() --> this=%p val=%d", this, getVal());
             }
           
           ~FixedDummy()
             {
-              TRACE  (test, "DTOR     ~FixedDummy()  this=%x val=%d", this, getVal());
+              TRACE  (test, "DTOR     ~FixedDummy()  this=%p val=%d", this, getVal());
             }
           
           friend void
           transfer_control (FixedDummy& from, FixedDummy& to)
           {
-            TRACE  (test, "TRANSFER  target=%x   <-- source=%x  (%d,%d)", &to,&from, to.getVal(),from.getVal());
+            TRACE  (test, "TRANSFER  target=%p   <-- source=%p  (%d,%d)", &to,&from, to.getVal(),from.getVal());
             
             if (throw_in_transfer)
               throw to.getVal();
diff --git a/tests/lib/vectortransfertest.cpp b/tests/lib/vectortransfertest.cpp
index 6254db7aa..f165f2ece 100644
--- a/tests/lib/vectortransfertest.cpp
+++ b/tests/lib/vectortransfertest.cpp
@@ -46,13 +46,13 @@ namespace lib {
         public:
           TransDummy()
             {
-              TRACE  (test, "CTOR      TransDummy() --> this=%x", this);
+              TRACE  (test, "CTOR      TransDummy() --> this=%p", this);
               setVal(0); // we use val_==0 to mark the "empty" state 
             }
           
           ~TransDummy()
             {
-              TRACE  (test, "DTOR     ~TransDummy()  this=%x", this);
+              TRACE  (test, "DTOR     ~TransDummy()  this=%p", this);
             }
           
           /* to make Dummy usable within vector, we need to provide
@@ -64,14 +64,14 @@ namespace lib {
           TransDummy (const TransDummy& o)
             : Dummy()
             {
-              TRACE  (test, "COPY-ctor TransDummy( ref=%x ) --> this=%x", &o,this);
+              TRACE  (test, "COPY-ctor TransDummy( ref=%p ) --> this=%p", &o,this);
               ASSERT (!o, "protocol violation: real copy operations inhibited");
             }
           
           TransDummy&
           operator= (TransDummy const& ref)
             {
-              TRACE  (test, "COPY      target=%x   <-- source=%x", this,&ref);
+              TRACE  (test, "COPY      target=%p   <-- source=%p", this,&ref);
               ASSERT (!(*this));
               ASSERT (!ref, "protocol violation: real copy operations inhibited");
               return *this;
@@ -81,7 +81,7 @@ namespace lib {
           setup (int x=0)
             {
               setVal (x? x : (rand() % 10000));
-              TRACE  (test, "CREATE    val=%d ---> this=%x", getVal(),this);
+              TRACE  (test, "CREATE    val=%d ---> this=%p", getVal(),this);
             }
           
           
@@ -100,7 +100,7 @@ namespace lib {
       void
       transfer_control (TransDummy& from, TransDummy& to)
       {
-        TRACE  (test, "TRANSFER  target=%x   <-- source=%x", &to,&from);
+        TRACE  (test, "TRANSFER  target=%p   <-- source=%p", &to,&from);
         ASSERT (!to, "protocol violation: target already manages another object");
         to.setVal (from.getVal());
         from.setVal(0);

From 937df6677471b20a8356b065f634212741fb7bb1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 19:14:36 +0200
Subject: [PATCH 293/368] apply Temp.Fix for Ticket #260

---
 src/proc/control/command-registry.hpp | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 9dd5206a9..93916bba1 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -71,7 +71,7 @@ namespace control {
    */
   class CommandRegistry
     : public lib::Sync<>
-    , protected TypedAllocationManager
+    , public TypedAllocationManager
     {
       
     public:

From bb8eb4055020c609245fe35a369c70e2acb1daf6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 19:28:52 +0200
Subject: [PATCH 294/368] disable 2 unfinished tests for now

---
 tests/40components.tests | 2 +-
 tests/46engine.tests     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/40components.tests b/tests/40components.tests
index ab40bd9e4..de71b721a 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -308,7 +308,7 @@ out: ::0::1::2::3::4::5::6::7::8::9::10::11::12::13::14::15::16::17::18::19
 END
 
 
-TEST "RefArray_test" RefArray_test  <<END
+PLANNED "RefArray_test" RefArray_test  <<END
 return: 0
 END
 
diff --git a/tests/46engine.tests b/tests/46engine.tests
index b5464d3e0..e669a11cb 100644
--- a/tests/46engine.tests
+++ b/tests/46engine.tests
@@ -2,7 +2,7 @@ TESTING "Component Test Suite: Render Engine parts" ./test-components --group=en
 
 
 
-TEST "BuffTable_test" BuffTable_test <<END
+PLANNED "BuffTable_test" BuffTable_test <<END
 return: 0
 END
 

From 27f437db8f62cb67f613da40b9e3dfc580855245 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 5 Sep 2009 20:10:06 +0200
Subject: [PATCH 295/368] autotools fix

---
 src/proc/Makefile.am | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/proc/Makefile.am b/src/proc/Makefile.am
index 848f595d2..0f896a834 100644
--- a/src/proc/Makefile.am
+++ b/src/proc/Makefile.am
@@ -71,7 +71,6 @@ liblumiprocengine_la_SOURCES =					\
 	$(liblumiprocengine_la_srcdir)/nodefactory.cpp		\
 	$(liblumiprocengine_la_srcdir)/nodewiring.cpp		\
 	$(liblumiprocengine_la_srcdir)/pluginadapter.cpp	\
-	$(liblumiprocengine_la_srcdir)/procnode.cpp		\
 	$(liblumiprocengine_la_srcdir)/projector.cpp		\
 	$(liblumiprocengine_la_srcdir)/rendergraph.cpp		\
 	$(liblumiprocengine_la_srcdir)/renderengine.cpp		\
@@ -213,7 +212,6 @@ noinst_HEADERS +=							\
 	$(liblumiproc_la_srcdir)/mobject/builder/toolfactory.hpp	\
 	$(liblumiproc_la_srcdir)/mobject/builderfacade.hpp		\
 	$(liblumiproc_la_srcdir)/control/pathmanager.hpp		\
-	$(liblumiproc_la_srcdir)/control/renderstate.hpp		\
 	$(liblumiproc_la_srcdir)/play/tick-service.hpp			\
 	$(liblumiproc_la_srcdir)/play/dummy-image-generator.hpp		\
 	$(liblumiproc_la_srcdir)/mobject/interpolator.hpp		\

From d15903f1db25453a52aacc64b380624783907646 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 7 Sep 2009 03:25:00 +0200
Subject: [PATCH 296/368] resolve design mismatch, as spotted by Ticket #260
 Hopefully this closes #260

---
 src/proc/control/command-registry.hpp         | 18 +++++++++---------
 src/proc/control/typed-allocation-manager.hpp | 11 +++++------
 2 files changed, 14 insertions(+), 15 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index cf1eeb28a..c82b5396c 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -71,8 +71,9 @@ namespace control {
    */
   class CommandRegistry
     : public lib::Sync<>
-    , public TypedAllocationManager
     {
+      TypedAllocationManager allocator_;
+      
       
     public:
       static lumiera::Singleton<CommandRegistry> instance;
@@ -121,21 +122,21 @@ namespace control {
        *  @return the ID used to register this definition 
        *          or \c NULL in case of an "anonymous" command */
       const char*
-      findDefinition (Command const& cmdInstance)
+      findDefinition (Command const& cmdInstance)  const
         {
           UNIMPLEMENTED ("try to find a registration in the index for a given command instance");
         }
       
       
       size_t
-      index_size()
+      index_size()  const
         {
           UNIMPLEMENTED ("number of defs in the index");
         }
       
       
       size_t
-      instance_count()
+      instance_count()  const
         {
           UNIMPLEMENTED ("number of active command impl instances");
         }
@@ -155,16 +156,15 @@ namespace control {
                      ,function<SIG_CAPT>& captFunctor
                      ,function<SIG_UNDO>& undoFunctor)
         {
-          Lock sync(this);
           
           // derive the storage type necessary
           // to hold the command arguments and UNDO memento
           typedef typename UndoSignature<SIG_CAPT>::Memento Mem;
           typedef ArgumentHolder<SIG_OPER,Mem> Arguments;
           
-          shared_ptr<Arguments> pArg (this->create<Arguments>());
+          shared_ptr<Arguments> pArg (allocator_.create<Arguments>());
           
-          return this->create<CommandImpl> (pArg, operFunctor,captFunctor,undoFunctor);
+          return allocator_.create<CommandImpl> (pArg, operFunctor,captFunctor,undoFunctor);
         }
       
       
@@ -176,12 +176,12 @@ namespace control {
        *  type information is vital for determining the exact allocation size for
        *  the clone ArgumentHolder. The only solution is to delegate the cloning
        *  of the arguments down into the ArgumentHolder, passing a reference
-       *  to the memory manager (=this object) for allocating the clone. 
+       *  to the memory manager for allocating the clone. 
        */
       shared_ptr<CommandImpl>
       createCloneImpl (CommandImpl const& reference)
         {
-          return this->create<CommandImpl> (reference, *this);
+          return allocator_.create<CommandImpl> (reference, allocator_);
         }
       
       
diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
index cdc04cc03..9ad8ebe5e 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -43,8 +43,7 @@
  ** there might be some type erasure involved, leaving the (otherwise opaque) implementation
  ** class as the only entity with a limited knowledge about the actual memory layout, and
  ** thus the only way of creating a clone properly would be to forward down into this
- ** implementation class). As we can't expect to create a one-size-fits-all implementation,
- ** we'll allow for customising the TypedAllocationManager through policy classes. 
+ ** implementation class).
  ** 
  ** Thus, TypedAllocationManager provides the classical operations of an allocator
  ** - allocate
@@ -104,10 +103,6 @@ namespace control { ////////////////////////////////////////////////////////////
       typedef TypedAllocationManager _TheManager;
       
     public:
-
-      /** this is an ABC */
-      virtual ~TypedAllocationManager() {}   ////////////////////////////////////TODO: seems superfluous? We don't have any extension points (and this is a good thing!)
-      
       
       
       /* ======= managing the created objects ============= */
@@ -287,6 +282,7 @@ namespace control { ////////////////////////////////////////////////////////////
       destroyElement (XX* entry)
         {
           if (!entry) return;
+          ////////////////////////////////////////////////TODO: when actually implementing a custom allocation, please assert here that the entry is indeed managed by us
           try
             {
               entry->~XX();
@@ -299,6 +295,9 @@ namespace control { ////////////////////////////////////////////////////////////
           releaseSlot<XX> (entry);
         }
       
+      template<class>
+      friend class Killer;  ///< especially all Killers are entitled to desroyElement()
+      
     };
   
   

From fd7337f8013529d2ea5d65eb80cff30fafce58dc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 20 Sep 2009 18:37:20 +0200
Subject: [PATCH 297/368] WIP drastically simplify command-mutation. As we're
 using now a command frontend interface and and CommandImpl frame in the
 Registry, most of the functionaliry on Mutation's interface is superfluous.
 Additionally, this separates Mutation and Closure.

---
 src/proc/control/command-argument-holder.hpp  |   7 +-
 src/proc/control/command-binding.hpp          |   3 +-
 src/proc/control/command-closure.hpp          |  29 ++++-
 src/proc/control/command-mutation.hpp         | 105 +++---------------
 .../proc/control/command-argument-test.cpp    |   1 +
 .../proc/control/command-mutation-test.cpp    |  52 ++++-----
 6 files changed, 78 insertions(+), 119 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 189a8f84e..0d04a25df 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -107,7 +107,10 @@ namespace control {
     : public AcceptArgumentBinding< SIG                      // to derive the desired bind(..) signature
                                   , ArgumentHolder<SIG,MEM>  // target class providing the implementation
                                   , CmdClosure               // base class to inherit from
-                                  > 
+                                  >
+    
+////////////////////////TODO: Ticket #266
+//  : public CmdClosure
     {
       /** copy construction allowed(but no assignment)*/
       ArgumentHolder& operator= (ArgumentHolder const&);
@@ -202,7 +205,7 @@ namespace control {
       
       
       /** store a new argument tuple within this ArgumentHolder,
-       *  discarding and previously stored arguments */
+       *  discarding any previously stored arguments */
       void
       bindArg (ArgTuple const& argTup)
         {
diff --git a/src/proc/control/command-binding.hpp b/src/proc/control/command-binding.hpp
index 14532ecbb..2f278b33d 100644
--- a/src/proc/control/command-binding.hpp
+++ b/src/proc/control/command-binding.hpp
@@ -56,6 +56,7 @@ namespace com { ///< Proc-Layer command implementation details
   
   
   
+////////////////////////TODO: Ticket #266  - can this be merged into argument-tuple-accept.hpp ??
   
   
   /**
@@ -63,7 +64,7 @@ namespace com { ///< Proc-Layer command implementation details
    * a set of \c bind(...) function for up to nine arbitrary arguments.
    * All these functions will package the argument values into a Tuple
    * (record) and forward the call to a \c bindArg(Tuple<TYPES...>) function
-   * on the target class. The latter function is asumed to perform a 
+   * on the target class. The latter function is assumed to perform a 
    * run-time check to detect calls with invalid signature.
    */
   template<class TAR, class BA>
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index fc3e70d0f..c1be0c4eb 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -34,10 +34,31 @@
  ** internally contains an Closure<SIG> instance (where SIG is the signature of the
  ** actual command operation function), which implements the invocation of the
  ** operation function with the stored argument tuple.
- ** //TODO
- **  
+ ** 
+ ** \par Command Closure and Lifecycle
+ ** When defining a command, Mutation objects are to be created based on a concrete function.
+ ** These are stored embedded into a type erasure container, thus disposing the specific type
+ ** information of the function and function arguments. Each command needs an Mutation object
+ ** holding the command operation and an UndoMutation holding the undo functor. 
+ ** 
+ ** Later on, any command needs to be made ready for execution by binding it to a specific
+ ** execution environment, which especially includes the target objects to be mutated by the
+ ** command. Effectively, this means "closing" the Mutation (and UNDO) functor(s) with the
+ ** actual function arguments. These arguments are stored embedded within an ArgumentHolder,
+ ** which thereby acts as closure. Besides, the ArgumentHolder also has to accommodate for
+ ** storage holding the captured UNDO state (memento). Thus, internally the ArgumentHolder
+ ** has to keep track of the actual types, thus allowing to re-construct the concrete
+ ** function signature when closing the Mutation.
+ ** 
+ ** Finally, when invoking the command, it passes a \c CmdClosure& to the Mutation object,
+ ** which allows the embedded function to be called with the concrete arguments. Besides
+ ** just invoking it, a command can also be used like a prototype object. To support this
+ ** use case it is possible to re-bind to a new set of command arguments, and to create
+ ** a clone copy of the argument (holder) without disclosing the actual types involved. 
+ ** 
  ** @see Command
  ** @see ProcDispatcher
+ ** @see command-argument-holder.hpp
  **
  */
 
@@ -192,7 +213,7 @@ namespace control {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       
       
-      typedef BuildTupleAccessor<Args,ParamAccessor> BuildAccessor;
+      typedef BuildTupleAccessor<Args,ParamAccessor> Accessor;
       typedef typename BuildAccessor::Accessor ParamStorageTuple;
       
       ParamStorageTuple params_;
@@ -201,7 +222,7 @@ namespace control {
       typedef Tuple<Args> ArgTuple;
       
       Closure (ArgTuple const& args)
-        : params_(BuildAccessor(args))
+        : params_(Accessor(args))
         { }
       
       /** create a clone copy of this, without disclosing the exact type */
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 3238b44ce..163fbb6e1 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -28,22 +28,11 @@
  ** and storing of a "memento" value behind the scenes. But towards Command, the
  ** Mutation acts as interface to conceal these details, as well as the actual
  ** type and parameters of the functions to be invoked. Thus, Mutation's
- ** public interface just consists of a function call operator \c void() .
+ ** public interface just consists of a function call operator.
  ** 
- ** \par Lifecycle
- ** Mutation objects are to be created based on a concrete function object, which then
- ** gets embedded into a type erasure container, thus disposing the specific type information.
- ** Moreover, building on this lib::OpaqueHolder yields a fixed size storage for Mutation objects,
- ** allowing them to be embedded immediately within the CommandImpl frame.
+ ** Mutation objects are based on lib::OpaqueHolder, which yields a fixed size storage,
+ ** allowing them e.g. to be embedded immediately within the CommandImpl frame.
  ** 
- ** Later on, any command needs to be made ready for execution by binding it to a specific
- ** execution environment, which especially includes the target objects to be mutated by the
- ** command. This procedure includes "closing" the Mutation (and UNDO) functor(s) with the
- ** actual function arguments. These arguments are stored embedded within an ArgumentHolder,
- ** which thereby acts as closure. Besides, the ArgumentHolder also has to accommodate for
- ** storage holding the captured UNDO state (memento). Thus, internally the ArgumentHolder
- ** has to keep track of the actual types, thus allowing to re-construct the concrete
- ** function signature when closing the Mutation.
  ** 
  ** @see Command
  ** @see ProcDispatcher
@@ -77,76 +66,35 @@ namespace control {
   
   /**
    * Unspecific command functor for implementing Proc-Layer Command.
-   * To be created from an tr1::function object, which later on
-   * can be \link #close closed \endlink with a set of actual 
-   * function arguments. The concrete type of the function
-   * and the arguments is concealed (erased) on the interface,
-   * while the unclosed/closed - state of the functor can be
-   * checked by bool() conversion.
+   * To be created from an tr1::function object, which later on gets
+   * any necessary arguments from a closure passed in on invocation.
+   * The concrete type of the function  and the arguments is
+   * concealed (erased) on the interface.
    */
   class Mutation
-    : public lib::BoolCheckable<Mutation>
     {
-      CmdFunctor func_;
-      CmdClosure* clo_;
+      const CmdFunctor func_;
       
     public:
       template<typename SIG>
       Mutation (function<SIG> const& func)
-        : func_(func),
-          clo_(0)
+        : func_(func)
         { }
       
-      virtual ~Mutation() {}
-      
-      
-      virtual Mutation&
-      close (CmdClosure& cmdClosure)
-        {
-          ///////////////////////////////////////////////////////////////////////////////TODO we need a better approach; this breaks when re-binding
-          REQUIRE (!clo_, "Lifecycle error: already closed over the arguments");
-          REQUIRE (func_, "Param error: not bound to a valid function");
-          func_ = cmdClosure.closeArguments(func_);
-          clo_ = &cmdClosure;
-          return *this;
-        }
       
       
       void
-      operator() ()
+      operator() (CmdClosure const& clo)
         {
-          if (!clo_)
-            throw lumiera::error::State ("Lifecycle error: function arguments not yet provided",
+          if (!clo)
+            throw lumiera::error::State ("Lifecycle error: function arguments not ready",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
-          invoke (func_);
+          clo.invoke (func_);
         }
       
-      
-      /** diagnostics */
-      operator string()  const
-        { 
-          return isValid()? "Mutation("+string (*clo_)+")"
-                          : "Mutation(untied)";
-        }
-      
-      virtual bool
-      isValid ()   const
-        {
-          return func_ && clo_;
-        }
-      
-      
-    private:
-      void
-      invoke (CmdFunctor & closedFunction)
-        {
-          closedFunction.getFun<void()>() ();
-        }
     };
   
   
-  inline ostream& operator<< (ostream& os, Mutation const& muta) { return os << string(muta); }
-  
   
   
   
@@ -164,7 +112,7 @@ namespace control {
    * and store the state (memento), which is implemented
    * by the specifically typed MementoTie object passed
    * in on construction. All these specific details
-   * are concealed on the interface
+   * are concealed (erased) on the interface
    */
   class UndoMutation
     : public Mutation
@@ -179,35 +127,18 @@ namespace control {
         { }
       
       
-      virtual Mutation&
-      close (CmdClosure& cmdClosure)
-        {
-          Mutation::close(cmdClosure);
-          captureMemento_.close(cmdClosure);
-          return *this;
-        }
-      
-      
       Mutation&
-      captureState ()
+      captureState (CmdClosure const& clo)
         {
-          if (!Mutation::isValid())
-            throw lumiera::error::State ("need to bind function arguments prior to capturing undo state",
+          if (!clo)
+            throw lumiera::error::State ("need additional function arguments to be able to capture UNDO state",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          captureMemento_();
+          captureMemento_(clo);
           return *this;
         }
       
       
-    private:
-      virtual bool
-      isValid ()  const
-        {
-          return Mutation::isValid() && captureMemento_;
-        }
-      
-      
     };
   
   
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index ab7e8ab22..ec43dcb53 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -213,6 +213,7 @@ namespace test    {
           
           for_each (tup, showIt);
           
+////////////////////////TODO: Ticket #266
           arg1->bind ();
           arg2->bind (rand() % 10);
           arg3->bind (rand() % 10, randTime());
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index 39c88355c..f8f8877ad 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -24,6 +24,7 @@
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
 #include "proc/control/command-mutation.hpp"
+#include "proc/control/command-argument-holder.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/tuple.hpp"
@@ -91,9 +92,8 @@ namespace test    {
       
       
       /** @test check the Mutation functor which is bound to our \c testFunc(int) .
-       *        Then close this Mutation by providing a parameter tuple.
-       *        Verify finally that by invoking the Mutation functor
-       *        actually \c testFunc(param) is executed.
+       *        Then create a argument closure and use this to invoke the Mutation
+       *        and verify actually \c testFunc(param) is executed.
        */
       void
       checkMutation ()
@@ -101,24 +101,25 @@ namespace test    {
           function<void(int)> funky  = testFunc;
           
           Mutation functor (funky);
-          ASSERT (!functor);
-          VERIFY_ERROR (UNBOUND_ARGUMENTS, functor() );
-          cout << functor << endl;
           
+          MissingArguments nullClosure;
+          ASSERT (!nullClosure);
+          cout << "empty placeholder closure: " << nullClosure << endl;
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, functor(nullClosure) );
+          
+          // now create a real closure....
           Tuple<Types<int> > param = tuple::make(23);
           Closure<void(int)> close_over (param);
           
-          CmdClosure& clo (close_over);
-          functor.close(clo);
-          ASSERT (functor);
+          CmdClosure& closure (close_over);
+          ASSERT (closure);
           
-          cout << "param values: " << clo << endl;
-          cout << functor << endl;
+          cout << "param values: " << closure << endl;
           
           testVal = 0;
-          functor();
+          functor(closure);
           ASSERT (testVal == 23);
-          functor();
+          functor(closure);
           ASSERT (testVal == 2*23);
         }
       
@@ -148,48 +149,49 @@ namespace test    {
           
           MemHolder mementoHolder (undo_func,cap_func);
           UndoMutation undoFunctor (mementoHolder);
-          ASSERT (!undoFunctor);
           ASSERT (!mementoHolder);
-          VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor() );
+          
+          MissingArguments nullClosure;
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor(nullClosure) );
+          VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor.captureState(nullClosure) );
           
           Tuple<Types<> > param;
           Closure<void()> clo (param);
           
           undoFunctor.close(clo);
-          ASSERT ( undoFunctor);
           ASSERT (!mementoHolder);
-          VERIFY_ERROR (MISSING_MEMENTO, undoFunctor() );
+          VERIFY_ERROR (MISSING_MEMENTO, undoFunctor (clo) );
           VERIFY_ERROR (MISSING_MEMENTO, mementoHolder.getState() );
           
           testVal = 11;
-          undoFunctor.captureState();
+          undoFunctor.captureState(clo);
           ASSERT (mementoHolder);
           ASSERT (testVal == 11);
           
           int mem = mementoHolder.getState();
           cout << "saved state: " << mem << endl;
           
-          undoFunctor();
+          undoFunctor(clo);
           ASSERT (testVal == 11 + 11);
-          undoFunctor();
+          undoFunctor(clo);
           ASSERT (testVal == 11 + 11 + 11);
-          undoFunctor.captureState();
+          undoFunctor.captureState(clo);
           ASSERT (33 == mementoHolder.getState());
-          undoFunctor();
+          undoFunctor(clo);
           ASSERT (testVal == 33 + 33);
           testVal = 9;
-          undoFunctor();
+          undoFunctor(clo);
           ASSERT (testVal == 42);
           
           UndoMutation clonedFunc (undoFunctor);    // refers to the same state
           ASSERT (clonedFunc);
           
           ASSERT (33 == mementoHolder.getState());
-          clonedFunc.captureState();
+          clonedFunc.captureState(clo);
           ASSERT (42 == mementoHolder.getState());  // and captures into the same storage
           
           testVal = 0;
-          clonedFunc();
+          clonedFunc(clo);
           ASSERT (testVal == 42);
         }
       

From 925fa685b1f02b1ac73a7ebfb8bfd57ce9ba52c2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 21 Sep 2009 03:11:46 +0200
Subject: [PATCH 298/368] WIP change HandlingPattern to work on CommandImpl
 rather

---
 src/proc/control/command-impl.hpp      | 10 +++++-----
 src/proc/control/command.cpp           |  5 +++--
 src/proc/control/command.hpp           |  1 +
 src/proc/control/handling-pattern.cpp  | 13 ++++++-------
 src/proc/control/handling-pattern.hpp  | 22 ++++++++++++++++------
 src/proc/control/handling-patterns.hpp | 15 ++++++++-------
 6 files changed, 39 insertions(+), 27 deletions(-)

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index bb580693f..a3551dd90 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -132,13 +132,13 @@ namespace control {
       setArguments (Arguments& args)
         {
           pClo_->bindArguments(args);
-          
-          TODO ("this will break when re-binding to new arguments");
-          
-          do_  .close(*pClo_);
-          undo_.close(*pClo_);
         }
       
+      void invokeOperation() { do_(*pClo_); }
+      void invokeCapture()   { undo_.captureState(*pClo_); }
+      void invokeUndo()      { undo_(*pClo_); }
+      
+      
       
       typedef HandlingPattern::ID PattID;
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index ec3303063..1c294131d 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -271,14 +271,15 @@ namespace control {
   ExecResult
   Command::exec (HandlingPattern const& execPattern)
   {
-    return execPattern (*this);
+    CommandImpl& thisCommand (_Handle::impl());
+    return execPattern.invoke (thisCommand, cStr(*this));
   }
   
   
   ExecResult
   Command::exec (HandlingPattern::ID pattID)
   {
-    return HandlingPattern::get(pattID) (*this);
+    return exec (HandlingPattern::get(pattID));
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 18f4ca36e..ba45edf44 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -132,6 +132,7 @@ namespace control {
       ExecResult exec (HandlingPattern const& execPattern);
       ExecResult exec (HandlingPattern::ID);
       
+      /** invoke using a default "synchronous" execution pattern */
       ExecResult execSync ();
       
       /** @return ID of the execution pattern used by operator() */
diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index 8d02128e7..d48f39d30 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -22,7 +22,6 @@
 
 
 
-#include "proc/control/command.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/handling-patterns.hpp"
 
@@ -58,9 +57,9 @@ namespace control {
   /** @note: does error handling, but delegates the actual
    *         execution to the protected (subclass) member */
   ExecResult
-  HandlingPattern::operator() (Command& command)  const
+  HandlingPattern::invoke (CommandImpl& command, Symbol name)  const
   {
-    TRACE (proc_dbg, "invoking %s...", cStr(command));
+    TRACE (proc_dbg, "invoking %s...", name);
     static format err_pre ("Error state detected, %s *NOT* invoked.");
     static format err_post ("Error state after %s invocation.");
     static format err_fatal ("Execution of %s raised unknown error.");
@@ -84,21 +83,21 @@ namespace control {
     catch (lumiera::Error& problem)
       {
         Symbol errID = lumiera_error();
-        WARN (command, "Invocation of %s failed: %s", cStr(command), problem.what());
+        WARN (command, "Invocation of %s failed: %s", name, problem.what());
         TRACE (proc_dbg, "Error flag was: %s", errID);
         return ExecResult (problem);
       }
     catch (std::exception& library_problem)
       {
         Symbol errID = lumiera_error();
-        WARN (command, "Invocation of %s failed: %s", cStr(command), library_problem.what());
+        WARN (command, "Invocation of %s failed: %s", name, library_problem.what());
         TRACE (proc_dbg, "Error flag was: %s", errID);
         return ExecResult (error::External (library_problem));
       }
     catch (...)
       {
         Symbol errID = lumiera_error();
-        ERROR (command, "Invocation of %s failed with unknown exception; error flag is: %s", cStr(command), errID);
+        ERROR (command, "Invocation of %s failed with unknown exception; error flag is: %s", name, errID);
         throw error::Fatal (str (err_fatal % command), errID);
       }
   }
@@ -115,7 +114,7 @@ namespace control {
   /* ====== execution result state object ======= */
   
   
-  /** @note we just grab an retain the error message.
+  /** @note we just grab and retain the error message.
    *  @todo rather keep the exception object around. */
   ExecResult::ExecResult (lumiera::Error const& problem)
     : log_(problem.what())
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 09fad5b65..c52b26075 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -22,7 +22,17 @@
 
 
 /** @file handling-pattern.hpp
- ** //TODO 
+ ** Pre-defined command execution templates.
+ ** Any command can be configured to use a specific handling pattern
+ ** on invocation. Moreover, there is a default handling pattern for commands.
+ ** These patterns define the steps necessary for getting the command actually
+ ** invoked (template method pattern). A pattern may cause the command to be
+ ** enqueued, registered for UNDO or dispatched into a background thread.
+ ** To carry out the work, HandlingPattern implementations are allowed to
+ ** invoke the CommandImpl API directly. 
+ **
+ ** @todo it is not clear what's the difference between "throw" and "no-throw" pattern
+ ** @todo any integration with the (yet undefined as of 9/09) ProcDispatcher is missing.
  **
  ** @see ProcDispatcher
  ** @see Session
@@ -37,7 +47,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
-//#include "include/symbol.hpp"
+#include "include/symbol.hpp"
 
 //#include <tr1/memory>
 #include <string>
@@ -47,11 +57,11 @@
 namespace control {
   
   using std::string;
-//  using lumiera::Symbol;
+  using lumiera::Symbol;
 //  using std::tr1::shared_ptr;
   
   
-  class Command;
+  class CommandImpl;
   
   
   /**
@@ -101,7 +111,7 @@ namespace control {
       /** main functionality: invoke a command, detect errors.
        *  @return ExecResult object, which might later be used to 
        *          detect errors on execution */
-      ExecResult operator() (Command& command)  const;
+      ExecResult invoke (CommandImpl& command, Symbol name)  const;
       
       /** @return HandlingPatter describing how the UNDO operation is to be performed */
       HandlingPattern const& howtoUNDO()  const;
@@ -111,7 +121,7 @@ namespace control {
       
     protected:
       
-      virtual void perform (Command& command)  const  =0;
+      virtual void perform (CommandImpl& command)  const  =0;
       
       virtual HandlingPattern const& defineUNDO()  const  =0;
       
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index 4892504af..b3e56f36c 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -1,5 +1,5 @@
 /*
-  HANDLILNG-PATTERNS.hpp  -  Collection of predefinded command handling patterns
+  HANDLILNG-PATTERNS.hpp  -  Collection of predefined command handling patterns
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -26,7 +26,7 @@
  ** There is a small number of different possibilities to handle execution
  ** and UNDO of proc-Layer commands. Each of these is defined as a subclass
  ** in this header and then hard wired into a small table. Handling patterns
- ** are stateless singleton objects, thus we build use SingletonSubclass
+ ** are stateless singleton objects, thus we build using SingletonSubclass
  ** factory objects and configure them hard wired with the respective
  ** implementation classes. The index positions in this table match
  ** the sequence within the enum HandlingPattern::ID; all of this
@@ -46,6 +46,7 @@
 #include "lib/error.hpp"
 #include "lib/singleton-subclass.hpp"
 #include "proc/control/handling-pattern.hpp"
+#include "proc/control/command-impl.hpp"
 #include "proc/mobject/session.hpp"
 #include "include/lifecycle.h"
 //#include "include/symbol.hpp"
@@ -75,7 +76,7 @@ namespace control {
       : public HandlingPattern
       {
         void
-        perform (Command& command)  const
+        perform (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
@@ -103,7 +104,7 @@ namespace control {
       : public HandlingPattern
       {
         void
-        perform (Command& command)  const
+        perform (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
@@ -131,7 +132,7 @@ namespace control {
       : public HandlingPattern
       {
         void
-        perform (Command& command)  const
+        perform (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
@@ -180,9 +181,9 @@ namespace control {
     {
       using lumiera::singleton::UseSubclass;
       
-      patternTable[HandlingPattern::SYNC]        = SingletonFac(UseSubclass<InvokeSyncNoThrow>());
+      patternTable[HandlingPattern::SYNC      ]  = SingletonFac(UseSubclass<InvokeSyncNoThrow>());
       patternTable[HandlingPattern::SYNC_THROW]  = SingletonFac(UseSubclass<InvokeSyncThrow>());
-      patternTable[HandlingPattern::ASYNC]       = SingletonFac(UseSubclass<InvokeAsync>());
+      patternTable[HandlingPattern::ASYNC     ]  = SingletonFac(UseSubclass<InvokeAsync>());
     }
     
     

From 246c53556967b68cc19a0e93ece802e286e77188 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 21 Sep 2009 03:15:06 +0200
Subject: [PATCH 299/368] Rewrite CmdClosure to actually invoke rather then to
 create a tr1::bind term basically this should close Ticket #205  (some
 details missing)

---
 src/proc/control/command-argument-holder.hpp  |  4 +-
 src/proc/control/command-closure.hpp          | 40 ++++++++-----------
 src/proc/control/command-impl.cpp             | 10 ++++-
 src/proc/control/command-impl.hpp             | 23 ++++++-----
 src/proc/control/command-mutation.hpp         |  4 +-
 .../proc/control/command-argument-test.cpp    |  7 ++--
 .../proc/control/command-mutation-test.cpp    | 19 ++-------
 7 files changed, 51 insertions(+), 56 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 0d04a25df..f707efe4a 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -151,14 +151,14 @@ namespace control {
       }
       
       
-      virtual CmdFunctor closeArguments (CmdFunctor const& func)
+      virtual void invoke (CmdFunctor const& func)
         {
           if (!isValid())
             throw lumiera::error::State ("Lifecycle error: can't bind functor, "
                                          "command arguments not yet provided",
                                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
           
-          return arguments_->closeArguments(func);
+          arguments_->invoke(func);
         }
       
       
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index c1be0c4eb..da173bb8d 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -126,13 +126,13 @@ namespace control {
     public:
       virtual ~CmdClosure() {}
       
-      virtual operator string() const =0;
+      virtual operator string() const                    =0;
       
-      virtual bool isValid ()   const =0;
+      virtual bool isValid ()   const                    =0;
       
-      virtual void bindArguments (Arguments&) =0;
+      virtual void bindArguments (Arguments&)            =0;
       
-      virtual CmdFunctor closeArguments (CmdFunctor const&) =0;
+      virtual void invoke (CmdFunctor const&)            =0;
       
       virtual PClo createClone (TypedAllocationManager&) =0;
     };
@@ -213,8 +213,8 @@ namespace control {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       
       
-      typedef BuildTupleAccessor<Args,ParamAccessor> Accessor;
-      typedef typename BuildAccessor::Accessor ParamStorageTuple;
+      typedef BuildTupleAccessor<Args,ParamAccessor> Builder;
+      typedef typename Builder::Accessor ParamStorageTuple;
       
       ParamStorageTuple params_;
       
@@ -222,7 +222,7 @@ namespace control {
       typedef Tuple<Args> ArgTuple;
       
       Closure (ArgTuple const& args)
-        : params_(Accessor(args))
+        : params_(Builder (args))
         { }
       
       /** create a clone copy of this, without disclosing the exact type */
@@ -240,26 +240,19 @@ namespace control {
       }
       
       
-      /** Core operation: use the embedded argument tuple
-       *  to close a given functor over its arguments.
-       *  @param unboundFunctor an function object, whose
-       *         function arguments are required to match 
-       *         the types of the embedded ParamStorageTuple
-       *  @return new functor object containing the function<void()>,
-       *         which is created by binding all arguments of the
-       *         input functor.
+      /** Core operation: use the embedded argument tuple for invoking a functor
+       *  @param unboundFunctor an function object, whose function arguments are
+       *         required to match the types of the embedded ParamStorageTuple
        *  @note  ASSERTION failure if the function signature 
        *         doesn't match the argument types tuple.
-       *  @note  when finally invoked, the functor, which is
-       *         bound here to the argument tuple, might actually
-       *         \em modify the param values. Thus this function
-       *         can't be const.
+       *  @note  the functor might actually \em modify the param values.
+       *         Thus this function can't be const.
        */
-      CmdFunctor
-      closeArguments (CmdFunctor const& unboundFunctor)
+      void
+      invoke (CmdFunctor const& unboundFunctor)
         {
-          return CmdFunctor (TupleApplicator<SIG> (params_)
-                               .bind ( unboundFunctor.getFun<SIG>()) );
+          TupleApplicator<SIG> apply_this_arguments(params_);
+          apply_this_arguments (unboundFunctor.getFun<SIG>());
         }
       
       
@@ -289,6 +282,5 @@ namespace control {
   
   
   
-  
 } // namespace control
 #endif
diff --git a/src/proc/control/command-impl.cpp b/src/proc/control/command-impl.cpp
index f8b31dd2b..79e5cfddd 100644
--- a/src/proc/control/command-impl.cpp
+++ b/src/proc/control/command-impl.cpp
@@ -31,6 +31,7 @@
 
 
 #include "proc/control/command-impl.hpp"
+#include "proc/control/command-argument-holder.hpp"
 //#include "proc/mobject/mobject-ref.hpp"
 //#include "proc/mobject/mobject.hpp"
 //#include "proc/mobject/placement.hpp"
@@ -49,7 +50,14 @@ namespace control {
   /////////////////////////////////////////TODO: is this impl file actually necessary??
 
   
-
+  bool
+  CommandImpl::hasUndoState (CmdClosure const& closure)
+  {
+    UNIMPLEMENTED ("how the hell do we get at the memento-captured state???");
+//    REQUIRE (INSTANCEOF (ArgumentHolder, &closure));
+//    return static_cast<ArgumentHolder const&> (closure).canUndo();
+  }
+  
   
   
   
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index a3551dd90..561a10331 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -43,8 +43,8 @@
 #define CONTROL_COMMAND_IMPL_H
 
 #include "proc/control/command.hpp"
+#include "proc/control/command-closure.hpp"
 #include "proc/control/command-mutation.hpp"
-#include "proc/control/command-argument-holder.hpp"
 #include "proc/control/typed-allocation-manager.hpp"
 #include "lib/bool-checkable.hpp"
 
@@ -59,11 +59,15 @@ namespace control {
   
   using std::tr1::function;
   using std::tr1::shared_ptr;
-
+  
   
   
   /**
-   * @todo Type-comment
+   * Proc-Layer Command implementation.
+   * Data record holding together the parts necessary for command execution
+   * - command operation functor
+   * - a functor to UNDO the command effect
+   * - closure holding actual parameters and UNDO state
    */
   class CommandImpl
     : public lib::BoolCheckable<CommandImpl
@@ -173,25 +177,26 @@ namespace control {
       canExec()  const    ///< state check: sufficiently defined to be invoked 
         {
           return isValid()
-              && *pClo_ && do_;
+              && *pClo_;
         }
       
       bool
       canUndo()  const    ///< state check: has undo state been captured? 
         {
-          return isValid() && undo_;
+          return isValid() && hasUndoState(*pClo_);
         }
       
       
       ////////////////////////////////////////////////////////////////////////////////////TODO comparisons
       
-    protected:
+    private:
+      
+      static bool hasUndoState (CmdClosure const&);
       
     };
-  ////////////////TODO currently just fleshing  out the API....
   
-
-
+  
+  
   
   
 } // namespace control
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 163fbb6e1..b1bc12787 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -84,7 +84,7 @@ namespace control {
       
       
       void
-      operator() (CmdClosure const& clo)
+      operator() (CmdClosure& clo)
         {
           if (!clo)
             throw lumiera::error::State ("Lifecycle error: function arguments not ready",
@@ -128,7 +128,7 @@ namespace control {
       
       
       Mutation&
-      captureState (CmdClosure const& clo)
+      captureState (CmdClosure& clo)
         {
           if (!clo)
             throw lumiera::error::State ("need additional function arguments to be able to capture UNDO state",
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index ec43dcb53..67ab7e678 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -29,6 +29,7 @@
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
+#include <tr1/functional>
 #include <iostream>
 #include <sstream>
 #include <cstdlib>
@@ -325,9 +326,9 @@ namespace test    {
           typedef function<void()> OpFun;
           
           // now close all the functions with the stored parameter values... 
-          OpFun bound_doItFun = args.closeArguments (CmdFunctor(doItFun)).getFun<void()>();
-          OpFun bound_undoFun = args.closeArguments (CmdFunctor(undoFun)).getFun<void()>();
-          OpFun bound_captFun = args.closeArguments (CmdFunctor(captFun)).getFun<void()>();
+          OpFun bound_doItFun = std::tr1::bind (&CmdClosure::invoke, args, CmdFunctor(doItFun));
+          OpFun bound_undoFun = std::tr1::bind (&CmdClosure::invoke, args, CmdFunctor(undoFun));
+          OpFun bound_captFun = std::tr1::bind (&CmdClosure::invoke, args, CmdFunctor(captFun));
           
           protocol.seekp(0);
           protocol << "START...";
diff --git a/tests/components/proc/control/command-mutation-test.cpp b/tests/components/proc/control/command-mutation-test.cpp
index f8f8877ad..d02822743 100644
--- a/tests/components/proc/control/command-mutation-test.cpp
+++ b/tests/components/proc/control/command-mutation-test.cpp
@@ -98,11 +98,12 @@ namespace test    {
       void
       checkMutation ()
         {
-          function<void(int)> funky  = testFunc;
+          typedef void SIG_fun(int);
+          function<SIG_fun> funky  = testFunc;
           
           Mutation functor (funky);
           
-          MissingArguments nullClosure;
+          MissingArguments<SIG_fun> nullClosure;
           ASSERT (!nullClosure);
           cout << "empty placeholder closure: " << nullClosure << endl;
           VERIFY_ERROR (UNBOUND_ARGUMENTS, functor(nullClosure) );
@@ -151,14 +152,13 @@ namespace test    {
           UndoMutation undoFunctor (mementoHolder);
           ASSERT (!mementoHolder);
           
-          MissingArguments nullClosure;
+          MissingArguments<void(void)> nullClosure;
           VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor(nullClosure) );
           VERIFY_ERROR (UNBOUND_ARGUMENTS, undoFunctor.captureState(nullClosure) );
           
           Tuple<Types<> > param;
           Closure<void()> clo (param);
           
-          undoFunctor.close(clo);
           ASSERT (!mementoHolder);
           VERIFY_ERROR (MISSING_MEMENTO, undoFunctor (clo) );
           VERIFY_ERROR (MISSING_MEMENTO, mementoHolder.getState() );
@@ -182,17 +182,6 @@ namespace test    {
           testVal = 9;
           undoFunctor(clo);
           ASSERT (testVal == 42);
-          
-          UndoMutation clonedFunc (undoFunctor);    // refers to the same state
-          ASSERT (clonedFunc);
-          
-          ASSERT (33 == mementoHolder.getState());
-          clonedFunc.captureState(clo);
-          ASSERT (42 == mementoHolder.getState());  // and captures into the same storage
-          
-          testVal = 0;
-          clonedFunc(clo);
-          ASSERT (testVal == 42);
         }
       
       

From 09b9f6484249a0a42def473333464948545b26f0 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 21 Sep 2009 03:33:56 +0200
Subject: [PATCH 300/368] diagnostics about captured state (on the CmdClosure
 API)

---
 src/proc/control/command-argument-holder.hpp |  6 ++++++
 src/proc/control/command-closure.hpp         | 16 +++++++---------
 src/proc/control/command-impl.cpp            |  7 -------
 src/proc/control/command-impl.hpp            |  4 +---
 4 files changed, 14 insertions(+), 19 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index f707efe4a..c2bcbb0f7 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -140,6 +140,12 @@ namespace control {
           return arguments_->isValid();
         }
       
+      virtual bool isCaptured() const
+        {
+          return memento_->isValid();
+        }
+
+      
       
       /** assign a new parameter tuple to this */
       virtual void bindArguments (Arguments& args)
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index da173bb8d..73b94ceda 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -127,14 +127,11 @@ namespace control {
       virtual ~CmdClosure() {}
       
       virtual operator string() const                    =0;
-      
-      virtual bool isValid ()   const                    =0;
-      
-      virtual void bindArguments (Arguments&)            =0;
-      
-      virtual void invoke (CmdFunctor const&)            =0;
-      
-      virtual PClo createClone (TypedAllocationManager&) =0;
+      virtual bool isValid ()   const                    =0;      ///< does this closure hold a valid argument tuple?
+      virtual bool isCaptured () const                   =0;      ///< does this closure hold captured UNDO state?
+      virtual void bindArguments (Arguments&)            =0;      ///< store a set of parameter values within this closure
+      virtual void invoke (CmdFunctor const&)            =0;      ///< invoke functor using the stored parameter values
+      virtual PClo createClone (TypedAllocationManager&) =0;      ///< create clone allocation without disclosing concrete type
     };
   
   
@@ -271,7 +268,8 @@ namespace control {
         }
       
       
-      bool isValid ()  const { return true; }
+      bool isValid ()   const { return true; }
+      bool isCaptured() const { return false; }
       
       
       /// Supporting equality comparisons...
diff --git a/src/proc/control/command-impl.cpp b/src/proc/control/command-impl.cpp
index 79e5cfddd..b73573091 100644
--- a/src/proc/control/command-impl.cpp
+++ b/src/proc/control/command-impl.cpp
@@ -50,13 +50,6 @@ namespace control {
   /////////////////////////////////////////TODO: is this impl file actually necessary??
 
   
-  bool
-  CommandImpl::hasUndoState (CmdClosure const& closure)
-  {
-    UNIMPLEMENTED ("how the hell do we get at the memento-captured state???");
-//    REQUIRE (INSTANCEOF (ArgumentHolder, &closure));
-//    return static_cast<ArgumentHolder const&> (closure).canUndo();
-  }
   
   
   
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 561a10331..92871a509 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -183,7 +183,7 @@ namespace control {
       bool
       canUndo()  const    ///< state check: has undo state been captured? 
         {
-          return isValid() && hasUndoState(*pClo_);
+          return isValid() && pClo_->isCaptured();
         }
       
       
@@ -191,8 +191,6 @@ namespace control {
       
     private:
       
-      static bool hasUndoState (CmdClosure const&);
-      
     };
   
   

From 7f09f57cbde4932269c390da70c42a622cd1275f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 21 Sep 2009 03:34:10 +0200
Subject: [PATCH 301/368] tests pass again

---
 tests/45controller.tests | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/tests/45controller.tests b/tests/45controller.tests
index 060fd131c..83aa89365 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -36,9 +36,8 @@ END
 
 
 TEST "Command functor and UNDO functor" CommandMutation_test <<END
-out: Mutation\(untied\)
+out: empty placeholder closure: Closure\(0\)
 out: param values: Closure\(23\)
-out: Mutation\(Closure\(23\)\)
 out: saved state: 11
 END
 

From 3b1e2f00a8e69239ecbeb11128e0d4466bcd2abb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 02:00:52 +0200
Subject: [PATCH 302/368] rewrite simulated "subsystem". Hopefully closes
 Ticket #253 - clarify the meaning of run(true), run(fail), run(throw) - do a
 real handshake between start() and the subsystem thread - avoid accessing the
 SubsystenRunner after signalling termination

---
 src/lib/sync.hpp                    | 16 +++++--
 tests/lib/subsystem-runner-test.cpp | 70 +++++++++++++++++------------
 2 files changed, 55 insertions(+), 31 deletions(-)

diff --git a/src/lib/sync.hpp b/src/lib/sync.hpp
index 4d3fa0757..d7afce536 100644
--- a/src/lib/sync.hpp
+++ b/src/lib/sync.hpp
@@ -411,11 +411,21 @@ namespace lib {
             void notify()                     { mon_.signal(false);}
             void notifyAll()                  { mon_.signal(true); }
             void setTimeout(ulong time)       { mon_.setTimeout(time); }
-            
-            template<typename C>
-            bool wait (C& cond, ulong time=0) { return mon_.wait(cond,time);}
             bool isTimedWait()                { return mon_.isTimedWait(); }
             
+            template<typename C>
+            bool
+            wait (C& cond, ulong timeout=0)
+              {
+                return mon_.wait(cond,timeout);
+              }
+            
+            template<typename X>
+            bool
+            wait  (X& instance, bool (X::*predicate)(void), ulong timeout=0)
+              {
+                return mon_.wait(instance,predicate,timeout);
+              }
             
             /** convenience shortcut: 
              *  Locks and immediately enters wait state,
diff --git a/tests/lib/subsystem-runner-test.cpp b/tests/lib/subsystem-runner-test.cpp
index 82e04364a..57a4953a6 100644
--- a/tests/lib/subsystem-runner-test.cpp
+++ b/tests/lib/subsystem-runner-test.cpp
@@ -90,6 +90,7 @@ namespace lumiera {
           
           volatile bool isUp_;
           volatile bool didRun_;
+          volatile bool started_;
           volatile bool termRequest_;
           int running_duration_;
           
@@ -107,16 +108,16 @@ namespace lumiera {
           bool
           start (lumiera::Option&, Subsys::SigTerm termination)
             {
-              REQUIRE (!isUp_, "attempt to start %s twice!", cStr(*this));
+              REQUIRE (!(isUp_|started_|didRun_), "attempt to start %s twice!", cStr(*this));
               
-              Lock guard (this);
-              Literal startSpec (extractID ("start",spec_));
+              Lock sync(this);
+              string startSpec (extractID ("start",spec_));
               ASSERT (!isnil (startSpec));
               
               if ("true"==startSpec) //----simulate successful subsystem start
                 { 
                   Thread (id_, bind (&MockSys::run, this, termination));            /////TODO: the thread description should be rather "Test: "+string(*this), but this requires to implement the class Literal as planned
-                  isUp_ = true;
+                  sync.wait(started_); // run-status handshake
                 }
               else
               if ("fail"==startSpec) //----not starting, incorrectly reporting success
@@ -125,7 +126,7 @@ namespace lumiera {
               if ("throw"==startSpec) //---starting flounders
                 throw error::Fatal("simulated failure to start the subsystem", LUMIERA_ERROR_TEST);
               
-              return isUp_;
+              return started_;
             }
           
           void
@@ -145,49 +146,61 @@ namespace lumiera {
             }
           
           
+          /** executes in a separate thread and
+           *  simulates a "running" subsystem.
+           *  Behaviour determined by run(XX) spec:
+           *  - run(true) : start, run, terminate normally
+           *  - run(throw): start, run, signal abnormal termination
+           *  - run(fail) : set didRun_, but abort, never enter running state
+           *  - run(false): just handshake, but then abort without further action
+           */
           void
-          run (Subsys::SigTerm termination)  ///< simulates a "running" subsystem
+          run (Subsys::SigTerm termination)
             {
               Literal runSpec (extractID ("run",spec_));
               ASSERT (!isnil (runSpec));
               
-              if ("false"!=runSpec) //----actually enter running state for some time
+              { // run-status handshake
+                Lock sync(this);
+                started_ = true;
+                isUp_    = ("true"==runSpec || "throw"==runSpec);
+                didRun_  = ("false"!=runSpec); // includes "fail" and "throw"
+                sync.notify();
+              }
+              
+              if (isUp_) //-------------actually enter running state for some time
                 {
-                  didRun_ = true;
                   running_duration_  =  MIN_RUNNING_TIME_ms;
                   running_duration_ += (rand() % (MAX_RUNNING_TIME_ms - MIN_RUNNING_TIME_ms));
                   
                   INFO (test, "thread %s now running....", cStr(*this));
                   
-                  Lock wait_blocking (this, &MockSys::tick);
+                  Lock sync_condition(this);
+                  while (!sync_condition.wait (*this, &MockSys::tick, TICK_DURATION_ms))
+                    running_duration_ -= TICK_DURATION_ms;
+                  
+                  INFO (test, "thread %s about to terminate...", cStr(*this));
+                  isUp_ = false;
                 }
               
-              Error problemIndicator("simulated Problem killing a subsystem",LUMIERA_ERROR_TEST);
-              lumiera_error();   //  reset error state....
-                                //   Note: in real life this actually
-                               //    would be an catched exception!
-              string problemReport (problemIndicator.what());
+              if ("fail" ==runSpec) return; // terminate without further notice
+              if ("true" ==runSpec) termination(0); // signal regular termination
+              if ("throw"==runSpec)
+                {
+                  Error problemIndicator("simulated Problem terminating subsystem",LUMIERA_ERROR_TEST);
+                  lumiera_error();    //  reset error state....
+                                     //   Note: in real life this actually
+                                    //    would be an catched exception!
+                  string problemReport (problemIndicator.what());
+                  termination (&problemReport);
+                }
               
-              {
-                Lock guard (this);
-                isUp_ = false;
-              }
-              INFO (test, "thread %s terminates.", cStr(*this));
-              termination ("true"==runSpec? 0 : &problemReport);
             }
           
           
           bool
           tick ()   ///< simulates async termination, either on request or by timing
             {
-              Lock sync(this);
-              if (!sync.isTimedWait())
-                {
-                  sync.setTimeout(TICK_DURATION_ms);
-                  running_duration_ += TICK_DURATION_ms;
-                }
-              
-              running_duration_ -= TICK_DURATION_ms;
               return termRequest_ || running_duration_ <= 0;
             }
           
@@ -199,6 +212,7 @@ namespace lumiera {
               spec_(spec),
               isUp_(false),
               didRun_(false),
+              started_(false),
               termRequest_(false),
               running_duration_(0)
             { }

From ad6d5cc7efa323c31f07226e99348568d0871cb4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 02:11:34 +0200
Subject: [PATCH 303/368] improve and steamline the subsystem testcases

---
 tests/lib/subsystem-runner-test.cpp | 59 +++++++----------------------
 tests/lib/sync-locking-test.cpp     |  3 +-
 2 files changed, 15 insertions(+), 47 deletions(-)

diff --git a/tests/lib/subsystem-runner-test.cpp b/tests/lib/subsystem-runner-test.cpp
index 57a4953a6..8585ee563 100644
--- a/tests/lib/subsystem-runner-test.cpp
+++ b/tests/lib/subsystem-runner-test.cpp
@@ -22,6 +22,7 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 #include "common/subsys.hpp"
 #include "common/subsystem-runner.hpp"
 #include "common/option.hpp"
@@ -47,7 +48,7 @@ using backend::Thread;
 
 
 namespace lumiera {
-  namespace test  {
+namespace test  {
     
     namespace { // private test classes and data...
       
@@ -56,7 +57,7 @@ namespace lumiera {
       /** limit for the randomly selected duration of
        *  subsystem's running phase (milliseconds) */
       const uint MAX_RUNNING_TIME_ms = 80;
-      const uint MIN_RUNNING_TIME_ms = 10;
+      const uint MIN_RUNNING_TIME_ms = 20;
       
       /** the "running" subsystem checks for a
        *  shutdown request every XX milliseconds */
@@ -69,6 +70,8 @@ namespace lumiera {
       /** marker for simulated failure exceptions */
       LUMIERA_ERROR_DEFINE( TEST, "simulated failure.");
       
+      using error::LUMIERA_ERROR_LOGIC;
+      
       
       
       
@@ -294,40 +297,14 @@ namespace lumiera {
             MockSys unit1 ("U1", "start(false), run(false).");
             MockSys unit2 ("U2", "start(throw), run(false).");
             MockSys unit3 ("U3", "start(fail),  run(false).");  // simulates incorrect behaviour
-            MockSys unit4 ("U4", "start(true),  run(false).");
+            MockSys unit4 ("U4", "start(true),  run(fail)." );  // simulates failure immediately after start
             SubsystemRunner runner(dummyOpt);
             
             runner.maybeRun (unit1);  // this one doesn't start at all, which isn't considered an error
             
-            try 
-              { 
-                runner.maybeRun (unit2);
-                NOTREACHED();
-              }
-            catch (lumiera::Error&)
-              {
-                ASSERT (lumiera_error() == LUMIERA_ERROR_TEST);
-              }
-            try 
-              { 
-                runner.maybeRun (unit3);
-                NOTREACHED();
-              }
-            catch (lumiera::Error&)
-              {
-                ASSERT (lumiera_error() == error::LUMIERA_ERROR_LOGIC); // incorrect behaviour trapped
-              }
-            try 
-              { 
-                runner.maybeRun (unit4);
-              }
-            catch (lumiera::Error&)
-              {
-                ASSERT (lumiera_error() == error::LUMIERA_ERROR_LOGIC); // detected that the subsystem didn't come up
-              }                                                         //   (due to the way the test subsystem is written,
-                                                                        //    this may not always be detected, because there
-                                                                        //    is a short time window where isUp_==true )
-            
+            VERIFY_ERROR (TEST,  runner.maybeRun (unit2) );
+            VERIFY_ERROR (LOGIC, runner.maybeRun (unit3) );     // incorrect behaviour trapped
+            VERIFY_ERROR (LOGIC, runner.maybeRun (unit4) );     // detected that the subsystem didn't come up
             
             runner.wait();
             
@@ -338,7 +315,7 @@ namespace lumiera {
             ASSERT (!unit1.didRun());
             ASSERT (!unit2.didRun());
             ASSERT (!unit3.didRun());
-            ASSERT (!unit4.didRun());
+            ASSERT ( unit4.didRun()); // ...but it failed immediately
           }
         
         
@@ -347,7 +324,7 @@ namespace lumiera {
           {
             cout << "-----singleSubsys_emegency_exit-----\n";
             
-            MockSys unit ("one", "start(true), run(fail).");
+            MockSys unit ("one", "start(true), run(throw).");
             SubsystemRunner runner(dummyOpt);
             
             runner.maybeRun (unit);
@@ -409,15 +386,7 @@ namespace lumiera {
             unit3.depends (unit2);
             SubsystemRunner runner(dummyOpt);
             
-            try 
-              { 
-                runner.maybeRun (unit4);
-                NOTREACHED();
-              }
-            catch (lumiera::Error&)
-              {
-                ASSERT (lumiera_error() == error::LUMIERA_ERROR_LOGIC); // failure to bring up prerequisites is detected
-              }
+            VERIFY_ERROR (LOGIC, runner.maybeRun (unit4) );   // failure to bring up prerequisites is detected
             ASSERT ( unit1.isRunning());
             ASSERT ( unit2.isRunning());
             ASSERT (!unit3.isRunning());
@@ -444,6 +413,4 @@ namespace lumiera {
     
     
     
-  } // namespace test
-
-} // namespace lumiera
+}} // namespace lumiera::test
diff --git a/tests/lib/sync-locking-test.cpp b/tests/lib/sync-locking-test.cpp
index 33651ebc9..d6586242c 100644
--- a/tests/lib/sync-locking-test.cpp
+++ b/tests/lib/sync-locking-test.cpp
@@ -58,7 +58,8 @@ namespace lib {
             {
               Lock guard (this); // note recursive lock
               
-              for ( uint i=0, lim=(rand() % MAX_PAUSE); i<lim; ++i);
+              for ( uint i=0, lim=(rand() % MAX_PAUSE); i<lim; ++i)
+                ;
             }
           
           void 

From c9f3a345dcfbf14f7c53dad5bce777aa0b3a0f37 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 24 Sep 2009 05:09:51 +0200
Subject: [PATCH 304/368] WIP towards CommandRegistry implementation

---
 src/proc/control/command-registry.hpp         | 19 +++++++++++++++++++
 .../proc/control/command-registry-test.cpp    |  4 +---
 2 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index c82b5396c..975c126c9 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -51,14 +51,18 @@
 #include "proc/control/typed-allocation-manager.hpp"
 //#include "proc/control/memento-tie.hpp"
 
+#include <boost/noncopyable.hpp>
+#include <tr1/unordered_map>
 #include <tr1/memory>
 //#include <iostream>
 #include <string>
+#include <map>
 
 
 
 namespace control {
   
+  using boost::noncopyable;
   using std::tr1::shared_ptr;
 //  using std::ostream;
   using std::string;
@@ -71,9 +75,16 @@ namespace control {
    */
   class CommandRegistry
     : public lib::Sync<>
+    , noncopyable
     {
       TypedAllocationManager allocator_;
       
+      typedef std::tr1::unordered_map<Symbol, Command> CmdIndex;
+      typedef std::map<void*, Symbol> ReverseIndex;
+      
+      CmdIndex index_;
+      ReverseIndex ridx_;
+      
       
     public:
       static lumiera::Singleton<CommandRegistry> instance;
@@ -87,6 +98,14 @@ namespace control {
         {
           Lock sync(this);
           UNIMPLEMENTED ("place a commandHandle into the command index, or return the command already registered there");
+          Command& indexSlot (index_[cmdID]);
+          if (!indexSlot)
+            {
+              indexSlot = commandHandle;
+              ridx_[&indexSlot] = cmdID;
+            }
+          return indexSlot;
+          ///////////////////////////TODO possible to return a const& ??
         }
       
       
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index 13dcb257c..a4d473db8 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -124,8 +124,7 @@ namespace test    {
           // represented internally by a prototype instance
           ASSERT (1+cnt_inst == registry.instance_count());
           cnt_inst++;
-
-          UNIMPLEMENTED ("cover all relevant API functions");
+          
           checkRegistration (registry);
           checkAllocation(registry);
           
@@ -226,7 +225,6 @@ namespace test    {
           ASSERT (!isSameObject (*pImpl, *clone));
           ASSERT (*pImpl == *clone);
           
-                                ///////////////////////////////////////////////TODO: maybe do a simulated command lifecycle here?
           ASSERT (!pImpl->canExec());
           typedef Types<int> ArgType;
           TypedArguments<Tuple<ArgType> > arg (Tuple<ArgType>(98765));

From f278d4521cc350e0926a5da958d528bca9b7ca30 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 24 Sep 2009 19:38:11 +0200
Subject: [PATCH 305/368] WIP: to make the ID type usable as hashtable key

---
 src/include/symbol.hpp                |  1 +
 src/lib/Makefile.am                   |  1 +
 src/lib/safeclib.h                    |  2 +-
 src/lib/symbol-impl.cpp               | 78 +++++++++++++++++++++++++++
 src/proc/asset/db.hpp                 |  1 +
 src/proc/control/command-registry.hpp |  4 +-
 src/proc/control/command.hpp          | 14 ++---
 7 files changed, 91 insertions(+), 10 deletions(-)
 create mode 100644 src/lib/symbol-impl.cpp

diff --git a/src/include/symbol.hpp b/src/include/symbol.hpp
index 5de94a2cd..00e19571d 100644
--- a/src/include/symbol.hpp
+++ b/src/include/symbol.hpp
@@ -32,6 +32,7 @@
  ** - automatically maintain a symbol table at runtime to support this
  ** - provide some magic (macros) allowing to build distinct types based on symbols.
  ** 
+ ** @see symbol-impl.cpp 
  ** @see configrules.hpp
  ** @see query.hpp
  */
diff --git a/src/lib/Makefile.am b/src/lib/Makefile.am
index f5ff19566..b6f89847b 100644
--- a/src/lib/Makefile.am
+++ b/src/lib/Makefile.am
@@ -46,6 +46,7 @@ liblumiera_la_SOURCES =						\
 	$(liblumiera_la_srcdir)/test/testoption.cpp 		\
 	$(liblumiera_la_srcdir)/test/test-helper.cpp 		\
 	$(liblumiera_la_srcdir)/test/suite.cpp 			\
+	$(liblumiera_la_srcdir)/symbol-impl.cpp			\
 	$(liblumiera_la_srcdir)/cmdline.cpp			\
 	$(liblumiera_la_srcdir)/logging.cpp
 
diff --git a/src/lib/safeclib.h b/src/lib/safeclib.h
index d949595f8..ed0d73fd3 100644
--- a/src/lib/safeclib.h
+++ b/src/lib/safeclib.h
@@ -25,7 +25,7 @@
 
 /**
  * @file
- * Portable and safe wrapers around some clib functions and some tools
+ * Portable and safe wrappers around some clib functions and some tools
  */
 LUMIERA_ERROR_DECLARE(NO_MEMORY);
 
diff --git a/src/lib/symbol-impl.cpp b/src/lib/symbol-impl.cpp
new file mode 100644
index 000000000..4b5e9bb35
--- /dev/null
+++ b/src/lib/symbol-impl.cpp
@@ -0,0 +1,78 @@
+/*
+  Symbol(impl)  -  helpers for working with literal string IDs 
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+/** @file symbol-impl.hpp
+ ** Collection of helpers for working with the lumiera::Symbol.
+ ** 
+ ** @todo currently as of 9/09 this is more of a placeholder.
+ ** And maybe a location for collecting small bits of implementation,
+ ** which could be usable later for real Symbol and Literal datatypes.
+ ** 
+ ** lumiera::Symbol
+ ** control::CommandRegistry for usage example of the hash function.
+ ** 
+ */
+
+
+
+#include "include/symbol.hpp"
+#include "lib/safeclib.h"
+
+#include <boost/functional/hash.hpp>
+#include <cstddef>
+
+using std::size_t;
+using boost::hash_combine;
+
+
+
+
+namespace lumiera {
+  
+  /** equality on Symbol values is defined
+   *  based on the content, not the address. */
+  inline bool
+  operator== (Symbol sy1, Symbol sy2)
+  {
+    return lumiera_strncmp (sy1,sy2, STRING_MAX_RELEVANT); 
+  }
+  
+  
+  /** generating a hash value, e.g. for hashtables.
+      This function is intended to be picked up by ADL,
+      and should be usable both with  \c std::tr1 and 
+      \c <boost/functional/hash.hpp> . It is implemented
+      similar as the boost::hash specialisation for std::string */
+  size_t hash_value (Symbol sym)
+  {
+    size_t hash=0;
+    const char *pos = sym;
+    size_t maxpos = STRING_MAX_RELEVANT;
+    for ( ; pos && --maxpos; ++pos)
+      hash_combine(hash, *pos);
+    
+    return hash;
+  }
+  
+  
+  
+} // namespace lumiera
diff --git a/src/proc/asset/db.hpp b/src/proc/asset/db.hpp
index 560e43b6f..f8c136f12 100644
--- a/src/proc/asset/db.hpp
+++ b/src/proc/asset/db.hpp
@@ -33,6 +33,7 @@
 
 #include <tr1/memory>
 #include <tr1/unordered_map>
+// #include <boost/functional/hash.hpp>   /////////TODO which boost include to use here??
 #include <boost/utility.hpp>
 
 
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 975c126c9..4f0abfe56 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -77,13 +77,13 @@ namespace control {
     : public lib::Sync<>
     , noncopyable
     {
-      TypedAllocationManager allocator_;
-      
+      // using a hashtable to implement the index
       typedef std::tr1::unordered_map<Symbol, Command> CmdIndex;
       typedef std::map<void*, Symbol> ReverseIndex;
       
       CmdIndex index_;
       ReverseIndex ridx_;
+      TypedAllocationManager allocator_;
       
       
     public:
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index ba45edf44..fe66a53ee 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -198,16 +198,16 @@ namespace control {
   
   inline bool
   operator== (Command const& c1, Command const& c2)
-    {
-      return (!c1 && !c2)
-          || ( c1 &&  c2  && (&c1.impl() == &c2.impl())); 
-    }
+  {
+    return (!c1 && !c2)
+        || ( c1 &&  c2  && (&c1.impl() == &c2.impl())); 
+  }
   
   inline bool
   operator!= (Command const& c1, Command const& c2)
-    {
-      return ! (c1 == c2); 
-    }
+  {
+    return ! (c1 == c2); 
+  }
   
   
   

From 18c357eb4a1cbdca2e4ecb636b760869e493d1a2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 24 Sep 2009 23:02:40 +0200
Subject: [PATCH 306/368] start using Symbol datatype instead of a disguised
 char*

---
 src/backend/thread-wrapper.hpp                |   8 +-
 src/common/appstate.hpp                       |   2 +-
 src/common/configrules.hpp                    |  16 +-
 src/common/external/libgavl.hpp               |   2 +-
 src/common/query/fake-configrules.cpp         |   7 +-
 src/include/lifecycle.h                       |  12 +-
 src/include/symbol.hpp                        |  58 -------
 src/lib/format.hpp                            |   6 +-
 src/lib/lifecycle.cpp                         |   8 +-
 src/lib/lifecycleregistry.hpp                 |   6 +-
 src/lib/query.cpp                             |   2 +-
 src/lib/query.hpp                             |  15 +-
 src/lib/streamtype.hpp                        |   9 +-
 src/lib/symbol-impl.cpp                       |  18 ++-
 src/lib/symbol.hpp                            | 145 ++++++++++++++++++
 src/lib/test/test-helper.cpp                  |   2 +-
 src/lib/test/test-helper.hpp                  |  24 +--
 src/proc/asset/buildinstruct.hpp              |  10 +-
 src/proc/asset/category.hpp                   |   6 +-
 src/proc/asset/procpatt.cpp                   |   2 +-
 src/proc/asset/procpatt.hpp                   |   2 +-
 src/proc/asset/struct.cpp                     |   2 +-
 src/proc/common.hpp                           |   2 +-
 src/proc/control/command-def.hpp              |   6 +-
 src/proc/control/command-invocation.hpp       |  13 +-
 src/proc/control/command-signature.hpp        |   4 +-
 src/proc/control/command.hpp                  |   4 +-
 src/proc/control/handling-pattern.cpp         |  14 +-
 src/proc/control/handling-pattern.hpp         |   4 +-
 src/proc/control/handling-patterns.hpp        |   4 +-
 src/proc/control/mediaimpllib.hpp             |   2 +-
 src/proc/control/proc-dispatcher.hpp          |   4 +-
 src/proc/control/stypemanager.cpp             |   4 +-
 src/proc/control/stypemanager.hpp             |   4 +-
 src/proc/mobject/builder/mould.hpp            |   2 +-
 src/proc/mobject/session.hpp                  |   8 +-
 src/proc/mobject/session/session.cpp          |  10 +-
 .../proc/control/command-registry-test.cpp    |   4 +-
 .../mobject/session/defsmanagerimpltest.cpp   |   2 +-
 .../proc/mobject/test-dummy-mobject.hpp       |   4 +-
 tests/lib/lifecycletest.cpp                   |   2 +-
 tests/lib/query/queryutilstest.cpp            |   2 +-
 tests/lib/singletontestmocktest.cpp           |   6 +-
 tests/lib/subsystem-runner-test.cpp           |   8 +-
 tests/lib/thread-wrapper-join-test.cpp        |   2 +-
 tests/lib/thread-wrapper-test.cpp             |   2 +-
 tests/lib/typed-allocation-manager-test.cpp   |   4 +-
 47 files changed, 302 insertions(+), 181 deletions(-)
 delete mode 100644 src/include/symbol.hpp
 create mode 100644 src/lib/symbol.hpp

diff --git a/src/backend/thread-wrapper.hpp b/src/backend/thread-wrapper.hpp
index 8a76cb5cf..23c553724 100644
--- a/src/backend/thread-wrapper.hpp
+++ b/src/backend/thread-wrapper.hpp
@@ -40,7 +40,7 @@ namespace backend {
   
   using std::tr1::bind;
   using std::tr1::function;
-  using lumiera::Literal;
+  using lib::Literal;
   using lib::Sync;
   using lib::RecursiveLock_Waitable;
   using lib::NonrecursiveLock_Waitable;
@@ -180,7 +180,7 @@ namespace backend {
                              , &run         // invoking the run helper and..
                              , this         // passing this start context as parameter
                              , joinCond     // maybe wait-blocking for the thread to terminate
-                             , purpose.c_str()
+                             , purpose.c()
                              , logging_flag
                              );
           
@@ -205,7 +205,7 @@ namespace backend {
        *         copied onto the stack of the new thread, thus it can be transient.
        * 
        */
-      Thread (Literal& purpose, Operation const& operation, NoBugFlag logging_flag = &NOBUG_FLAG(thread))
+      Thread (Literal purpose, Operation const& operation, NoBugFlag logging_flag = &NOBUG_FLAG(thread))
         : started_(false),
           operation_(operation)
         {
@@ -217,7 +217,7 @@ namespace backend {
        *         to wait-blocking on the termination of this newly created thread 
        * 
        */
-      Thread (Literal& purpose, Operation const& operation, 
+      Thread (Literal purpose, Operation const& operation, 
               JoinHandle& join, NoBugFlag logging_flag = &NOBUG_FLAG(thread))
         : started_(false),
           operation_(operation)
diff --git a/src/common/appstate.hpp b/src/common/appstate.hpp
index ca77f7128..69775aec4 100644
--- a/src/common/appstate.hpp
+++ b/src/common/appstate.hpp
@@ -35,7 +35,7 @@
 #ifndef LUMIERA_APPSTATE_H
 #define LUMIERA_APPSTATE_H
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "common/option.hpp"
 #include "common/subsys.hpp"
 
diff --git a/src/common/configrules.hpp b/src/common/configrules.hpp
index 66c2c95ec..2b23fd68b 100644
--- a/src/common/configrules.hpp
+++ b/src/common/configrules.hpp
@@ -48,6 +48,7 @@
 
 #include "lib/p.hpp"
 #include "lib/query.hpp"
+#include "lib/symbol.hpp"
 #include "lib/meta/generator.hpp"
 #include "lib/singleton-subclass.hpp"
 
@@ -92,8 +93,17 @@ namespace lumiera
       };
     
     
+    using lib::Symbol;
+    using lib::Literal;
+    
+/** placeholder definition for later.
+ *  @todo intention is to integrate with lib::Symbol
+ */
+#define SYMBOL uint
+    
+    
     template
-      < const Symbol SYM,            // Predicate symbol
+      < SYMBOL SYM,                  // Predicate symbol
         typename SIG = bool(string) //  Signature
       >
     class Pred
@@ -119,10 +129,10 @@ namespace lumiera
       {
         static const TY NIL;
         
-        template<Symbol SYM, typename SIG>
+        template<SYMBOL SYM, typename SIG>
         TY find (Pred<SYM,SIG> capability);
         
-        template<Symbol SYM, typename SIG>
+        template<SYMBOL SYM, typename SIG>
         TY make (Pred<SYM,SIG> capability, TY& refObj =NIL);
       };
     
diff --git a/src/common/external/libgavl.hpp b/src/common/external/libgavl.hpp
index d8d7bc412..505fc4325 100644
--- a/src/common/external/libgavl.hpp
+++ b/src/common/external/libgavl.hpp
@@ -33,7 +33,7 @@ namespace lib {
   namespace external {
   
   
-  using lumiera::Symbol;
+  using lib::Symbol;
   
   using lumiera::StreamType;
   typedef StreamType::ImplFacade ImplFacade;
diff --git a/src/common/query/fake-configrules.cpp b/src/common/query/fake-configrules.cpp
index db7d453d1..5b6c9c23f 100644
--- a/src/common/query/fake-configrules.cpp
+++ b/src/common/query/fake-configrules.cpp
@@ -59,11 +59,12 @@ namespace lumiera {
       
       /** helper especially for creating structural assets from a capability query */
       template<class STRU>
-      AnyPair entry_Struct(Symbol caps)
+      AnyPair entry_Struct(Literal caps)
       {
         typedef typename WrapReturn<STRU>::Wrapper Ptr;
         
-        Query<STRU> query(caps); 
+        string capabilities (caps);
+        Query<STRU> query (capabilities); 
         Ptr obj = Struct::create (query);
         return AnyPair(query.asKey(), obj);
       }
@@ -125,7 +126,7 @@ namespace lumiera {
     {
       typedef WrapReturn<Pipe>::Wrapper Ptr;
       
-      Ptr newPipe (Struct::create (Query<Pipe> ("make(PP), "+q)));
+      Ptr newPipe (Struct::create (Query<Pipe> (string("make(PP), ")+q)));
       answer_->insert (entry<Pipe> (q, newPipe));
       return true;
     }
diff --git a/src/include/lifecycle.h b/src/include/lifecycle.h
index 40634bc95..26e649569 100644
--- a/src/include/lifecycle.h
+++ b/src/include/lifecycle.h
@@ -39,18 +39,20 @@
 
 #ifdef __cplusplus
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include <boost/noncopyable.hpp>
 
 
 
 namespace lumiera {
   
-  extern Symbol ON_BASIC_INIT;      ///< automatic static init. treated specially
-  extern Symbol ON_GLOBAL_INIT;     ///< to be triggered in main()             @note no magic!
-  extern Symbol ON_GLOBAL_SHUTDOWN; ///< to be triggered at the end of main()  @note no magic!
+  using lib::Symbol;
   
-  extern Symbol ON_EMERGENCY;       ///< activated on shutdown after premature failure of a subsystem
+  extern const char * ON_BASIC_INIT;      ///< automatic static init. treated specially
+  extern const char * ON_GLOBAL_INIT;     ///< to be triggered in main()             @note no magic!
+  extern const char * ON_GLOBAL_SHUTDOWN; ///< to be triggered at the end of main()  @note no magic!
+  
+  extern const char * ON_EMERGENCY;       ///< activated on shutdown after premature failure of a subsystem
 
   
   // client code is free to register and use additional lifecycle events
diff --git a/src/include/symbol.hpp b/src/include/symbol.hpp
deleted file mode 100644
index 00e19571d..000000000
--- a/src/include/symbol.hpp
+++ /dev/null
@@ -1,58 +0,0 @@
-/*
-  SYMBOL.hpp  -  symbolic constant datatype 
- 
-  Copyright (C)         Lumiera.org
-    2008,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-*/
-
-/** @file symbol.hpp
- ** WIP placeholder definition for a planned Symbol datatype.
- ** 
- ** @todo for the (currently just planned as of 11/08) rules based configuration
- ** in the Proc-Layer a explicit Symbol datatype will probably very helpful.
- ** For now we just a typedef is sufficient. A real Symbol datatype should 
- ** - be definable by string constant
- ** - integrate smoothly with std::string
- ** - provide a unique numeric index for each distinct Symbol
- ** - automatically maintain a symbol table at runtime to support this
- ** - provide some magic (macros) allowing to build distinct types based on symbols.
- ** 
- ** @see symbol-impl.cpp 
- ** @see configrules.hpp
- ** @see query.hpp
- */
-
-
-#ifndef LUMIERA_SYMBOL_H
-#define LUMIERA_SYMBOL_H
-
-
-#include <string>
-
-
-namespace lumiera {
-  
-  typedef const char * const Symbol;  ///< Token or Atom with distinct identity @todo define a real Symbol class, i.e. same literal string==same pointer,
-
-  typedef const std::string Literal; ///< inline string literal @todo improve interaction with Symbol
-
-  
-  
-} // namespace lumiera
-
-#endif
diff --git a/src/lib/format.hpp b/src/lib/format.hpp
index 9b472dd82..084a5c941 100644
--- a/src/lib/format.hpp
+++ b/src/lib/format.hpp
@@ -34,7 +34,7 @@
 
 //#include "lib/util.hpp"
 #include "lib/meta/trait.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 
 #include <string>
 #include <cstring>
@@ -48,7 +48,7 @@ namespace util {
   
   using lumiera::typelist::can_ToString;
   using lumiera::typelist::can_lexical2string;
-  using lumiera::Symbol;
+  using lib::Symbol;
   using boost::enable_if;
   using boost::disable_if;
   using std::string;
@@ -121,7 +121,7 @@ namespace util {
               return string(prefix) + res;
           }
       
-        return fallback? fallback
+        return fallback? string(fallback)
                        : tyStr(val);
       }
   }
diff --git a/src/lib/lifecycle.cpp b/src/lib/lifecycle.cpp
index 553a9fc32..939e3e252 100644
--- a/src/lib/lifecycle.cpp
+++ b/src/lib/lifecycle.cpp
@@ -63,11 +63,11 @@ namespace lumiera {
   
   
   
-  Symbol ON_BASIC_INIT      ("ON_BASIC_INIT");
-  Symbol ON_GLOBAL_INIT     ("ON_GLOBAL_INIT");
-  Symbol ON_GLOBAL_SHUTDOWN ("ON_GLOBAL_SHUTDOWN");
+  const char * ON_BASIC_INIT      ("ON_BASIC_INIT");
+  const char * ON_GLOBAL_INIT     ("ON_GLOBAL_INIT");
+  const char * ON_GLOBAL_SHUTDOWN ("ON_GLOBAL_SHUTDOWN");
   
-  Symbol ON_EMERGENCY       ("ON_EMERGENCY");
+  const char * ON_EMERGENCY       ("ON_EMERGENCY");
   
   
 } // namespace lumiera
diff --git a/src/lib/lifecycleregistry.hpp b/src/lib/lifecycleregistry.hpp
index 3d14e2209..4a426e2e6 100644
--- a/src/lib/lifecycleregistry.hpp
+++ b/src/lib/lifecycleregistry.hpp
@@ -74,14 +74,14 @@ namespace lumiera {
       
       
       /** @note only one copy of each distinct callback remembered */ 
-      bool enrol (const string label, Hook toCall)
+      bool enrol (Symbol label, Hook toCall)
         {
           return table_[label]
                         .insert(toCall)
                         .second;  // true if actually stored 
         }
       
-      void execute (const string label)
+      void execute (Symbol label)
         {
           Callbacks& cbs (table_[label]);
           Iter e = cbs.end();
@@ -102,7 +102,7 @@ namespace lumiera {
       
       
     private:
-      std::map<const string, Callbacks> table_;
+      std::map<Symbol, Callbacks> table_;
       
       LifecycleRegistry ()  {
         execute (ON_BASIC_INIT);   // just to be sure, typically a NOP, because nothing is registered yet 
diff --git a/src/lib/query.cpp b/src/lib/query.cpp
index 59be860a3..931d07ff4 100644
--- a/src/lib/query.cpp
+++ b/src/lib/query.cpp
@@ -81,7 +81,7 @@ namespace lumiera {
       getTermRegex (Symbol sym)
       {
         if (!contains (regexTable, sym))
-          regexTable[sym] = regex (string(sym)+=matchArgument);
+          regexTable[sym] = regex (string(sym)+matchArgument);
         return regexTable[sym];
       }
     }
diff --git a/src/lib/query.hpp b/src/lib/query.hpp
index 911acaabf..52430e0c6 100644
--- a/src/lib/query.hpp
+++ b/src/lib/query.hpp
@@ -30,11 +30,13 @@
 
 #include <boost/format.hpp>
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 
 
 namespace lumiera {
-
+  
+  using lib::Symbol;
+  using lib::Literal;
   using std::string;
   using boost::format;
 
@@ -50,7 +52,7 @@ namespace lumiera {
   class Query : public std::string
     {
     public:
-      explicit Query (const string& predicate="") : string(predicate) {}
+      explicit Query (string const& predicate="") : string(predicate) {}
       explicit Query (format& pattern)            : string(str(pattern)) {}
       
       const string asKey()  const
@@ -62,8 +64,7 @@ namespace lumiera {
     };                                          //        for calling removeTerm on the string-ref....
 
     
-  namespace query
-    {
+  namespace query {
     
     /** ensure standard format for a given id string.
      *  Trim, sanitise and ensure the first letter is lower case.
@@ -84,7 +85,5 @@ namespace lumiera {
     const string removeTerm (Symbol, string& termString);
 
     
-  } // namespace query
-    
-} // namespace lumiera
+}} // namespace lumiera::query
 #endif
diff --git a/src/lib/streamtype.hpp b/src/lib/streamtype.hpp
index bde5e8e94..6dc5747fc 100644
--- a/src/lib/streamtype.hpp
+++ b/src/lib/streamtype.hpp
@@ -35,14 +35,17 @@
 #define LUMIERA_STREAMTYPE_HPP
 
 
+#include "lib/symbol.hpp"
 #include "lib/query.hpp"
 
 #include <boost/noncopyable.hpp>
 
 
 namespace lumiera {
-
-
+  
+  using lib::Symbol;
+  
+  
   /**
    * 
    */
@@ -160,7 +163,7 @@ namespace lumiera {
      * opaque placeholder (type erasure) 
      * for implementation specific type info.
      * Intended to be passed to a concrete
-     * MediaImplLib to build an ImplFacade. 
+     * MediaImplLib to build an ImplFacade.
      */
   class StreamType::ImplFacade::TypeTag
     {
diff --git a/src/lib/symbol-impl.cpp b/src/lib/symbol-impl.cpp
index 4b5e9bb35..f852b1ffb 100644
--- a/src/lib/symbol-impl.cpp
+++ b/src/lib/symbol-impl.cpp
@@ -21,21 +21,23 @@
 * *****************************************************/
 
 /** @file symbol-impl.hpp
- ** Collection of helpers for working with the lumiera::Symbol.
+ ** Collection of helpers for working with the lib::Symbol.
  ** 
  ** @todo currently as of 9/09 this is more of a placeholder.
  ** And maybe a location for collecting small bits of implementation,
  ** which could be usable later for real Symbol and Literal datatypes.
  ** 
- ** lumiera::Symbol
+ ** lib::Symbol
  ** control::CommandRegistry for usage example of the hash function.
  ** 
  */
 
 
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
+extern "C" {
 #include "lib/safeclib.h"
+}
 
 #include <boost/functional/hash.hpp>
 #include <cstddef>
@@ -46,12 +48,12 @@ using boost::hash_combine;
 
 
 
-namespace lumiera {
+namespace lib {
   
   /** equality on Symbol values is defined
    *  based on the content, not the address. */
-  inline bool
-  operator== (Symbol sy1, Symbol sy2)
+  bool
+  operator== (Literal sy1, Literal sy2)
   {
     return lumiera_strncmp (sy1,sy2, STRING_MAX_RELEVANT); 
   }
@@ -62,7 +64,7 @@ namespace lumiera {
       and should be usable both with  \c std::tr1 and 
       \c <boost/functional/hash.hpp> . It is implemented
       similar as the boost::hash specialisation for std::string */
-  size_t hash_value (Symbol sym)
+  size_t hash_value (Literal sym)
   {
     size_t hash=0;
     const char *pos = sym;
@@ -75,4 +77,4 @@ namespace lumiera {
   
   
   
-} // namespace lumiera
+} // namespace lib
diff --git a/src/lib/symbol.hpp b/src/lib/symbol.hpp
new file mode 100644
index 000000000..562a6bf09
--- /dev/null
+++ b/src/lib/symbol.hpp
@@ -0,0 +1,145 @@
+/*
+  SYMBOL.hpp  -  symbolic constant datatype 
+ 
+  Copyright (C)         Lumiera.org
+    2008,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file symbol.hpp
+ ** WIP placeholder definition for a planned Symbol datatype.
+ ** 
+ ** @todo for the (currently just planned as of 11/08) rules based configuration
+ ** in the Proc-Layer a explicit Symbol datatype will probably very helpful.
+ ** For now we just a typedef is sufficient. A real Symbol datatype should 
+ ** - be definable by string constant
+ ** - integrate smoothly with std::string
+ ** - provide a unique numeric index for each distinct Symbol
+ ** - automatically maintain a symbol table at runtime to support this
+ ** - provide some magic (macros) allowing to build distinct types based on symbols.
+ ** 
+ ** @see symbol-impl.cpp 
+ ** @see configrules.hpp
+ ** @see query.hpp
+ */
+
+
+#ifndef LIB_SYMBOL_H
+#define LIB_SYMBOL_H
+
+
+#include <string>
+#include <cstring>
+
+
+namespace lib {
+  
+  /** inline string literal
+   *  @todo improve interaction with Symbol
+   *  @todo make it non-nullable 
+   */
+  class Literal
+    {
+       const char * str_;
+       
+    public:
+       Literal (const char* literal)
+         : str_(literal)
+         { }
+       
+       Literal (Literal const& o)
+         : str_(o.str_)
+         { }
+       
+       operator const char* ()  const { return str_; }
+       const char* c()          const { return str_; }
+       
+       bool
+       empty()  const
+         {
+           return !str_ || 0 == std::strlen(str_);
+         }
+       
+    protected:
+       /** Assignment prohibited */
+       Literal& operator= (const char* newStr)
+         {
+           str_ = newStr;
+           return *this;
+         }
+    };
+  
+  
+  /** Token or Atom with distinct identity
+   * @todo define a real Symbol class, i.e. same literal string==same pointer,
+   */
+  class Symbol
+    : public Literal
+    {
+    public:
+       Symbol (const char* lit =0)
+         : Literal(lit)
+         { }
+      
+       Symbol (Symbol const& o)
+         : Literal(o)
+         { }
+       
+       Symbol&
+       operator= (Literal const& otherSym)
+         {
+           Literal::operator= (otherSym);
+           return *this;
+         }
+    };
+  
+  
+  /** safety guard: maximum number of chars to process.
+   *  For comparisons, hash calculations etc., when dealing
+   *  with raw char ptrs (typically literal values) */
+  const size_t STRING_MAX_RELEVANT = 1000;
+  
+  
+  /* ===== to be picked up by ADL ===== */
+  
+  size_t hash_value (Literal);
+  
+  bool operator== (Literal sy1, Literal sy2);
+  
+  inline bool
+  operator!= (Literal sy1, Literal sy2)
+  {
+    return ! (sy1 == sy2); 
+  }
+  
+  inline std::string
+  operator+ (std::string str, Literal const& sym)
+  {
+    const char* symP (sym);
+    return str + symP;
+  }
+  
+  inline std::string
+  operator+ (Literal const& sym, std::string str)
+  {
+    const char* symP (sym);
+    return symP + str;
+  }
+
+} // namespace lib
+
+#endif
diff --git a/src/lib/test/test-helper.cpp b/src/lib/test/test-helper.cpp
index fbe7f1d4a..401690788 100644
--- a/src/lib/test/test-helper.cpp
+++ b/src/lib/test/test-helper.cpp
@@ -34,7 +34,7 @@ namespace test{
   
   
   string
-  showSizeof (size_t siz, Symbol name)
+  showSizeof (size_t siz, const char* name)
   {
     static format fmt ("sizeof( %s ) %|30t|= %3d");
     return str (fmt % (name? name:"?") % siz);
diff --git a/src/lib/test/test-helper.hpp b/src/lib/test/test-helper.hpp
index ef004ec88..26d3b5616 100644
--- a/src/lib/test/test-helper.hpp
+++ b/src/lib/test/test-helper.hpp
@@ -25,7 +25,7 @@
 #define LIB_TEST_TESTHELPER_H
 
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "lib/lumitime.hpp"
 
 #include <typeinfo>
@@ -37,7 +37,7 @@
 namespace lib {
 namespace test{
   
-  using lumiera::Symbol;
+  using lib::Literal;
   using lumiera::Time;
   using std::string;
   using std::rand;
@@ -52,10 +52,10 @@ namespace test{
    *          type identification as implemented by the compiler.
    */
   template<typename T>
-  inline const char*
-  showType (T const& obj, Symbol name=0)
+  inline Literal
+  showType (T const& obj, Literal name=0)
   {
-    return name? name : typeid(obj).name();
+    return name? name : Literal(typeid(obj).name());
   }
   
   /** get a sensible display for a type 
@@ -65,36 +65,36 @@ namespace test{
    *          type identification as implemented by the compiler.
    */
   template<typename T>
-  inline const char*
-  showType (Symbol name=0)
+  inline Literal
+  showType (Literal name=0)
   {
-    return name? name : typeid(T).name();
+    return name? name : Literal(typeid(T).name());
   }
   
   
   /** for printing sizeof().
    *  prints the given size and name literally, without any further magic */
   string
-  showSizeof (size_t siz, Symbol name);
+  showSizeof (size_t siz, const char* name);
   
   /** for printing sizeof(), trying to figure out the type name automatically */
   template<typename T>
   inline string
-  showSizeof(Symbol name=0)
+  showSizeof(const char* name=0)
   {
     return showSizeof (sizeof (T), showType<T> (name));
   }
   
   template<typename T>
   inline string
-  showSizeof(T const& obj, Symbol name=0)
+  showSizeof(T const& obj, const char* name=0)
   {
     return showSizeof (sizeof (obj), showType (obj,name));
   }
   
   template<typename T>
   inline string
-  showSizeof(T *obj, Symbol name=0)
+  showSizeof(T *obj, const char* name=0)
   {
     return obj? showSizeof (*obj, name)
               : showSizeof<T> (name);
diff --git a/src/proc/asset/buildinstruct.hpp b/src/proc/asset/buildinstruct.hpp
index dee85d58d..1b1129762 100644
--- a/src/proc/asset/buildinstruct.hpp
+++ b/src/proc/asset/buildinstruct.hpp
@@ -32,6 +32,8 @@
 #define ASSET_BUILDINSTRUCT_H
 
 
+#include "lib/symbol.hpp"
+
 #include <boost/variant.hpp>
 #include <string>
 
@@ -39,9 +41,11 @@ using std::string;
 
 
 
-namespace asset
-  {
+namespace asset {
+
   using lumiera::P;
+  using lib::Symbol;
+  using lib::Literal;
   
   class Proc;
   class ProcPatt;
@@ -57,7 +61,7 @@ namespace asset
       vector<PProc> nodes;
 
       /** identifying the point where the nodes should be attached */
-      string point;
+      Literal point;
       
       DoAttach (Symbol where = CURRENT) 
         : point(where) 
diff --git a/src/proc/asset/category.hpp b/src/proc/asset/category.hpp
index c644f2acc..aee5a8a9e 100644
--- a/src/proc/asset/category.hpp
+++ b/src/proc/asset/category.hpp
@@ -24,6 +24,8 @@
 #ifndef ASSET_CATEGORY_H
 #define ASSET_CATEGORY_H
 
+#include "lib/symbol.hpp"
+
 #include <string>
 #include <iostream>
 #include <boost/functional/hash.hpp>
@@ -31,6 +33,8 @@
 
 
 namespace asset {
+
+  using lib::Literal;
   
   using std::string;
   using std::ostream;
@@ -70,7 +74,7 @@ namespace asset {
       string path_;
       
     public:
-      Category (const Kind root, string subfolder ="")
+      Category (const Kind root, Literal subfolder ="")
         : kind_(root), path_(subfolder) {};
       
       bool operator== (Category const& other) const { return kind_== other.kind_ && path_== other.path_; }
diff --git a/src/proc/asset/procpatt.cpp b/src/proc/asset/procpatt.cpp
index 95e985134..4663a3ec7 100644
--- a/src/proc/asset/procpatt.cpp
+++ b/src/proc/asset/procpatt.cpp
@@ -64,7 +64,7 @@ namespace asset
   ProcPatt::newCopy (string newID)  const
   {
     TODO ("implement the Pattern-ID within the propDescriptor!");
-    TODO ("implement a consitent struct asset naming scheme at one central location!!!!!");
+    TODO ("implement a consistent struct asset naming scheme at one central location!!!!!");
     const Asset::Ident newIdi ( this->ident.name+".X"
                               , this->ident.category
                               );
diff --git a/src/proc/asset/procpatt.hpp b/src/proc/asset/procpatt.hpp
index 4eee80fb2..227679afb 100644
--- a/src/proc/asset/procpatt.hpp
+++ b/src/proc/asset/procpatt.hpp
@@ -36,7 +36,7 @@ using std::vector;
 namespace asset
   {
   using lumiera::P;
-  using lumiera::Symbol;
+  using lib::Symbol;
 
   class Proc;
   class ProcPatt;
diff --git a/src/proc/asset/struct.cpp b/src/proc/asset/struct.cpp
index 9774f1786..79c5d26a4 100644
--- a/src/proc/asset/struct.cpp
+++ b/src/proc/asset/struct.cpp
@@ -37,7 +37,7 @@
 
 using boost::format;
 
-using lumiera::Symbol;
+using lib::Symbol;
 using lumiera::query::normaliseID;
 using lumiera::query::QueryHandler;
 using lumiera::ConfigRules;
diff --git a/src/proc/common.hpp b/src/proc/common.hpp
index 7c0680b91..c7da68e24 100644
--- a/src/proc/common.hpp
+++ b/src/proc/common.hpp
@@ -45,7 +45,7 @@
 #include "lib/p.hpp"
 #include "lib/util.hpp"
 #include "lib/lumitime.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "lib/error.hpp"   ///< pulls in NoBug via loggging.h
 
 
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 16b494102..2decf0c4c 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -50,7 +50,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "include/logging.h"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/command-impl.hpp"                   /////TODO: any chance to get rid of this import here??
 #include "proc/control/command-registry.hpp"
@@ -75,7 +75,7 @@ namespace control {
   
   using std::tr1::shared_ptr;
   using std::tr1::function;
-  using lumiera::Symbol;
+  using lib::Symbol;
   using util::cStr;
   
   using lumiera::typelist::FunctionSignature;
@@ -240,7 +240,7 @@ namespace control {
         : id_(cmdID)
         , prototype_(Command::fetchDef(cmdID))
         {
-          TRACE (command_dbg, "starting CommandDef('%s')...", cmdID);
+          TRACE (command_dbg, "starting CommandDef('%s')...", cmdID.c() );
         }
       
       template<typename SIG>
diff --git a/src/proc/control/command-invocation.hpp b/src/proc/control/command-invocation.hpp
index f8ab945cb..bc1ff54b9 100644
--- a/src/proc/control/command-invocation.hpp
+++ b/src/proc/control/command-invocation.hpp
@@ -40,7 +40,7 @@
 #define CONTROL_COMMAND_INVOCACTION_H
 
 //#include "pre.hpp"
-//#include "include/symbol.hpp"
+//#include "lib/symbol.hpp"
 //#include "lib/meta/typelist.hpp"
 //#include "lib/meta/tuple.hpp"
 #include "proc/control/command.hpp"
@@ -55,7 +55,7 @@
 
 namespace control {
   
-//  using lumiera::Symbol;
+//  using lib::Symbol;
 //  using std::tr1::shared_ptr;
   using namespace lumiera::typelist;
   
@@ -158,5 +158,14 @@ namespace control {
     return com::RuntimeCheckedCommandInvoker (command);
   }
   
+  
+  inline
+  com::RuntimeCheckedCommandInvoker
+  invoke (const char* cmdID)
+  {
+    return invoke(Symbol(cmdID));
+  }
+  
+  
 } // namespace control
 #endif
diff --git a/src/proc/control/command-signature.hpp b/src/proc/control/command-signature.hpp
index 5c403cace..150e3db0b 100644
--- a/src/proc/control/command-signature.hpp
+++ b/src/proc/control/command-signature.hpp
@@ -47,7 +47,7 @@
 #define CONTROL_COMMAND_SIGNATURE_H
 
 //#include "pre.hpp"
-//#include "include/symbol.hpp"
+//#include "lib/symbol.hpp"
 #include "lib/meta/function.hpp"
 #include "lib/meta/typelist.hpp"
 #include "lib/meta/typelist-util.hpp"
@@ -62,7 +62,7 @@
 
 namespace control {
   
-//  using lumiera::Symbol;
+//  using lib::Symbol;
 //  using std::tr1::shared_ptr;
   using std::tr1::function;
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index fe66a53ee..130cea17b 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -54,7 +54,7 @@
 
 #include "pre.hpp"
 #include "lib/error.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "proc/control/command-binding.hpp"
 #include "proc/control/argument-erasure.hpp"
 #include "proc/control/handling-pattern.hpp"
@@ -71,7 +71,7 @@
 namespace control {
   
   using std::string;
-  using lumiera::Symbol;
+  using lib::Symbol;
   using std::tr1::shared_ptr;
   using lumiera::typelist::Tuple;
   
diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index d48f39d30..7df3c41d5 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -25,7 +25,7 @@
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/handling-patterns.hpp"
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "include/logging.h"
 #include "lib/util.hpp"
 //#include "proc/mobject/mobject-ref.hpp"
@@ -59,7 +59,7 @@ namespace control {
   ExecResult
   HandlingPattern::invoke (CommandImpl& command, Symbol name)  const
   {
-    TRACE (proc_dbg, "invoking %s...", name);
+    TRACE (proc_dbg, "invoking %s...", name.c());
     static format err_pre ("Error state detected, %s *NOT* invoked.");
     static format err_post ("Error state after %s invocation.");
     static format err_fatal ("Execution of %s raised unknown error.");
@@ -83,21 +83,21 @@ namespace control {
     catch (lumiera::Error& problem)
       {
         Symbol errID = lumiera_error();
-        WARN (command, "Invocation of %s failed: %s", name, problem.what());
-        TRACE (proc_dbg, "Error flag was: %s", errID);
+        WARN (command, "Invocation of %s failed: %s", name.c(), problem.what());
+        TRACE (proc_dbg, "Error flag was: %s", errID.c());
         return ExecResult (problem);
       }
     catch (std::exception& library_problem)
       {
         Symbol errID = lumiera_error();
-        WARN (command, "Invocation of %s failed: %s", name, library_problem.what());
-        TRACE (proc_dbg, "Error flag was: %s", errID);
+        WARN (command, "Invocation of %s failed: %s", name.c(), library_problem.what());
+        TRACE (proc_dbg, "Error flag was: %s", errID.c());
         return ExecResult (error::External (library_problem));
       }
     catch (...)
       {
         Symbol errID = lumiera_error();
-        ERROR (command, "Invocation of %s failed with unknown exception; error flag is: %s", name, errID);
+        ERROR (command, "Invocation of %s failed with unknown exception; error flag is: %s", name.c(), errID.c());
         throw error::Fatal (str (err_fatal % command), errID);
       }
   }
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index c52b26075..5422bfb31 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -47,7 +47,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 
 //#include <tr1/memory>
 #include <string>
@@ -57,7 +57,7 @@
 namespace control {
   
   using std::string;
-  using lumiera::Symbol;
+  using lib::Symbol;
 //  using std::tr1::shared_ptr;
   
   
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index b3e56f36c..f4d62cc7b 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -49,7 +49,7 @@
 #include "proc/control/command-impl.hpp"
 #include "proc/mobject/session.hpp"
 #include "include/lifecycle.h"
-//#include "include/symbol.hpp"
+//#include "lib/symbol.hpp"
 
 //#include <tr1/memory>
 //#include <string>
@@ -63,7 +63,7 @@ namespace control {
   
     using std::vector;
 //  using std::string;
-//  using lumiera::Symbol;
+//  using lib::Symbol;
 //  using std::tr1::shared_ptr;
     
     
diff --git a/src/proc/control/mediaimpllib.hpp b/src/proc/control/mediaimpllib.hpp
index 958d65a12..6150c3f4e 100644
--- a/src/proc/control/mediaimpllib.hpp
+++ b/src/proc/control/mediaimpllib.hpp
@@ -31,7 +31,7 @@
 
 namespace control {
   
-  using lumiera::Symbol;
+  using lib::Symbol;
   
   
   class MediaImplLib
diff --git a/src/proc/control/proc-dispatcher.hpp b/src/proc/control/proc-dispatcher.hpp
index b0783a940..61352bc47 100644
--- a/src/proc/control/proc-dispatcher.hpp
+++ b/src/proc/control/proc-dispatcher.hpp
@@ -36,7 +36,7 @@
 #define CONTROL_PROC_DISPATCHER_H
 
 //#include "pre.hpp"
-//#include "include/symbol.hpp"
+//#include "lib/symbol.hpp"
 #include "proc/control/command.hpp"
 
 //#include <tr1/memory>
@@ -45,7 +45,7 @@
 
 namespace control {
   
-//  using lumiera::Symbol;
+//  using lib::Symbol;
 //  using std::tr1::shared_ptr;
   
   
diff --git a/src/proc/control/stypemanager.cpp b/src/proc/control/stypemanager.cpp
index d2f798a8b..30e34f644 100644
--- a/src/proc/control/stypemanager.cpp
+++ b/src/proc/control/stypemanager.cpp
@@ -30,7 +30,7 @@
 namespace control {
   
   using lumiera::StreamType;
-  using lumiera::Symbol;
+  using lib::Symbol;
   
   /* ======= stream type manager lifecycle ==========*/
   
@@ -63,7 +63,7 @@ namespace control {
    *        their basic setup functions using this hook, which can be done via
    *        the C interface functions 
    */
-  Symbol ON_STREAMTYPES_RESET ("ON_STREAMTYPES_RESET");
+  const char* ON_STREAMTYPES_RESET ("ON_STREAMTYPES_RESET");
   
   
   
diff --git a/src/proc/control/stypemanager.hpp b/src/proc/control/stypemanager.hpp
index 31ec08675..b35334124 100644
--- a/src/proc/control/stypemanager.hpp
+++ b/src/proc/control/stypemanager.hpp
@@ -33,7 +33,7 @@
 
 namespace control {
   
-  using lumiera::Symbol;
+  using lib::Symbol;
   using lumiera::StreamType;
   
   
@@ -90,7 +90,7 @@ namespace control {
       ImplFacade const& fetchImpl (StreamType::ImplFacade::TypeTag);
     };
   
-  extern Symbol ON_STREAMTYPES_RESET;  ///< triggered to load the generic pristine default
+  extern const char* ON_STREAMTYPES_RESET;  ///< triggered to load the generic pristine default
   
   
   template<class TY>
diff --git a/src/proc/mobject/builder/mould.hpp b/src/proc/mobject/builder/mould.hpp
index 425e76b30..9a0108104 100644
--- a/src/proc/mobject/builder/mould.hpp
+++ b/src/proc/mobject/builder/mould.hpp
@@ -35,7 +35,7 @@ namespace mobject {
   
     using std::vector;
     using asset::PProcPatt;
-    using lumiera::Symbol;
+    using lib::Symbol;
 
 
     /**
diff --git a/src/proc/mobject/session.hpp b/src/proc/mobject/session.hpp
index 7ce03ed62..0542e1da2 100644
--- a/src/proc/mobject/session.hpp
+++ b/src/proc/mobject/session.hpp
@@ -36,7 +36,7 @@
 #include "proc/mobject/placement.hpp"
 #include "proc/mobject/session/defsmanager.hpp"
 #include "lib/singleton.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 
 #include <boost/noncopyable.hpp>
 #include <tr1/memory>
@@ -99,9 +99,9 @@ namespace mobject {
     };
   
   
-  extern lumiera::Symbol ON_SESSION_START;  ///< triggered before loading any content into a newly created session
-  extern lumiera::Symbol ON_SESSION_INIT;   ///< triggered when initialising a new session, after adding content
-  extern lumiera::Symbol ON_SESSION_END;    ///< triggered before discarding an existing session
+  extern const char* ON_SESSION_START;  ///< triggered before loading any content into a newly created session
+  extern const char* ON_SESSION_INIT;   ///< triggered when initialising a new session, after adding content
+  extern const char* ON_SESSION_END;    ///< triggered before discarding an existing session
   
   
   namespace session {
diff --git a/src/proc/mobject/session/session.cpp b/src/proc/mobject/session/session.cpp
index 1a75c5e9b..f466259b3 100644
--- a/src/proc/mobject/session/session.cpp
+++ b/src/proc/mobject/session/session.cpp
@@ -35,11 +35,11 @@
 #include "proc/mobject/session/defsmanager.hpp"
 #include "proc/mobject/session/session-impl.hpp"
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "lib/singleton.hpp"
 
 
-using lumiera::Symbol;
+using lib::Symbol;
 using lumiera::Singleton;
 using mobject::session::SessManager;
 using mobject::session::SessManagerImpl;
@@ -69,7 +69,7 @@ namespace mobject {
    *        session should register their basic setup functions using this hook, which can be
    *        done via the C interface functions defined in lifecycle.h
    */
-  Symbol ON_SESSION_START ("ON_SESSION_START");
+  const char* ON_SESSION_START ("ON_SESSION_START");
   
   /** \par
    *  LifecycleHook, to perform any initialisation, wiring and registrations necessary
@@ -77,7 +77,7 @@ namespace mobject {
    *  and configuration has already be loaded. Any subsystems requiring to build some indices
    *  or wiring to keep track of the session's content should register here.
    */
-  Symbol ON_SESSION_INIT ("ON_SESSION_INIT");
+  const char* ON_SESSION_INIT ("ON_SESSION_INIT");
   
   /** \par
    *  LifecycleHook, to perform any state saving, deregistration or de-activation necessary 
@@ -87,7 +87,7 @@ namespace mobject {
    *        specific/internal information into the persisted state, besides actually attaching
    *        data to objects within the session?
    */
-  Symbol ON_SESSION_END ("ON_SESSION_END");
+  const char* ON_SESSION_END ("ON_SESSION_END");
   
   
   
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index a4d473db8..d03ef200f 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -36,7 +36,7 @@
 #include "proc/control/command-registry.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "lib/util.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
@@ -68,7 +68,7 @@ namespace test    {
 //  using util::contains;
 
 //  using session::test::TestClip;
-  using lumiera::Symbol;
+  using lib::Symbol;
 //  using lumiera::P;
   
   
diff --git a/tests/components/proc/mobject/session/defsmanagerimpltest.cpp b/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
index 89cbc4368..c3a260876 100644
--- a/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
+++ b/tests/components/proc/mobject/session/defsmanagerimpltest.cpp
@@ -43,7 +43,7 @@ namespace asset {
   namespace test {
     
     using mobject::Session;
-    using lumiera::Symbol;
+    using lib::Symbol;
     using lumiera::Query;
     using lumiera::query::normaliseID;
     
diff --git a/tests/components/proc/mobject/test-dummy-mobject.hpp b/tests/components/proc/mobject/test-dummy-mobject.hpp
index 28988c473..d301fbd81 100644
--- a/tests/components/proc/mobject/test-dummy-mobject.hpp
+++ b/tests/components/proc/mobject/test-dummy-mobject.hpp
@@ -43,7 +43,7 @@
 #include "proc/mobject/builder/buildertool.hpp"
 #include "proc/mobject/session/abstractmo.hpp"
 #include "proc/mobject/placement.hpp"
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
@@ -61,7 +61,7 @@ using std::cout;
 namespace mobject {
 namespace test    {
   
-  using lumiera::Symbol;
+  using lib::Symbol;
   using builder::BuilderTool;
   
   
diff --git a/tests/lib/lifecycletest.cpp b/tests/lib/lifecycletest.cpp
index 8b98373e5..00b43fd36 100644
--- a/tests/lib/lifecycletest.cpp
+++ b/tests/lib/lifecycletest.cpp
@@ -39,7 +39,7 @@ namespace test   {
   void basicInitHook () { ++basicInit; }
   void myCallback() { ++customCallback; }
   
-  Symbol MY_DEADLY_EVENT = "dial M for murder";
+  const char* MY_DEADLY_EVENT = "dial M for murder";
   
   
   namespace // register them to be invoked by lifecycle event id
diff --git a/tests/lib/query/queryutilstest.cpp b/tests/lib/query/queryutilstest.cpp
index 6f642ea49..61b464118 100644
--- a/tests/lib/query/queryutilstest.cpp
+++ b/tests/lib/query/queryutilstest.cpp
@@ -139,7 +139,7 @@ namespace lumiera {
             }
           
           void
-          ASSERT_removeTerm (Symbol sym, string input, Symbol extracted, Symbol modified)
+          ASSERT_removeTerm (Symbol sym, string input, string extracted, string modified)
             {
               ASSERT (extracted == removeTerm (sym, input));
               ASSERT (modified  == input);
diff --git a/tests/lib/singletontestmocktest.cpp b/tests/lib/singletontestmocktest.cpp
index 131603c49..797916f6a 100644
--- a/tests/lib/singletontestmocktest.cpp
+++ b/tests/lib/singletontestmocktest.cpp
@@ -57,11 +57,11 @@ namespace lumiera
         TestSingletonO(Symbol ty="TestSingletonO")
             : callCnt (0), typid(ty), msg ("%s::doIt() call=%d\n")
         {
-          TRACE (test, "ctor %s", typid);
+          TRACE (test, "ctor %s", typid.c());
         }
         virtual ~TestSingletonO()
         {
-          TRACE (test, "dtor %s", typid);
+          TRACE (test, "dtor %s", typid.c());
         }
 
         void doIt ()
@@ -158,7 +158,7 @@ namespace lumiera
           sing->doIt();
           ASSERT (sing->getCnt() == 1);
 
-          instance.injectSubclass (0); // unshaddowing original instance
+          instance.injectSubclass (0); // un-shadowing original instance
           sing = &instance();
           ASSERT (sing->getCnt() == 2);
           sing->doIt();
diff --git a/tests/lib/subsystem-runner-test.cpp b/tests/lib/subsystem-runner-test.cpp
index 8585ee563..e86e0af05 100644
--- a/tests/lib/subsystem-runner-test.cpp
+++ b/tests/lib/subsystem-runner-test.cpp
@@ -27,7 +27,7 @@
 #include "common/subsystem-runner.hpp"
 #include "common/option.hpp"
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "backend/thread-wrapper.hpp"
 #include "lib/error.hpp"
 #include "lib/query.hpp"
@@ -89,7 +89,7 @@ namespace test  {
           public Sync<RecursiveLock_Waitable>
         {
           Literal id_;
-          Literal spec_;
+          const string spec_;
           
           volatile bool isUp_;
           volatile bool didRun_;
@@ -101,7 +101,7 @@ namespace test  {
           bool
           shouldStart (lumiera::Option&)
             {
-              Literal startSpec (extractID ("start",spec_));
+              string startSpec (extractID ("start",spec_));
               return "true" ==startSpec 
                   || "fail" ==startSpec
                   || "throw"==startSpec;
@@ -160,7 +160,7 @@ namespace test  {
           void
           run (Subsys::SigTerm termination)
             {
-              Literal runSpec (extractID ("run",spec_));
+              string runSpec (extractID ("run",spec_));
               ASSERT (!isnil (runSpec));
               
               { // run-status handshake
diff --git a/tests/lib/thread-wrapper-join-test.cpp b/tests/lib/thread-wrapper-join-test.cpp
index e7e80cd08..93257e794 100644
--- a/tests/lib/thread-wrapper-join-test.cpp
+++ b/tests/lib/thread-wrapper-join-test.cpp
@@ -23,7 +23,7 @@
 
 #include "lib/test/run.hpp"
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "backend/thread-wrapper.hpp"
 #include "lib/error.hpp"
 #include "lib/sync.hpp"
diff --git a/tests/lib/thread-wrapper-test.cpp b/tests/lib/thread-wrapper-test.cpp
index 9c66b4145..edd9660f1 100644
--- a/tests/lib/thread-wrapper-test.cpp
+++ b/tests/lib/thread-wrapper-test.cpp
@@ -23,7 +23,7 @@
 
 #include "lib/test/run.hpp"
 
-#include "include/symbol.hpp"
+#include "lib/symbol.hpp"
 #include "backend/thread-wrapper.hpp"
 #include "lib/sync.hpp"
 
diff --git a/tests/lib/typed-allocation-manager-test.cpp b/tests/lib/typed-allocation-manager-test.cpp
index 09c5254e8..c8cf35de1 100644
--- a/tests/lib/typed-allocation-manager-test.cpp
+++ b/tests/lib/typed-allocation-manager-test.cpp
@@ -27,7 +27,7 @@
 #include "proc/control/typed-allocation-manager.hpp"
 //#include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
-//#include "include/symbol.hpp"
+//#include "lib/symbol.hpp"
 #include "lib/util.hpp"
 
 
@@ -58,7 +58,7 @@ namespace test    {
 //  using util::contains;
 
 //  using session::test::TestClip;
-//  using lumiera::Symbol;
+//  using lib::Symbol;
 //  using lumiera::P;
   
   

From 109cc4701cd5cb794a10427e8c583827b2cb5880 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 25 Sep 2009 01:10:20 +0200
Subject: [PATCH 307/368] unit test to verify building a hashtable with Symbol
 keys

---
 src/lib/symbol-impl.cpp             |   2 +-
 tests/40components.tests            |  14 +++
 tests/lib/Makefile.am               |   2 +
 tests/lib/symbol-hashtable-test.cpp | 104 ++++++++++++++++++++++
 tests/lib/symbol-test.cpp           | 129 ++++++++++++++++++++++++++++
 5 files changed, 250 insertions(+), 1 deletion(-)
 create mode 100644 tests/lib/symbol-hashtable-test.cpp
 create mode 100644 tests/lib/symbol-test.cpp

diff --git a/src/lib/symbol-impl.cpp b/src/lib/symbol-impl.cpp
index f852b1ffb..1345ab795 100644
--- a/src/lib/symbol-impl.cpp
+++ b/src/lib/symbol-impl.cpp
@@ -55,7 +55,7 @@ namespace lib {
   bool
   operator== (Literal sy1, Literal sy2)
   {
-    return lumiera_strncmp (sy1,sy2, STRING_MAX_RELEVANT); 
+    return !lumiera_strncmp (sy1,sy2, STRING_MAX_RELEVANT); 
   }
   
   
diff --git a/tests/40components.tests b/tests/40components.tests
index 6d8ca8fb6..dce3d49ec 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -456,6 +456,20 @@ return: 0
 END
 
 
+TEST "Symbol_test" Symbol_test  <<END
+out: one
+out: sizeof.+lib.Literal.+  =   (4|8)
+out: Ss
+out: one\.\.\.\.one
+return: 0
+END
+
+
+TEST "Hashtable with Symbol keys" SymbolHashtable_test  <<END
+return: 0
+END
+
+
 TEST "Test support functions" TestHelper_test <<END
 out: Displaying types and sizes....
 out: sizeof..theUniverse.+ =  42
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 024d593cd..4a0e00bf5 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -76,6 +76,8 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/sync-classlock-test.cpp		\
 	$(testlib_srcdir)/sync-locking-test.cpp			\
 	$(testlib_srcdir)/sync-waiting-test.cpp			\
+	$(testlib_srcdir)/symbol-test.cpp			\
+	$(testlib_srcdir)/symbol-hashtable-test.cpp		\
 	$(testlib_srcdir)/time-wrapper-test.cpp			\
 	$(testlib_srcdir)/thread-wrapper-test.cpp		\
 	$(testlib_srcdir)/thread-wrapper-join-test.cpp		\
diff --git a/tests/lib/symbol-hashtable-test.cpp b/tests/lib/symbol-hashtable-test.cpp
new file mode 100644
index 000000000..92fd43a34
--- /dev/null
+++ b/tests/lib/symbol-hashtable-test.cpp
@@ -0,0 +1,104 @@
+/*
+  SymbolHashtable(Test)  -  building a hashtable with Symbol (id) keys
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+
+#include "lib/symbol.hpp"
+
+#include <boost/functional/hash.hpp>
+#include <tr1/unordered_map>
+#include <string>
+
+using util::isnil;
+using util::contains;
+
+
+
+namespace lib {
+namespace test{
+  
+  using std::string;
+  using boost::hash;
+  
+  
+  namespace { // test data
+    Symbol KEY1 ("Key1");
+    Symbol KEY2 ("Key2");
+    Symbol KEY3 ("Key3");
+    Symbol KEY4 ("Key4");
+    Symbol KEY5 ("Key5");
+    
+  }
+  
+  typedef std::tr1::unordered_map< Symbol, string, hash<Symbol> > HTable;
+  
+  
+  /*************************************************************
+   * @test build a hashtable using Symbol objects as Keys.
+   *       Especially this verifies picking up a customised
+   *       hash implementation via ADL
+   * @see symbol-impl.cpp
+   */
+  class SymbolHashtable_test : public Test
+    {
+      
+      void
+      run (Arg)
+        {
+          HTable table;
+          ASSERT (isnil(table));
+          
+          table[KEY1] = string (KEY1);
+          table[KEY2] = string (KEY2);
+          table[KEY3] = string (KEY3);
+          table[KEY4] = string (KEY4);
+          
+          ASSERT (!isnil(table));
+          ASSERT (4 == table.size());
+          ASSERT (contains (table, KEY1));
+          ASSERT (contains (table, KEY2));
+          ASSERT (contains (table, KEY3));
+          ASSERT (contains (table, KEY4));
+          ASSERT (!contains (table, KEY5));
+          
+          ASSERT (string (KEY1) == table[KEY1]);
+          ASSERT (string (KEY2) == table[KEY2]);
+          ASSERT (string (KEY3) == table[KEY3]);
+          ASSERT (string (KEY4) == table[KEY4]);
+          
+          table[KEY3] += "..."; 
+          ASSERT (string(KEY3)       != table[KEY3]);
+          ASSERT (string(KEY3)+"..." == table[KEY3]);
+          
+          ASSERT (isnil (table[KEY5])); // adds a new empty value object as side effect
+          ASSERT (5 == table.size());
+        }
+    };
+  
+  LAUNCHER (SymbolHashtable_test, "function common");
+  
+  
+}} // namespace lib::test
+
diff --git a/tests/lib/symbol-test.cpp b/tests/lib/symbol-test.cpp
new file mode 100644
index 000000000..0da7699fa
--- /dev/null
+++ b/tests/lib/symbol-test.cpp
@@ -0,0 +1,129 @@
+/*
+  Symbol(Test)  -  verify basic properties of a Symbol datatype
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/util.hpp"
+#include "lib/test/test-helper.hpp"
+
+#include "lib/symbol.hpp"
+
+
+#include <iostream>
+
+using std::cout;
+using std::endl;
+using util::isnil;
+using util::isSameObject;
+
+
+
+namespace lib {
+namespace test{
+  
+  
+  /**********************************************************
+   * @test properties of Symbol data type. Currently this is
+   *       just a thin wrapper for a const char *
+   * @todo this test is very much WIP, as the implementation
+   *       of a real symbol type and symbol table remains 
+   *       to be done. See Ticket #157
+   */
+  class Symbol_test : public Test
+    {
+      
+      void
+      run (Arg)
+        {
+          checkLiteral();
+          checkSymbolCreation();
+        }
+      
+      
+      void
+      checkLiteral()
+        {
+          Literal li1 ("one");
+          Literal li2 (li1);
+          Literal li3 ("one ");
+          
+          cout << li1 << endl;
+          cout << showSizeof(li1) << endl;
+          ASSERT (sizeof(Literal) == sizeof(char*));
+          
+          ASSERT (li1 == li2);
+          ASSERT (!isSameObject (li1,li2));
+          ASSERT (li1 != li3);
+          ASSERT (li2 != li3);
+          ASSERT (li3 != li2);
+          
+          cout << showType(li1 + string("ce"))         << endl;
+          cout << showType(string("minus " +li1))      << endl;
+          cout << li2+string("..") << string("..")+li2 << endl;
+          
+          ASSERT (hash_value(li1) == hash_value(li2));
+          ASSERT (hash_value(li2) != hash_value(li3));
+        }
+      
+      
+      void
+      checkEmptyLiteral()
+        {
+          Literal nn1 (0);
+          Literal nn2 ("");
+          
+          ASSERT (isnil (nn1));
+          ASSERT (isnil (nn2));
+          
+          Literal nnn (" ");
+          ASSERT (!isnil (nnn));
+        }
+      
+      
+      void
+      checkSymbolCreation()
+        {
+          Literal l1("1");
+          Symbol sy1("1");
+          Symbol sy2(l1);
+          
+          ASSERT (sy1 == sy2);
+          ASSERT (!isSameObject (l1,sy1));
+          ASSERT (!isSameObject (sy1,sy2));
+          
+          Symbol sy3;
+          ASSERT (isnil(sy3));
+          ASSERT (sy1 != sy3);
+          
+          sy3 = l1;
+          ASSERT (!isnil(sy3));
+          ASSERT (sy1 == sy3);
+          
+          TODO ("real functionality of Symbol data type");
+        }
+    };
+  
+  LAUNCHER (Symbol_test, "unit common");
+  
+  
+}} // namespace lib::test
+

From 8dc434a141f0fb8684fbcaae34a5ddc1d268c51a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 25 Sep 2009 16:36:56 +0200
Subject: [PATCH 308/368] CommandRegistry implementation (...)

---
 src/proc/control/command-registry.hpp | 34 ++++++++++++++++++---------
 src/proc/control/command.cpp          | 24 +++++++++++--------
 src/proc/control/command.hpp          |  5 ++--
 3 files changed, 40 insertions(+), 23 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 4f0abfe56..7e7129cf3 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -43,6 +43,7 @@
 #include "lib/sync.hpp"
 #include "lib/format.hpp"
 #include "include/logging.h"
+#include "lib/util.hpp"
 //#include "lib/bool-checkable.hpp"
 
 #include "proc/control/command.hpp"
@@ -51,6 +52,7 @@
 #include "proc/control/typed-allocation-manager.hpp"
 //#include "proc/control/memento-tie.hpp"
 
+#include <boost/functional/hash.hpp>
 #include <boost/noncopyable.hpp>
 #include <tr1/unordered_map>
 #include <tr1/memory>
@@ -62,10 +64,13 @@
 
 namespace control {
   
+  using boost::hash;
   using boost::noncopyable;
   using std::tr1::shared_ptr;
+  using std::tr1::unordered_map;
 //  using std::ostream;
   using std::string;
+  using util::contains;
   
   
   
@@ -78,8 +83,8 @@ namespace control {
     , noncopyable
     {
       // using a hashtable to implement the index
-      typedef std::tr1::unordered_map<Symbol, Command> CmdIndex;
-      typedef std::map<void*, Symbol> ReverseIndex;
+      typedef unordered_map<Symbol, Command, hash<Symbol> > CmdIndex;
+      typedef std::map< void*, Symbol> ReverseIndex;
       
       CmdIndex index_;
       ReverseIndex ridx_;
@@ -93,11 +98,11 @@ namespace control {
       /** register a command (Frontend) under the given ID
        *  @return either the new command, or an already existing
        *          command registered under the given ID  */ 
-      Command
+      Command&
       track (Symbol cmdID, Command const& commandHandle)
         {
           Lock sync(this);
-          UNIMPLEMENTED ("place a commandHandle into the command index, or return the command already registered there");
+          
           Command& indexSlot (index_[cmdID]);
           if (!indexSlot)
             {
@@ -105,7 +110,6 @@ namespace control {
               ridx_[&indexSlot] = cmdID;
             }
           return indexSlot;
-          ///////////////////////////TODO possible to return a const& ??
         }
       
       
@@ -117,7 +121,15 @@ namespace control {
       remove (Symbol cmdID)
         {
           Lock sync(this);
-          UNIMPLEMENTED ("de-register a command definition.");
+          
+          bool actually_remove = contains (index_,cmdID);
+          if (actually_remove)
+            {
+              ridx_.erase(& index_[cmdID]);
+              index_.erase(cmdID);
+            }
+          ENSURE (!contains (index_,cmdID));
+          return actually_remove;
         }
       
       
@@ -128,11 +140,11 @@ namespace control {
       queryIndex (Symbol cmdID)
         {
           Lock sync(this);
-          UNIMPLEMENTED ("retrieve the command registered under the given ID, maybe return an »empty« command");
-          // if index.contains(cmdID)
-          //   return index[cmdID]
-          // else
-          return Command();
+          
+          if (contains (index_,cmdID))
+            return index_[cmdID];
+          else
+            return Command();
         }
       
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 1c294131d..602fd9e2a 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -105,7 +105,7 @@ namespace control {
   }
   
   
-  Command
+  Command const&
   Command::fetchDef (Symbol cmdID)
   {
     CommandRegistry& registry = CommandRegistry::instance();
@@ -150,18 +150,22 @@ namespace control {
   
   
   Command
-  Command::storeDef (Symbol newCmdID)
+  Command::storeDef (Symbol newCmdID)  const
   {
     CommandRegistry& registry = CommandRegistry::instance();
+    
+    if (!registry.queryIndex (newCmdID))
+      {
+        Command cloneDefinition;
+        cloneDefinition.activate (registry.createCloneImpl(impl()));
+        
+        Command& registeredCloneDef = registry.track (newCmdID, cloneDefinition);
+        if (cloneDefinition == registeredCloneDef)
+          return registeredCloneDef; 
+      }
+    
     static format fmt("Unable to store %s as new command. ID \"%s\" is already in use");
-    
-    if (registry.queryIndex (newCmdID))
-      throw error::Logic (str (fmt % *this % newCmdID), LUMIERA_ERROR_DUPLICATE_COMMAND);
-    
-    Command cloneDefinition;
-    cloneDefinition.activate (registry.createCloneImpl(impl()));
-    
-    return registry.track (newCmdID, cloneDefinition);
+    throw error::Logic (str (fmt % *this % newCmdID), LUMIERA_ERROR_DUPLICATE_COMMAND);
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 130cea17b..269a53425 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -116,7 +116,8 @@ namespace control {
       static Command get (FuncPtr func);
       static bool remove (Symbol cmdID); 
       
-      Command storeDef (Symbol newCmdID);
+      /** create a clone definition */
+      Command storeDef (Symbol newCmdID)  const;
       
       Command() { } ///< undefined command
      ~Command();
@@ -165,7 +166,7 @@ namespace control {
       
       
     protected:
-      static Command fetchDef (Symbol cmdID);
+      static Command const& fetchDef (Symbol cmdID);
       
       friend class CommandDef;
       

From 4c9af94e1d3afe2e51560837ffa3249bf2c4b676 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 26 Sep 2009 02:14:07 +0200
Subject: [PATCH 309/368] improve and clean up the Command interface

---
 src/proc/control/command.cpp | 21 +++++++++++++--------
 src/proc/control/command.hpp | 20 +++++++++++---------
 2 files changed, 24 insertions(+), 17 deletions(-)

diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 602fd9e2a..6902ea302 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -79,12 +79,15 @@ namespace control {
   
   
   
-  /** */
+  /** Access existing command for use.
+   *  @throw error::Invalid if command not 
+   *         registered or incompletely defined.
+   */
   Command 
   Command::get (Symbol cmdID)
   {
     Command cmd = CommandRegistry::instance().queryIndex (cmdID);
-    static format fmt("Command definition \"%s\" not found");
+    static format fmt("Command \"%s\" not found");
     if (!cmd)
       throw error::Invalid(str(fmt % cmdID), LUMIERA_ERROR_INVALID_COMMAND);
       
@@ -99,13 +102,15 @@ namespace control {
    *        thus this feature is unimplemented for the time being.
    */
   Command
-  Command::get (FuncPtr funcP)
+  Command::get (FuncPtr)
   {
     UNIMPLEMENTED ("find a command definition which was based on the given function (ptr)");
   }
   
   
-  Command const&
+  /** @internal to be invoked by CommandDef
+   *  when starting a new definition  */
+  Command
   Command::fetchDef (Symbol cmdID)
   {
     CommandRegistry& registry = CommandRegistry::instance();
@@ -120,10 +125,11 @@ namespace control {
   }              // return new or currently registered cmd...
   
   
-  /** @internal to be invoked by CommandDef
+  /** @internal to be invoked through CommandDef to make a command ready
    *  @throw std::bad_alloc, in which case
-   *         CommandRegistry::killCommandImpl is invoked */
-  Command&
+   *         CommandRegistry::killCommandImpl is invoked.
+   *  @throw error::Logic when this is already activated. */
+  void
   Command::activate (shared_ptr<CommandImpl> const& implFrame)
   {
     static format fmt("Command \"%s\" already defined");
@@ -135,7 +141,6 @@ namespace control {
     _Handle::activate (implFrame);
             
     INFO (command, "Command \"%s\" defined OK", cStr(*this));
-    return *this;
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 269a53425..d064daf1c 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -122,6 +122,16 @@ namespace control {
       Command() { } ///< undefined command
      ~Command();
       
+      
+      
+      /* === command lifecycle === */
+      
+      void activate (shared_ptr<CommandImpl> const&);
+      
+      template<typename TYPES>
+      Command& bindArg (Tuple<TYPES> const&);
+      
+      
       ExecResult operator() () ;
       ExecResult undo () ;
       
@@ -145,14 +155,6 @@ namespace control {
       
       
       
-      /* === command lifecycle === */
-      
-      Command& activate (shared_ptr<CommandImpl> const&);
-      
-      template<typename TYPES>
-      Command& bindArg (Tuple<TYPES> const&);
-      
-      
       /* === diagnostics === */
       
       static size_t definition_count();
@@ -166,7 +168,7 @@ namespace control {
       
       
     protected:
-      static Command const& fetchDef (Symbol cmdID);
+      static Command fetchDef (Symbol cmdID);
       
       friend class CommandDef;
       

From 7fccecacce55c447b710f689b50cf3a87850a886 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 26 Sep 2009 04:19:57 +0200
Subject: [PATCH 310/368] WIP using the reverse index to find out the
 Command-ID this includes using a Command* as key within a std::map

---
 src/lib/util.hpp                      | 15 ++++++++++++-
 src/proc/control/command-registry.hpp | 32 ++++++++++++++++++---------
 src/proc/control/command.cpp          |  2 +-
 src/proc/control/command.hpp          |  8 +++++++
 4 files changed, 45 insertions(+), 12 deletions(-)

diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index a72f6c2b1..85203c727 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -99,7 +99,7 @@ namespace util {
   /** shortcut for containment test on a map */
   template <typename MAP>
   inline bool 
-  contains (MAP& map, typename MAP::key_type& key)
+  contains (MAP& map, typename MAP::key_type const& key)
   {
     return map.find(key) != map.end();
   }
@@ -132,6 +132,19 @@ namespace util {
     return end != std::find(begin,end, val);
   }
   
+  /** fetch value from a Map, or return a default if not found */
+  template <typename MAP>
+  inline typename MAP::value_type
+  getValue_or_default (MAP& map, typename MAP::key_type const& key
+                               , typename MAP::value_type defaultVal)
+  {
+    typename MAP::iterator pos = map.find (key);
+    if (pos != map.end())
+      return pos->second;
+    else
+      return defaultVal;
+  }
+  
   /** shortcut for removing all copies of an Element
    *  in any sequential collection */
   template <typename SEQ>
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 7e7129cf3..b6451f8b5 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -71,8 +71,23 @@ namespace control {
 //  using std::ostream;
   using std::string;
   using util::contains;
+  using util::getValue_or_default;
   
   
+  /**
+   * Helper for building a std::map with
+   * Command* as keys. Defines the order
+   * by the address of the Command's 
+   * implementation object.
+   */
+  struct order_by_impl
+    {
+      bool
+      operator() (Command* pC1, Command* pC2)
+        {
+          return ( pC1 &&  pC2  && (*pC1 < *pC2));
+        }
+    };
   
   
   /**
@@ -84,7 +99,7 @@ namespace control {
     {
       // using a hashtable to implement the index
       typedef unordered_map<Symbol, Command, hash<Symbol> > CmdIndex;
-      typedef std::map< void*, Symbol> ReverseIndex;
+      typedef std::map<Command*, Symbol, order_by_impl> ReverseIndex;
       
       CmdIndex index_;
       ReverseIndex ridx_;
@@ -140,12 +155,8 @@ namespace control {
       queryIndex (Symbol cmdID)
         {
           Lock sync(this);
-          
-          if (contains (index_,cmdID))
-            return index_[cmdID];
-          else
-            return Command();
-        }
+          return getValue_or_default (index_, cmdID, Command() );
+        }                                           //if not found
       
       
       /** search the command index for a definition
@@ -155,14 +166,15 @@ namespace control {
       const char*
       findDefinition (Command const& cmdInstance)  const
         {
-          UNIMPLEMENTED ("try to find a registration in the index for a given command instance");
-        }
+//        Lock sync(this);                                     ////////////////////////////////////TICKET #272  Lock should also be usable in const methods
+          return getValue_or_default (ridx_, &cmdInstance, 0 );
+        }                                   //used as Key
       
       
       size_t
       index_size()  const
         {
-          UNIMPLEMENTED ("number of defs in the index");
+          return index_.size();
         }
       
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 6902ea302..f70695c83 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -200,7 +200,7 @@ namespace control {
   
   
   
-  /** is this a valid command definition frame? especially
+  /** is this a valid command definition? especially..
    *  - the prototype command is initialised properly
    *  - there is a command definition registered for our command ID
    *  - and the registered command uses the same underlying command impl
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index d064daf1c..0c105d2a5 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -165,6 +165,7 @@ namespace control {
       
       operator string() const;
       friend bool operator== (Command const&, Command const&);
+      friend bool operator<  (Command const&, Command const&);
       
       
     protected:
@@ -212,6 +213,13 @@ namespace control {
     return ! (c1 == c2); 
   }
   
+  /** allow for sets and associative containers */
+  inline bool
+  operator< (Command const& c1, Command const& c2)
+  {
+    return ( c1 &&  c2  && (&c1.impl() < &c2.impl())); 
+  }
+  
   
   
   

From 6a77bebb6a43c434a89abf7990ba413171c63641 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 26 Sep 2009 16:42:57 +0200
Subject: [PATCH 311/368] fix type for search in map

---
 src/lib/util.hpp                      | 6 +++---
 src/proc/control/command-registry.hpp | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index 85203c727..bcceb2480 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -134,11 +134,11 @@ namespace util {
   
   /** fetch value from a Map, or return a default if not found */
   template <typename MAP>
-  inline typename MAP::value_type
+  inline typename MAP::mapped_type
   getValue_or_default (MAP& map, typename MAP::key_type const& key
-                               , typename MAP::value_type defaultVal)
+                               , typename MAP::mapped_type defaultVal)
   {
-    typename MAP::iterator pos = map.find (key);
+    typename MAP::const_iterator pos = map.find (key);
     if (pos != map.end())
       return pos->second;
     else
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index b6451f8b5..04c7c1c2c 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -83,7 +83,7 @@ namespace control {
   struct order_by_impl
     {
       bool
-      operator() (Command* pC1, Command* pC2)
+      operator() (const Command *pC1, const Command *pC2)  const
         {
           return ( pC1 &&  pC2  && (*pC1 < *pC2));
         }
@@ -99,7 +99,7 @@ namespace control {
     {
       // using a hashtable to implement the index
       typedef unordered_map<Symbol, Command, hash<Symbol> > CmdIndex;
-      typedef std::map<Command*, Symbol, order_by_impl> ReverseIndex;
+      typedef std::map<const Command*, Symbol, order_by_impl> ReverseIndex;
       
       CmdIndex index_;
       ReverseIndex ridx_;

From 022a96128421001e1834beb52abd0326aa101e22 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 26 Sep 2009 17:45:53 +0200
Subject: [PATCH 312/368] finish implementation of CommandRegistry

---
 src/proc/control/command-registry.hpp | 54 ++++++++++++++++++---------
 1 file changed, 37 insertions(+), 17 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 04c7c1c2c..f355dc365 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -23,9 +23,29 @@
 
 /** @file command-registry.hpp
  ** Managing command definitions and the storage of individual command objects.
- ** @todo WIP WIP.
+ ** The CommandRegistry is an singleton object, accessible only at the implementation level
+ ** of control::Command (note: CommandImpl isn't tied to the registry). For the other parts
+ ** of the command system, it serves all "get me this command object"-services. Actually,
+ ** these can be decomposed into two distinct parts:
+ ** - allocation of CommandImpl frames and argument holders, which is delegated
+ **   to the TypedAllocationManager
+ ** - maintaining an index to find pre-build command definitions (prototypes)
  ** 
- ** \par Lifecycle
+ ** \par Services during command lifecycle
+ ** Each command starts out as command definition, accessed by client code through CommandDef.
+ ** While collecting the necessary parts of such a definition, there is just an empty (pending)
+ ** Command (smart-ptr frontend), which is already registered with the intended command-ID.
+ ** A lookup on this ID would still fail in this phase, as the \link #queryIndex search function \endlink
+ ** treats missing and incomplete command definitions similar. When the definition is complete,
+ ** a CommandImpl frame is allocated, configured and used to activate the Command (smart-ptr frontend).
+ ** 
+ ** Later on, client code is assumed to re-access the command by ID. It may bind arguments, which are
+ ** stored in the already allocated ArgumentHolder. (-->Ticket #269). As the Command frontend is a
+ ** smart-ptr, commands may be copied, stored away and passed on. When finally the ref-count of
+ ** a given definition goes to zero, de-allocation happens automatically. This can't happen for
+ ** a registered command definition though, as a Command instance is stored within the index
+ ** table, keeping the linked data alive. Thus, any registered commands will remain in memory
+ ** until de-registered explicitly, or until application shutdown.
  ** 
  ** @see Command
  ** @see ProcDispatcher
@@ -44,19 +64,16 @@
 #include "lib/format.hpp"
 #include "include/logging.h"
 #include "lib/util.hpp"
-//#include "lib/bool-checkable.hpp"
 
 #include "proc/control/command.hpp"
 #include "proc/control/command-signature.hpp"
 #include "proc/control/command-argument-holder.hpp"
 #include "proc/control/typed-allocation-manager.hpp"
-//#include "proc/control/memento-tie.hpp"
 
 #include <boost/functional/hash.hpp>
 #include <boost/noncopyable.hpp>
 #include <tr1/unordered_map>
 #include <tr1/memory>
-//#include <iostream>
 #include <string>
 #include <map>
 
@@ -68,10 +85,10 @@ namespace control {
   using boost::noncopyable;
   using std::tr1::shared_ptr;
   using std::tr1::unordered_map;
-//  using std::ostream;
-  using std::string;
-  using util::contains;
   using util::getValue_or_default;
+  using util::contains;
+  using std::string;
+  using std::map;
   
   
   /**
@@ -91,7 +108,11 @@ namespace control {
   
   
   /**
-   * TODO type comment
+   * Registry managing command implementation objects (Singleton).
+   * Relies on TypedAllocationManager for pooled custom allocation (TODO: not implemented as of 9/09)
+   * Registered command (definitions) are accessible by command ID;
+   * as this mapping is bidirectional, it is also possible to find
+   * out the ID for a given command.
    */
   class CommandRegistry
     : public lib::Sync<>
@@ -99,7 +120,7 @@ namespace control {
     {
       // using a hashtable to implement the index
       typedef unordered_map<Symbol, Command, hash<Symbol> > CmdIndex;
-      typedef std::map<const Command*, Symbol, order_by_impl> ReverseIndex;
+      typedef map< const Command*, Symbol, order_by_impl> ReverseIndex;
       
       CmdIndex index_;
       ReverseIndex ridx_;
@@ -181,14 +202,14 @@ namespace control {
       size_t
       instance_count()  const
         {
-          UNIMPLEMENTED ("number of active command impl instances");
+          return allocator_.numSlots<CommandImpl>();
         }
       
       
       /** set up a new command implementation frame
-       *  @return shared-ptr owning a newly created CommandImpl, allocated 
-       *          through the registry and wired internally to invoke 
-       *          TypedAllocationManager#destroyElement for cleanup. 
+       *  @return shared-ptr owning a newly created CommandImpl, allocated
+       *          through the registry and wired internally to invoke
+       *          TypedAllocationManager#destroyElement for cleanup.
        */
       template< typename SIG_OPER    ///< signature of the command operation
               , typename SIG_CAPT    ///< signature for capturing undo state
@@ -222,13 +243,12 @@ namespace control {
        *  to the memory manager for allocating the clone. 
        */
       shared_ptr<CommandImpl>
-      createCloneImpl (CommandImpl const& reference)
+      createCloneImpl (CommandImpl const& refObject)
         {
-          return allocator_.create<CommandImpl> (reference, allocator_);
+          return allocator_.create<CommandImpl> (refObject, allocator_);
         }
       
       
-      
     };
   
   

From c921d927a23f73abf2efa6d7c23beac41556064a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 26 Sep 2009 17:52:26 +0200
Subject: [PATCH 313/368] provide API for counting the allocations
 (unimplemented)

---
 src/proc/control/typed-allocation-manager.hpp | 51 ++++++++++++++++++-
 tests/lib/typed-allocation-manager-test.cpp   |  6 +++
 2 files changed, 55 insertions(+), 2 deletions(-)

diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
index 9ad8ebe5e..20916d51f 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -33,7 +33,7 @@
  ** then to provide a general-purpose allocator to be used by any instance of a given
  ** type. Typically, the goal is to handle memory management for an index or registry,
  ** holding implementation objects to be shielded from the client code. Moreover, we'll
- ** have to deal with families of types rather then with individual types, and typically
+ ** have to deal with families of types rather then with individual types; usually
  ** there will be some common or combined handling for all family members.
  ** 
  ** The intention is for this TypedAllocationManager template to be used both as a base
@@ -103,6 +103,8 @@ namespace control { ////////////////////////////////////////////////////////////
       typedef TypedAllocationManager _TheManager;
       
     public:
+      template<class XX>
+      size_t numSlots()  const;
       
       
       /* ======= managing the created objects ============= */
@@ -264,6 +266,7 @@ namespace control { ////////////////////////////////////////////////////////////
         {
           TODO ("redirect to the corresponding pool allocator");
           void* space = new char[sizeof(XX)];
+          allocCnt_.inc<XX>();
           return Slot<XX> (this, space);
         }
       
@@ -274,6 +277,7 @@ namespace control { ////////////////////////////////////////////////////////////
           TODO ("redirect to the corresponding pool allocator");
           typedef char Storage[sizeof(XX)];
           delete[] reinterpret_cast<Storage*> (entry);
+          allocCnt_.dec<XX>();
         }
       
       
@@ -289,8 +293,9 @@ namespace control { ////////////////////////////////////////////////////////////
             }
           catch(...)
             {
+              lumiera_err errorID = lumiera_error();
               WARN (command_dbg, "dtor of %s failed: %s", util::tyStr(entry).c_str()
-                                                        , lumiera_error() );
+                                                        , errorID );
             }
           releaseSlot<XX> (entry);
         }
@@ -298,8 +303,50 @@ namespace control { ////////////////////////////////////////////////////////////
       template<class>
       friend class Killer;  ///< especially all Killers are entitled to desroyElement()
       
+      
+    private:
+      /** 
+       * temporary helper to count the number of allocations
+       * for diagnostic purpose. When actually implementing a
+       * custom allocation, this information should be available
+       * from the allocator. 
+       */
+      class SlotCounter
+        {
+        public:
+          template<class X>
+          size_t 
+          get()  const
+            {
+              UNIMPLEMENTED ("get typed count");
+            }
+          
+          template<class X>
+          void 
+          inc()
+            {
+              UNIMPLEMENTED ("increment typed count");
+            }
+          
+          template<class X>
+          void 
+          dec()
+            {
+              UNIMPLEMENTED ("decrement typed count");
+            }
+        };
+      
+      SlotCounter allocCnt_;
     };
   
   
+  
+  template<class XX>
+  size_t
+  TypedAllocationManager::numSlots()  const
+  {
+    return allocCnt_.get<XX>();
+  }
+
 } // namespace control
 #endif
diff --git a/tests/lib/typed-allocation-manager-test.cpp b/tests/lib/typed-allocation-manager-test.cpp
index c8cf35de1..e57686cc6 100644
--- a/tests/lib/typed-allocation-manager-test.cpp
+++ b/tests/lib/typed-allocation-manager-test.cpp
@@ -145,8 +145,14 @@ namespace test    {
               ASSERT (2 == pD2x.use_count());
               ASSERT (isSameObject (*pD21, *pD2x));
               
+              ASSERT (2 == allocator.numSlots<DummyObj<1> >());
+              ASSERT (2 == allocator.numSlots<DummyObj<22> >());
+              
+              ASSERT (0 == allocator.numSlots<long>()); // query just some unrelated type...
             }
           
+          ASSERT (0 == allocator.numSlots<DummyObj<1> >());
+          ASSERT (0 == allocator.numSlots<DummyObj<22> >());
           ASSERT (0 == checksum_);
         }
     };

From 83cd7fd8304dbfe1a5d985d7fcb8ed65a8375304 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 26 Sep 2009 23:00:55 +0200
Subject: [PATCH 314/368] Extract the type-based counting into a separate
 facility

---
 src/lib/typed-counter.hpp                     | 119 ++++++++++++++++++
 src/proc/control/typed-allocation-manager.hpp |  34 +----
 tests/40components.tests                      |   5 +
 tests/lib/Makefile.am                         |   1 +
 tests/lib/typed-counter-test.cpp              | 109 ++++++++++++++++
 5 files changed, 236 insertions(+), 32 deletions(-)
 create mode 100644 src/lib/typed-counter.hpp
 create mode 100644 tests/lib/typed-counter-test.cpp

diff --git a/src/lib/typed-counter.hpp b/src/lib/typed-counter.hpp
new file mode 100644
index 000000000..fc5cba278
--- /dev/null
+++ b/src/lib/typed-counter.hpp
@@ -0,0 +1,119 @@
+/*
+  TYPED-COUNTER.hpp  -  maintain a set of type based contexts 
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file typed-allocation-manager.hpp
+ ** Abstract foundation for building custom allocation managers.
+ ** Currently (as of 8/09) this is a draft, factored out of the command-registry.
+ ** The expectation is that we'll face several similar situations, and thus it
+ ** would be good to build up a common set of operations and behaviour.
+ ** @todo WIP WIP.
+ **
+ ** \par Concept Summary
+ ** The idea is rather to tie the memory manager to a very specific usage situation,
+ ** then to provide a general-purpose allocator to be used by any instance of a given
+ ** type. Typically, the goal is to handle memory management for an index or registry,
+ ** holding implementation objects to be shielded from the client code. Moreover, we'll
+ ** have to deal with families of types rather then with individual types; usually
+ ** there will be some common or combined handling for all family members.
+ ** 
+ ** The intention is for this TypedAllocationManager template to be used both as a base
+ ** class providing the implementation skeleton for the actual custom allocation manager,
+ ** and as an abstract interface, which can be forwarded to the \em implementation classes
+ ** in case there is some cooperation required to get the allocation done (for example,
+ ** there might be some type erasure involved, leaving the (otherwise opaque) implementation
+ ** class as the only entity with a limited knowledge about the actual memory layout, and
+ ** thus the only way of creating a clone properly would be to forward down into this
+ ** implementation class).
+ ** 
+ ** Thus, TypedAllocationManager provides the classical operations of an allocator
+ ** - allocate
+ ** - construct
+ ** - deallocate
+ ** But each of these operations is to be invoked in a \em typed context. Besides,
+ ** there is a facility allowing to create ref-counting handles and smart-pointers,
+ ** which are internally tied to this memory manager through a deleter function.
+ ** 
+ ** @todo using a quick-n-dirty heap allocation implementation for now (8/09),
+ **       but should write a custom allocator based on cehteh's mpool!
+ ** 
+ ** @see CommandRegistry
+ ** @see AllocationCluster (another custom allocation scheme, which could be united)
+ **
+ */
+
+
+
+#ifndef LIB_TYPED_COUNTER_H
+#define LIB_TYPED_COUNTER_H
+
+//#include "pre.hpp"
+#include "lib/error.hpp"
+#include "lib/format.hpp"
+#include "include/logging.h"
+
+
+#include <tr1/memory>
+
+
+
+namespace lib {
+  
+  using std::tr1::shared_ptr;
+  
+  
+  
+  
+      /** 
+       * temporary helper to count the number of allocations
+       * for diagnostic purpose. When actually implementing a
+       * custom allocation, this information should be available
+       * from the allocator. 
+       */
+  class TypedCounter
+    {
+        public:
+          template<class X>
+          size_t 
+          get()  const
+            {
+              UNIMPLEMENTED ("get typed count");
+            }
+          
+          template<class X>
+          void 
+          inc()
+            {
+              UNIMPLEMENTED ("increment typed count");
+            }
+          
+          template<class X>
+          void 
+          dec()
+            {
+              UNIMPLEMENTED ("decrement typed count");
+            }
+    };
+  
+
+} // namespace lib
+#endif
diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/proc/control/typed-allocation-manager.hpp
index 20916d51f..346ad1b17 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/proc/control/typed-allocation-manager.hpp
@@ -69,6 +69,7 @@
 //#include "pre.hpp"
 #include "lib/error.hpp"
 #include "lib/format.hpp"
+#include "lib/typed-counter.hpp"
 #include "include/logging.h"
 
 
@@ -305,38 +306,7 @@ namespace control { ////////////////////////////////////////////////////////////
       
       
     private:
-      /** 
-       * temporary helper to count the number of allocations
-       * for diagnostic purpose. When actually implementing a
-       * custom allocation, this information should be available
-       * from the allocator. 
-       */
-      class SlotCounter
-        {
-        public:
-          template<class X>
-          size_t 
-          get()  const
-            {
-              UNIMPLEMENTED ("get typed count");
-            }
-          
-          template<class X>
-          void 
-          inc()
-            {
-              UNIMPLEMENTED ("increment typed count");
-            }
-          
-          template<class X>
-          void 
-          dec()
-            {
-              UNIMPLEMENTED ("decrement typed count");
-            }
-        };
-      
-      SlotCounter allocCnt_;
+      lib::TypedCounter allocCnt_;
     };
   
   
diff --git a/tests/40components.tests b/tests/40components.tests
index dce3d49ec..63db0fb3a 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -848,6 +848,11 @@ return: 0
 END
 
 
+PLANNED "building type based contexts" TypedCounter_test <<END
+return: 0
+END
+
+
 TEST "VectorTransfer_test" VectorTransfer_test <<END
 return: 0
 END
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 4a0e00bf5..1acd20f60 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -85,6 +85,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/test/testoptiontest.cpp		\
 	$(testlib_srcdir)/test/test-helper-test.cpp		\
 	$(testlib_srcdir)/typed-allocation-manager-test.cpp	\
+	$(testlib_srcdir)/typed-counter-test.cpp		\
 	$(testlib_srcdir)/vectortransfertest.cpp		\
 	$(testlib_srcdir)/visitingtoolconcept.cpp		\
 	$(testlib_srcdir)/visitingtoolextendedtest.cpp		\
diff --git a/tests/lib/typed-counter-test.cpp b/tests/lib/typed-counter-test.cpp
new file mode 100644
index 000000000..e21272255
--- /dev/null
+++ b/tests/lib/typed-counter-test.cpp
@@ -0,0 +1,109 @@
+/*
+  TypedCounter(Test)  -  managing a set of type based contexts
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/control/command.hpp"
+#include "proc/control/typed-allocation-manager.hpp"
+//#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+//#include "lib/symbol.hpp"
+#include "lib/util.hpp"
+
+
+#include <tr1/memory>
+//#include <boost/ref.hpp>
+//#include <boost/format.hpp>
+//#include <iostream>
+#include <cstdlib>
+//#include <string>
+
+
+namespace lib {
+namespace test{
+
+
+//  using boost::format;
+//  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+  using std::tr1::shared_ptr;
+//  using std::tr1::bind;
+//  using std::string;
+  using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+  using util::isSameObject;
+//  using util::contains;
+
+//  using session::test::TestClip;
+//  using lib::Symbol;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  namespace { // test data and helpers...
+  
+    long checksum_ = 0;
+    
+    /**
+     * Yet-another fammily of dummy types....
+     */
+    template<uint siz>
+    class DummyType
+      {
+        char crap_[siz];
+      };
+  }
+  
+  
+  
+  /***************************************************************************************
+   * @test cover the basic implementation of a custom allocator, delegating to mpool.
+   *       TypedAllocationManager is a base class, used e.g. to build the CommandRegistry.
+   * 
+   * @todo planned but not implemented as of 8/09   see also Ticket #217
+   *        
+   * @see CommandRegistry
+   * @see command-registry-test.cpp
+   * @see allocationclustertest.cpp
+   */
+  class TypedCounter_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          UNIMPLEMENTED ("type based contexts");
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (TypedCounter_test, "unit common");
+  
+  
+}} // namespace lib::test

From 517fb8b2009c79d4ffdcb5390be94059509a0163 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 27 Sep 2009 02:46:26 +0200
Subject: [PATCH 315/368] multithreaded torture test for the (planned)
 TypedCounter

---
 src/lib/typed-counter.hpp        | 112 +++++--------
 tests/lib/typed-counter-test.cpp | 274 ++++++++++++++++++++++++++++---
 2 files changed, 294 insertions(+), 92 deletions(-)

diff --git a/src/lib/typed-counter.hpp b/src/lib/typed-counter.hpp
index fc5cba278..e90490382 100644
--- a/src/lib/typed-counter.hpp
+++ b/src/lib/typed-counter.hpp
@@ -21,43 +21,19 @@
 */
 
 
-/** @file typed-allocation-manager.hpp
- ** Abstract foundation for building custom allocation managers.
- ** Currently (as of 8/09) this is a draft, factored out of the command-registry.
- ** The expectation is that we'll face several similar situations, and thus it
- ** would be good to build up a common set of operations and behaviour.
- ** @todo WIP WIP.
- **
- ** \par Concept Summary
- ** The idea is rather to tie the memory manager to a very specific usage situation,
- ** then to provide a general-purpose allocator to be used by any instance of a given
- ** type. Typically, the goal is to handle memory management for an index or registry,
- ** holding implementation objects to be shielded from the client code. Moreover, we'll
- ** have to deal with families of types rather then with individual types; usually
- ** there will be some common or combined handling for all family members.
- ** 
- ** The intention is for this TypedAllocationManager template to be used both as a base
- ** class providing the implementation skeleton for the actual custom allocation manager,
- ** and as an abstract interface, which can be forwarded to the \em implementation classes
- ** in case there is some cooperation required to get the allocation done (for example,
- ** there might be some type erasure involved, leaving the (otherwise opaque) implementation
- ** class as the only entity with a limited knowledge about the actual memory layout, and
- ** thus the only way of creating a clone properly would be to forward down into this
- ** implementation class).
- ** 
- ** Thus, TypedAllocationManager provides the classical operations of an allocator
- ** - allocate
- ** - construct
- ** - deallocate
- ** But each of these operations is to be invoked in a \em typed context. Besides,
- ** there is a facility allowing to create ref-counting handles and smart-pointers,
- ** which are internally tied to this memory manager through a deleter function.
- ** 
- ** @todo using a quick-n-dirty heap allocation implementation for now (8/09),
- **       but should write a custom allocator based on cehteh's mpool!
- ** 
- ** @see CommandRegistry
- ** @see AllocationCluster (another custom allocation scheme, which could be united)
+/** @file typed-counter.hpp
+ ** Creating sets of type-based contexts.
+ ** The idea is to get a "slot" for any given type, so we can build
+ ** tables or families of implementations based on these types. Currently,
+ ** the slot allocation is based on static variables and thus is global.
+ ** This leads to a waste of slots, as the various clients of this service
+ ** typically will utilise different sets of types.
+ ** @todo WIP WIP... this is the first, preliminary version of a facility,
+ **       which is expected to get quite important for custom allocation management.
+  ** 
+ ** @see typed-counter-test.cpp
+ ** @see TypedAllocationManager
+ ** @see AllocationCluster (custom allocation scheme using a similar idea inline)
  **
  */
 
@@ -68,52 +44,50 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
-#include "lib/format.hpp"
-#include "include/logging.h"
+//#include "lib/format.hpp"
+//#include "include/logging.h"
 
 
-#include <tr1/memory>
+//#include <tr1/memory>
 
 
 
 namespace lib {
   
-  using std::tr1::shared_ptr;
+//using std::tr1::shared_ptr;
   
   
   
   
-      /** 
-       * temporary helper to count the number of allocations
-       * for diagnostic purpose. When actually implementing a
-       * custom allocation, this information should be available
-       * from the allocator. 
-       */
+  /** 
+   * Helper providing a set of counters, each tied to a specific type. 
+   */
   class TypedCounter
     {
-        public:
-          template<class X>
-          size_t 
-          get()  const
-            {
-              UNIMPLEMENTED ("get typed count");
-            }
-          
-          template<class X>
-          void 
-          inc()
-            {
-              UNIMPLEMENTED ("increment typed count");
-            }
-          
-          template<class X>
-          void 
-          dec()
-            {
-              UNIMPLEMENTED ("decrement typed count");
-            }
+    public:
+      template<class X>
+      size_t 
+      get()  const
+        {
+          UNIMPLEMENTED ("get typed count");
+        }
+      
+      template<class X>
+      void 
+      inc()
+        {
+          UNIMPLEMENTED ("increment typed count");
+        }
+      
+      template<class X>
+      void 
+      dec()
+        {
+          UNIMPLEMENTED ("decrement typed count");
+        }
     };
   
-
+  
+  
 } // namespace lib
 #endif
diff --git a/tests/lib/typed-counter-test.cpp b/tests/lib/typed-counter-test.cpp
index e21272255..7335c9fed 100644
--- a/tests/lib/typed-counter-test.cpp
+++ b/tests/lib/typed-counter-test.cpp
@@ -24,17 +24,22 @@
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
 //#include "proc/control/command.hpp"
-#include "proc/control/typed-allocation-manager.hpp"
+#include "lib/typed-counter.hpp"
 //#include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
 //#include "lib/symbol.hpp"
+#include "lib/sync.hpp"
+#include "lib/scoped-ptrvect.hpp"
+#include "backend/thread-wrapper.hpp"
 #include "lib/util.hpp"
 
+#include <tr1/functional>
 
-#include <tr1/memory>
+//#include <tr1/memory>
 //#include <boost/ref.hpp>
 //#include <boost/format.hpp>
 //#include <iostream>
+#include <vector>
 #include <cstdlib>
 //#include <string>
 
@@ -47,14 +52,19 @@ namespace test{
 //  using boost::str;
   //using lumiera::Time;
   //using util::contains;
-  using std::tr1::shared_ptr;
-//  using std::tr1::bind;
+  using backend::Thread;
+  using backend::JoinHandle;
+//  using std::tr1::shared_ptr;
+  using std::tr1::bind;
+  using std::tr1::placeholders::_1;
 //  using std::string;
+  using std::vector;
   using std::rand;
   //using std::cout;
   //using std::endl;
 //  using lib::test::showSizeof;
-  using util::isSameObject;
+//  using util::isSameObject;
+  using util::for_each;
 //  using util::contains;
 
 //  using session::test::TestClip;
@@ -66,38 +76,256 @@ namespace test{
 //  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
   
   namespace { // test data and helpers...
-  
-    long checksum_ = 0;
-    
-    /**
-     * Yet-another fammily of dummy types....
-     */
-    template<uint siz>
-    class DummyType
+      
+      const uint MAX_FAMILIES   = 20;  ///< maximum separate "families", each sharing a TypedCounter
+      const uint MAX_MEMBERS    =  5;  ///< maximum members per family (member == test thread)
+      const uint MAX_ITERATIONS =  5;  ///< maximum iterations within a single test thread
+      const uint MAX_DELAY_ms   = 50;  ///< maximum delay between check iterations
+      
+      
+      /** 
+       * Interface to a family of dummy types
+       */
+      class DummyType
+        {
+        public:
+          virtual ~DummyType() { }
+          
+          /** core test operation: do a random increment or decrement
+           *  on the provided TypedCounter instance, and also save an
+           *  account to a local embedded checksum for verification */
+          virtual void doCount               (TypedCounter&)  =0;
+          
+          virtual void collect_externalCount (TypedCounter&)  =0;
+          virtual void collect_internalCount ()               =0;
+        };
+      
+      
+      /* === Checksums === */
+      
+      long sum_TypedCounter_;    ///< Sum1: calculated from TypedCounter
+      long sum_internal_;        ///< Sum2: control value calculated from Dummy::localChecksum_
+      
+      void
+      accountExternal (DummyType& target, TypedCounter& counter_to_use)
       {
-        char crap_[siz];
-      };
+        target.collect_externalCount (counter_to_use);
+      }
+      void
+      accountInternal (DummyType& target)
+      {
+        target.collect_internalCount();
+      }
+      
+      
+      /**
+       * To actually drive the TypedCounter invocations, we need a family
+       * of different (but of course related) types. Actually, we use these
+       * subclasses here also to carry out the invocations and the accounting
+       * to build up the checksums for verification.
+       */
+      template<uint i>
+      class Dummy
+        : public DummyType
+        , public lib::Sync<>
+        {
+          long localChecksum_;
+          
+          void
+          record_internal (int increment)
+            {
+              Lock protect(this);
+              localChecksum_ += increment;
+            }
+          
+          
+          void
+          doCount (TypedCounter& counter)
+            {
+              // note: deliberately *not* synchronised
+              
+              if (rand() % 2)
+                {
+                  counter.inc<Dummy>();
+                  record_internal (+1);
+                }
+              else
+                {
+                  counter.dec<Dummy>();
+                  record_internal (-1);
+                }
+            }
+          
+          void
+          collect_externalCount (TypedCounter& counter)
+            {
+              sum_TypedCounter_  += counter.get<Dummy>();
+            }
+          
+          void
+          collect_internalCount ()
+            {
+              sum_internal_ += localChecksum_;
+            }
+          
+        public:
+          Dummy() : localChecksum_(0) {}
+        };
+
+    
+      
+  
+        
+      
+      /** 
+       * Collection of target functions,
+       * to be invoked during the test run
+       */
+      struct DummyTarget
+        {
+          typedef ScopedPtrVect<DummyType> TargetVect;
+          
+          TargetVect targets_;
+          
+          DummyTarget ()
+            : targets_(10)
+            {
+              targets_.manage(new Dummy<0>);
+              targets_.manage(new Dummy<1>);
+              targets_.manage(new Dummy<2>);
+              targets_.manage(new Dummy<3>);
+              targets_.manage(new Dummy<4>);
+              targets_.manage(new Dummy<5>);
+              targets_.manage(new Dummy<6>);
+              targets_.manage(new Dummy<7>);
+              targets_.manage(new Dummy<8>);
+              targets_.manage(new Dummy<9>);
+            }
+          
+          
+          /** entry point for the SingleCheck instances
+           *  to trigger off a single invocation
+           */
+          void
+          torture (TypedCounter& counter_to_use)
+            {
+              uint victim = (rand() % 10);
+              targets_[victim].doCount (counter_to_use);
+            }
+          
+          /** allow Iteration over all targets in the TargetVect */
+          TargetVect::iterator begin() { return targets_.begin(); }
+          TargetVect::iterator end()   { return targets_.end();   }
+        };
+      
+      DummyTarget targetCollection; 
+      
+      
+      
+      /**
+       * Each single check runs in a separate thread
+       * and performs a random sequence of increments
+       * and decrements on random targets. 
+       */
+      class SingleCheck
+        : JoinHandle,
+          Thread
+        {
+          TypedCounter& counterSet_;
+          long localChecksum_;
+          
+        public:
+          SingleCheck (TypedCounter& counter_to_use)
+            : Thread("TypedCounter_test worker Thread",
+                     bind (&SingleCheck::runCheckSequence, this, (rand() % MAX_ITERATIONS)),
+                     (backend::JoinHandle&)*this 
+                    )
+            , counterSet_(counter_to_use)
+            , localChecksum_(0)
+            { }
+          
+         ~SingleCheck () { this->join(); }
+          
+          
+        private:
+          void runCheckSequence(uint iterations)
+            {
+              while (--iterations)
+                {
+                  usleep (1000 * (rand() % MAX_DELAY_ms));
+                  targetCollection.torture (counterSet_);
+            }   }
+        };
+      
+      
+      /** 
+       * Family of individual checks, sharing
+       * a common TypedCounter instance.
+       */
+      struct TestFamily
+        {
+          ScopedPtrVect<SingleCheck> checks_;
+          TypedCounter ourCounter_;
+          
+          TestFamily()
+            : checks_(MAX_MEMBERS)
+            {
+              uint members (1 + rand() % MAX_MEMBERS);
+              while (members--)
+                checks_.manage (new SingleCheck (ourCounter_));
+            }
+          
+          void
+          account()
+            {
+              for_each ( targetCollection
+                       , bind (accountExternal, _1, ourCounter_)
+                       );
+            }
+        };
+      
+      
+      /** a series of independent context sets */
+      typedef ScopedPtrVect<TestFamily> FamilyTable;
+      
   }
   
   
   
   /***************************************************************************************
-   * @test cover the basic implementation of a custom allocator, delegating to mpool.
-   *       TypedAllocationManager is a base class, used e.g. to build the CommandRegistry.
+   * @test build multiple sets of type-based contexts and run a simple counting operation
+   *       in each of them concurrently. Check the proper allocation of type-IDs in each
+   *       context and verify correct counting operation by checksum.
    * 
-   * @todo planned but not implemented as of 8/09   see also Ticket #217
+   * @todo using currently (9/09) a simple implementation based on static variables.
+   *       This causes waste of storage for the type-based tables. It would be better
+   *       if each set would build it's own Type-IDs. Ticket #
    *        
-   * @see CommandRegistry
-   * @see command-registry-test.cpp
-   * @see allocationclustertest.cpp
+   * @see TypedAllocationManager
+   * @see typed-counter.hpp
    */
   class TypedCounter_test : public Test
     {
       
-      virtual void
+      void
       run (Arg) 
         {
-          UNIMPLEMENTED ("type based contexts");
+          sum_TypedCounter_ = 0;
+          sum_internal_     = 0;
+          
+          uint num_Families (1 + rand() % MAX_FAMILIES);
+          
+          FamilyTable testFamilies(num_Families);
+          for (uint i=0; i<num_Families; ++i)
+            testFamilies.manage (new TestFamily);
+          
+          testFamilies.clear(); // blocks until all threads have terminated
+          
+          for (uint i=0; i<num_Families; ++i)
+            testFamilies[i].account();
+          for_each (targetCollection, accountInternal);
+          
+          ASSERT (sum_TypedCounter_ == sum_internal_);
         }
     };
   

From 373f9a5724986dc8a8ce557deb707cbae42f14ef Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 27 Sep 2009 15:27:07 +0200
Subject: [PATCH 316/368] fix Ticket #272 (synchronisation from const methods)

---
 src/lib/sync.hpp | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/lib/sync.hpp b/src/lib/sync.hpp
index d7afce536..d62960a94 100644
--- a/src/lib/sync.hpp
+++ b/src/lib/sync.hpp
@@ -387,10 +387,10 @@ namespace lib {
     class Sync
       {
         typedef sync::Monitor<CONF> Monitor;
-        Monitor objectMonitor_;
+        mutable Monitor objectMonitor_;
         
         static Monitor&
-        getMonitor(Sync* forThis)
+        getMonitor(const Sync* forThis)
           {
             REQUIRE (forThis);
             return forThis->objectMonitor_;

From f6397ef11c844836598eaf75609c4a32998889e3 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 27 Sep 2009 17:29:05 +0200
Subject: [PATCH 317/368] implemented TypedCounter and TypedContext. Test
 basically pass, but shows an interesting deadlock from time to time

---
 src/lib/typed-counter.hpp        | 107 +++++++++++++++++++++++++----
 src/lib/visitor-dispatcher.hpp   |   1 -
 tests/lib/typed-counter-test.cpp | 114 ++++++++++++++++++++-----------
 3 files changed, 167 insertions(+), 55 deletions(-)

diff --git a/src/lib/typed-counter.hpp b/src/lib/typed-counter.hpp
index e90490382..8b7ca90a7 100644
--- a/src/lib/typed-counter.hpp
+++ b/src/lib/typed-counter.hpp
@@ -30,7 +30,7 @@
  ** typically will utilise different sets of types.
  ** @todo WIP WIP... this is the first, preliminary version of a facility,
  **       which is expected to get quite important for custom allocation management.
-  ** 
+ ** 
  ** @see typed-counter-test.cpp
  ** @see TypedAllocationManager
  ** @see AllocationCluster (custom allocation scheme using a similar idea inline)
@@ -44,47 +44,128 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
-//#include "lib/format.hpp"
-//#include "include/logging.h"
+#include "lib/sync-classlock.hpp"
 
-
-//#include <tr1/memory>
+#include <vector>
 
 
 
 namespace lib {
   
-//using std::tr1::shared_ptr;
+  using std::vector;
+  
+  
+  /** 
+   * Providing type-IDs for a specific context.
+   * This facility allows to access a numeric ID for each
+   * provided distinct type. Type-IDs may be used e.g. for
+   * dispatcher tables or for custom allocators. 
+   * The type-IDs generated here are not completely global though.
+   * Rather, they are tied to a specific type context, e.g. a class
+   * implementing a custom allocator.
+   */
+  template<class CX>
+  class TypedContext
+    {
+      static size_t lastGeneratedTypeID;
+      
+    public:
+      static size_t
+      newTypeID (size_t& typeID)
+        {
+          ClassLock<TypedContext> synchronised();
+          if (!typeID)
+            typeID = ++lastGeneratedTypeID;
+          return typeID;
+        }
+      
+      /** type-ID */
+      template<typename TY>
+      class ID
+        {
+          static size_t typeID;
+          
+        public:
+          static size_t
+          get()
+            {
+              if (typeID)
+                return typeID;
+              else
+                return newTypeID(typeID);
+            }
+        };
+    };
+  
+  /** storage for the type-ID generation mechanism */
+  template<class CX>
+  size_t TypedContext<CX>::lastGeneratedTypeID (0);
+  
+  /** table holding all the generated type-IDs */
+  template<class CX>
+  template<typename TY>
+  size_t TypedContext<CX>::ID<TY>::typeID (0);
   
   
   
   
   /** 
-   * Helper providing a set of counters, each tied to a specific type. 
+   * Helper providing a set of counters, each tied to a specific type.
    */
   class TypedCounter
+    : public Sync<>
     {
+      mutable vector<long> counters_;
+      
+      template<typename TY>
+      size_t
+      slot()  const
+        {
+          size_t typeID = TypedContext<TypedCounter>::ID<TY>::get();
+          if (size() < typeID)
+            counters_.resize (typeID);
+          
+          ENSURE (counters_.capacity() >= typeID);
+          return (typeID - 1);
+        }
+      
+      
     public:
+      TypedCounter()
+        {
+          counters_.reserve(5);  // pre-allocated 5 slots
+        }
+      
+      
       template<class X>
-      size_t 
+      long 
       get()  const
         {
-          UNIMPLEMENTED ("get typed count");
+          Lock sync(this);
+          return counters_[slot<X>()];
         }
       
       template<class X>
-      void 
+      long 
       inc()
         {
-          UNIMPLEMENTED ("increment typed count");
+          Lock sync(this);
+          return ++counters_[slot<X>()];
         }
       
       template<class X>
-      void 
+      long 
       dec()
         {
-          UNIMPLEMENTED ("decrement typed count");
+          Lock sync(this);
+          return --counters_[slot<X>()];
         }
+      
+      
+      /* == diagnostics == */
+      
+      size_t size() const { return counters_.size(); }
+      bool empty()  const { return counters_.empty();}
     };
   
   
diff --git a/src/lib/visitor-dispatcher.hpp b/src/lib/visitor-dispatcher.hpp
index 4ec682ea4..c0b60c997 100644
--- a/src/lib/visitor-dispatcher.hpp
+++ b/src/lib/visitor-dispatcher.hpp
@@ -60,7 +60,6 @@ namespace visitor {
     size_t tagID; ///< tag value
     static size_t lastRegisteredID;
     
-  private:
     static void
     generateID (size_t& id)
       {
diff --git a/tests/lib/typed-counter-test.cpp b/tests/lib/typed-counter-test.cpp
index 7335c9fed..60f712a27 100644
--- a/tests/lib/typed-counter-test.cpp
+++ b/tests/lib/typed-counter-test.cpp
@@ -21,66 +21,59 @@
 * *****************************************************/
 
 
+/** @file typed-counter-test.cpp
+ ** Stress test to verify type-based contexts.
+ ** Besides a simple usage (unit) test, this test performs a massively multithreaded
+ ** test of the type-based contexts, through use of the TypedCounter. The idea behind
+ ** this facility is to provide a context, in which type-IDs can be allocated. In the
+ ** case of the TypedCounter, these type-IDs are used to index into a vector of counters,
+ ** this way allowing to access a counter for a given type.
+ ** <P>
+ ** This test builds several "families", which each share a TypedCounter. Each of these
+ ** families runs a set of member threads, which concurrently access the TypedCounter of
+ ** this family. After waiting for all threads to finish, we compare the checksum built
+ ** within the target objects with the checksum collected through the TypedCounters.
+ ** 
+ ** @see thread-wrapper-test.cpp
+ ** @see thread-wrapper-join-test.cpp
+ **
+ */
+
+
+
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/control/command.hpp"
 #include "lib/typed-counter.hpp"
-//#include "proc/control/command-def.hpp"
-//#include "lib/lumitime.hpp"
-//#include "lib/symbol.hpp"
-#include "lib/sync.hpp"
 #include "lib/scoped-ptrvect.hpp"
 #include "backend/thread-wrapper.hpp"
+#include "lib/sync.hpp"
 #include "lib/util.hpp"
 
 #include <tr1/functional>
-
-//#include <tr1/memory>
-//#include <boost/ref.hpp>
-//#include <boost/format.hpp>
-//#include <iostream>
 #include <vector>
 #include <cstdlib>
-//#include <string>
 
 
 namespace lib {
 namespace test{
-
-
-//  using boost::format;
-//  using boost::str;
-  //using lumiera::Time;
-  //using util::contains;
+  
+  
   using backend::Thread;
   using backend::JoinHandle;
-//  using std::tr1::shared_ptr;
+  using util::for_each;
+  using util::isnil;
   using std::tr1::bind;
   using std::tr1::placeholders::_1;
-//  using std::string;
   using std::vector;
   using std::rand;
-  //using std::cout;
-  //using std::endl;
-//  using lib::test::showSizeof;
-//  using util::isSameObject;
-  using util::for_each;
-//  using util::contains;
-
-//  using session::test::TestClip;
-//  using lib::Symbol;
-//  using lumiera::P;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
-  
   namespace { // test data and helpers...
       
       const uint MAX_FAMILIES   = 20;  ///< maximum separate "families", each sharing a TypedCounter
       const uint MAX_MEMBERS    =  5;  ///< maximum members per family (member == test thread)
       const uint MAX_ITERATIONS =  5;  ///< maximum iterations within a single test thread
-      const uint MAX_DELAY_ms   = 50;  ///< maximum delay between check iterations
+      const uint MAX_DELAY_ms   =  3;  ///< maximum delay between check iterations
       
       
       /** 
@@ -159,6 +152,7 @@ namespace test{
           void
           collect_externalCount (TypedCounter& counter)
             {
+              // Lock not necessary, because of invocation sequence
               sum_TypedCounter_  += counter.get<Dummy>();
             }
           
@@ -171,11 +165,11 @@ namespace test{
         public:
           Dummy() : localChecksum_(0) {}
         };
-
-    
       
-  
-        
+      
+      
+      
+      
       
       /** 
        * Collection of target functions,
@@ -264,8 +258,8 @@ namespace test{
        */
       struct TestFamily
         {
-          ScopedPtrVect<SingleCheck> checks_;
           TypedCounter ourCounter_;
+          ScopedPtrVect<SingleCheck> checks_;
           
           TestFamily()
             : checks_(MAX_MEMBERS)
@@ -275,6 +269,12 @@ namespace test{
                 checks_.manage (new SingleCheck (ourCounter_));
             }
           
+         ~TestFamily()
+            {
+              checks_.clear(); // blocks until all test threads finished
+              account();
+            }
+          
           void
           account()
             {
@@ -309,6 +309,41 @@ namespace test{
       
       void
       run (Arg) 
+        {
+          simpleUsageTest();
+          tortureTest();
+        }
+      
+      
+      void
+      simpleUsageTest ()
+        {
+          TypedCounter myCounter;
+          ASSERT (isnil (myCounter));
+          ASSERT (0==myCounter.size());
+          
+          ASSERT (0 == myCounter.get<short>());
+          ASSERT (1 == myCounter.size());
+          
+          ASSERT (0 == myCounter.get<long>());
+          ASSERT (2 == myCounter.size());
+          
+          ASSERT (-1 == myCounter.dec<short>());
+          ASSERT (-2 == myCounter.dec<short>());
+          ASSERT (+1 == myCounter.inc<long>());
+          
+          ASSERT (-2 == myCounter.get<short>());
+          ASSERT (+1 == myCounter.get<long>());
+          
+          
+          ASSERT (1 == TypedContext<TypedCounter>::ID<short>::get());
+          ASSERT (2 == TypedContext<TypedCounter>::ID<long>::get());
+          ASSERT (2 == myCounter.size());
+        }
+      
+      
+      void 
+      tortureTest () 
         {
           sum_TypedCounter_ = 0;
           sum_internal_     = 0;
@@ -321,10 +356,7 @@ namespace test{
           
           testFamilies.clear(); // blocks until all threads have terminated
           
-          for (uint i=0; i<num_Families; ++i)
-            testFamilies[i].account();
           for_each (targetCollection, accountInternal);
-          
           ASSERT (sum_TypedCounter_ == sum_internal_);
         }
     };

From 9376bff71ef0476fdaed87c0fed728b7c8dfd547 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 28 Sep 2009 17:54:50 +0200
Subject: [PATCH 318/368] race fixed, test pass

---
 src/backend/thread-wrapper.hpp   |  8 +++-----
 tests/40components.tests         |  2 +-
 tests/lib/typed-counter-test.cpp | 34 +++++++++++++-------------------
 3 files changed, 18 insertions(+), 26 deletions(-)

diff --git a/src/backend/thread-wrapper.hpp b/src/backend/thread-wrapper.hpp
index 23c553724..730b4338b 100644
--- a/src/backend/thread-wrapper.hpp
+++ b/src/backend/thread-wrapper.hpp
@@ -62,12 +62,11 @@ namespace backend {
    * wait state, the contained mutex remains locked and prevents the thread
    * manager from invoking the broadcast() on the condition var. 
    * 
-   * @note this is a draft. It doesn't even work, because Cehteh is still planning
-   *       details of the thread handling and didn't implement the waiting feature. 
+   * @see thread-wrapper-join-test.cpp 
    */
   class JoinHandle
     : public Sync<RecursiveLock_Waitable>
-    , Sync<RecursiveLock_Waitable>::Lock
+    , Sync<RecursiveLock_Waitable>::Lock   // noncopyable, immediately acquire the lock
     {
       typedef Sync<RecursiveLock_Waitable> SyncBase;
       
@@ -95,8 +94,7 @@ namespace backend {
               isWaiting_ = true;
               return false; // causes entering the blocking wait
             }
-          TODO ("any possibility to detect spurious wakeups? can they happen?");
-          return true; // causes end of the blocking wait
+          return true;    //   causes end of blocking wait
         }
       
       
diff --git a/tests/40components.tests b/tests/40components.tests
index 63db0fb3a..c7efedcf3 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -848,7 +848,7 @@ return: 0
 END
 
 
-PLANNED "building type based contexts" TypedCounter_test <<END
+TEST "Type-based contexts" TypedCounter_test <<END
 return: 0
 END
 
diff --git a/tests/lib/typed-counter-test.cpp b/tests/lib/typed-counter-test.cpp
index 60f712a27..e60697205 100644
--- a/tests/lib/typed-counter-test.cpp
+++ b/tests/lib/typed-counter-test.cpp
@@ -29,7 +29,7 @@
  ** case of the TypedCounter, these type-IDs are used to index into a vector of counters,
  ** this way allowing to access a counter for a given type.
  ** <P>
- ** This test builds several "families", which each share a TypedCounter. Each of these
+ ** This test builds several "families", each sharing a TypedCounter. Each of these
  ** families runs a set of member threads, which concurrently access the TypedCounter of
  ** this family. After waiting for all threads to finish, we compare the checksum built
  ** within the target objects with the checksum collected through the TypedCounters.
@@ -62,8 +62,9 @@ namespace test{
   using backend::JoinHandle;
   using util::for_each;
   using util::isnil;
-  using std::tr1::bind;
   using std::tr1::placeholders::_1;
+  using std::tr1::bind;
+  using std::tr1::ref;
   using std::vector;
   using std::rand;
   
@@ -71,8 +72,8 @@ namespace test{
   namespace { // test data and helpers...
       
       const uint MAX_FAMILIES   = 20;  ///< maximum separate "families", each sharing a TypedCounter
-      const uint MAX_MEMBERS    =  5;  ///< maximum members per family (member == test thread)
-      const uint MAX_ITERATIONS =  5;  ///< maximum iterations within a single test thread
+      const uint MAX_MEMBERS    = 30;  ///< maximum members per family (member == test thread)
+      const uint MAX_ITERATIONS = 50;  ///< maximum iterations within a single test thread
       const uint MAX_DELAY_ms   =  3;  ///< maximum delay between check iterations
       
       
@@ -225,30 +226,27 @@ namespace test{
         : JoinHandle,
           Thread
         {
-          TypedCounter& counterSet_;
-          long localChecksum_;
-          
         public:
           SingleCheck (TypedCounter& counter_to_use)
-            : Thread("TypedCounter_test worker Thread",
-                     bind (&SingleCheck::runCheckSequence, this, (rand() % MAX_ITERATIONS)),
-                     (backend::JoinHandle&)*this 
+            : Thread("TypedCounter_test worker Thread"
+                    , bind (&SingleCheck::runCheckSequence, this, ref(counter_to_use), (rand() % MAX_ITERATIONS))
+                    , (backend::JoinHandle&)*this 
                     )
-            , counterSet_(counter_to_use)
-            , localChecksum_(0)
             { }
           
          ~SingleCheck () { this->join(); }
           
           
         private:
-          void runCheckSequence(uint iterations)
+          void runCheckSequence(TypedCounter& counter, uint iterations)
             {
-              while (--iterations)
+              do
                 {
                   usleep (1000 * (rand() % MAX_DELAY_ms));
-                  targetCollection.torture (counterSet_);
-            }   }
+                  targetCollection.torture (counter);
+                }
+              while (iterations--);
+            }
         };
       
       
@@ -297,10 +295,6 @@ namespace test{
    *       in each of them concurrently. Check the proper allocation of type-IDs in each
    *       context and verify correct counting operation by checksum.
    * 
-   * @todo using currently (9/09) a simple implementation based on static variables.
-   *       This causes waste of storage for the type-based tables. It would be better
-   *       if each set would build it's own Type-IDs. Ticket #
-   *        
    * @see TypedAllocationManager
    * @see typed-counter.hpp
    */

From 337077d6176468eaa76d72d3c550a6c57ec53a7f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 02:29:27 +0200
Subject: [PATCH 319/368] random seed to improve coverage when run standalone

---
 tests/lib/typed-counter-test.cpp | 1 +
 1 file changed, 1 insertion(+)

diff --git a/tests/lib/typed-counter-test.cpp b/tests/lib/typed-counter-test.cpp
index e60697205..9dc43f366 100644
--- a/tests/lib/typed-counter-test.cpp
+++ b/tests/lib/typed-counter-test.cpp
@@ -339,6 +339,7 @@ namespace test{
       void 
       tortureTest () 
         {
+          std::srand (time (NULL));
           sum_TypedCounter_ = 0;
           sum_internal_     = 0;
           

From 777e80dd64f3baf4a74f0d5a68e86698fa59e74e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 04:46:44 +0200
Subject: [PATCH 320/368] use BoolCheckable instead of explicit operator bool()

---
 src/lib/singleton-ref.hpp | 21 +++++++--------------
 1 file changed, 7 insertions(+), 14 deletions(-)

diff --git a/src/lib/singleton-ref.hpp b/src/lib/singleton-ref.hpp
index 1adf14698..48e74635c 100644
--- a/src/lib/singleton-ref.hpp
+++ b/src/lib/singleton-ref.hpp
@@ -24,7 +24,7 @@
  ** Helper for singleton-kind access without managing object creation and lifecycle. 
  ** A typical usage scenario is when implementing C Language Interfaces without any
  ** canonical access to some "this" pointer.  
- **
+ ** 
  ** @see gui::NotificationService usage example
  */
 
@@ -34,12 +34,13 @@
 
 
 #include "lib/error.hpp"
+#include "lib/bool-checkable.hpp"
 
 #include <boost/noncopyable.hpp>
 
 
 namespace lib {
-
+  
   namespace singleton {
   
     /***************************************
@@ -48,7 +49,8 @@ namespace lib {
      */
     template<class TY>
     class AccessAsReference
-      : boost::noncopyable
+      : public lib::BoolCheckable<AccessAsReference<TY>
+             , boost::noncopyable>
       {
         TY* obj_;
         
@@ -72,22 +74,13 @@ namespace lib {
         TY* 
         operator-> ()  const
           {
-            if (!obj_)
+            if (!isValid())
               throw lumiera::error::State("Target currently not available.");
             return obj_;
           }
         
         
-        typedef TY* _ThisType::*unspecified_bool_type;
-        
-        /** implicit conversion to "bool" */
-        operator unspecified_bool_type()  const // never throws
-          {
-            return obj_?  &_ThisType::obj_ : 0;
-          }
-        
-        bool operator! ()  const { return !obj_; }
-        
+        bool isValid()  const { return obj_; }
       };
     
   } // namespace Singleton

From da8be6861c61a200060a573ac254b2e2d92988bd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 04:47:09 +0200
Subject: [PATCH 321/368] WIP some musing about opening the session interface

---
 src/proc/control/handling-patterns.hpp |  3 +-
 src/proc/control/proc-dispatcher.cpp   | 56 ++++++++++++++++++++++++++
 src/proc/control/proc-dispatcher.hpp   | 12 ++++++
 3 files changed, 69 insertions(+), 2 deletions(-)

diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index f4d62cc7b..dc35d7ea4 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -47,7 +47,6 @@
 #include "lib/singleton-subclass.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/command-impl.hpp"
-#include "proc/mobject/session.hpp"
 #include "include/lifecycle.h"
 //#include "lib/symbol.hpp"
 
@@ -187,7 +186,7 @@ namespace control {
     }
     
     
-    lumiera::LifecycleHook _schedule (mobject::ON_SESSION_START, &prepareCommandHandlingPatterns);
+    lumiera::LifecycleHook _schedule (lumiera::ON_GLOBAL_INIT, &prepareCommandHandlingPatterns);
   
   } // (END) definition of concrete handling patterns
   
diff --git a/src/proc/control/proc-dispatcher.cpp b/src/proc/control/proc-dispatcher.cpp
index a20fabe90..6d2a8e41c 100644
--- a/src/proc/control/proc-dispatcher.cpp
+++ b/src/proc/control/proc-dispatcher.cpp
@@ -23,6 +23,8 @@
 
 
 #include "proc/control/proc-dispatcher.hpp"
+#include "proc/mobject/session.hpp"
+#include "include/logging.h"
 //#include "proc/mobject/mobject-ref.hpp"
 //#include "proc/mobject/mobject.hpp"
 //#include "proc/mobject/placement.hpp"
@@ -32,7 +34,61 @@
 
 namespace control {
   
+  
+  namespace {
+  
+    /** when session gets ready,
+     *  open the command processing interface.
+     */
+    void
+    activateCommandProcessing()
+    {
+      ProcDispatcher::instance().activate();
+    }
+    
+    
+    lumiera::LifecycleHook _schedule (mobject::ON_SESSION_INIT, &activateCommandProcessing);
+  
+  }
+  
+  /** storage for Singleton access */
+  lumiera::Singleton<ProcDispatcher> ProcDispatcher::instance;
+  
+  
+  
   /** */
+  void
+  ProcDispatcher::activate()
+  {
+    INFO (command, "Session command processing activated.");
+    TODO ("implement command processing queue");
+  }
+  
+  
+  void
+  ProcDispatcher::deactivate()
+  {
+    INFO (command, "Session command interface closed.");
+    TODO ("implement command processing queue");
+  }
+
+  
+  void
+  ProcDispatcher::clear()
+  {
+    if (!empty())
+      WARN (command, "DISCARDING pending Session commands.");
+    TODO ("implement command processing queue");
+  }
+  
+  
+  bool
+  ProcDispatcher::empty()  const
+  {
+    TODO ("implement command processing queue");
+    return true;
+  }
+
   
   
   
diff --git a/src/proc/control/proc-dispatcher.hpp b/src/proc/control/proc-dispatcher.hpp
index 61352bc47..02227d6b2 100644
--- a/src/proc/control/proc-dispatcher.hpp
+++ b/src/proc/control/proc-dispatcher.hpp
@@ -38,6 +38,7 @@
 //#include "pre.hpp"
 //#include "lib/symbol.hpp"
 #include "proc/control/command.hpp"
+#include "lib/singleton.hpp"
 
 //#include <tr1/memory>
 
@@ -56,6 +57,17 @@ namespace control {
     {
       
     public:
+      static lumiera::Singleton<ProcDispatcher> instance;
+      
+      void activate();
+      void deactivate();
+      void clear();
+      
+      
+      /* == diagnostics == */
+      
+//    size_t size() const ;
+      bool empty()  const ;
       
     };
   ////////////////TODO currently just fleshing  out the API....

From 843f44795eb1504ef73e82e1a7228693fb16897a Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 16:38:01 +0200
Subject: [PATCH 322/368] Bring the design- pages up-to date. Document design
 decisions more clearly

---
 wiki/renderengine.html | 32 ++++++++++++++++++++------------
 1 file changed, 20 insertions(+), 12 deletions(-)

diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index b36adb355..9a2e98214 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1167,6 +1167,9 @@ This is an very important external Interface, because it links together all thre
 * completely hide the Session object behind a ''~PImpl'' smart pointer, so the session object can be switched when reloading.
 * the [[Fixture]] acts as isolation layer, and all objects refered from the Fixture are refcounting smart pointers. So, even when the session gets switched, the old objects remain valid as long as needed.</pre>
 </div>
+<div title="DataFrame" modifier="Ichthyostega" created="200909291346" tags="def spec" changecount="1">
+<pre>A ''frame of data'' is the central low-level abstraction when dealing with media data and media processing.</pre>
+</div>
 <div title="DefaultTiddlers" modifier="Ichthyostega" modified="200802031805" created="200706172308" changecount="6">
 <pre>[[ProcLayer and Engine]]
 </pre>
@@ -1201,12 +1204,12 @@ As we don't have a Prolog interpreter on board yet, we utilize a mock store with
 {{{default(Obj)}}} is a predicate expressing that the object {{{Obj}}} can be considered the default setup under the given conditions. Using the //default// can be considered as a shortcut for actually finding a exact and unique solution. The latter would require to specify all sorts of detailed properties up to the point where only one single object can satisfy all conditions. On the other hand, leaving some properties unspecified would yield a set of solutions (and the user code issuing the query had to provide means for selecting one soltution from this set). Just falling back on the //default// means that the user code actually doesn't care for any additional properties (as long as the properties he //does// care for are satisfied). Nothing is said specifically on //how//&amp;nbsp; this default gets configured; actually there can be rules //somewhere,// and, additionally, anything encountered once while asking for a default can be re-used as default under similar circumstances.
 &amp;rarr; [[implementing defaults|DefaultsImplementation]]</pre>
 </div>
-<div title="DesignDecisions" modifier="Ichthyostega" modified="200809230234" created="200801062209" tags="decision design discuss" changecount="20">
+<div title="DesignDecisions" modifier="Ichthyostega" modified="200909291401" created="200801062209" tags="decision design discuss" changecount="24">
 <pre>Along the way of working out various [[implementation details|ImplementationDetails]], decisions need to be made on how to understand the different facilities and entities and how to tackle some of the problems. This page is mainly a collection of keywords, summaries and links to further the discussion. And the various decisions should allways be read as proposals to solve some problem at hand...
 
-''Everything is an object'' &amp;mdash; of course, that's a //no-brainer // todays. Rather, important is what is not &quot;an object&quot;, meaning it can't be arranged arbitrarily
-* we have one and only one global [[Session]] which directly contains a collection of multiple [[EDLs|EDL]] and is associated with a globally managed collection of [[assets|Asset]] (no, we don't have scoped variables here; if e.g. a media has been &quot;opened&quot;, it is just plain globally known as asset.)
-* we have some global [[pipes|Pipe]], which are treated in a unique manner and don't behave like other objects (e.g. effects)
+''Everything is an object'' &amp;mdash; of course, that's a //no-brainer,// todays. Rather, important is what is not &quot;an object&quot;, meaning it can't be arranged arbitrarily
+* we have one and only one global [[Session]] which directly contains a collection of multiple [[Sequences|EDL]] and is associated with a globally managed collection of [[assets|Asset]]. We don't utilise scoped variables here (no &quot;mandantisation&quot;); if e.g. a media has been //opened,// it is just plain //globally known//&amp;nbsp; as asset.
+* the [[knowledge base|ConfigRules]] is just available globally. Obviously, the session gets a chance to install rules into this knowledge base, but we don't stress ownership here.
 * we have a [[Fixture]] which acts as isolation layer towards the render engine and is (re)built automatically.
 
 We ''separate'' processing (rendering) and configuration (building). We have a [[Builder]] which creates a network of [[render nodes|ProcNode]], to be processed by //pulling data // from some [[Pipe]]
@@ -1214,6 +1217,8 @@ We ''separate'' processing (rendering) and configuration (building). We have a [
 ''Objects are [[placed|Placement]] rather'' than assembled, connected, wired, attached. This is more of a rule-based approach and gives us one central metaphor and abstraction, allowing us to treat everything in an uniform manner. You can place it as you like, and the builder tries to make sense out of it, silently disabling what doesn't make sense.
 An [[EDL]] is just a collection of configured and placed objects (and has no additional, fixed structure). [[Tracks|Track]] form a mere organisational grid, they are grouping devices not first-class entities (a track doesn't &quot;have&quot; a pipe or &quot;is&quot; a video track and the like; it can be configured to behave in such manner by using placements though). [[Pipes|Pipe]] are hooks for making connections and are the only facility to build processing chains. We have global pipes, and each clip is built around a lokal [[source port|ClipSourcePort]] &amp;mdash; and that's all. No special &quot;media viewer&quot; and &quot;arranger&quot;, no special role for media sources, no commitment to some fixed media stream types (video and audio). All of this is sort of pushed down to be configuration, represented as asset of some kind. For example, we have [[processing pattern|ProcPatt]] assets to represent the way of building the source network for reading from some media file (including codecs treated like effect plugin nodes)
 
+Actual ''media data and handling'' is abstracted rigorously. Media is conceived as being stream-like data of distinct StreamType. When it comes to more low-level media handling, we build on the DataFrame abstraction. Media processing isn't the focus of Lumiera; we organise the processing but otherwise ''rely on media handling libraries.'' In a similar vein, multiplicity is understood as type variation. Consequently, we don't build an audio and video &quot;section&quot; and we don't even have audio tracks and video tracks. Lumiera uses tracks and clips, and clips build on media, but we're able to deal with multichannel mixed-typed media.
+
 ''State'' is rigorously ''externalized'' and operations are to be ''scheduled'', to simplify locking and error handling. State is either treated similar to media stream data (as addressable and cacheable data frame), or is represented as &quot;parameter&quot; to be served by some [[parameter provider|ParamProvider]]. Consequently, [[Automation]] is just another kind of parameter, i.e. a function &amp;mdash; how this function is calculated is an encapsulated implementation detail (we don't have &quot;bezier automation&quot;, and then maybe a &quot;linear automation&quot;, a &quot;mask automation&quot; and yet another way to handle transitions)
 
 Deliberately there is an limitaion on the flexibility of what can be added to the system via Plugins. We allow configuration and parametrisation to be extended and we allow processing and data handling to be extended, but we disallow extensions to the fundamental structure of the system by plugins. They may provide new implementations for already known subsystems, but they can't introduce new subsystems not envisioned in the general design of the application.
@@ -1420,10 +1425,10 @@ Some further details
 
 As the builder and thus render engine //only consults the fixture,// while all editing operations finally propagate to the fixture as well, we get an isolation layer between the high level part of the Proc layer (editing, object manipulation) and the render engine. Creating the Fixture can be seen as a preprocessing step to simplify the build process. For this reason, the process of [[(re)building the fixture|PlanningBuildFixture]] has been designed together with the [[Builder]]</pre>
 </div>
-<div title="Frame" modifier="Ichthyostega" modified="200706220333" created="200706220332" tags="def" changecount="2">
+<div title="Frame" modifier="Ichthyostega" modified="200909291345" created="200706220332" tags="def" changecount="3">
 <pre>This term has //two meanings, //so care has to be taken for not confusing them.
 # in general use, a Frame means one full image of a video clip, i.e an array of rows of pixels. For interlaced footage, one Frame contains two halfimages, commonly called Fields. (Cinelerra2 confuses this terms)
-# here in this design, we use Frame as an abstraction for a buffer of raw media data to be processed. If in doubt, we should label this &quot;Dataframe&quot;.
+# here in this design, we use Frame as an abstraction for a buffer of raw media data to be processed. If in doubt, we should label this &quot;DataFrame&quot;.
 #* one video Dataframe contains a single video frame
 #* one audio Dataframe contains a block of raw audio samples
 #* one OpenGL Dataframe could contain raw texture data (but I am lacking expertise for this topic)
@@ -1601,7 +1606,7 @@ Besides routing to a global pipe, wiring plugs can also connect to the source po
 Finally, this example shows an ''automation'' data set controlling some parameter of an effect contained in one of the global pipes. From the effect's POV, the automation is simply a ParamProvider, i.e a function yielding a scalar value over time. The automation data set may be implemented as a bézier curve, or by a mathematical function (e.g. sine or fractal pseudo random) or by some captured and interpolated data values. Interestingly, in this example the automation data set has been placed relatively to the meta clip (albeit on another track), thus it will follow and adjust when the latter is moved.
 </pre>
 </div>
-<div title="ImplementationDetails" modifier="Ichthyostega" modified="200904252305" created="200708080322" tags="overview" changecount="33">
+<div title="ImplementationDetails" modifier="Ichthyostega" modified="200909291328" created="200708080322" tags="overview" changecount="35">
 <pre>This wiki page is the entry point to detail notes covering some technical decisions, details and problems encountered in the course of the implementation of the Lumiera Renderengine, the Builder and the related parts.
 
 * [[Packages, Interfaces and Namespaces|InterfaceNamespaces]]
@@ -1625,11 +1630,13 @@ Finally, this example shows an ''automation'' data set controlling some paramete
 * how to [[start the GUI|GuiStart]] and how to [[communicate|GuiCommunication]]
 * build the first LayerSeparationInterfaces
 * decide on SessionInterface and create [[Session datastructure layout|SessionDataMem]]
-</pre>
+* shaping the GUI/~Proc-Interface, based on MObjectRef and the [[Command frontend|CommandHandling]]</pre>
 </div>
-<div title="ImplementationGuidelines" modifier="Ichthyostega" modified="200906060443" created="200711210531" tags="discuss draft" changecount="12">
+<div title="ImplementationGuidelines" modifier="Ichthyostega" modified="200909291414" created="200711210531" tags="discuss draft" changecount="15">
 <pre>!Observations, Ideas, Proposals
-''this page is a scrapbook for collecting ideas'' &amp;mdash; please don't take anything noted here too literal. While writing code, I observe that I (ichthyo) follow certain informal guidelines, some of which I'd like to note down because they could evolve into general style guidelines for the proc layer code.
+''this page is a scrapbook for collecting ideas'' &amp;mdash; please don't take anything noted here too literal. While writing code, I observe that I (ichthyo) follow certain informal guidelines, some of which I'd like to note down because they could evolve into general style guidelines for the Proc-Layer code.
+* ''Inversion of Control'' is the leading design principle.
+* but deliberately we stay just below the level of using Dependency Injection. Singletons and call-by-name are good enough. We're going to build //one// application, not any conceivable application.
 * avoid doing anything non-local during the startup phase or shutdown phase of the application. consequently, always prefer using an explicit lumiera::Singleton&lt;T&gt; over using an static instance directly, thus yielding better control when the ctor and dtor will be invoked.
 * write error handling code only if the error situation can be actually //handled// at this place. Otherwise, be prepared for exceptions just passing by and thus handle any resources by &quot;resource acquisition is initialisation&quot; (RAII). Remember: error handling defeats decoupling and encapsulation
 * (almost) never {{{delete}}} an object directly, use {{{new}}} only when some smart pointer is at hand.
@@ -3263,15 +3270,16 @@ Besides, they provide an __inward interface__ for the [[ProcNode]]s, enabling th
 
 </pre>
 </div>
-<div title="ProcLayer and Engine" modifier="Ichthyostega" modified="200907212232" created="200706190056" tags="overview" changecount="19">
+<div title="ProcLayer and Engine" modifier="Ichthyostega" modified="200909291327" created="200706190056" tags="overview" changecount="20">
 <pre>The Render Engine is the part of the application doing the actual video calculations. Its operations are guided by the Objects and Parameters edited by the user in [[the EDL|EDL]] and it retrieves the raw audio and video data from the [[Data backend|backend.html]]. Because the inner workings of the Render Engine are closely related to the structures used in the EDL, this design covers [[the aspect of objects placed into the EDL|MObjects]] as well.
 &lt;&lt;&lt;
 ''Status'': started out as design draft in summer '07, Ichthyo is now in the middle of a implementing the foundations and main structures in C++
 * basic [[AssetManager]] working
 * [[Builder]] implementation is on the way (&amp;rarr;[[more|BuilderPrimitives]])
-* made a first draft of how to wire and operate procesing nodes (&amp;rarr;[[more|RenderMechanics]])
+* made a first draft of how to wire and operate processing nodes (&amp;rarr;[[more|RenderMechanics]])
 * first attempts to [[integrate with the GUI|GuiIntegration]]
 * first outline of the [[session implementation|PlanningSessionInMem]]
+* as a prerequisite, defined and implemented [[Proc-Layer Command frontend|CommandHandling]]
 &lt;&lt;&lt;
 
 !Summary

From e9b95e47cf0dca34a2e13bf9808ee99f99334374 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 29 Sep 2009 18:09:34 +0200
Subject: [PATCH 323/368] Command handling pattern? test-driven brainstorming

---
 src/proc/control/handling-pattern.hpp         |   1 +
 tests/45controller.tests                      |  24 ++-
 tests/components/Makefile.am                  |   2 +
 .../control/handling-pattern-basics-test.cpp  | 194 ++++++++++++++++++
 .../handling-pattern-standard-impl-test.cpp   | 126 ++++++++++++
 wiki/renderengine.html                        |  21 +-
 6 files changed, 359 insertions(+), 9 deletions(-)
 create mode 100644 tests/components/proc/control/handling-pattern-basics-test.cpp
 create mode 100644 tests/components/proc/control/handling-pattern-standard-impl-test.cpp

diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 5422bfb31..7ec8befdf 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -96,6 +96,7 @@ namespace control {
         { SYNC
         , SYNC_THROW
         , ASYNC
+        , DUMMY
         
         , NUM_IDS
         };
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 83aa89365..f59d50a1f 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -35,13 +35,6 @@ out: RESET...undoIt\(time=00:..:....00\)----memento-:START...doIt\( Time=00:..:.
 END
 
 
-TEST "Command functor and UNDO functor" CommandMutation_test <<END
-out: empty placeholder closure: Closure\(0\)
-out: param values: Closure\(23\)
-out: saved state: 11
-END
-
-
 TEST "build argument accepting function" AcceptArgumentTuple_test <<END
 out: sizeof\( .+control.+TestClass.+ \) =   1
 out: sizeof\( .+control.+TestClass.+lumiera.Time.+ \) =  (12)|(16)
@@ -50,6 +43,13 @@ return: 0
 END
 
 
+TEST "Command functor and UNDO functor" CommandMutation_test <<END
+out: empty placeholder closure: Closure\(0\)
+out: param values: Closure\(23\)
+out: saved state: 11
+END
+
+
 TEST "Memento wiring and storage" MementoTie_test <<END
 return: 0
 END
@@ -60,6 +60,16 @@ return: 0
 END
 
 
+PLANNED "handling pattern basics" HandlingPatternBasics_test <<END
+return: 0
+END
+
+
+PLANNED "handling patterns" HandlingPatternStandardImpl_test <<END
+return: 0
+END
+
+
 PLANNED "Command usage aspects I"  CommandUse1_test <<END
 return: 0
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 616989f55..f807a3083 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -56,6 +56,8 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-registry-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/handling-pattern-basics-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/handling-pattern-standard-impl-test.cpp	\
 	$(testcomponents_srcdir)/proc/engine/buff-table-test.cpp		\
 	$(testcomponents_srcdir)/proc/engine/node-basic-test.cpp         	\
 	$(testcomponents_srcdir)/proc/engine/node-fabrication-test.cpp         	\
diff --git a/tests/components/proc/control/handling-pattern-basics-test.cpp b/tests/components/proc/control/handling-pattern-basics-test.cpp
new file mode 100644
index 000000000..6dee11eba
--- /dev/null
+++ b/tests/components/proc/control/handling-pattern-basics-test.cpp
@@ -0,0 +1,194 @@
+/*
+  HandlingPatternBasics(Test)  -  verify elementary operation of a command handling pattern
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/test/test-helper.hpp"
+#include "proc/control/command.hpp"
+#include "proc/control/command-impl.hpp"
+#include "proc/control/command-registry.hpp"
+#include "proc/control/argument-erasure.hpp"
+#include "proc/control/handling-pattern.hpp"
+//#include "lib/lumitime.hpp"
+#include "lib/symbol.hpp"
+//#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+//#include <tr1/functional>
+//#include <boost/ref.hpp>
+//#include <boost/format.hpp>
+//#include <iostream>
+#include <cstdlib>
+//#include <string>
+
+
+namespace control {
+namespace test    {
+
+
+//  using boost::format;
+//  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+  using std::tr1::function;
+//  using std::tr1::bind;
+//  using std::string;
+  using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+//  using util::isSameObject;
+//  using util::contains;
+  using lib::Symbol;
+
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  namespace { // test data and helpers...
+  
+    Symbol TEST_CMD  = "test.command1.handling";
+    HandlingPattern::ID TEST_PATTERN = HandlingPattern::DUMMY;
+  }
+  
+  typedef shared_ptr<CommandImpl> PCommandImpl;
+  typedef HandlingPattern const& HaPatt;
+  
+  
+  
+  /**********************************************************************************
+   * @test operate and verify a simple dummy command handling pattern.
+   *       interface. Add/remove a command instance to the index, allocate an
+   *       CommandImpl frame and verify it is removed properly on ref count zero.
+   * @note this test covers mainly the behaviour of a handling pattern as a concept,
+   *       not so much the behaviour of the (standard) handling pattern implementations. 
+   * 
+   * @see HandlingPattern
+   * @see CommandRegistry
+   * @see command.hpp
+   * @see command-basic-test.cpp
+   */
+  class HandlingPatternBasics_test : public Test
+    {
+      
+      uint cnt_inst;
+      
+      
+      virtual void
+      run (Arg) 
+        {
+          CommandRegistry& registry = CommandRegistry::instance();
+          ASSERT (&registry);
+          
+          cnt_inst = registry.instance_count();
+      
+          {
+            PCommandImpl pCom = buildTestCommand(registry);
+            checkExec (pCom);
+            checkUndo (pCom);
+          }
+          
+          ASSERT (cnt_inst == registry.instance_count());
+        }
+      
+      
+      /** create a command implementation frame usable for tests.
+       *  This simulates what normally happens within a CommandDef.
+       *  The created CommandImpl isn't registered, and thus will
+       *  just go away when the smart-ptr leaves scope.
+       */
+      PCommandImpl
+      buildTestCommand (CommandRegistry& registry)
+        {
+          
+          typedef void Sig_oper(int);
+          typedef long Sig_capt(int);
+          typedef void Sig_undo(int,long);
+          
+          function<Sig_oper> o_Fun (command1::operate);
+          function<Sig_capt> c_Fun (command1::capture);
+          function<Sig_undo> u_Fun (command1::undoIt);
+          
+          ASSERT (o_Fun && c_Fun && u_Fun);
+          
+          // when the CommandDef is complete, it issues the
+          // allocation call to the registry behind the scenes....
+          
+          PCommandImpl pImpl = registry.newCommandImpl(o_Fun,c_Fun,u_Fun);
+          ASSERT (pImpl); 
+          ASSERT (*pImpl);
+          return pImpl;
+        }
+      
+      
+      void
+      checkExec (PCommandImpl com)
+        {
+          ASSERT (com);
+          ASSERT (!com->canExec());
+          
+          typedef Types<int> ArgType;
+          const int ARGU (1 + rand() % 1000);
+          Tuple<ArgType> tuple(ARGU);
+          TypedArguments<Tuple<ArgType> > arg(tuple);
+          com->setArguments(arg);
+          
+          ASSERT (com->canExec());
+          ASSERT (!com->canUndo());
+          command1::check_ = 0;
+          
+          HaPatt patt = HandlingPattern::get(TEST_PATTERN);
+          ExecResult res = patt.invoke(*com, TEST_CMD);
+          
+          ASSERT (res);
+          ASSERT (ARGU == command1::check_);
+          ASSERT (com->canUndo());
+        }
+      
+      
+      void
+      checkUndo (PCommandImpl com)
+        {
+          ASSERT (com);
+          ASSERT (com->canExec());
+          ASSERT (com->canUndo());
+          
+          ASSERT (command1::check_ > 0);
+          
+          HaPatt ePatt = HandlingPattern::get(TEST_PATTERN);
+          HaPatt uPatt = ePatt.howtoUNDO();
+          ExecResult res = uPatt.invoke(*com, TEST_CMD);
+          
+          ASSERT (res);
+          ASSERT (command1::check_ == 0);
+        }
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (HandlingPatternBasics_test, "function controller");
+      
+      
+}} // namespace control::test
diff --git a/tests/components/proc/control/handling-pattern-standard-impl-test.cpp b/tests/components/proc/control/handling-pattern-standard-impl-test.cpp
new file mode 100644
index 000000000..f9fdf0058
--- /dev/null
+++ b/tests/components/proc/control/handling-pattern-standard-impl-test.cpp
@@ -0,0 +1,126 @@
+/*
+  HandlingPatternStandardImpl(Test)  -  cover the provided standard command handling patterns
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+//#include "lib/test/test-helper.hpp"
+//#include "proc/asset/media.hpp"
+//#include "proc/mobject/session.hpp"
+//#include "proc/mobject/session/edl.hpp"
+//#include "proc/mobject/session/testclip.hpp"
+//#include "proc/mobject/test-dummy-mobject.hpp"
+//#include "lib/p.hpp"
+//#include "proc/mobject/placement.hpp"
+//#include "proc/mobject/placement-index.hpp"
+//#include "proc/mobject/explicitplacement.hpp"
+#include "proc/control/command.hpp"
+#include "proc/control/command-impl.hpp"
+#include "proc/control/command-registry.hpp"
+//#include "proc/control/command-def.hpp"
+//#include "lib/lumitime.hpp"
+//#include "lib/symbol.hpp"
+//#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+//#include <tr1/functional>
+//#include <boost/ref.hpp>
+//#include <boost/format.hpp>
+//#include <iostream>
+//#include <cstdlib>
+//#include <string>
+
+
+namespace control {
+namespace test    {
+
+
+//  using boost::format;
+//  using boost::str;
+  //using lumiera::Time;
+  //using util::contains;
+  using std::tr1::function;
+//  using std::tr1::bind;
+//  using std::string;
+  //using std::rand;
+  //using std::cout;
+  //using std::endl;
+//  using lib::test::showSizeof;
+//  using util::isSameObject;
+//  using util::contains;
+
+//  using session::test::TestClip;
+//  using lib::Symbol;
+//  using lumiera::P;
+  
+  
+  //using lumiera::typelist::BuildTupleAccessor;
+//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
+  
+  namespace { // test data and helpers...
+  
+//  Symbol TEST_CMD  = "test.command1.1";
+//  Symbol TEST_CMD2 = "test.command1.2";
+  }
+  
+  
+  
+  /***********************************************************************
+   * @test verify correct behaviour of all the command handling patterns
+   *       provided by the default configuration of a lumiera session.
+   *       - executing quasi synchronous
+   *       - the throw-on-error variant
+   *       - background execution
+   *       - ...?
+   * @todo define and code those handling patterns; Ticket #210
+   * 
+   * @see HandlingPattern
+   * @see CommandRegistry
+   * @see command.hpp
+   * @see command-basic-test.cpp
+   */
+  class HandlingPatternStandardImpl_test : public Test
+    {
+      
+      uint cnt_inst;
+      
+      
+      virtual void
+      run (Arg) 
+        {
+          CommandRegistry& registry = CommandRegistry::instance();
+          ASSERT (&registry);
+          
+          cnt_inst = registry.instance_count();
+          
+          UNIMPLEMENTED ("unit test to cover the standard command handling patterns");
+          
+          ASSERT (cnt_inst == registry.instance_count());
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (HandlingPatternStandardImpl_test, "function controller");
+      
+      
+}} // namespace control::test
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 9a2e98214..2fc4e4a54 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -995,7 +995,7 @@ While generally there is //no limitation// on the number and type of parameters,
 Usually, parameters should be passed //by value// &amp;mdash; with the exception of target object(s), which are typically bound as MObjectRef, causing them to be resolved at commad execution time (late binding).
 </pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200907212323" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="26">
+<div title="CommandHandling" modifier="Ichthyostega" modified="200909291418" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="27">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
@@ -1014,7 +1014,24 @@ While the usual »Memento« implementation might automatically capture the whole
 A command may be [[defined|CommandDefinition]] completely from scratch, or it might just serve as a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
 
 By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation. While nothing prevents you from invoking the command operation functor several times, each invocation will overwrite the undo state captrued by the previous invocation. Thus, each command instance should bes seen as the promise (or later the trace) of a single operation execution. In a similar vein, the undo capturing should be defined as to be self sufficient, so that invoking just the undo functor of a single command performes any necessary steps to restore the situation found before invoking the corresponding mutation functor &amp;mdash; of course only //with respect to the topic covered by this command.// So, while commands provide a lot of flexibility and allow to do a multitude of things, certainly there is an intended CommandLifecycle.
-&amp;rarr; more on possible [[command usage scenarios|CommandUsage]]</pre>
+&amp;rarr; more on possible [[command usage scenarios|CommandUsage]]
+&amp;rarr; more details regarding [[command implementation|CommandImpl]]
+</pre>
+</div>
+<div title="CommandImpl" modifier="Ichthyostega" modified="200909291434" created="200909291424" tags="spec impl" changecount="9">
+<pre>Commands are separated in a handle (the {{{control::Command}}}-object), to be used by the client code, and an implementation level, which is managed transparently behind the stages. Client code is assumed to build a CommandDefinition at some point, and from then on to access the command ''by ID'', yielding the command handle.
+Binding of arguments, invocation and UNDO all are accessible through this frontend.
+
+!Infrastructure
+To support this handling scheme, some infrastructure is in place:
+* a command registry maintains the ID &amp;harr; Command relation.
+* indirectly, through a custom alloctaor, the registry is also involved into allocation of the command implementation frame
+* this implementation frame combines
+** an operation mutation and an undo mutation
+** a closure, implemented through an argument holder
+** an undo state capturing mechanism, based on a capturing function provided on definition
+* performing the actual execution is delegated to a handling pattern object, accessed by name.
+</pre>
 </div>
 <div title="CommandLifecycle" modifier="Ichthyostega" modified="200907240010" created="200907210135" tags="SessionLogic spec draft design img" changecount="10">
 <pre>[&lt;img[Structure of Commands|uml/fig135173.png]]

From 8c21f21acc8f52da83b766f72f3a81b302bac037 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 30 Sep 2009 00:27:14 +0200
Subject: [PATCH 324/368] namespace cleanup: bring Singleton and Factory into
 lib::

---
 src/backend/enginefacade.cpp                  |   2 +-
 src/backend/mediaaccessfacade.hpp             |  16 +-
 src/backend/netnodefacade.cpp                 |   2 +-
 src/backend/scriptrunnerfacade.cpp            |   2 +-
 src/common/configfacade.cpp                   |   2 +-
 src/common/configrules.cpp                    |   4 +-
 src/common/configrules.hpp                    |   2 +-
 src/common/guifacade.cpp                      |   2 +-
 src/common/query/fake-configrules.hpp         |   2 +-
 src/include/configfacade.hpp                  |   4 +-
 src/lib/factory.hpp                           |  20 +-
 src/lib/singleton-subclass.hpp                |  10 +-
 src/lib/singleton.hpp                         |   4 +-
 src/lib/singletonfactory.hpp                  |  15 +-
 src/lib/singletonpolicies.hpp                 | 176 +++++++------
 src/lib/singletonpreconfigure.hpp             |  42 ++--
 src/lib/test/mockinjector.hpp                 | 110 ++++-----
 src/lib/visitor-dispatcher.hpp                |   1 +
 src/proc/asset/db.hpp                         |   2 +-
 src/proc/asset/media.hpp                      |   2 +-
 src/proc/asset/meta.hpp                       |   4 +-
 src/proc/asset/proc.hpp                       |   2 +-
 src/proc/asset/struct.hpp                     |   2 +-
 src/proc/assetmanager.cpp                     |   2 +-
 src/proc/assetmanager.hpp                     |   4 +-
 src/proc/control/command-registry.hpp         |   2 +-
 src/proc/control/command.cpp                  |   2 +-
 src/proc/control/handling-patterns.hpp        |   4 +-
 src/proc/control/proc-dispatcher.cpp          |   2 +-
 src/proc/control/proc-dispatcher.hpp          |   2 +-
 src/proc/control/stypemanager.cpp             |   2 +-
 src/proc/control/stypemanager.hpp             |   4 +-
 src/proc/facade.cpp                           |   4 +-
 src/proc/mobject/placement-index.hpp          |   4 +-
 src/proc/mobject/session/session-impl.hpp     |   2 +-
 src/proc/mobject/session/session.cpp          |   2 +-
 src/proc/play/dummy-player-service.cpp        |   2 +-
 .../components/proc/asset/deleteassettest.cpp |   1 -
 tests/components/proc/asset/testclipasset.hpp |   1 -
 .../proc/engine/node-basic-test.cpp           |   1 -
 .../proc/engine/node-fabrication-test.cpp     |   1 -
 .../proc/engine/node-operation-test.cpp       |   1 -
 .../proc/engine/node-source-test.cpp          |   1 -
 .../proc/mobject/builder/buildsegmenttest.cpp |   1 -
 .../mobject/controller/rendersegmenttest.cpp  |   1 -
 .../mobject/session/defsregistryimpltest.cpp  |   4 +-
 .../proc/mobject/session/testclip.cpp         |   2 +-
 .../proc/mobject/session/testsession1.hpp     |   1 -
 tests/lib/factory-special-test.cpp            |   6 +-
 tests/lib/factorytest.cpp                     |   8 +-
 tests/lib/singleton-subclass-test.cpp         |  30 +--
 tests/lib/singleton-test.cpp                  |  16 +-
 tests/lib/singletontestmocktest.cpp           | 232 +++++++++---------
 tests/lib/testtargetobj.hpp                   | 130 +++++-----
 tests/lib/visitingtoolconcept.cpp             |   2 +-
 55 files changed, 438 insertions(+), 467 deletions(-)

diff --git a/src/backend/enginefacade.cpp b/src/backend/enginefacade.cpp
index 2fbe9bc19..93b2dedc8 100644
--- a/src/backend/enginefacade.cpp
+++ b/src/backend/enginefacade.cpp
@@ -67,7 +67,7 @@ namespace backend {
     };
   
   namespace {
-    lumiera::Singleton<EngineSubsysDescriptor> theDescriptor;
+    lib::Singleton<EngineSubsysDescriptor> theDescriptor;
   }
   
   
diff --git a/src/backend/mediaaccessfacade.hpp b/src/backend/mediaaccessfacade.hpp
index c9e390306..3d009c6fe 100644
--- a/src/backend/mediaaccessfacade.hpp
+++ b/src/backend/mediaaccessfacade.hpp
@@ -30,16 +30,16 @@
 
 
 
-namespace backend_interface
-  {
+namespace backend_interface {
   
   struct ChanDesc;
-
+  
+  
   /******************************************************************
    * Interface to the backend layer:
    * provides functions for querying (opening) a media file,
    * detecting the channels or streams found within this file etc. 
-   * Implemention delegating to the actual backend functions.
+   * Implementation delegating to the actual backend functions.
    * 
    * convention: data passed by pointer is owned by the originator;
    * it should be copied if needed byond the control flow 
@@ -52,17 +52,17 @@ namespace backend_interface
       
       static Singleton<MediaAccessFacade> instance;
       
-      /** request for testing the denoted files accessability 
+      /** request for testing the denoted files accessibility 
        *  @param name path and filename of the media file.
        *  @throw invalid when passing empty filename
        *  @return opaque handle usable for querying channel
        *          information from this file, NULL if the
-       *          file is not acessible.
+       *          file is not accessible.
        */
       virtual FileHandle queryFile (const char* name)  throw(lumiera::error::Invalid);
       
       /** request for information about the n-th channel 
-       *  of the file refered by FileHandle.
+       *  of the file referred by FileHandle.
        *  @return ChanDesc which may contain \c NULL values if
        *          the file doesn't contain this much channels.
        *  @todo   throw or return NULL-ChanDesc if Filehandle is invalid?
@@ -85,7 +85,7 @@ namespace backend_interface
        */
       const char* chanID;
       
-      /** identifier characterizing the access method (or codec)
+      /** identifier characterising the access method (or codec)
        *  needed to get at the media data. This should be rather
        *  a high level description of the media stream type, 
        *  e.g. "H264" -- anyhow, it will be used to find a 
diff --git a/src/backend/netnodefacade.cpp b/src/backend/netnodefacade.cpp
index e61baaeed..24d97b8b2 100644
--- a/src/backend/netnodefacade.cpp
+++ b/src/backend/netnodefacade.cpp
@@ -66,7 +66,7 @@ namespace backend {
     };
   
   namespace {
-    lumiera::Singleton<NetNodeSubsysDescriptor> theDescriptor;
+    lib::Singleton<NetNodeSubsysDescriptor> theDescriptor;
   }
   
   
diff --git a/src/backend/scriptrunnerfacade.cpp b/src/backend/scriptrunnerfacade.cpp
index 2e8955af1..9ecf4f13f 100644
--- a/src/backend/scriptrunnerfacade.cpp
+++ b/src/backend/scriptrunnerfacade.cpp
@@ -67,7 +67,7 @@ namespace backend {
     };
   
   namespace {
-    lumiera::Singleton<ScriptRunnerSubsysDescriptor> theDescriptor;
+    lib::Singleton<ScriptRunnerSubsysDescriptor> theDescriptor;
   }
   
   
diff --git a/src/common/configfacade.cpp b/src/common/configfacade.cpp
index ca4310480..b0860e08e 100644
--- a/src/common/configfacade.cpp
+++ b/src/common/configfacade.cpp
@@ -65,7 +65,7 @@ namespace lumiera {
   
   
   /** storage for the single system-wide config facade instance */
-  Singleton<Config> Config::instance;
+  lib::Singleton<Config> Config::instance;
   
   
   Config::Config ()
diff --git a/src/common/configrules.cpp b/src/common/configrules.cpp
index 2a5530324..248d71461 100644
--- a/src/common/configrules.cpp
+++ b/src/common/configrules.cpp
@@ -43,12 +43,12 @@ namespace lumiera
   namespace {
   
     /** type of the actual ConfigRules implementation to use */
-    singleton::UseSubclass<query::MockConfigRules> typeinfo;
+    lib::singleton::UseSubclass<query::MockConfigRules> typeinfo;
   }
   
       
   /** Singleton factory instance, parametrised to actual impl. type. */
-  SingletonSub<ConfigRules> ConfigRules::instance (typeinfo); 
+  lib::SingletonSub<ConfigRules> ConfigRules::instance (typeinfo); 
 
 
   
diff --git a/src/common/configrules.hpp b/src/common/configrules.hpp
index 2b23fd68b..a08bfceeb 100644
--- a/src/common/configrules.hpp
+++ b/src/common/configrules.hpp
@@ -227,7 +227,7 @@ namespace lumiera
     {
   
     public:
-      static SingletonSub<ConfigRules> instance;
+      static lib::SingletonSub<ConfigRules> instance;
       
     };
   
diff --git a/src/common/guifacade.cpp b/src/common/guifacade.cpp
index 670aa00b5..b28c65130 100644
--- a/src/common/guifacade.cpp
+++ b/src/common/guifacade.cpp
@@ -163,7 +163,7 @@ namespace gui {
           }
       };
     
-    lumiera::Singleton<GuiSubsysDescriptor> theDescriptor;
+    lib::Singleton<GuiSubsysDescriptor> theDescriptor;
     
   } // (End) impl details
   
diff --git a/src/common/query/fake-configrules.hpp b/src/common/query/fake-configrules.hpp
index 21da6f2eb..7bba3430d 100644
--- a/src/common/query/fake-configrules.hpp
+++ b/src/common/query/fake-configrules.hpp
@@ -234,7 +234,7 @@ namespace lumiera
       {
       protected:
         MockConfigRules ();                                   ///< to be used only by the singleton factory
-        friend class lumiera::singleton::StaticCreate<MockConfigRules>;
+        friend class lib::singleton::StaticCreate<MockConfigRules>;
 
         virtual ~MockConfigRules() {}
         
diff --git a/src/include/configfacade.hpp b/src/include/configfacade.hpp
index d2eb44a30..7e6c8307b 100644
--- a/src/include/configfacade.hpp
+++ b/src/include/configfacade.hpp
@@ -55,13 +55,13 @@ namespace lumiera {
       static const string get (string const& key);
       
       
-      static lumiera::Singleton<Config> instance;
+      static lib::Singleton<Config> instance;
       
     private:
       Config();
       ~Config();
       
-      friend class lumiera::singleton::StaticCreate<Config>;
+      friend class lib::singleton::StaticCreate<Config>;
       
       //////////////////TODO: define startup/shutdown and loading of the config interface
       
diff --git a/src/lib/factory.hpp b/src/lib/factory.hpp
index e7e568bf8..6cefba752 100644
--- a/src/lib/factory.hpp
+++ b/src/lib/factory.hpp
@@ -21,14 +21,14 @@
 */
 
 
-#ifndef LUMIERA_FACTORY_H
-#define LUMIERA_FACTORY_H
+#ifndef LIB_FACTORY_H
+#define LIB_FACTORY_H
 
 #include <tr1/memory>
 
 
 
-namespace lumiera {
+namespace lib {
   namespace factory {
     
     /**
@@ -46,7 +46,7 @@ namespace lumiera {
         {
         protected:
           SMP wrap (T* product) { return SMP (product); }
-
+          
         public:
           typedef SMP PType;
         };
@@ -82,10 +82,10 @@ namespace lumiera {
     
     
     
-    /* -- some example and default instantiations -- */  
+    /* -- some example and default instantiations -- */
     
     using std::tr1::shared_ptr;
-
+    
     /** 
      * a frequently used instantiation of the Wrapper,
      * Utilising the refcounting tr1::shared_ptr.
@@ -95,7 +95,7 @@ namespace lumiera {
       {
       protected:
         shared_ptr<T> wrap (T* product) { return shared_ptr<T> (product); }
-
+        
       public:
         typedef shared_ptr<T> PType;
       };
@@ -104,7 +104,7 @@ namespace lumiera {
     /** 
      * Shortcut: commonly used (partial) instantiation of the Factory,
      * generating refcounting shared_ptr wrapped Objects. Built upon
-     * the corresponding special instantiation of the Wrapper template. 
+     * the corresponding special instantiation of the Wrapper template.
      */
     template<class T>
     class RefcountFac : public Factory<T, Wrapper<T,shared_ptr<T> > >
@@ -135,10 +135,10 @@ namespace lumiera {
       
       
   } // namespace factory
-
+  
   /// @note Factory can be usable as-is (wraps into std::auto_ptr)
   using factory::Factory;
   
   
-} // namespace lumiera
+} // namespace lib
 #endif
diff --git a/src/lib/singleton-subclass.hpp b/src/lib/singleton-subclass.hpp
index e3c6b530c..ce120278a 100644
--- a/src/lib/singleton-subclass.hpp
+++ b/src/lib/singleton-subclass.hpp
@@ -35,8 +35,8 @@
  */
 
 
-#ifndef LUMIERA_SINGLETON_SUBCLASS_H
-#define LUMIERA_SINGLETON_SUBCLASS_H
+#ifndef LIB_SINGLETON_SUBCLASS_H
+#define LIB_SINGLETON_SUBCLASS_H
 
 
 #include "lib/singleton.hpp"
@@ -45,7 +45,7 @@
 #include <typeinfo>
 
 
-namespace lumiera {
+namespace lib {
   
   using boost::scoped_ptr;
   
@@ -53,7 +53,7 @@ namespace lumiera {
   namespace singleton {
     
       /** 
-       * Helper template to use the general policy classes of the lumiera::Singleton,
+       * Helper template to use the general policy classes of the lib::Singleton,
        * but change the way they are parametrised on-the-fly. 
        */
       template<template<class> class POL, class I>
@@ -172,6 +172,6 @@ namespace lumiera {
     };
 
 
-} // namespace lumiera
+} // namespace lib
 
 #endif
diff --git a/src/lib/singleton.hpp b/src/lib/singleton.hpp
index 20fa5332c..731c441ac 100644
--- a/src/lib/singleton.hpp
+++ b/src/lib/singleton.hpp
@@ -40,8 +40,8 @@
  */
 
 
-#ifndef LUMIERA_SINGLETON_H
-#define LUMIERA_SINGLETON_H
+#ifndef LIB_SINGLETON_H
+#define LIB_SINGLETON_H
 
 
 #include "lib/singletonpolicies.hpp"
diff --git a/src/lib/singletonfactory.hpp b/src/lib/singletonfactory.hpp
index 13751c956..737ebe8b4 100644
--- a/src/lib/singletonfactory.hpp
+++ b/src/lib/singletonfactory.hpp
@@ -31,8 +31,8 @@ This code is heavily inspired by
 
 
 
-#ifndef LUMIERA_SINGLETONFACTORY_H
-#define LUMIERA_SINGLETONFACTORY_H
+#ifndef LIB_SINGLETONFACTORY_H
+#define LIB_SINGLETONFACTORY_H
 
 
 #include "lib/singletonpolicies.hpp"  // several Policies usable together with SingletonFactory
@@ -42,7 +42,7 @@ This code is heavily inspired by
 #include "lib/util.hpp"
 #include "lib/sync-classlock.hpp"
 
-namespace lumiera {
+namespace lib {
   
   /**
    * A configurable Template for implementing Singletons. 
@@ -143,12 +143,5 @@ namespace lumiera {
 /////       But the whole point of my pervasive use of this singleton template is to remain
 /////       below this borderline of integration ("IoC yes, but avoid DI").
   
-} // namespace lumiera
+} // namespace lib
 #endif
-/*
-// Local Variables:
-// mode: C++
-// c-file-style: "gnu"
-// indent-tabs-mode: nil
-// End:
-*/
diff --git a/src/lib/singletonpolicies.hpp b/src/lib/singletonpolicies.hpp
index 8a4f3271b..b8333334d 100644
--- a/src/lib/singletonpolicies.hpp
+++ b/src/lib/singletonpolicies.hpp
@@ -31,8 +31,8 @@ This code is heavily inspired by
 
 
 
-#ifndef LUMIERA_SINGLETONPOLICIES_H
-#define LUMIERA_SINGLETONPOLICIES_H
+#ifndef LIB_SINGLETONPOLICIES_H
+#define LIB_SINGLETONPOLICIES_H
 
 #include "lib/nobug-init.hpp"
 #include "lib/error.hpp"
@@ -40,101 +40,99 @@ This code is heavily inspired by
 #include <vector>
 
 
-namespace lumiera {
+namespace lib {
   namespace singleton {
     
     
-      /* === several Policies usable in conjunction with lumiera::Singleton === */
-      
-      /** 
-       * Policy placing the Singleton instance into a statically allocated buffer
-       */
-      template<class S>
-      struct StaticCreate
-        {
-          static S* create ()
-            {
+    /* === several Policies usable in conjunction with lib::Singleton === */
+    
+    /** 
+     * Policy placing the Singleton instance into a statically allocated buffer
+     */
+    template<class S>
+    struct StaticCreate
+      {
+        static S* create ()
+          {
 #ifdef DEBUG
-              static uint callCount = 0;
-              ASSERT ( 0 == callCount++ );
+            static uint callCount = 0;
+            ASSERT ( 0 == callCount++ );
 #endif              
-              static char buff[sizeof(S)];
-              return new(buff) S();
-            }
-          static void destroy (S* pSi)
-            {
-              pSi-> ~S();
-            }
-        };
-      
-      
-      /**
-       * Policy for creating the Singleton instance heap allocated
-       */
-      template<class S>
-      struct HeapCreate
-        {
-          static S* create ()         { return new S; }
-          static void destroy (S* pS) { delete pS;    }
-        };
-      
-      
-      
-      
-      
-      typedef void (*DelFunc)(void);
-      using std::vector;
-      
-      /**
-       * Policy relying on the compiler/runtime system for Singleton Lifecycle
-       */
-      template<class S>
-      struct AutoDestroy
-        {
-          /** implements the Singleton removal by calling
-           *  the provided deleter function(s) at application shutdown,
-           *  relying on the runtime system calling destructors of static
-           *  objects. Because this Policy class can be shared between 
-           *  several Singletons, we need to memorise all registered
-           *  deleter functions for calling them at shutdown.
-           */ 
-          static void
-          scheduleDelete (DelFunc kill_the_singleton)
-            {
-                 class DeleteTrigger
-                        {
-                          vector<DelFunc> dels_;
-                          
-                        public:
-                          void schedule (DelFunc del) 
-                            { 
-                              dels_.push_back(del); 
-                            }
-                         ~DeleteTrigger()        
-                            { 
-                              vector<DelFunc>::iterator i = dels_.begin();
-                              for ( ; i != dels_.end(); ++i )
-                                (*i)(); // invoke deleter func 
-                            }
-                        };
+            static char buff[sizeof(S)];
+            return new(buff) S();
+          }
+        static void destroy (S* pSi)
+          {
+            pSi-> ~S();
+          }
+      };
+    
+    
+    /**
+     * Policy for creating the Singleton instance heap allocated
+     */
+    template<class S>
+    struct HeapCreate
+      {
+        static S* create ()         { return new S; }
+        static void destroy (S* pS) { delete pS;    }
+      };
+    
+    
+    
+    
+    
+    typedef void (*DelFunc)(void);
+    using std::vector;
+    
+    /**
+     * Policy relying on the compiler/runtime system for Singleton Lifecycle
+     */
+    template<class S>
+    struct AutoDestroy
+      {
+        /** implements the Singleton removal by calling
+         *  the provided deleter function(s) at application shutdown,
+         *  relying on the runtime system calling destructors of static
+         *  objects. Because this Policy class can be shared between 
+         *  several Singletons, we need to memorise all registered
+         *  deleter functions for calling them at shutdown.
+         */ 
+        static void
+        scheduleDelete (DelFunc kill_the_singleton)
+          {
+               class DeleteTrigger
+                      {
+                        vector<DelFunc> dels_;
                         
-              REQUIRE (kill_the_singleton);
-              static DeleteTrigger finally;
-              finally.schedule (kill_the_singleton);
-            }
-          
-          static void
-          onDeadReference ()
-            {
-              throw error::Logic ("Trying to access the a Singleton instance that has "
-                                  "already been released or finished its lifecycle.");
-            }
-        };
+                      public:
+                        void schedule (DelFunc del) 
+                          { 
+                            dels_.push_back(del); 
+                          }
+                       ~DeleteTrigger()        
+                          { 
+                            vector<DelFunc>::iterator i = dels_.begin();
+                            for ( ; i != dels_.end(); ++i )
+                              (*i)(); // invoke deleter func 
+                          }
+                      };
+                      
+            REQUIRE (kill_the_singleton);
+            static DeleteTrigger finally;
+            finally.schedule (kill_the_singleton);
+          }
+        
+        static void
+        onDeadReference ()
+          {
+            throw lumiera::error::Logic ("Trying to access the a Singleton instance that has "
+                                         "already been released or finished its lifecycle.");
+          }
+      };
     
     
     
     
-  } // namespace singleton
-  
-} // namespace lumiera
+}} // namespace lib::singleton
 #endif
diff --git a/src/lib/singletonpreconfigure.hpp b/src/lib/singletonpreconfigure.hpp
index a95295a7b..a657a0ec9 100644
--- a/src/lib/singletonpreconfigure.hpp
+++ b/src/lib/singletonpreconfigure.hpp
@@ -21,11 +21,11 @@
 */
 
 /** @file singletonpreconfigure.hpp
- ** Preconfiguration of some Singleton types, done by template specialisation.
+ ** Pre-configuration of some Singleton types, done by template specialisation.
  ** Typically the client code just includes singleton.h and uses the Singleton
  ** type. But in some cases, we want to configure specific (dependency injection)
  ** behaviour at a central location. At some point, we may well have a full blown
- ** Dependency Manager, but for the moment using just some specialized Singleton
+ ** Dependency Manager, but for the moment using just some specialised Singleton
  ** type for some instances seems sufficient.
  **
  ** One reason why one wants special Singleton behaviour is testing: Without
@@ -33,22 +33,22 @@
  ** in place of some service object, so we can verify the behaviour of the code
  ** <i>using</i> this service. For this, we mix lumiera::test::MockInjector
  ** into the actual Singleton type.
- **
+ ** 
  ** @note we declare the specialisations into the target namespace
- **
+ ** 
  ** @see SingletonFactory
  ** @see singletontestmocktest.hpp
  */
 
 
-#ifndef LUMIERA_SINGLETONPRECONFIGURE_H
-#define LUMIERA_SINGLETONPRECONFIGURE_H
+#ifndef LIB_SINGLETONPRECONFIGURE_H
+#define LIB_SINGLETONPRECONFIGURE_H
 
 #include "lib/test/mockinjector.hpp"
 
 
-namespace lumiera
-  {
+namespace lib {
+  
   /**
    * Default Singleton configuration
    * @note all Policy template parameters taking default values
@@ -58,25 +58,23 @@ namespace lumiera
     : public SingletonFactory<SI>
     { }
     ;
-    
-    
+  
+  
   /* ********************************************************************** */
   /* Forward declarations of all Classes we want to specialise the template */
   /* ********************************************************************** */
-    
+  
   namespace test {
-    
     class TestSingletonO;
-    using lumiera::Singleton;
+    using lib::Singleton;
     
   } // namespace test
 }  // namespace lumiera
 
-namespace backend_interface
-  {
+namespace backend_interface {
   class MediaAccessFacade;
-  using lumiera::Singleton;
-    
+  using lib::Singleton;
+  
 } // namespace backend_interface
 
 
@@ -87,23 +85,23 @@ namespace backend_interface
   /* Specialisation Definitions */
   /* ************************** */
 
-namespace lumiera {
+namespace lib {
   
   using test::MockInjector;
   
-    
+  
   template<>
   class Singleton<test::TestSingletonO>
     : public MockInjector<test::TestSingletonO>
     { };
-
-    
+  
+  
   template<>
   class Singleton<backend_interface::MediaAccessFacade>
     : public MockInjector<backend_interface::MediaAccessFacade>
     { };
 
-} // namespace lumiera
+} // namespace lib
 
 
 
diff --git a/src/lib/test/mockinjector.hpp b/src/lib/test/mockinjector.hpp
index b778f4b0c..594ac2727 100644
--- a/src/lib/test/mockinjector.hpp
+++ b/src/lib/test/mockinjector.hpp
@@ -31,63 +31,61 @@
 #include <boost/scoped_ptr.hpp>
 
 
-namespace lumiera {
-  namespace test {
-    
-    using boost::scoped_ptr;
-    
-    /**
-     * Special SingletonFactory allowing to inject some instance of the Singleton
-     * class, thus shadowing "the" (default) Singleton instance temporarily.
-     * This allows installing a Mock Subclass of the Singleton for running tests,
-     * while the Singleton can be used as usual in production code.
-     * @note we use the default policies or SingletonFactory 
-     */
-    template<class SI>
-    class MockInjector : public SingletonFactory<SI>
-      {
-        scoped_ptr<SI> mock_;
-        
-      public:
-        /** Overwriting the normal Singleton creation Interface
-         *  to return some mock if defined, falling back to the
-         *  default Singleton creation behaviour else.
-         */
-        SI& operator() ()
-          {
-            if (mock_)
-              return *mock_;
-            else
-              return SingletonFactory<SI>::operator() ();
-          }
-        
-        void injectSubclass (SI* mockobj)
-          {
-            TRACE_IF (mockobj,  test, "Singleton: installing Mock object");
-            TRACE_IF (!mockobj, test, "Singleton: removing Mock object");
-            mock_.reset (mockobj);
-          }
-        
-        
-        MockInjector () {};
-        
-        /** @note MockInjector singleton factory objects can be copied,
-         *        but the copy will start out with clean internal state,
-         *        i.e. exhibiting normal SingletonFactory behaviour
-         *        without mock object.
-         */
-        MockInjector (const MockInjector& other) 
-          : SingletonFactory<SI>(other), mock_(0) { }
-        
-        MockInjector<SI>& operator= (const MockInjector<SI>& other)
-          {
-            return SingletonFactory<SI>::operator= (other);
-          }
-      };
+namespace lib {
+namespace test{
+  
+  using boost::scoped_ptr;
+  
+  /**
+   * Special SingletonFactory allowing to inject some instance of the Singleton
+   * class, thus shadowing "the" (default) Singleton instance temporarily.
+   * This allows installing a Mock Subclass of the Singleton for running tests,
+   * while the Singleton can be used as usual in production code.
+   * @note we use the default policies or SingletonFactory 
+   */
+  template<class SI>
+  class MockInjector : public SingletonFactory<SI>
+    {
+      scoped_ptr<SI> mock_;
+      
+    public:
+      /** Overwriting the normal Singleton creation Interface
+       *  to return some mock if defined, falling back to the
+       *  default Singleton creation behaviour else.
+       */
+      SI& operator() ()
+        {
+          if (mock_)
+            return *mock_;
+          else
+            return SingletonFactory<SI>::operator() ();
+        }
+      
+      void injectSubclass (SI* mockobj)
+        {
+          TRACE_IF (mockobj,  test, "Singleton: installing Mock object");
+          TRACE_IF (!mockobj, test, "Singleton: removing Mock object");
+          mock_.reset (mockobj);
+        }
       
       
+      MockInjector () {};
       
-  } // namespace test
-
-} // namespace lumiera
+      /** @note MockInjector singleton factory objects can be copied,
+       *        but the copy will start out with clean internal state,
+       *        i.e. exhibiting normal SingletonFactory behaviour
+       *        without mock object.
+       */
+      MockInjector (const MockInjector& other) 
+        : SingletonFactory<SI>(other), mock_(0) { }
+      
+      MockInjector<SI>& operator= (const MockInjector<SI>& other)
+        {
+          return SingletonFactory<SI>::operator= (other);
+        }
+    };
+  
+  
+  
+}} // namespace lib::test
 #endif
diff --git a/src/lib/visitor-dispatcher.hpp b/src/lib/visitor-dispatcher.hpp
index c0b60c997..26e99f9aa 100644
--- a/src/lib/visitor-dispatcher.hpp
+++ b/src/lib/visitor-dispatcher.hpp
@@ -38,6 +38,7 @@ namespace lumiera {
 namespace visitor {
   
   using lib::ClassLock;
+  using lib::Singleton;
   
   
   template<class TOOL> class Tag;
diff --git a/src/proc/asset/db.hpp b/src/proc/asset/db.hpp
index f8c136f12..f371b5efc 100644
--- a/src/proc/asset/db.hpp
+++ b/src/proc/asset/db.hpp
@@ -97,7 +97,7 @@ namespace asset {
       DB () : table() { }
       ~DB ()          {clear();}
       
-      friend class lumiera::singleton::StaticCreate<DB>;
+      friend class lib::singleton::StaticCreate<DB>;
       
       
     public:
diff --git a/src/proc/asset/media.hpp b/src/proc/asset/media.hpp
index 4273a3f68..8f92525e4 100644
--- a/src/proc/asset/media.hpp
+++ b/src/proc/asset/media.hpp
@@ -139,7 +139,7 @@ namespace asset {
   /** 
    * Factory specialised for creating Media Asset objects.
    */ 
-  class MediaFactory : public lumiera::Factory<asset::Media>
+  class MediaFactory : public lib::Factory<asset::Media>
     {
     public:
       typedef P<asset::Media> PType;
diff --git a/src/proc/asset/meta.hpp b/src/proc/asset/meta.hpp
index 18d94ddc7..da12b2bd7 100644
--- a/src/proc/asset/meta.hpp
+++ b/src/proc/asset/meta.hpp
@@ -90,9 +90,9 @@ namespace asset
   
   
   /** 
-   * Factory specialized for createing Metadata Asset objects.
+   * Factory specialised for creating Metadata Asset objects.
    */ 
-  class MetaFactory : public lumiera::Factory<asset::Meta>
+  class MetaFactory : public lib::Factory<asset::Meta>
     {
     public:
       typedef P<asset::Meta> PType;
diff --git a/src/proc/asset/proc.hpp b/src/proc/asset/proc.hpp
index 61ce66cbc..b99a3f364 100644
--- a/src/proc/asset/proc.hpp
+++ b/src/proc/asset/proc.hpp
@@ -114,7 +114,7 @@ namespace asset {
   /** 
    * Factory specialised for creating Processor Asset objects.
    */ 
-  class ProcFactory : public lumiera::Factory<asset::Proc>
+  class ProcFactory : public lib::Factory<asset::Proc>
     {
     public:
       typedef P<asset::Proc> PType;
diff --git a/src/proc/asset/struct.hpp b/src/proc/asset/struct.hpp
index 07efca7e0..5c8e5accf 100644
--- a/src/proc/asset/struct.hpp
+++ b/src/proc/asset/struct.hpp
@@ -110,7 +110,7 @@ namespace asset {
   /** 
    * Factory specialised for creating Structural Asset objects.
    */ 
-  class StructFactory : public lumiera::Factory<asset::Struct>
+  class StructFactory : public lib::Factory<asset::Struct>
     {
       scoped_ptr<StructFactoryImpl> impl_;
 
diff --git a/src/proc/assetmanager.cpp b/src/proc/assetmanager.cpp
index e8fd45352..c26811bed 100644
--- a/src/proc/assetmanager.cpp
+++ b/src/proc/assetmanager.cpp
@@ -36,7 +36,7 @@ using std::tr1::placeholders::_1;
 using boost::format;
 using util::for_each;
 
-using lumiera::Singleton;
+using lib::Singleton;
 using lib::Sync;
 
 
diff --git a/src/proc/assetmanager.hpp b/src/proc/assetmanager.hpp
index 843548247..6068a86c4 100644
--- a/src/proc/assetmanager.hpp
+++ b/src/proc/assetmanager.hpp
@@ -68,7 +68,7 @@ namespace asset {
     
     
     public:
-      static lumiera::Singleton<AssetManager> instance;
+      static lib::Singleton<AssetManager> instance;
       
       /** provide the unique ID for given Asset::Ident tuple */
       static ID<Asset> getID (const Asset::Ident&);
@@ -112,7 +112,7 @@ namespace asset {
       
       AssetManager ();
       
-      friend class lumiera::singleton::StaticCreate<AssetManager>;
+      friend class lib::singleton::StaticCreate<AssetManager>;
       
     };
     
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index f355dc365..3e90d7cf9 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -128,7 +128,7 @@ namespace control {
       
       
     public:
-      static lumiera::Singleton<CommandRegistry> instance;
+      static lib::Singleton<CommandRegistry> instance;
       
       
       /** register a command (Frontend) under the given ID
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index f70695c83..f6272a14c 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -71,7 +71,7 @@ namespace control {
   
   
   /** storage for the singleton factory used to access CommandRegistry */
-  lumiera::Singleton<CommandRegistry> CommandRegistry::instance;
+  lib::Singleton<CommandRegistry> CommandRegistry::instance;
   
   
   
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index dc35d7ea4..4b6f968ef 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -156,7 +156,7 @@ namespace control {
     
     /* ======== Handling Pattern Table ========== */
     
-    typedef lumiera::SingletonSub<HandlingPattern> SingletonFac;
+    typedef lib::SingletonSub<HandlingPattern> SingletonFac;
     
     /** Table of available command handling patterns */
     vector<SingletonFac> patternTable;
@@ -178,7 +178,7 @@ namespace control {
     void
     prepareCommandHandlingPatterns()
     {
-      using lumiera::singleton::UseSubclass;
+      using lib::singleton::UseSubclass;
       
       patternTable[HandlingPattern::SYNC      ]  = SingletonFac(UseSubclass<InvokeSyncNoThrow>());
       patternTable[HandlingPattern::SYNC_THROW]  = SingletonFac(UseSubclass<InvokeSyncThrow>());
diff --git a/src/proc/control/proc-dispatcher.cpp b/src/proc/control/proc-dispatcher.cpp
index 6d2a8e41c..2fcb6e251 100644
--- a/src/proc/control/proc-dispatcher.cpp
+++ b/src/proc/control/proc-dispatcher.cpp
@@ -52,7 +52,7 @@ namespace control {
   }
   
   /** storage for Singleton access */
-  lumiera::Singleton<ProcDispatcher> ProcDispatcher::instance;
+  lib::Singleton<ProcDispatcher> ProcDispatcher::instance;
   
   
   
diff --git a/src/proc/control/proc-dispatcher.hpp b/src/proc/control/proc-dispatcher.hpp
index 02227d6b2..d15021523 100644
--- a/src/proc/control/proc-dispatcher.hpp
+++ b/src/proc/control/proc-dispatcher.hpp
@@ -57,7 +57,7 @@ namespace control {
     {
       
     public:
-      static lumiera::Singleton<ProcDispatcher> instance;
+      static lib::Singleton<ProcDispatcher> instance;
       
       void activate();
       void deactivate();
diff --git a/src/proc/control/stypemanager.cpp b/src/proc/control/stypemanager.cpp
index 30e34f644..10131f130 100644
--- a/src/proc/control/stypemanager.cpp
+++ b/src/proc/control/stypemanager.cpp
@@ -46,7 +46,7 @@ namespace control {
   
   /** access the system-wide stream type manager instance.
    *  Implemented as singleton. */
-  lumiera::Singleton<STypeManager> STypeManager::instance;
+  lib::Singleton<STypeManager> STypeManager::instance;
   
   
   void 
diff --git a/src/proc/control/stypemanager.hpp b/src/proc/control/stypemanager.hpp
index b35334124..70003eef4 100644
--- a/src/proc/control/stypemanager.hpp
+++ b/src/proc/control/stypemanager.hpp
@@ -44,7 +44,7 @@ namespace control {
       boost::scoped_ptr<Registry> reg_;
       
     public:
-      static lumiera::Singleton<STypeManager> instance;
+      static lib::Singleton<STypeManager> instance;
       
       typedef StreamType::ImplFacade ImplFacade;
       
@@ -77,7 +77,7 @@ namespace control {
       STypeManager() ;
       ~STypeManager();
       
-      friend class lumiera::singleton::StaticCreate<STypeManager>;
+      friend class lib::singleton::StaticCreate<STypeManager>;
       
       /** Lifecycle: reset all type registration information
        *  to the <i>generic pristine default</i> state. This includes
diff --git a/src/proc/facade.cpp b/src/proc/facade.cpp
index f3180550c..3c7d6f93b 100644
--- a/src/proc/facade.cpp
+++ b/src/proc/facade.cpp
@@ -104,8 +104,8 @@ namespace proc {
     };
   
   namespace {
-    lumiera::Singleton<BuilderSubsysDescriptor> theBuilderDescriptor;   
-    lumiera::Singleton<SessionSubsysDescriptor> theSessionDescriptor;
+    lib::Singleton<BuilderSubsysDescriptor> theBuilderDescriptor;   
+    lib::Singleton<SessionSubsysDescriptor> theSessionDescriptor;
   }
   
   
diff --git a/src/proc/mobject/placement-index.hpp b/src/proc/mobject/placement-index.hpp
index cc2616ae8..bd8950ef4 100644
--- a/src/proc/mobject/placement-index.hpp
+++ b/src/proc/mobject/placement-index.hpp
@@ -49,7 +49,7 @@
 
 namespace mobject {
   
-  using lumiera::factory::RefcountFac;
+  using lib::factory::RefcountFac;
   using std::tr1::shared_ptr;
   using boost::scoped_ptr;
   using std::vector;
@@ -110,7 +110,7 @@ namespace mobject {
     protected:
       PlacementIndex() ;
       
-      friend class lumiera::factory::Factory<PlacementIndex, lumiera::factory::Wrapper<PlacementIndex, shared_ptr<PlacementIndex> > >;
+      friend class lib::factory::Factory<PlacementIndex, lib::factory::Wrapper<PlacementIndex, shared_ptr<PlacementIndex> > >;
     };
   ////////////////TODO currently just fleshing  out the API; probably have to split off an impl.class; but for now a PImpl is sufficient...
   
diff --git a/src/proc/mobject/session/session-impl.hpp b/src/proc/mobject/session/session-impl.hpp
index 72b0a9001..0ddc63381 100644
--- a/src/proc/mobject/session/session-impl.hpp
+++ b/src/proc/mobject/session/session-impl.hpp
@@ -94,7 +94,7 @@ namespace session {
       scoped_ptr<SessionImpl> pImpl_;
       
       SessManagerImpl()  throw();
-      friend class lumiera::singleton::StaticCreate<SessManagerImpl>;
+      friend class lib::singleton::StaticCreate<SessManagerImpl>;
       
       virtual ~SessManagerImpl() {}
       
diff --git a/src/proc/mobject/session/session.cpp b/src/proc/mobject/session/session.cpp
index f466259b3..dec115d15 100644
--- a/src/proc/mobject/session/session.cpp
+++ b/src/proc/mobject/session/session.cpp
@@ -40,7 +40,7 @@
 
 
 using lib::Symbol;
-using lumiera::Singleton;
+using lib::Singleton;
 using mobject::session::SessManager;
 using mobject::session::SessManagerImpl;
 
diff --git a/src/proc/play/dummy-player-service.cpp b/src/proc/play/dummy-player-service.cpp
index 18f80277b..54ce69e9d 100644
--- a/src/proc/play/dummy-player-service.cpp
+++ b/src/proc/play/dummy-player-service.cpp
@@ -91,7 +91,7 @@ namespace proc  {
             }
         };
       
-      lumiera::Singleton<DummyPlayerSubsysDescriptor> theDummyPlayerDescriptor;
+      lib::Singleton<DummyPlayerSubsysDescriptor> theDummyPlayerDescriptor;
       
       
       
diff --git a/tests/components/proc/asset/deleteassettest.cpp b/tests/components/proc/asset/deleteassettest.cpp
index e589dc23d..d8c79f761 100644
--- a/tests/components/proc/asset/deleteassettest.cpp
+++ b/tests/components/proc/asset/deleteassettest.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/asset/testclipasset.hpp b/tests/components/proc/asset/testclipasset.hpp
index d1027f139..fc501625c 100644
--- a/tests/components/proc/asset/testclipasset.hpp
+++ b/tests/components/proc/asset/testclipasset.hpp
@@ -26,7 +26,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/engine/node-basic-test.cpp b/tests/components/proc/engine/node-basic-test.cpp
index c04d420c4..bff44a4df 100644
--- a/tests/components/proc/engine/node-basic-test.cpp
+++ b/tests/components/proc/engine/node-basic-test.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 #include "proc/engine/nodefactory.hpp"
 #include "proc/engine/nodewiring.hpp"
diff --git a/tests/components/proc/engine/node-fabrication-test.cpp b/tests/components/proc/engine/node-fabrication-test.cpp
index 5827a77df..7130b5397 100644
--- a/tests/components/proc/engine/node-fabrication-test.cpp
+++ b/tests/components/proc/engine/node-fabrication-test.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/engine/node-operation-test.cpp b/tests/components/proc/engine/node-operation-test.cpp
index f83c3eaf5..8ac2b56d4 100644
--- a/tests/components/proc/engine/node-operation-test.cpp
+++ b/tests/components/proc/engine/node-operation-test.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/engine/node-source-test.cpp b/tests/components/proc/engine/node-source-test.cpp
index 7a3b52f23..d00a87b47 100644
--- a/tests/components/proc/engine/node-source-test.cpp
+++ b/tests/components/proc/engine/node-source-test.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/mobject/builder/buildsegmenttest.cpp b/tests/components/proc/mobject/builder/buildsegmenttest.cpp
index a078106cd..1983d8c29 100644
--- a/tests/components/proc/mobject/builder/buildsegmenttest.cpp
+++ b/tests/components/proc/mobject/builder/buildsegmenttest.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/mobject/controller/rendersegmenttest.cpp b/tests/components/proc/mobject/controller/rendersegmenttest.cpp
index fd891ad60..c8fd4b4b6 100644
--- a/tests/components/proc/mobject/controller/rendersegmenttest.cpp
+++ b/tests/components/proc/mobject/controller/rendersegmenttest.cpp
@@ -22,7 +22,6 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/components/proc/mobject/session/defsregistryimpltest.cpp b/tests/components/proc/mobject/session/defsregistryimpltest.cpp
index 87ccce09c..88c804cec 100644
--- a/tests/components/proc/mobject/session/defsregistryimpltest.cpp
+++ b/tests/components/proc/mobject/session/defsregistryimpltest.cpp
@@ -109,8 +109,8 @@ namespace mobject {
           
           
           // fabricating Objects wrapped into smart-ptrs
-          lumiera::factory::RefcountFac<Dummy<13> > oFac;
-          lumiera::factory::RefcountFac<Dummy<23> > pFac;
+          lib::factory::RefcountFac<Dummy<13> > oFac;
+          lib::factory::RefcountFac<Dummy<23> > pFac;
           
           O o1, o2, o3;
           Q13 q1, q2, q3, q4, q5;
diff --git a/tests/components/proc/mobject/session/testclip.cpp b/tests/components/proc/mobject/session/testclip.cpp
index add7277d8..a506d2849 100644
--- a/tests/components/proc/mobject/session/testclip.cpp
+++ b/tests/components/proc/mobject/session/testclip.cpp
@@ -68,7 +68,7 @@ namespace test    {
         { }
     };
       
-  lumiera::Singleton<Testbed> testbed_1; // invoke ctor when creating first TestClip...
+  lib::Singleton<Testbed> testbed_1; // invoke ctor when creating first TestClip...
   
   
   
diff --git a/tests/components/proc/mobject/session/testsession1.hpp b/tests/components/proc/mobject/session/testsession1.hpp
index 4928c2b23..641c875d8 100644
--- a/tests/components/proc/mobject/session/testsession1.hpp
+++ b/tests/components/proc/mobject/session/testsession1.hpp
@@ -27,7 +27,6 @@
 
 #include "proc/mobject/session.hpp"
 #include "lib/error.hpp"
-//#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 //#include <boost/format.hpp>
diff --git a/tests/lib/factory-special-test.cpp b/tests/lib/factory-special-test.cpp
index c8cc078d3..9e205b5ff 100644
--- a/tests/lib/factory-special-test.cpp
+++ b/tests/lib/factory-special-test.cpp
@@ -38,8 +38,8 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera {
-namespace test {
+namespace lib {
+namespace test{
   
   /**
    * Example Allocator using plain C memory management.
@@ -319,4 +319,4 @@ namespace test {
   
   
   
-}} // namespace lumiera::test
+}} // lib::test
diff --git a/tests/lib/factorytest.cpp b/tests/lib/factorytest.cpp
index d1026f7b4..1100c489f 100644
--- a/tests/lib/factorytest.cpp
+++ b/tests/lib/factorytest.cpp
@@ -36,8 +36,8 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera {
-namespace test {
+namespace lib {
+namespace test{
   
   class ObjFactory;
   
@@ -98,7 +98,7 @@ namespace test {
    *       further shared-ptrs, invoke a member function and
    *       finally, when leaving the scope, our TargetObj
    *       will be destroyed automatically.
-   * @see  lumiera::Factory
+   * @see  lib::Factory
    */
   class Factory_test : public Test
     {
@@ -121,4 +121,4 @@ namespace test {
   
   
   
-}} // namespace lumiera::test
+}} // namespace lib::test
diff --git a/tests/lib/singleton-subclass-test.cpp b/tests/lib/singleton-subclass-test.cpp
index 1ffa4a079..7fb274784 100644
--- a/tests/lib/singleton-subclass-test.cpp
+++ b/tests/lib/singleton-subclass-test.cpp
@@ -22,6 +22,7 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 #include "lib/util.hpp"
 
 #include "testtargetobj.hpp"
@@ -38,9 +39,10 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera {
-namespace test    {
+namespace lib {
+namespace test{
   
+  using lumiera::error::LUMIERA_ERROR_ASSERTION;
   
   /**
    * Target object to be instantiated as Singleton
@@ -85,9 +87,9 @@ namespace test    {
    *       subclasses (implementation classes) without coupling the 
    *       caller to the concrete class type.
    * Expected results: an instance of the subclass is created.
-   * @see  lumiera::Singleton
-   * @see  lumiera::SingletonSubclassFactory
-   * @see  lumiera::singleton::Adapter
+   * @see  lib::Singleton
+   * @see  lib::SingletonSubclassFactory
+   * @see  lib::singleton::Adapter
    */
   class SingletonSubclass_test : public Test
     {
@@ -131,18 +133,12 @@ namespace test    {
       void verify_error_detection ()
         {
           
-          singleton::UseSubclass<Impl_XXX> more_special_type;                       
+          singleton::UseSubclass<Impl_XXX> more_special_type;
           
-          try
-            {
-              SingletonSubclassFactory<Interface> instance (more_special_type);
-              cout << "was able to re-configure the SingletonSubclassFactory "
-                      "with another type. This should be detected in debug mode\n";
-            }
-          catch (...)
-            {
-              ASSERT (lumiera_error () == error::LUMIERA_ERROR_ASSERTION);
-            }
+          VERIFY_ERROR (ASSERTION, SingletonSubclassFactory<Interface> instance (more_special_type) );
+              /* in debug mode, an attempt to re-configure an already
+               * configured SingletonSubclassFactory with another type
+               * should be detected and spotted by assertion failure */
           
           
           // Note: the following won't compile, because the "subclass" isn't a subclass...
@@ -159,4 +155,4 @@ namespace test    {
   
   
   
-}} // namespace lumiera::test
+}} // namespace lib::test
diff --git a/tests/lib/singleton-test.cpp b/tests/lib/singleton-test.cpp
index a5a6fdd3f..e734ff275 100644
--- a/tests/lib/singleton-test.cpp
+++ b/tests/lib/singleton-test.cpp
@@ -40,8 +40,8 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera {
-namespace test    {
+namespace lib {
+namespace test{
   
   
   /**
@@ -72,9 +72,9 @@ namespace test    {
   /*******************************************************************
    * @test implement a Singleton class using our Singleton Template.
    * Expected results: no memory leaks.
-   * @see  lumiera::Singleton
-   * @see  lumiera::singleton::StaticCreate
-   * @see  lumiera::singleton::HeapCreate
+   * @see  lib::Singleton
+   * @see  lib::singleton::StaticCreate
+   * @see  lib::singleton::HeapCreate
    */
   class Singleton_test : public Test
     {
@@ -90,7 +90,7 @@ namespace test    {
         }
       
       
-      /** @test parametrize the Singleton creation such as to create
+      /** @test parametrise the Singleton creation such as to create
        *        the single TargetObj instance as a static variable.
        */
       void testStaticallyAllocatedSingleton (uint num)
@@ -100,7 +100,7 @@ namespace test    {
           useInstance (num, "statically allocated");
         }
       
-      /** @test parametrize the Singleton creation such as to create
+      /** @test parametrise the Singleton creation such as to create
        *        the single TargetObj instance allocated on the Heap
        *        and deleted automatically at application shutdown.
        */
@@ -134,4 +134,4 @@ namespace test    {
   
   
   
-}} // namespace lumiera::test
+}} // namespace lib::test
diff --git a/tests/lib/singletontestmocktest.cpp b/tests/lib/singletontestmocktest.cpp
index 797916f6a..ba4aade39 100644
--- a/tests/lib/singletontestmocktest.cpp
+++ b/tests/lib/singletontestmocktest.cpp
@@ -37,88 +37,88 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera
-  {
-  namespace test
+namespace lib {
+namespace test{
+  
+  
+  /**
+   * Client Class normally to be instantiated as Singleton.
+   * But for tests, this class should be replaced by a Mock....
+   */
+  class TestSingletonO
     {
-
-
-    /**
-     * Client Class normally to be instantiated as Singleton.
-     * But for tests, this class should be replaced by a Mock....
-     */
-    class TestSingletonO
+      int callCnt;
+      Symbol typid;
+      format msg;
+      
+    public:
+      TestSingletonO(Symbol ty="TestSingletonO")
+          : callCnt (0), typid(ty), msg ("%s::doIt() call=%d\n")
       {
-        int callCnt;
-        Symbol typid;
-        format msg;
-
-      public:
-        TestSingletonO(Symbol ty="TestSingletonO")
-            : callCnt (0), typid(ty), msg ("%s::doIt() call=%d\n")
-        {
-          TRACE (test, "ctor %s", typid.c());
-        }
-        virtual ~TestSingletonO()
-        {
-          TRACE (test, "dtor %s", typid.c());
-        }
-
-        void doIt ()
-        {
-          ++callCnt;
-          cout << msg % typid % callCnt;
-        }
-        int getCnt ()
-        {
-          return callCnt;
-        }
-
-      };
-
-
-    /**
-     * Mock-1 to replace the Client Class...
-     */
-    struct Mock_1 : TestSingletonO
+        TRACE (test, "ctor %s", typid.c());
+      }
+      virtual ~TestSingletonO()
       {
-        Mock_1() : TestSingletonO("Mock_1")
-        {};
-      };
-
-    /**
-     * Mock-2 to replace the Client Class...
-     */
-    struct Mock_2 : TestSingletonO
+        TRACE (test, "dtor %s", typid.c());
+      }
+      
+      void doIt ()
       {
-        Mock_2() : TestSingletonO("Mock_2")
-        {};
-      };
-
-
-
-
-
-
-
-
-
-
-    /*******************************************************************
-     * @test inject a Mock object into the Singleton Factory, 
-     *       to be returned and used in place of the original object.
-     * Expected results: Mock(s) called, no memory leaks.
-     * @see  lumiera::Singleton
-     * @see  lumiera::singleton::Static
-     */
-    class SingletonTestMock_test : public Test
+        ++callCnt;
+        cout << msg % typid % callCnt;
+      }
+      int getCnt ()
       {
-        Singleton<TestSingletonO> instance;
-
-        virtual void run(Arg arg)
+        return callCnt;
+      }
+      
+    };
+  
+  
+  /**
+   * Mock-1 to replace the Client Class...
+   */
+  struct Mock_1 : TestSingletonO
+    {
+      Mock_1() : TestSingletonO("Mock_1")
+      {};
+    };
+  
+  /**
+   * Mock-2 to replace the Client Class...
+   */
+  struct Mock_2 : TestSingletonO
+    {
+      Mock_2() : TestSingletonO("Mock_2")
+      {};
+    };
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  /*******************************************************************
+   * @test inject a Mock object into the Singleton Factory,
+   *       to be returned and used in place of the original object.
+   * Expected results: Mock(s) called, no memory leaks.
+   * @see  lib::Singleton
+   * @see  lib::singleton::Static
+   */
+  class SingletonTestMock_test : public Test
+    {
+      
+      Singleton<TestSingletonO> instance;
+      
+      void
+      run (Arg arg)
         {
           string scenario = isnil(arg)? "default" : arg[1];
-
+          
           if (scenario == "default")
             injectBoth();
           else
@@ -131,19 +131,20 @@ namespace lumiera
                 if (scenario == "firstMock")
                   firstMock();
         }
-
-
-        /** @test complete use sequence: first access the Client Object,
-         *        then replace it by two different mocks, and finally
-         *        restore the original Client Object 
-         */
-        void injectBoth ()
+      
+      
+      /** @test complete use sequence: first access the Client Object,
+       *        then replace it by two different mocks, and finally
+       *        restore the original Client Object 
+       */
+      void
+      injectBoth ()
         {
           TestSingletonO* sing = &instance();
           sing->doIt();
           sing->doIt();
           ASSERT (sing->getCnt() == 2);
-
+          
           instance.injectSubclass (new Mock_1);
           sing = &instance();
           sing->doIt();
@@ -152,66 +153,65 @@ namespace lumiera
           sing->doIt();
           sing->doIt();
           ASSERT (sing->getCnt() == 5);
-
+          
           instance.injectSubclass (new Mock_2);
           sing = &instance();
           sing->doIt();
           ASSERT (sing->getCnt() == 1);
-
+          
           instance.injectSubclass (0); // un-shadowing original instance
           sing = &instance();
           ASSERT (sing->getCnt() == 2);
           sing->doIt();
           ASSERT (sing->getCnt() == 3);
         }
-
-
-        /** @test just use Singleton Factory normally without any Mock.
-         */
-        void noMock ()
+      
+      
+      /** @test just use Singleton Factory normally without any Mock. */
+      void
+      noMock ()
         {
           TestSingletonO& sing = instance();
           sing.doIt();
         }
-
-
-        /** @test inject the Mock prior to using the Singleton Factory,
-         *        thus the original Client Object shouldn't be created. 
-         */
-        void onlyMock ()
+      
+      
+      /** @test inject the Mock prior to using the Singleton Factory,
+       *        thus the original Client Object shouldn't be created.*/
+      void
+      onlyMock ()
         {
           instance.injectSubclass (new Mock_1);
           TestSingletonO& sing = instance();
           sing.doIt();
         }
-
-
-        /** @test inject the Mock prior to using the Singleton Factory,
-         *        but then reset the Mock, so following calls should
-         *        create the original Client Object. 
-         */
-        void firstMock ()
+      
+      
+      /** @test inject the Mock prior to using the Singleton Factory,
+       *        but then reset the Mock, so following calls should
+       *        create the original Client Object. 
+       */
+      void
+      firstMock ()
         {
           instance.injectSubclass (new Mock_1);
           TestSingletonO* sing = &instance();
           sing->doIt();
           sing->doIt();
           ASSERT (sing->getCnt() == 2);
-
+          
           instance.injectSubclass (0);
           sing = &instance();
           sing->doIt();
           ASSERT (sing->getCnt() == 1);
         }
-      };
-
-
-
-    /** Register this test class... */
-    LAUNCHER (SingletonTestMock_test, "unit common");
-
-
-
-  } // namespace test
-
-} // namespace lumiera
+    };
+  
+  
+  
+  /** Register this test class... */
+  LAUNCHER (SingletonTestMock_test, "unit common");
+  
+  
+  
+}} // namespace lib::test
diff --git a/tests/lib/testtargetobj.hpp b/tests/lib/testtargetobj.hpp
index a0159deab..c3b1e77ef 100644
--- a/tests/lib/testtargetobj.hpp
+++ b/tests/lib/testtargetobj.hpp
@@ -26,7 +26,6 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/factory.hpp"
 //#include "lib/util.hpp"
 
 #include <boost/algorithm/string/join.hpp>
@@ -41,71 +40,68 @@ using std::string;
 using std::cout;
 
 
-namespace lumiera
-  {
-  namespace test
-    {
-    /**
-     * Target object to be created by Test-Factories or as Singleton.
-     * Allocates a variable amount of additional heap memory
-     * and prints diagnostic messages.
-     */
-    class TestTargetObj
-      {
-        uint cnt_;
-        string* heapData_; 
-        string* heapArray_; 
-        
-      public:
-        TestTargetObj(uint num);
-        ~TestTargetObj()  throw();
-        
-        operator string () const;
-      };
-    
-    
-    
-    inline
-    TestTargetObj::TestTargetObj(uint num)
-      : cnt_ (num),
-        heapData_ (new string(num,'*')),
-        heapArray_ (new string[num])
-    {
-      for (uint i=0; i<cnt_; ++i)
-        heapArray_[i] = lexical_cast<string>(i);
-      cout << format("ctor TargetObj(%i) successful\n") % cnt_;
-    }
-    
-    
-    inline
-    TestTargetObj::~TestTargetObj()  throw()
-    {
-      delete heapData_;
-      delete[] heapArray_;
-      cout << format("dtor ~TargetObj(%i) successful\n") % cnt_;
-    }
-    
-    
-    
-    inline
-    TestTargetObj::operator string () const
-    {
-      string array_contents = "{";
-      for (uint i=0; i<cnt_; ++i)
-        array_contents += heapArray_[i]+",";
-      array_contents+="}";
-      
-      return str (format(".....TargetObj(%1%): data=\"%2%\", array[%1%]=%3%")
-                        % cnt_ 
-                        % *heapData_ 
-                        % array_contents
-                 );
-    }
-    
-    
-    
-    
-  } // namespace test
+namespace lib {
+namespace test{
 
-} // namespace lumiera
+  /**
+   * Target object to be created by Test-Factories or as Singleton.
+   * Allocates a variable amount of additional heap memory
+   * and prints diagnostic messages.
+   */
+  class TestTargetObj
+    {
+      uint cnt_;
+      string* heapData_; 
+      string* heapArray_; 
+      
+    public:
+      TestTargetObj(uint num);
+      ~TestTargetObj()  throw();
+      
+      operator string () const;
+    };
+  
+  
+  
+  inline
+  TestTargetObj::TestTargetObj(uint num)
+    : cnt_ (num),
+      heapData_ (new string(num,'*')),
+      heapArray_ (new string[num])
+  {
+    for (uint i=0; i<cnt_; ++i)
+      heapArray_[i] = lexical_cast<string>(i);
+    cout << format("ctor TargetObj(%i) successful\n") % cnt_;
+  }
+  
+  
+  inline
+  TestTargetObj::~TestTargetObj()  throw()
+  {
+    delete heapData_;
+    delete[] heapArray_;
+    cout << format("dtor ~TargetObj(%i) successful\n") % cnt_;
+  }
+  
+  
+  
+  inline
+  TestTargetObj::operator string () const
+  {
+    string array_contents = "{";
+    for (uint i=0; i<cnt_; ++i)
+      array_contents += heapArray_[i]+",";
+    array_contents+="}";
+    
+    return str (format(".....TargetObj(%1%): data=\"%2%\", array[%1%]=%3%")
+                      % cnt_ 
+                      % *heapData_ 
+                      % array_contents
+               );
+  }
+  
+  
+  
+  
+}} // namespace lib::test
 #endif
diff --git a/tests/lib/visitingtoolconcept.cpp b/tests/lib/visitingtoolconcept.cpp
index 056a103df..352273358 100644
--- a/tests/lib/visitingtoolconcept.cpp
+++ b/tests/lib/visitingtoolconcept.cpp
@@ -60,7 +60,7 @@
 #include <iostream>
 #include <vector>
 
-using lumiera::Singleton;
+using lib::Singleton;
 using boost::format;
 using std::string;
 using std::cout;

From 8ee76b1bfdcc64a3eaf5ddd0125c06057a64b277 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 30 Sep 2009 02:26:32 +0200
Subject: [PATCH 325/368] configurable factory? test-driven brainstorming

---
 src/lib/multifact.hpp        | 120 +++++++++++++++++++++++++++++++++++
 tests/40components.tests     |  10 +++
 tests/lib/Makefile.am        |   3 +-
 tests/lib/multifact-test.cpp | 118 ++++++++++++++++++++++++++++++++++
 4 files changed, 250 insertions(+), 1 deletion(-)
 create mode 100644 src/lib/multifact.hpp
 create mode 100644 tests/lib/multifact-test.cpp

diff --git a/src/lib/multifact.hpp b/src/lib/multifact.hpp
new file mode 100644
index 000000000..d7595565c
--- /dev/null
+++ b/src/lib/multifact.hpp
@@ -0,0 +1,120 @@
+/*
+  MULTIFACT.hpp  -  flexible family-of-object factory template
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+/** @file multifact.hpp
+ ** Building blocks of a configurable factory, generating families of related objects.
+ ** 
+ ** @todo WIP-WIP-WIP ... currently collecting various bits of implementation here. TICKET #277
+ ** 
+ ** @see SingletonFactory
+ ** @see lib::factory::Factory
+ */
+
+
+#ifndef LIB_MULTIFACT_H
+#define LIB_MULTIFACT_H
+
+
+#include "lib/error.hpp"
+//#include <tr1/memory>
+
+#include <tr1/functional>
+
+
+
+namespace lib {
+  namespace factory {
+    
+    /**
+     * Repository of registered production lines.
+     * @todo write type comment
+     */
+    template<typename TY, typename ID>
+    class Fab
+      {
+        typedef TY& RawProduct;
+        typedef std::tr1::function<RawProduct(void)> & FactoryFunc;
+        
+      public:
+        static FactoryFunc
+        select (ID id)
+          {
+            UNIMPLEMENTED ("how to store/select the production line");
+          }
+        
+        static void
+        defineProduction (ID id, FactoryFunc fun)
+          {
+            UNIMPLEMENTED ("how to store/select the production line");
+          }
+      };
+    
+    
+    
+    /**
+     * @todo write type comment
+     */
+    template< typename TY
+            , typename ID
+            , template<class> class Wrapper
+            >
+    class MultiFact
+      : Wrapper<TY>
+      {
+        typedef Fab<TY,ID> _Fab;
+        typedef typename _Fab::FactoryFunc Creator;
+        typedef typename WR::PType Product;
+        
+      public:
+        Product
+        operator() (ID id)
+          {
+            Creator func = _Fab::select(id);
+            return wrap (func());
+          }
+        
+        /**
+         * to set up a production line,
+         * associated with a specific ID
+         */
+        struct Produce
+          : Creator
+          {
+            template<typename FUNC>
+            Produce (ID id, FUNC fun)
+              : Creator(fun)
+              {
+                _Fab::defineProduction (id, *this);
+              }
+          };
+        
+      };
+      
+      
+      
+  } // namespace factory
+  
+//using factory::Factory;
+  
+  
+} // namespace lib
+#endif
diff --git a/tests/40components.tests b/tests/40components.tests
index c7efedcf3..2da0e1e44 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -284,6 +284,16 @@ return: 0
 END
 
 
+PLANNED "configurable Factory" MultiFact_test <<END
+out: Impl-1
+out: Impl-2
+out: Impl-3
+out: Impl-4
+out: sizeof\( .+ \) =   1
+return: 0
+END
+
+
 TEST "inline type erasure" OpaqueHolder_test  <<END
 out: 1
 out: 3
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index 1acd20f60..d0fca1599 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -36,6 +36,7 @@ test_lib_LDADD =			\
 	$(NOBUGMT_LUMIERA_LIBS) -ldl -lboost_program_options-mt -lboost_regex-mt
 
 test_lib_SOURCES =						\
+	$(testlib_srcdir)/mainsuite.cpp				\
 	$(testlib_srcdir)/allocationclustertest.cpp		\
 	$(testlib_srcdir)/appconfigtest.cpp			\
 	$(testlib_srcdir)/customsharedptrtest.cpp		\
@@ -48,8 +49,8 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/hash-indexed-test.cpp			\
 	$(testlib_srcdir)/helloworldtest.cpp			\
 	$(testlib_srcdir)/lifecycletest.cpp			\
+	$(testlib_srcdir)/multifact-test.cpp			\
 	$(testlib_srcdir)/iter-adapter-test.cpp			\
-	$(testlib_srcdir)/mainsuite.cpp				\
 	$(testlib_srcdir)/meta/typelist-test.cpp         	\
 	$(testlib_srcdir)/meta/typelist-manip-test.cpp    	\
 	$(testlib_srcdir)/meta/typeseq-manip-test.cpp    	\
diff --git a/tests/lib/multifact-test.cpp b/tests/lib/multifact-test.cpp
new file mode 100644
index 000000000..e91ba71f6
--- /dev/null
+++ b/tests/lib/multifact-test.cpp
@@ -0,0 +1,118 @@
+/*
+  MultiFact(Test)  -  unittest for the configurable object-family creating factory
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/multifact.hpp"
+#include "lib/util.hpp"
+
+#include <boost/lexical_cast.hpp>
+#include <iostream>
+#include <string>
+
+
+
+namespace lib {
+namespace test{
+  
+  using boost::lexical_cast;
+  //using util::isnil;
+  using util::isSameObject;
+  using std::string;
+  using std::cout;
+  
+  
+  namespace { // hierarchy of test dummy objects
+    
+    struct Interface
+      {
+        virtual ~Interface() {};
+        virtual operator string ();
+      };
+    
+    enum theID
+      { ONE = 1
+      , TWO
+      , THR
+      , FOU
+      };
+    
+    typedef MultiFact<Interface, theID, PassReference> TestFactory;
+    
+    
+    template<theID ii>
+    class Implementation
+      : public Interface
+      {
+        operator string()
+          {
+            return "Impl-"+lexical_cast<string> (ii);
+          }
+      };
+    
+    TestFactory::ProduceSingleton<Implementation<ONE> > _register_for_fabrication_ONE;
+    TestFactory::ProduceSingleton<Implementation<TWO> > _register_for_fabrication_TWO;
+    TestFactory::ProduceSingleton<Implementation<THR> > _register_for_fabrication_THR;
+    TestFactory::ProduceSingleton<Implementation<FOU> > _register_for_fabrication_FOU;
+  }
+  
+  
+  
+  
+  
+  /*******************************************************************
+   * @test verify simple setup of the MultiFact template.
+   *       Define a hierarchy of test dummy objects, such as to
+   *       register them automatically for creation through a suitable
+   *       instantiation of MultiFact. Verify we get the correct product
+   *       when invoking this MultiFac flavour.
+   * @see  lib::MultiFact
+   */
+  class MultiFact_test : public Test
+    {
+      void
+      run (Arg) 
+        {
+          TestFactory theFact;
+          cout << theFact(ONE) << endl;
+          cout << theFact(TWO) << endl;
+          cout << theFact(THR) << endl;
+          cout << theFact(FOU) << endl;
+          cout << showSizeof (theFact) << endl;
+          
+          Interface & o1 = theFact(ONE);
+          Interface & o2 = theFact(ONE);
+          ASSERT (isSameObject(o1,o2));
+          
+          TestFactory anotherFact;
+          Interface & o3 = anotherFact(ONE);
+          ASSERT (isSameObject(o2,o3));
+        } 
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (MultiFact_test, "unit common");
+  
+  
+  
+}} // namespace lib::test

From 5910f213839dbbd0b4a6011d4bc16bca0f67457c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 30 Sep 2009 18:18:30 +0200
Subject: [PATCH 326/368] first draft impl regarding automatic installation of
 a singleton facotry into MultiFact

---
 src/lib/multifact.hpp        | 65 ++++++++++++++++++++++++++++++++----
 tests/lib/multifact-test.cpp | 18 +++++++---
 2 files changed, 71 insertions(+), 12 deletions(-)

diff --git a/src/lib/multifact.hpp b/src/lib/multifact.hpp
index d7595565c..85b63fea8 100644
--- a/src/lib/multifact.hpp
+++ b/src/lib/multifact.hpp
@@ -35,6 +35,7 @@
 
 
 #include "lib/error.hpp"
+#include "lib/singleton.hpp"
 //#include <tr1/memory>
 
 #include <tr1/functional>
@@ -44,6 +45,18 @@
 namespace lib {
   namespace factory {
     
+    /**
+     * Dummy "wrapper",
+     * just returning a target-ref
+     */
+    template<typename TAR>
+    struct PassReference
+      {
+        typedef TAR& PType;
+        
+        PType wrap (TAR& object) { return object; }
+      };
+    
     /**
      * Repository of registered production lines.
      * @todo write type comment
@@ -52,10 +65,11 @@ namespace lib {
     class Fab
       {
         typedef TY& RawProduct;
-        typedef std::tr1::function<RawProduct(void)> & FactoryFunc;
         
       public:
-        static FactoryFunc
+        typedef std::tr1::function<RawProduct(void)> FactoryFunc;
+        
+        static FactoryFunc&
         select (ID id)
           {
             UNIMPLEMENTED ("how to store/select the production line");
@@ -82,13 +96,13 @@ namespace lib {
       {
         typedef Fab<TY,ID> _Fab;
         typedef typename _Fab::FactoryFunc Creator;
-        typedef typename WR::PType Product;
+        typedef typename Wrapper<TY>::PType Product;
         
       public:
         Product
         operator() (ID id)
           {
-            Creator func = _Fab::select(id);
+            Creator& func = _Fab::select(id);
             return wrap (func());
           }
         
@@ -107,10 +121,47 @@ namespace lib {
               }
           };
         
+        /**
+         * Convenience shortcut for automatically setting up
+         * a production line, fabricating a singleton instance
+         * of the given target type (TAR)
+         */
+        template<class TAR>
+        class ProduceSingleton
+          {
+            static Produce autoRegistration;
+            
+            typedef std::tr1::function<TAR&(void)> AccessSingleton_Func;
+            
+            static AccessSingleton_Func
+            createSingleton_accessFunction()
+              {
+                static Singleton<TAR> theSingletonFactory;
+                // using this static singleton factory for
+                // "fabricating" the TAR instance. Consequently,
+                // the created TAR object lives within this static
+                // allocated memory.
+                return std::tr1::bind (&Singleton<TAR>::operator(), theSingletonFactory);
+              }
+          };
+        
       };
-      
-      
-      
+    
+    
+    /** define a static instance variable
+     *  to trigger the sideeffect of automatic registration.
+     *  This templated definition actually happens, when the
+     *  ProduceSingleton template gets instantiated. This may be
+     *  triggered explicitly, or by inheriting from ProduceSingleton.
+     */
+    template< typename TY, typename ID
+            , template<class> class Wrapper>
+    template< class TAR>
+    typename MultiFact<TY,ID,Wrapper>::Produce
+    MultiFact<TY,ID,Wrapper>::ProduceSingleton<TAR>::autoRegistration ( TY::getID()  // required within target type!
+                                                                      , createSingleton_accessFunction());
+    
+    
   } // namespace factory
   
 //using factory::Factory;
diff --git a/tests/lib/multifact-test.cpp b/tests/lib/multifact-test.cpp
index e91ba71f6..9cb2e0cc8 100644
--- a/tests/lib/multifact-test.cpp
+++ b/tests/lib/multifact-test.cpp
@@ -22,6 +22,7 @@
 
 
 #include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
 #include "lib/multifact.hpp"
 #include "lib/util.hpp"
 
@@ -35,10 +36,13 @@ namespace lib {
 namespace test{
   
   using boost::lexical_cast;
+  using lib::test::showSizeof;
   //using util::isnil;
   using util::isSameObject;
+  using std::ostream;
   using std::string;
   using std::cout;
+  using std::endl;
   
   
   namespace { // hierarchy of test dummy objects
@@ -49,6 +53,9 @@ namespace test{
         virtual operator string ();
       };
     
+    inline ostream& operator<< (ostream& os, Interface& ifa) { return os << string(ifa); }
+    
+    
     enum theID
       { ONE = 1
       , TWO
@@ -56,12 +63,13 @@ namespace test{
       , FOU
       };
     
-    typedef MultiFact<Interface, theID, PassReference> TestFactory;
+    typedef factory::MultiFact<Interface, theID, factory::PassReference> TestFactory;
     
     
     template<theID ii>
     class Implementation
       : public Interface
+      , TestFactory::ProduceSingleton<Implementation<ii> >
       {
         operator string()
           {
@@ -69,10 +77,10 @@ namespace test{
           }
       };
     
-    TestFactory::ProduceSingleton<Implementation<ONE> > _register_for_fabrication_ONE;
-    TestFactory::ProduceSingleton<Implementation<TWO> > _register_for_fabrication_TWO;
-    TestFactory::ProduceSingleton<Implementation<THR> > _register_for_fabrication_THR;
-    TestFactory::ProduceSingleton<Implementation<FOU> > _register_for_fabrication_FOU;
+    template class Implementation<ONE>;
+    template class Implementation<TWO>;
+    template class Implementation<THR>;
+    template class Implementation<FOU>;
   }
   
   

From bc6f8eebdaf05839d982852e6771d5329e9dc963 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 30 Sep 2009 23:22:28 +0200
Subject: [PATCH 327/368] basically working draft; convoluted and with a lot of
 static magic

---
 src/lib/multifact.hpp                  | 71 +++++++++++++++-----------
 src/proc/control/handling-patterns.hpp |  4 +-
 tests/lib/multifact-test.cpp           | 14 ++---
 3 files changed, 52 insertions(+), 37 deletions(-)

diff --git a/src/lib/multifact.hpp b/src/lib/multifact.hpp
index 85b63fea8..002b09d95 100644
--- a/src/lib/multifact.hpp
+++ b/src/lib/multifact.hpp
@@ -39,6 +39,7 @@
 //#include <tr1/memory>
 
 #include <tr1/functional>
+#include <map>
 
 
 
@@ -62,24 +63,26 @@ namespace lib {
      * @todo write type comment
      */
     template<typename TY, typename ID>
-    class Fab
+    struct Fab
       {
         typedef TY& RawProduct;
-        
-      public:
         typedef std::tr1::function<RawProduct(void)> FactoryFunc;
         
+        
         static FactoryFunc&
         select (ID id)
           {
-            UNIMPLEMENTED ("how to store/select the production line");
+            return producerTable_[id];
           }
         
         static void
-        defineProduction (ID id, FactoryFunc fun)
+        defineProduction (ID id, FactoryFunc& fun)
           {
-            UNIMPLEMENTED ("how to store/select the production line");
+            producerTable_[id] = fun;
           }
+        
+      private:
+        std::map<ID, FactoryFunc> producerTable_;
       };
     
     
@@ -128,38 +131,48 @@ namespace lib {
          */
         template<class TAR>
         class ProduceSingleton
+          : Singleton<TAR>
+          , Produce
           {
-            static Produce autoRegistration;
-            
             typedef std::tr1::function<TAR&(void)> AccessSingleton_Func;
             
-            static AccessSingleton_Func
-            createSingleton_accessFunction()
+            AccessSingleton_Func
+            createSingleton_accessFunction(Singleton<TAR>* theFactory)
               {
-                static Singleton<TAR> theSingletonFactory;
-                // using this static singleton factory for
-                // "fabricating" the TAR instance. Consequently,
-                // the created TAR object lives within this static
-                // allocated memory.
-                return std::tr1::bind (&Singleton<TAR>::operator(), theSingletonFactory);
+                return std::tr1::bind (&Singleton<TAR>::operator(), theFactory);
+              }
+            
+          public:
+            ProduceSingleton()
+              : Produce ( TAR::getTypeID()  // required within target type!
+                        , createSingleton_accessFunction(this))
+              {
+                INFO (test, "zoing");
               }
           };
-        
       };
     
+    template<class X>
+    struct AutoInstantiation
+      {
+        static X autoRegistration;
+      };
     
-    /** define a static instance variable
-     *  to trigger the sideeffect of automatic registration.
-     *  This templated definition actually happens, when the
-     *  ProduceSingleton template gets instantiated. This may be
-     *  triggered explicitly, or by inheriting from ProduceSingleton.
-     */
-    template< typename TY, typename ID
-            , template<class> class Wrapper>
-    template< class TAR>
-    typename MultiFact<TY,ID,Wrapper>::Produce
-    MultiFact<TY,ID,Wrapper>::ProduceSingleton<TAR>::autoRegistration ( TY::getID()  // required within target type!
-                                                                      , createSingleton_accessFunction());
+    template<class X>
+    X AutoInstantiation<X>::autoRegistration;
+    
+//    /** define a static instance variable
+//     *  to trigger the sideeffect of automatic registration.
+//     *  This templated definition actually happens, when the
+//     *  ProduceSingleton template gets instantiated. This may be
+//     *  triggered explicitly, or by inheriting from ProduceSingleton.
+//     */
+//    template< typename TY, typename ID
+//            , template<class> class Wrapper>
+//    template< class TAR>
+//    typename MultiFact<TY,ID,Wrapper>::Produce
+//    MultiFact<TY,ID,Wrapper>::ProduceSingleton<TAR>::autoRegistration ( TY::getID()  // required within target type!
+//                                                                      , createSingleton_accessFunction());
     
     
   } // namespace factory
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index 4b6f968ef..8a5a87c2c 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -181,8 +181,8 @@ namespace control {
       using lib::singleton::UseSubclass;
       
       patternTable[HandlingPattern::SYNC      ]  = SingletonFac(UseSubclass<InvokeSyncNoThrow>());
-      patternTable[HandlingPattern::SYNC_THROW]  = SingletonFac(UseSubclass<InvokeSyncThrow>());
-      patternTable[HandlingPattern::ASYNC     ]  = SingletonFac(UseSubclass<InvokeAsync>());
+//      patternTable[HandlingPattern::SYNC_THROW]  = SingletonFac(UseSubclass<InvokeSyncThrow>());
+//      patternTable[HandlingPattern::ASYNC     ]  = SingletonFac(UseSubclass<InvokeAsync>());
     }
     
     
diff --git a/tests/lib/multifact-test.cpp b/tests/lib/multifact-test.cpp
index 9cb2e0cc8..164311faf 100644
--- a/tests/lib/multifact-test.cpp
+++ b/tests/lib/multifact-test.cpp
@@ -50,7 +50,7 @@ namespace test{
     struct Interface
       {
         virtual ~Interface() {};
-        virtual operator string ();
+        virtual operator string () =0;
       };
     
     inline ostream& operator<< (ostream& os, Interface& ifa) { return os << string(ifa); }
@@ -69,18 +69,20 @@ namespace test{
     template<theID ii>
     class Implementation
       : public Interface
-      , TestFactory::ProduceSingleton<Implementation<ii> >
       {
         operator string()
           {
             return "Impl-"+lexical_cast<string> (ii);
           }
+        
+      public:
+        static theID getTypeID() { return ii; }
       };
     
-    template class Implementation<ONE>;
-    template class Implementation<TWO>;
-    template class Implementation<THR>;
-    template class Implementation<FOU>;
+    TestFactory::ProduceSingleton<Implementation<ONE> > singletonInstantiation_ONE;
+    TestFactory::ProduceSingleton<Implementation<TWO> > singletonInstantiation_TWO;
+    TestFactory::ProduceSingleton<Implementation<THR> > singletonInstantiation_THR;
+    TestFactory::ProduceSingleton<Implementation<FOU> > singletonInstantiation_FOU;
   }
   
   

From b7204e05edffeae7774c9f4b544ab1407f77913c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 30 Sep 2009 23:57:45 +0200
Subject: [PATCH 328/368] removed all the magic and made it simply instance
 based

---
 src/lib/multifact.hpp        | 78 ++++++++++++++----------------------
 tests/40components.tests     |  2 +-
 tests/lib/multifact-test.cpp | 15 ++++---
 3 files changed, 40 insertions(+), 55 deletions(-)

diff --git a/src/lib/multifact.hpp b/src/lib/multifact.hpp
index 002b09d95..c24648bd7 100644
--- a/src/lib/multifact.hpp
+++ b/src/lib/multifact.hpp
@@ -36,7 +36,7 @@
 
 #include "lib/error.hpp"
 #include "lib/singleton.hpp"
-//#include <tr1/memory>
+#include "util.hpp"
 
 #include <tr1/functional>
 #include <map>
@@ -46,6 +46,8 @@
 namespace lib {
   namespace factory {
     
+    using util::contains;
+    
     /**
      * Dummy "wrapper",
      * just returning a target-ref
@@ -69,14 +71,17 @@ namespace lib {
         typedef std::tr1::function<RawProduct(void)> FactoryFunc;
         
         
-        static FactoryFunc&
+        FactoryFunc&
         select (ID id)
           {
+            if (!contains (producerTable_,id))
+              throw lumiera::error::Invalid("unknown factory product requested.");
+            
             return producerTable_[id];
           }
         
-        static void
-        defineProduction (ID id, FactoryFunc& fun)
+        void
+        defineProduction (ID id, FactoryFunc fun)
           {
             producerTable_[id] = fun;
           }
@@ -101,28 +106,25 @@ namespace lib {
         typedef typename _Fab::FactoryFunc Creator;
         typedef typename Wrapper<TY>::PType Product;
         
+        _Fab funcTable_;
+        
       public:
         Product
         operator() (ID id)
           {
-            Creator& func = _Fab::select(id);
+            Creator& func = funcTable_.select(id);
             return wrap (func());
           }
         
-        /**
-         * to set up a production line,
-         * associated with a specific ID
+        /** to set up a production line,
+         *  associated with a specific ID
          */
-        struct Produce
-          : Creator
+        template<typename FUNC>
+        void
+        defineProduction (ID id, FUNC fun)
           {
-            template<typename FUNC>
-            Produce (ID id, FUNC fun)
-              : Creator(fun)
-              {
-                _Fab::defineProduction (id, *this);
-              }
-          };
+            funcTable_.defineProduction (id, fun);
+          }
         
         /**
          * Convenience shortcut for automatically setting up
@@ -130,49 +132,27 @@ namespace lib {
          * of the given target type (TAR)
          */
         template<class TAR>
-        class ProduceSingleton
-          : Singleton<TAR>
-          , Produce
+        class Singleton
+          : lib::Singleton<TAR>
           {
-            typedef std::tr1::function<TAR&(void)> AccessSingleton_Func;
+            typedef lib::Singleton<TAR> SingFac;
+//            typedef std::tr1::function<TAR&(void)> AccessSingleton_Func;
             
-            AccessSingleton_Func
-            createSingleton_accessFunction(Singleton<TAR>* theFactory)
+            Creator
+            createSingleton_accessFunction()
               {
-                return std::tr1::bind (&Singleton<TAR>::operator(), theFactory);
+                return std::tr1::bind (&SingFac::operator()
+                                      , static_cast<SingFac*>(this));
               }
             
           public:
-            ProduceSingleton()
-              : Produce ( TAR::getTypeID()  // required within target type!
-                        , createSingleton_accessFunction(this))
+            Singleton (MultiFact& factory, ID id)
               {
-                INFO (test, "zoing");
+                factory.defineProduction(id, createSingleton_accessFunction());
               }
           };
       };
     
-    template<class X>
-    struct AutoInstantiation
-      {
-        static X autoRegistration;
-      };
-    
-    template<class X>
-    X AutoInstantiation<X>::autoRegistration;
-    
-//    /** define a static instance variable
-//     *  to trigger the sideeffect of automatic registration.
-//     *  This templated definition actually happens, when the
-//     *  ProduceSingleton template gets instantiated. This may be
-//     *  triggered explicitly, or by inheriting from ProduceSingleton.
-//     */
-//    template< typename TY, typename ID
-//            , template<class> class Wrapper>
-//    template< class TAR>
-//    typename MultiFact<TY,ID,Wrapper>::Produce
-//    MultiFact<TY,ID,Wrapper>::ProduceSingleton<TAR>::autoRegistration ( TY::getID()  // required within target type!
-//                                                                      , createSingleton_accessFunction());
     
     
   } // namespace factory
diff --git a/tests/40components.tests b/tests/40components.tests
index 2da0e1e44..0292330ab 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -289,7 +289,7 @@ out: Impl-1
 out: Impl-2
 out: Impl-3
 out: Impl-4
-out: sizeof\( .+ \) =   1
+out: sizeof\( .+MultiFact.+Interface.+theID.+PassReference.+ \) =
 return: 0
 END
 
diff --git a/tests/lib/multifact-test.cpp b/tests/lib/multifact-test.cpp
index 164311faf..8669b188d 100644
--- a/tests/lib/multifact-test.cpp
+++ b/tests/lib/multifact-test.cpp
@@ -44,6 +44,7 @@ namespace test{
   using std::cout;
   using std::endl;
   
+  using lumiera::error::LUMIERA_ERROR_INVALID;
   
   namespace { // hierarchy of test dummy objects
     
@@ -79,10 +80,12 @@ namespace test{
         static theID getTypeID() { return ii; }
       };
     
-    TestFactory::ProduceSingleton<Implementation<ONE> > singletonInstantiation_ONE;
-    TestFactory::ProduceSingleton<Implementation<TWO> > singletonInstantiation_TWO;
-    TestFactory::ProduceSingleton<Implementation<THR> > singletonInstantiation_THR;
-    TestFactory::ProduceSingleton<Implementation<FOU> > singletonInstantiation_FOU;
+    TestFactory theFact;
+    
+    TestFactory::Singleton<Implementation<ONE> > holder1 (theFact,ONE);
+    TestFactory::Singleton<Implementation<TWO> > holder2 (theFact,TWO);
+    TestFactory::Singleton<Implementation<THR> > holder3 (theFact,THR);
+    TestFactory::Singleton<Implementation<FOU> > holder4 (theFact,FOU);
   }
   
   
@@ -102,7 +105,6 @@ namespace test{
       void
       run (Arg) 
         {
-          TestFactory theFact;
           cout << theFact(ONE) << endl;
           cout << theFact(TWO) << endl;
           cout << theFact(THR) << endl;
@@ -114,6 +116,9 @@ namespace test{
           ASSERT (isSameObject(o1,o2));
           
           TestFactory anotherFact;
+          VERIFY_ERROR (INVALID, anotherFact(ONE) );
+          
+          TestFactory::Singleton<Implementation<ONE> > anotherSingletonHolder (anotherFact,ONE);
           Interface & o3 = anotherFact(ONE);
           ASSERT (isSameObject(o2,o3));
         } 

From 7e4a984ed464bbc577685312b14c16f8d396b47d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 1 Oct 2009 01:00:21 +0200
Subject: [PATCH 329/368] Finish MultiFact for now; use it to set up a table of
 HandlingPatterns

---
 src/lib/multifact.hpp                  | 53 +++++++++++++++++++++-----
 src/proc/control/handling-patterns.hpp | 34 ++++++-----------
 tests/lib/multifact-test.cpp           |  6 ++-
 3 files changed, 59 insertions(+), 34 deletions(-)

diff --git a/src/lib/multifact.hpp b/src/lib/multifact.hpp
index c24648bd7..557e52375 100644
--- a/src/lib/multifact.hpp
+++ b/src/lib/multifact.hpp
@@ -46,7 +46,6 @@
 namespace lib {
   namespace factory {
     
-    using util::contains;
     
     /**
      * Dummy "wrapper",
@@ -60,9 +59,11 @@ namespace lib {
         PType wrap (TAR& object) { return object; }
       };
     
+    
     /**
-     * Repository of registered production lines.
-     * @todo write type comment
+     * Table of registered production functions for MultiFact.
+     * Each stored function can be accessed by ID and is able
+     * to fabricate a specific object, which is assignable to TY
      */
     template<typename TY, typename ID>
     struct Fab
@@ -74,7 +75,7 @@ namespace lib {
         FactoryFunc&
         select (ID id)
           {
-            if (!contains (producerTable_,id))
+            if (!contains (id))
               throw lumiera::error::Invalid("unknown factory product requested.");
             
             return producerTable_[id];
@@ -86,6 +87,12 @@ namespace lib {
             producerTable_[id] = fun;
           }
         
+        
+        /* === diagnostics === */
+        
+        bool empty ()         const { return producerTable_.empty(); }
+        bool contains (ID id) const { return util::contains (producerTable_,id); }
+        
       private:
         std::map<ID, FactoryFunc> producerTable_;
       };
@@ -93,7 +100,14 @@ namespace lib {
     
     
     /**
-     * @todo write type comment
+     * Factory for creating a family of objects by ID.
+     * The actual factory functions are to be installed
+     * from the usage site through calls to #defineProduction .
+     * Each generated object will be treated by the Wrapper template,
+     * allowing for the generation of smart-ptrs. The embedded class
+     * Singleton allows to build a family of singleton objects; it is
+     * to be instantiated at the call site and acts as singleton factory,
+     * accessible through a MultiFact instance as frontend.
      */
     template< typename TY
             , typename ID
@@ -108,6 +122,7 @@ namespace lib {
         
         _Fab funcTable_;
         
+        
       public:
         Product
         operator() (ID id)
@@ -116,6 +131,7 @@ namespace lib {
             return wrap (func());
           }
         
+        
         /** to set up a production line,
          *  associated with a specific ID
          */
@@ -126,17 +142,17 @@ namespace lib {
             funcTable_.defineProduction (id, fun);
           }
         
+        
         /**
          * Convenience shortcut for automatically setting up
          * a production line, fabricating a singleton instance
          * of the given target type (TAR)
          */
-        template<class TAR>
+        template<class IMP>
         class Singleton
-          : lib::Singleton<TAR>
+          : lib::Singleton<IMP>
           {
-            typedef lib::Singleton<TAR> SingFac;
-//            typedef std::tr1::function<TAR&(void)> AccessSingleton_Func;
+            typedef lib::Singleton<IMP> SingFac;
             
             Creator
             createSingleton_accessFunction()
@@ -151,13 +167,30 @@ namespace lib {
                 factory.defineProduction(id, createSingleton_accessFunction());
               }
           };
+          
+        
+        /* === diagnostics === */
+          
+        bool empty ()         const { return funcTable_.empty();       }
+        bool contains (ID id) const { return funcTable_.contains (id); }
       };
     
     
     
   } // namespace factory
   
-//using factory::Factory;
+  
+  
+  /** 
+   * Standard configuration of the family-of-object factory
+   * @todo this is rather guesswork... find out what the best and most used configuration could be....
+   */
+  template< typename TY
+          , typename ID
+          >
+  class MultiFact
+    : public factory::MultiFact<TY,ID, factory::PassReference>
+    { };
   
   
 } // namespace lib
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index 8a5a87c2c..0bf03035b 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -44,7 +44,7 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
-#include "lib/singleton-subclass.hpp"
+#include "lib/multifact.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/command-impl.hpp"
 #include "include/lifecycle.h"
@@ -156,39 +156,27 @@ namespace control {
     
     /* ======== Handling Pattern Table ========== */
     
-    typedef lib::SingletonSub<HandlingPattern> SingletonFac;
+    typedef lib::MultiFact<HandlingPattern, HandlingPattern::ID> HandlingPatternFactory;
     
     /** Table of available command handling patterns */
-    vector<SingletonFac> patternTable;
+    HandlingPatternFactory patternTable;
+    
+    HandlingPatternFactory::Singleton<InvokeSyncNoThrow> holder1 (patternTable, HandlingPattern::SYNC);
+    HandlingPatternFactory::Singleton<InvokeSyncThrow>   holder2 (patternTable, HandlingPattern::SYNC_THROW);
+    HandlingPatternFactory::Singleton<InvokeAsync>       holder3 (patternTable, HandlingPattern::ASYNC);
     
     
     /** access the singleton instance for a given ID */
     inline HandlingPattern const&
-    getPatternInstance (size_t id)
+    getPatternInstance (HandlingPattern::ID id)
     {
-      REQUIRE (id < patternTable.size());
-      return patternTable[id] ();
-    }
-    
-    
-    /** populate the handling pattern table.
-     *  This init-function will be invoked each time
-     *  a new session is created or loaded.
-     */
-    void
-    prepareCommandHandlingPatterns()
-    {
-      using lib::singleton::UseSubclass;
+      REQUIRE (patternTable.contains(id));
       
-      patternTable[HandlingPattern::SYNC      ]  = SingletonFac(UseSubclass<InvokeSyncNoThrow>());
-//      patternTable[HandlingPattern::SYNC_THROW]  = SingletonFac(UseSubclass<InvokeSyncThrow>());
-//      patternTable[HandlingPattern::ASYNC     ]  = SingletonFac(UseSubclass<InvokeAsync>());
+      return patternTable (id);
     }
     
-    
-    lumiera::LifecycleHook _schedule (lumiera::ON_GLOBAL_INIT, &prepareCommandHandlingPatterns);
   
-  } // (END) definition of concrete handling patterns
+  } // (END) definition of concrete handling patterns
   
   
   
diff --git a/tests/lib/multifact-test.cpp b/tests/lib/multifact-test.cpp
index 8669b188d..d2df7c886 100644
--- a/tests/lib/multifact-test.cpp
+++ b/tests/lib/multifact-test.cpp
@@ -37,8 +37,8 @@ namespace test{
   
   using boost::lexical_cast;
   using lib::test::showSizeof;
-  //using util::isnil;
   using util::isSameObject;
+  using util::isnil;
   using std::ostream;
   using std::string;
   using std::cout;
@@ -46,6 +46,7 @@ namespace test{
   
   using lumiera::error::LUMIERA_ERROR_INVALID;
   
+  
   namespace { // hierarchy of test dummy objects
     
     struct Interface
@@ -80,8 +81,10 @@ namespace test{
         static theID getTypeID() { return ii; }
       };
     
+    /** Factory instance for the tests... */
     TestFactory theFact;
     
+    // Configure the products to be fabricated....
     TestFactory::Singleton<Implementation<ONE> > holder1 (theFact,ONE);
     TestFactory::Singleton<Implementation<TWO> > holder2 (theFact,TWO);
     TestFactory::Singleton<Implementation<THR> > holder3 (theFact,THR);
@@ -116,6 +119,7 @@ namespace test{
           ASSERT (isSameObject(o1,o2));
           
           TestFactory anotherFact;
+          ASSERT (isnil (anotherFact));
           VERIFY_ERROR (INVALID, anotherFact(ONE) );
           
           TestFactory::Singleton<Implementation<ONE> > anotherSingletonHolder (anotherFact,ONE);

From bb45ad67d833648ed6e68438a63a8a6ced3fae66 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 1 Oct 2009 01:51:10 +0200
Subject: [PATCH 330/368] WIP change how the undo operation is invoked

---
 src/proc/control/handling-pattern.cpp  | 11 +++++++++--
 src/proc/control/handling-pattern.hpp  |  5 +++--
 src/proc/control/handling-patterns.hpp | 18 +++++++++---------
 3 files changed, 21 insertions(+), 13 deletions(-)

diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index 7df3c41d5..439e425dd 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -70,7 +70,7 @@ namespace control {
           return ExecResult (error::Logic (str (err_pre % command), errID_pre));
         
         // Execute the command
-        perform (command);
+        dispatch (command);
         
         Symbol errID = lumiera_error();
         if (errID)
@@ -103,10 +103,17 @@ namespace control {
   }
   
   
+  void
+  HandlingPattern::dispatch (CommandImpl& command)
+  {
+    perform (command);
+  }
+  
+  
   HandlingPattern const&
   HandlingPattern::howtoUNDO()  const
   {
-    return defineUNDO();
+    UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
   }
   
   
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 7ec8befdf..34421428a 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -122,9 +122,10 @@ namespace control {
       
     protected:
       
-      virtual void perform (CommandImpl& command)  const  =0;
+      virtual void dispatch(CommandImpl& command)  const;
       
-      virtual HandlingPattern const& defineUNDO()  const  =0;
+      virtual void perform (CommandImpl& command)  const  =0;
+      virtual void revert  (CommandImpl& command)  const  =0;
       
       
       
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index 0bf03035b..a5ee4486e 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -80,10 +80,10 @@ namespace control {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
         
-        HandlingPattern const&
-        defineUNDO()  const
+        void
+        revert(CommandImpl& command)  const
           {
-            UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
+            UNIMPLEMENTED ("actually undo the effect of a command, according to this pattern");
           }
         
         bool
@@ -108,10 +108,10 @@ namespace control {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
         
-        HandlingPattern const&
-        defineUNDO()  const
+        void
+        revert(CommandImpl& command)  const
           {
-            UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
+            UNIMPLEMENTED ("actually undo the effect of a command, according to this pattern");
           }
         
         bool
@@ -136,10 +136,10 @@ namespace control {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
         
-        HandlingPattern const&
-        defineUNDO()  const
+        void
+        revert(CommandImpl& command)  const
           {
-            UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
+            UNIMPLEMENTED ("actually undo the effect of a command, according to this pattern");
           }
         
         bool

From effbb49afba11a865bfa07cc36eaf9fb77418b23 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 1 Oct 2009 01:51:47 +0200
Subject: [PATCH 331/368] Dummy HandingPattern implementation for unit tests

---
 src/proc/control/handling-patterns.hpp | 31 ++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index a5ee4486e..d8da74f5f 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -151,6 +151,37 @@ namespace control {
     
     
     
+    /**
+     * Handling Pattern: invoke command directly and without any integration
+     * with other facilities. This pattern is intended to be used for unit tests.
+     */
+    class InvokeDirectly
+      : public HandlingPattern
+      {
+        void
+        perform (CommandImpl& command)  const
+          {
+            REQUIRE (command.canExec());
+            command.invokeCapture();
+            command.invokeOperation();
+          }
+        
+        void
+        revert(CommandImpl& command)  const
+          {
+            REQUIRE (command.canUndo());
+            command.invokeUndo();
+          }
+        
+        bool
+        isValid()  const
+          {
+            return true;
+          }
+      };
+    
+    
+    
     
     
     

From 248b87f344aa7afe3f48df58efa64c42b3f9196c Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 1 Oct 2009 13:29:53 +0200
Subject: [PATCH 332/368] Basic implementation of HandlingPattern settled for
 now the ''real implementation'' (integrated with the ProcDispatcher) is still
 missing, but it's enough to get the tests going

---
 src/proc/control/handling-pattern.cpp  |  30 +-----
 src/proc/control/handling-pattern.hpp  |  35 ++++---
 src/proc/control/handling-patterns.hpp | 129 ++++++++++++++-----------
 3 files changed, 102 insertions(+), 92 deletions(-)

diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index 439e425dd..91f84d77d 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -25,12 +25,8 @@
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/handling-patterns.hpp"
 
-#include "lib/symbol.hpp"
 #include "include/logging.h"
 #include "lib/util.hpp"
-//#include "proc/mobject/mobject-ref.hpp"
-//#include "proc/mobject/mobject.hpp"
-//#include "proc/mobject/placement.hpp"
 
 #include <boost/format.hpp>
 
@@ -44,16 +40,14 @@ using util::isnil;
 
 namespace control {
   
-  /** */
+  /** retrieve pre-configured pattern */
   HandlingPattern const&
   HandlingPattern::get (ID id)
   {
-    REQUIRE ((0 <= id) && (id < NUM_IDS));
-    
     return getPatternInstance(id); 
   }
   
-
+  
   /** @note: does error handling, but delegates the actual
    *         execution to the protected (subclass) member */
   ExecResult
@@ -69,8 +63,8 @@ namespace control {
         if (errID_pre)
           return ExecResult (error::Logic (str (err_pre % command), errID_pre));
         
-        // Execute the command
-        dispatch (command);
+        // execute or undo it...
+        perform (command);
         
         Symbol errID = lumiera_error();
         if (errID)
@@ -103,20 +97,6 @@ namespace control {
   }
   
   
-  void
-  HandlingPattern::dispatch (CommandImpl& command)
-  {
-    perform (command);
-  }
-  
-  
-  HandlingPattern const&
-  HandlingPattern::howtoUNDO()  const
-  {
-    UNIMPLEMENTED ("yield a handling pattern suitable for UNDOing a command, according to this pattern");
-  }
-  
-  
   
   /* ====== execution result state object ======= */
   
@@ -141,6 +121,6 @@ namespace control {
     if (!isnil (log_))
       throw error::Logic ("Command execution failed: "+log_);
   }
-      
+  
   
 } // namespace control
diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index 34421428a..c2193e7c0 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -22,7 +22,7 @@
 
 
 /** @file handling-pattern.hpp
- ** Pre-defined command execution templates.
+ ** Pre-defined command execution skeletons.
  ** Any command can be configured to use a specific handling pattern
  ** on invocation. Moreover, there is a default handling pattern for commands.
  ** These patterns define the steps necessary for getting the command actually
@@ -46,10 +46,9 @@
 
 //#include "pre.hpp"
 #include "lib/error.hpp"
-#include "lib/bool-checkable.hpp"
 #include "lib/symbol.hpp"
+#include "lib/bool-checkable.hpp"
 
-//#include <tr1/memory>
 #include <string>
 
 
@@ -58,14 +57,16 @@ namespace control {
   
   using std::string;
   using lib::Symbol;
-//  using std::tr1::shared_ptr;
   
   
   class CommandImpl;
   
   
   /**
-   * @todo Type-comment
+   * Result (Status) of command execution.
+   * It is returned when invoking a HandlingPattern
+   * and can be used to check for success and/or re-throw
+   * any Exception encountered during the command execution.
    */
   class ExecResult
     : public lib::BoolCheckable<ExecResult>
@@ -83,8 +84,18 @@ namespace control {
       friend class HandlingPattern;
     };
   
+  
+  
   /**
-   * @todo Type-comment
+   * Operation Skeleton how to invoke or undo a command.
+   * Concrete implementations may be retrieved by ID;
+   * they range from just invoking the command operations
+   * straight forward to dispatching with the ProcDispatcher
+   * or running the command asynchronously in a background thread.
+   * A HandlingPattern first of all describes how to invoke the
+   * command operation, but for each pattern it is possible to
+   * get a special "undo pattern", which, on activation, will
+   * reverse the effect of the basic pattern.  
    */
   class HandlingPattern
     : public lib::BoolCheckable<HandlingPattern>
@@ -114,23 +125,23 @@ namespace control {
        *          detect errors on execution */
       ExecResult invoke (CommandImpl& command, Symbol name)  const;
       
-      /** @return HandlingPatter describing how the UNDO operation is to be performed */
-      HandlingPattern const& howtoUNDO()  const;
+      /** @return HandlingPattern describing how the UNDO operation is to be performed */
+      HandlingPattern const& howtoUNDO()  const { return getUndoPatt(); }
       
       
       virtual bool isValid()  const  =0;
       
     protected:
       
-      virtual void dispatch(CommandImpl& command)  const;
+      virtual HandlingPattern const& getUndoPatt() const =0;
+      virtual void perform (CommandImpl& command)  const =0;
       
-      virtual void perform (CommandImpl& command)  const  =0;
-      virtual void revert  (CommandImpl& command)  const  =0;
+      virtual void exec (CommandImpl& command)  const  =0;
+      virtual void undo (CommandImpl& command)  const  =0;
       
       
       
     };
-  ////////////////TODO currently just fleshing  out the API....
   
   
   
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index d8da74f5f..14c7b48d3 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -47,23 +47,72 @@
 #include "lib/multifact.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/command-impl.hpp"
-#include "include/lifecycle.h"
-//#include "lib/symbol.hpp"
-
-//#include <tr1/memory>
-//#include <string>
-#include<vector>
 
 
 
 namespace control {
 
   namespace { // concrete command handling patterns 
-  
-    using std::vector;
-//  using std::string;
-//  using lib::Symbol;
-//  using std::tr1::shared_ptr;
+    
+    
+    
+    
+    /**
+     * Handling Pattern Foundation: invoke command directly and without
+     * any external intervention. This pattern is intended as implementation
+     * base class, but can be used as-is for unit tests.
+     */
+    class BasicHandlingPattern
+      : public HandlingPattern
+      {
+        bool isValid()  const { return true; }
+        
+        void
+        exec (CommandImpl& command)  const
+          {
+            REQUIRE (command.canExec());
+            command.invokeCapture();
+            command.invokeOperation();
+          }
+        
+        void
+        undo (CommandImpl& command)  const
+          {
+            REQUIRE (command.canUndo());
+            command.invokeUndo();
+          }
+        
+        /* == invoking operation or undo == */
+        
+        void perform (CommandImpl& command)  const { return exec(command); }
+        
+        class UndoProxyPattern
+          : public HandlingPattern
+          {
+            BasicHandlingPattern& basePatt_;
+            
+            bool isValid()                       const { return basePatt_.isValid();     }
+            void exec (CommandImpl& command)     const { return basePatt_.exec(command); }
+            void undo (CommandImpl& command)     const { return basePatt_.undo(command); }
+            
+            void perform (CommandImpl& command)  const { return undo(command); }
+            HandlingPattern const& getUndoPatt() const { return basePatt_; }
+            
+          public:
+            UndoProxyPattern (BasicHandlingPattern& refPattern)
+              : basePatt_(refPattern)
+              { }
+          };
+        
+        HandlingPattern const& getUndoPatt() const { return standardUndoPattern_; }
+        UndoProxyPattern standardUndoPattern_;
+        friend class UndoProxyPattern;
+        
+      public:
+        BasicHandlingPattern()
+          : standardUndoPattern_(*this)
+          { }
+      };
     
     
     
@@ -72,16 +121,16 @@ namespace control {
      * @todo describe this pattern in more detail....
      */
     class InvokeSyncNoThrow
-      : public HandlingPattern
+      : public BasicHandlingPattern
       {
         void
-        perform (CommandImpl& command)  const
+        exec (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
         
         void
-        revert(CommandImpl& command)  const
+        undo (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually undo the effect of a command, according to this pattern");
           }
@@ -100,16 +149,16 @@ namespace control {
      * @todo describe this pattern in more detail....
      */
     class InvokeSyncThrow
-      : public HandlingPattern
+      : public BasicHandlingPattern
       {
         void
-        perform (CommandImpl& command)  const
+        exec (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
         
         void
-        revert(CommandImpl& command)  const
+        undo (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually undo the effect of a command, according to this pattern");
           }
@@ -128,16 +177,16 @@ namespace control {
      * @todo describe this pattern in more detail....
      */
     class InvokeAsync
-      : public HandlingPattern
+      : public BasicHandlingPattern
       {
         void
-        perform (CommandImpl& command)  const
+        exec (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually invoke a command, according to this pattern");
           }
         
         void
-        revert(CommandImpl& command)  const
+        undo (CommandImpl& command)  const
           {
             UNIMPLEMENTED ("actually undo the effect of a command, according to this pattern");
           }
@@ -151,37 +200,6 @@ namespace control {
     
     
     
-    /**
-     * Handling Pattern: invoke command directly and without any integration
-     * with other facilities. This pattern is intended to be used for unit tests.
-     */
-    class InvokeDirectly
-      : public HandlingPattern
-      {
-        void
-        perform (CommandImpl& command)  const
-          {
-            REQUIRE (command.canExec());
-            command.invokeCapture();
-            command.invokeOperation();
-          }
-        
-        void
-        revert(CommandImpl& command)  const
-          {
-            REQUIRE (command.canUndo());
-            command.invokeUndo();
-          }
-        
-        bool
-        isValid()  const
-          {
-            return true;
-          }
-      };
-    
-    
-    
     
     
     
@@ -189,12 +207,13 @@ namespace control {
     
     typedef lib::MultiFact<HandlingPattern, HandlingPattern::ID> HandlingPatternFactory;
     
-    /** Table of available command handling patterns */
+    /** holds singleton pattern instances by ID */
     HandlingPatternFactory patternTable;
     
-    HandlingPatternFactory::Singleton<InvokeSyncNoThrow> holder1 (patternTable, HandlingPattern::SYNC);
-    HandlingPatternFactory::Singleton<InvokeSyncThrow>   holder2 (patternTable, HandlingPattern::SYNC_THROW);
-    HandlingPatternFactory::Singleton<InvokeAsync>       holder3 (patternTable, HandlingPattern::ASYNC);
+    HandlingPatternFactory::Singleton<InvokeSyncNoThrow>    holder1 (patternTable, HandlingPattern::SYNC);
+    HandlingPatternFactory::Singleton<InvokeSyncThrow>      holder2 (patternTable, HandlingPattern::SYNC_THROW);
+    HandlingPatternFactory::Singleton<InvokeAsync>          holder3 (patternTable, HandlingPattern::ASYNC);
+    HandlingPatternFactory::Singleton<BasicHandlingPattern> holder4 (patternTable, HandlingPattern::DUMMY);
     
     
     /** access the singleton instance for a given ID */

From 8136b0a4b87096e6618db0be20363490f62db51e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 1 Oct 2009 14:32:26 +0200
Subject: [PATCH 333/368] HandlingPattern: basic unit test pass

---
 src/proc/control/handling-pattern.hpp         |  2 +-
 tests/components/Makefile.am                  |  1 +
 .../proc/control/test-dummy-commands.cpp      | 44 +++++++++++++++++++
 .../proc/control/test-dummy-commands.hpp      |  7 +--
 4 files changed, 50 insertions(+), 4 deletions(-)
 create mode 100644 tests/components/proc/control/test-dummy-commands.cpp

diff --git a/src/proc/control/handling-pattern.hpp b/src/proc/control/handling-pattern.hpp
index c2193e7c0..d4b4ae946 100644
--- a/src/proc/control/handling-pattern.hpp
+++ b/src/proc/control/handling-pattern.hpp
@@ -112,7 +112,7 @@ namespace control {
         , NUM_IDS
         };
       
-      static ID defaultID() { return SYNC; }
+      static ID defaultID() { return DUMMY; }   ///////////TODO: should be ID::SYNC   Ticket #211
       
       
       static HandlingPattern const& get (ID id);
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index f807a3083..5580a4c4b 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -54,6 +54,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-use2-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use3-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-registry-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/test-dummy-commands.cpp		\
 	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/memento-tie-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/handling-pattern-basics-test.cpp		\
diff --git a/tests/components/proc/control/test-dummy-commands.cpp b/tests/components/proc/control/test-dummy-commands.cpp
new file mode 100644
index 000000000..8ec030c72
--- /dev/null
+++ b/tests/components/proc/control/test-dummy-commands.cpp
@@ -0,0 +1,44 @@
+/*
+  test-dummy-commands  -  global checksum variables used to build test commands
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "proc/control/test-dummy-commands.hpp"
+
+
+
+namespace control {
+namespace test    {
+  
+  
+  
+  namespace command1 {
+    long check_ = 0;
+  }
+  
+  
+  
+  namespace command2 {
+    ostringstream check_;
+  }
+  
+  
+}} // namespace control::test
diff --git a/tests/components/proc/control/test-dummy-commands.hpp b/tests/components/proc/control/test-dummy-commands.hpp
index fe24a059a..230984498 100644
--- a/tests/components/proc/control/test-dummy-commands.hpp
+++ b/tests/components/proc/control/test-dummy-commands.hpp
@@ -1,5 +1,5 @@
 /*
-  TEST-DUMMY-COMMANDS.hpp  -  dummy function used to build test commands
+  TEST-DUMMY-COMMANDS.hpp  -  dummy functions used to build test commands
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -40,6 +40,7 @@
 
 //#include "pre.hpp"
 //#include "lib/test/run.hpp"
+#include "lib/error.hpp"
 #include "lib/test/test-helper.hpp"
 //#include "proc/asset/media.hpp"
 //#include "proc/mobject/session.hpp"
@@ -86,7 +87,7 @@ namespace test    {
   
   namespace command1 { ///< test command just adding a given value
     
-    static long check_ = 0;
+    extern long check_;
       
     inline void
     operate (int someVal)
@@ -117,7 +118,7 @@ namespace test    {
     using lumiera::error::External;
     
     
-    static ostringstream check_;
+    extern ostringstream check_;
       
     
     typedef function<string()> FunS;

From 455ee343442bd8823284857a5fe6795912fb0c96 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 01:52:59 +0200
Subject: [PATCH 334/368] start brainstorming on #279 (extensible ID)

---
 src/lib/sub-id.hpp        |  67 ++++++++++++++++++++
 tests/40components.tests  |   5 ++
 tests/lib/Makefile.am     |   1 +
 tests/lib/sub-id-test.cpp | 127 ++++++++++++++++++++++++++++++++++++++
 4 files changed, 200 insertions(+)
 create mode 100644 src/lib/sub-id.hpp
 create mode 100644 tests/lib/sub-id-test.cpp

diff --git a/src/lib/sub-id.hpp b/src/lib/sub-id.hpp
new file mode 100644
index 000000000..8706a03aa
--- /dev/null
+++ b/src/lib/sub-id.hpp
@@ -0,0 +1,67 @@
+/*
+  SUB-ID.hpp  -  extensible symbolic identifier
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file sub-id.hpp
+ ** Extensible symbolic ID type. 
+ ** @todo (9/09) WIP-WIP-WIP just some vague emerging ideas here...
+ ** 
+ ** My observation is that, during design, I did run again and again into a specific
+ ** situation, which I then needed to circumvent due to a lacking primary solution.
+ ** Learning from that experiences, I start building this structured ID template.
+ ** - it shall be an \em symbolic identifier, not an artificial ID
+ ** - the basic value set should be limited and statically type safe.
+ ** - possibility of structured adornments and variations
+ ** - optionally concealing these extensions from the interface level
+ ** 
+ ** @see SubID_test
+ ** @see MultiFact
+ **
+ */
+
+
+
+#ifndef LIB_SUB_ID_H
+#define LIB_SUB_ID_H
+
+//#include <functional>
+
+
+namespace lib {
+  
+  
+  
+  
+  /**
+   * 
+   */
+  template<typename I>
+  struct SubID
+    {
+    };
+  
+  
+  
+  
+  
+} // namespace lib
+#endif
diff --git a/tests/40components.tests b/tests/40components.tests
index 0292330ab..1d6dacbf9 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -863,6 +863,11 @@ return: 0
 END
 
 
+PLANNED "extensible symbolic identifier" SubID_test <<END
+return: 0
+END
+
+
 TEST "VectorTransfer_test" VectorTransfer_test <<END
 return: 0
 END
diff --git a/tests/lib/Makefile.am b/tests/lib/Makefile.am
index d0fca1599..7362c6caf 100644
--- a/tests/lib/Makefile.am
+++ b/tests/lib/Makefile.am
@@ -87,6 +87,7 @@ test_lib_SOURCES =						\
 	$(testlib_srcdir)/test/test-helper-test.cpp		\
 	$(testlib_srcdir)/typed-allocation-manager-test.cpp	\
 	$(testlib_srcdir)/typed-counter-test.cpp		\
+	$(testlib_srcdir)/sub-id-test.cpp			\
 	$(testlib_srcdir)/vectortransfertest.cpp		\
 	$(testlib_srcdir)/visitingtoolconcept.cpp		\
 	$(testlib_srcdir)/visitingtoolextendedtest.cpp		\
diff --git a/tests/lib/sub-id-test.cpp b/tests/lib/sub-id-test.cpp
new file mode 100644
index 000000000..dfa99046c
--- /dev/null
+++ b/tests/lib/sub-id-test.cpp
@@ -0,0 +1,127 @@
+/*
+  SubID(Test)  -  exploring possible properties of an extensible symbolic identifier
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+
+#include "lib/sub-id.hpp"
+
+#include <boost/functional/hash.hpp>
+#include <tr1/unordered_map>
+#include <tr1/functional>
+#include <vector>
+#include <string>
+
+
+namespace lib {
+namespace test{
+  
+//  using std::tr1::function;
+  using std::tr1::bind;
+  using std::tr1::placeholders::_1;
+  using boost::hash;
+  using std::vector;
+  using std::string;
+  
+  
+  namespace { // test data
+  
+  }
+  
+  
+  
+  
+  /****************************************************************************
+   * @test for now (9/09) this is a playground for shaping a vague design idea
+   *       - base types and casts 
+   *       - exploring some extensions
+   *       - use this ID as Hash-Map key
+   *       
+   * @see lib::SubID
+   */
+  class SubID_test : public Test
+    {
+      
+      virtual void
+      run (Arg)
+        {
+          UNIMPLEMENTED ("SubID brainstorming");
+          
+          checkBaseType();
+          checkExtension();
+          
+//        buildHashtable<ID_A> (buildIDs<ID_A>() );
+//        buildHashtable<ID_B> (buildIDs<ID_B>() );
+        }
+      
+      
+      void
+      checkBaseType ()
+        {
+        }
+      
+      
+      void
+      checkExtension ()
+        {
+        }
+      
+      
+      template<class KEY>
+      struct HashTable
+        : std::tr1::unordered_map<KEY, string, hash<KEY> >
+        {
+          void
+          add (KEY key)
+            {
+              *this[key] = string(key);
+            }
+          
+          void
+          verify (KEY key)
+            {
+              ASSERT (string(key) == *this[key]);
+            }
+        };
+      
+      
+      template<class KEY>
+      void
+      buildHashtable (vector<KEY> keys)
+        {
+          
+          typedef HashTable<KEY> HTab;
+          HTab tab;
+          
+          for_each (keys, bind (&HTab::add,    tab, _1 ));
+          for_each (keys, bind (&HTab::verify, tab, _1 ));
+        }
+      
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (SubID_test, "unit common");
+  
+  
+}} // namespace lib::test

From c3d767b4448df93c19dc8d7853cb23178ddb1d37 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 03:35:48 +0200
Subject: [PATCH 335/368] try out a recursive approach for the extensible ID
 more of a general feasability study... to be continued later

---
 src/lib/sub-id.hpp        | 67 +++++++++++++++++++++++++++++++++++++--
 tests/lib/sub-id-test.cpp | 25 +++++++++++++--
 2 files changed, 88 insertions(+), 4 deletions(-)

diff --git a/src/lib/sub-id.hpp b/src/lib/sub-id.hpp
index 8706a03aa..257dc2638 100644
--- a/src/lib/sub-id.hpp
+++ b/src/lib/sub-id.hpp
@@ -33,6 +33,9 @@
  ** - possibility of structured adornments and variations
  ** - optionally concealing these extensions from the interface level
  ** 
+ ** The first attempt to build such an entity is based on standard techniques,
+ ** disregarding performance and memory footprint considerations.
+ ** 
  ** @see SubID_test
  ** @see MultiFact
  **
@@ -43,11 +46,17 @@
 #ifndef LIB_SUB_ID_H
 #define LIB_SUB_ID_H
 
+#include "lib/format.hpp"
+
 //#include <functional>
+#include <iostream>
+#include <string>
 
 
 namespace lib {
-  
+
+  using std::string;
+  using std::ostream;
   
   
   
@@ -55,11 +64,65 @@ namespace lib {
    * 
    */
   template<typename I>
-  struct SubID
+  class SubId;
+  
+  class SubID
     {
+    public:
+      virtual ~SubID()  { }
+      
+      virtual operator string()  const =0;
+    };
+
+      
+  ostream&
+  operator<< (ostream& os, SubID const& sID)
+    {
+      return os << string(sID);
+    }
+  
+
+  
+  template<typename I>
+  class SubId
+    : public SubID
+    {
+      I baseID_;
+      
+    public:
+      SubId (I id)
+        : baseID_(id)
+        { }
+      
+      operator string()  const
+        {
+          return util::str (baseID_);   
+        }
     };
   
   
+  template<typename I, class SUZ>
+  class ExtendedSubId
+    : public SubId<I>
+    {
+      typedef SubId<I> _baID;
+      
+      SUZ extID_;
+      
+    public:
+      ExtendedSubId (I i, SUZ const& chain)
+        : _baID(i)
+        , extID_(chain)
+        { }
+      
+      operator string()  const
+        {
+          return _baID::operator string()
+               + '.'
+               + string (extID_);   
+        }
+    };
+  
   
   
   
diff --git a/tests/lib/sub-id-test.cpp b/tests/lib/sub-id-test.cpp
index dfa99046c..e51635b20 100644
--- a/tests/lib/sub-id-test.cpp
+++ b/tests/lib/sub-id-test.cpp
@@ -32,6 +32,7 @@
 #include <string>
 
 
+
 namespace lib {
 namespace test{
   
@@ -41,10 +42,14 @@ namespace test{
   using boost::hash;
   using std::vector;
   using std::string;
-  
+  using std::cout;
+  using std::endl;
+
   
   namespace { // test data
   
+    enum Colour { R,G,B };
+    
   }
   
   
@@ -64,11 +69,11 @@ namespace test{
       virtual void
       run (Arg)
         {
-          UNIMPLEMENTED ("SubID brainstorming");
           
           checkBaseType();
           checkExtension();
           
+          TODO ("Hash functions, better implementation");
 //        buildHashtable<ID_A> (buildIDs<ID_A>() );
 //        buildHashtable<ID_B> (buildIDs<ID_B>() );
         }
@@ -77,12 +82,28 @@ namespace test{
       void
       checkBaseType ()
         {
+          typedef SubId<Colour> CID;
+          CID c1 (R);
+          CID c2 (G);
+          CID c3 (B);
+          
+          cout << "..." << c1 << c2 << c3 << endl;
         }
       
       
       void
       checkExtension ()
         {
+          typedef SubId<Colour> CID;
+          typedef SubId<uint>   UID;
+          
+          typedef ExtendedSubId<Colour, UID> CUID;
+          
+          SubID const& id1 = CUID(R, 12);
+          SubID const& id2 = CUID(G, 13);
+          
+          cout << "id1=" << id1 << endl;
+          cout << "id2=" << id2 << endl;
         }
       
       

From cb7c884293d36f89ebc4ff86a69c2891d8436d6d Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 15:26:11 +0200
Subject: [PATCH 336/368] handling patterns usable for now. Close #275

---
 src/proc/control/handling-pattern.cpp         |  5 ++-
 src/proc/control/handling-patterns.hpp        |  7 +++-
 tests/45controller.tests                      |  2 +-
 .../control/handling-pattern-basics-test.cpp  | 41 ++++---------------
 4 files changed, 18 insertions(+), 37 deletions(-)

diff --git a/src/proc/control/handling-pattern.cpp b/src/proc/control/handling-pattern.cpp
index 91f84d77d..b3d961418 100644
--- a/src/proc/control/handling-pattern.cpp
+++ b/src/proc/control/handling-pattern.cpp
@@ -34,8 +34,8 @@
 using boost::str;
 using boost::format;
 using namespace lumiera;
-using util::cStr;
 using util::isnil;
+using util::cStr;
 
 
 namespace control {
@@ -48,7 +48,8 @@ namespace control {
   }
   
   
-  /** @note: does error handling, but delegates the actual
+  /** @param name to use in log and error messages
+   *  @note  does error handling, but delegates the actual
    *         execution to the protected (subclass) member */
   ExecResult
   HandlingPattern::invoke (CommandImpl& command, Symbol name)  const
diff --git a/src/proc/control/handling-patterns.hpp b/src/proc/control/handling-patterns.hpp
index 14c7b48d3..d01ad6236 100644
--- a/src/proc/control/handling-patterns.hpp
+++ b/src/proc/control/handling-patterns.hpp
@@ -86,7 +86,7 @@ namespace control {
         
         void perform (CommandImpl& command)  const { return exec(command); }
         
-        class UndoProxyPattern
+        class UndoProxyPattern     ///< standard UNDO implementation by reconfiguring a base Pattern
           : public HandlingPattern
           {
             BasicHandlingPattern& basePatt_;
@@ -119,6 +119,7 @@ namespace control {
     /**
      * Handling Pattern: invoke blocking, translate exceptions into an error state
      * @todo describe this pattern in more detail....
+     * @todo unimplemented...
      */
     class InvokeSyncNoThrow
       : public BasicHandlingPattern
@@ -146,7 +147,9 @@ namespace control {
     
     /**
      * Handling Pattern: invoke blocking, propagating any exceptions immediately
+     * @todo is throwing here helpful, and how to integrate it into ExecResult...?
      * @todo describe this pattern in more detail....
+     * @todo unimplemented...
      */
     class InvokeSyncThrow
       : public BasicHandlingPattern
@@ -174,7 +177,9 @@ namespace control {
     
     /**
      * Handling Pattern: just schedule command to be invoked asynchronously
+     * @todo clarify what "async" means and if we need it.....
      * @todo describe this pattern in more detail....
+     * @todo unimplemented...
      */
     class InvokeAsync
       : public BasicHandlingPattern
diff --git a/tests/45controller.tests b/tests/45controller.tests
index f59d50a1f..8ee423e4d 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -60,7 +60,7 @@ return: 0
 END
 
 
-PLANNED "handling pattern basics" HandlingPatternBasics_test <<END
+TEST "handling pattern basics" HandlingPatternBasics_test <<END
 return: 0
 END
 
diff --git a/tests/components/proc/control/handling-pattern-basics-test.cpp b/tests/components/proc/control/handling-pattern-basics-test.cpp
index 6dee11eba..16f6ff878 100644
--- a/tests/components/proc/control/handling-pattern-basics-test.cpp
+++ b/tests/components/proc/control/handling-pattern-basics-test.cpp
@@ -22,50 +22,27 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/test/test-helper.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/command-impl.hpp"
 #include "proc/control/command-registry.hpp"
 #include "proc/control/argument-erasure.hpp"
 #include "proc/control/handling-pattern.hpp"
-//#include "lib/lumitime.hpp"
 #include "lib/symbol.hpp"
-//#include "lib/util.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
 
-//#include <tr1/functional>
-//#include <boost/ref.hpp>
-//#include <boost/format.hpp>
-//#include <iostream>
 #include <cstdlib>
-//#include <string>
 
 
 namespace control {
 namespace test    {
-
-
-//  using boost::format;
-//  using boost::str;
-  //using lumiera::Time;
-  //using util::contains;
-  using std::tr1::function;
-//  using std::tr1::bind;
-//  using std::string;
-  using std::rand;
-  //using std::cout;
-  //using std::endl;
-//  using lib::test::showSizeof;
-//  using util::isSameObject;
-//  using util::contains;
+  
+  
   using lib::Symbol;
-
+  using std::tr1::function;
+  using std::rand;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
-  
   namespace { // test data and helpers...
   
     Symbol TEST_CMD  = "test.command1.handling";
@@ -79,13 +56,11 @@ namespace test    {
   
   /**********************************************************************************
    * @test operate and verify a simple dummy command handling pattern.
-   *       interface. Add/remove a command instance to the index, allocate an
-   *       CommandImpl frame and verify it is removed properly on ref count zero.
    * @note this test covers mainly the behaviour of a handling pattern as a concept,
-   *       not so much the behaviour of the (standard) handling pattern implementations. 
+   *       not so much the behaviour of the (standard) handling pattern implementations.
    * 
    * @see HandlingPattern
-   * @see CommandRegistry
+   * @see BasicHandlingPattern
    * @see command.hpp
    * @see command-basic-test.cpp
    */
@@ -189,6 +164,6 @@ namespace test    {
   
   /** Register this test class... */
   LAUNCHER (HandlingPatternBasics_test, "function controller");
-      
-      
+  
+  
 }} // namespace control::test

From 3835399c5fb7b9f160462929487e98debfef67c0 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 17:26:50 +0200
Subject: [PATCH 337/368] Testsuite: catch exceptions at the level of invoking
 individual tests

---
 src/common/appstate.cpp |  2 +-
 src/lib/test/run.hpp    | 22 +++++++++++-----
 src/lib/test/suite.cpp  | 56 ++++++++++++++++++++++++++++-------------
 src/lib/test/suite.hpp  | 26 +++++++++++++++----
 4 files changed, 76 insertions(+), 30 deletions(-)

diff --git a/src/common/appstate.cpp b/src/common/appstate.cpp
index 1b949e2b0..dfcab9834 100644
--- a/src/common/appstate.cpp
+++ b/src/common/appstate.cpp
@@ -48,7 +48,7 @@ namespace lumiera {
     inline void
     log_and_clear_unexpected_errorstate ()
     {
-      if (const char * errorstate = lumiera_error ())
+      if (lumiera_err errorstate = lumiera_error ())
         ALERT (common, "*** Unexpected error: %s\n     Triggering emergency exit.", errorstate);
     }
     
diff --git a/src/lib/test/run.hpp b/src/lib/test/run.hpp
index cd7621c89..ff61cf30c 100644
--- a/src/lib/test/run.hpp
+++ b/src/lib/test/run.hpp
@@ -21,6 +21,17 @@
  
 */
 
+/** @file run.hpp
+ ** Simple test class runner. Allows for writing unit tests as subclass of
+ ** test::Test . They may be installed for automatic invocation through test::Suite
+ ** by defining a Launcher instance, which can be done conveniently by the macro LAUNCHER
+ ** 
+ ** @see HelloWorld_test
+ ** @see test::Suite
+ ** @see mainsuite.cpp
+ ** @see main.cpp
+ */
+
 
 #ifndef TESTHELPER_RUN_H
 #define TESTHELPER_RUN_H
@@ -37,12 +48,11 @@
 #include <string>
 
 
-namespace test
-  {
-
+namespace test {
+  
   using std::string;
   using std::auto_ptr;
-
+  
   typedef std::vector<string> & Arg; 
   
   
@@ -60,7 +70,7 @@ namespace test
     
     
     
-  /** interface: generic testcase creating functor. */  
+  /** interface: generic testcase creating functor. */
   class Launcher
     {
     public:
@@ -86,7 +96,7 @@ namespace test
     public:
       Launch (string testID, string groups)  { Suite::enrol (this,testID,groups); };
       virtual auto_ptr<Test> operator() ()   { return auto_ptr<Test> (new TEST ); };
-    };   
+    };
     
 } // namespace test
 
diff --git a/src/lib/test/suite.cpp b/src/lib/test/suite.cpp
index d1d383d71..5c8af1357 100644
--- a/src/lib/test/suite.cpp
+++ b/src/lib/test/suite.cpp
@@ -22,26 +22,29 @@
 
 
 
-#include <map>
-#include <vector>
-#include <memory>
-#include <tr1/memory>
-#include <iostream>
-#include <sstream>
-#include <boost/algorithm/string.hpp>
-
 #include "include/logging.h"
 #include "lib/cmdline.hpp"
+#include "lib/test/test-helper.hpp"
 #include "lib/test/suite.hpp"
 #include "lib/test/run.hpp"
 #include "lib/error.hpp"
 #include "lib/util.hpp"
 
+#include <boost/algorithm/string.hpp>
+#include <tr1/memory>
+#include <iostream>
+#include <sstream>
+#include <memory>
+#include <vector>
+#include <map>
 
 
 namespace test {
   
   using std::map;
+  using std::cout;
+  using std::cerr;
+  using std::endl;
   using std::vector;
   using std::auto_ptr;
   using std::tr1::shared_ptr;
@@ -49,6 +52,7 @@ namespace test {
   
   using util::isnil;
   using util::contains;
+  using lib::test::showType;
   
   typedef map<string, Launcher*> TestMap;
   typedef shared_ptr<TestMap>  PTestMap;
@@ -133,14 +137,30 @@ namespace test {
     TRACE(test, "Test-Suite( groupID=%s )\n", groupID.c_str () );
     
     if (!testcases.getGroup(groupID))
-      throw lumiera::error::Invalid ();
-      //throw "empty testsuite";     /////////// TODO Errorhandling!
+      throw lumiera::error::Invalid ("empty testsuite");
   }
     
 #define VALID(test,testID) \
   ASSERT ((test), "NULL testcase launcher for test '%s' found in testsuite '%s'", groupID_.c_str(),testID.c_str());
   
   
+  namespace { // internal helper for launching with error logging
+    
+    void
+    invokeTestCase (Test& theTest, Arg cmdline)
+    {
+      try { theTest.run (cmdline); }
+      catch (lumiera::Error& failure)
+        {
+          lumiera_err errorID = lumiera_error(); // reset error flag
+          cerr << "*** Test Failure " << showType(theTest) << endl;
+          cerr << "***            : " << failure.what() << endl;
+          ERROR (test,     "Error state %s", errorID);
+          WARN  (progress, "Caught exception %s", failure.what());
+    }   }
+  }
+  
+  
   /** run all testcases contained in this Suite.
    *  The first argument in the commandline, if present, 
    *  will select one single testcase with a matching ID.
@@ -155,7 +175,7 @@ namespace test {
   {
     PTestMap tests = testcases.getGroup(groupID_);
     if (!tests)
-      throw lumiera::error::Invalid (); ///////// TODO: pass error description
+      throw lumiera::error::Invalid ("test group not found"); ///////// TODO: pass error description
     
     if (0 < cmdline.size())
       {
@@ -168,7 +188,7 @@ namespace test {
             Launcher* test = (*tests)[testID];
             cmdline.erase (cmdline.begin());
             VALID (test,testID);
-            (*test)()->run(cmdline);
+            invokeTestCase (*(*test)(), cmdline);  // TODO confusing statement, improve definition of test collection datatype Ticket #289
             return;
       }   }
     
@@ -179,7 +199,7 @@ namespace test {
         std::cout << "\n  ----------"<< i->first<< "----------\n";
         Launcher* test = (i->second);
         VALID (test, i->first);
-        (*test)()->run(cmdline); // actually no cmdline arguments
+        invokeTestCase (*(*test)(), cmdline); // actually no cmdline arguments
       }
   }
   
@@ -194,13 +214,13 @@ namespace test {
     PTestMap tests = testcases.getGroup(groupID_);
     ASSERT (tests);
     
-    std::cout << "TESTING \"Component Test Suite: " << groupID_ << "\" ./test-components\n\n";
+    cout << "TESTING \"Component Test Suite: " << groupID_ << "\" ./test-components\n\n";
     
     for ( TestMap::iterator i=tests->begin(); i!=tests->end(); ++i )
       {
         string key (i->first);
-        std::cout << "\n\n";
-        std::cout << "TEST \""<<key<<"\" "<<key<<" <<END\n";
+        cout << "\n\n";
+        cout << "TEST \""<<key<<"\" "<<key<<" <<END\n";
         Launcher* test = (i->second);
         VALID (test, i->first);
         try
@@ -209,9 +229,9 @@ namespace test {
           }
         catch (...) 
           {
-            std::cout << "PLANNED ============= " << lumiera_error() << "\n";
+            cout << "PLANNED ============= " << lumiera_error() << "\n";
           }
-        std::cout << "END\n";
+        cout << "END\n";
       }
   }
   
diff --git a/src/lib/test/suite.hpp b/src/lib/test/suite.hpp
index ad378b54a..13a883888 100644
--- a/src/lib/test/suite.hpp
+++ b/src/lib/test/suite.hpp
@@ -20,6 +20,22 @@
  
 */
 
+/** @file suite.hpp
+ ** Building and running a suite of tests, implemented as test classes.
+ ** This simple test suite runner is intended to be linked into a standalone C++ application,
+ ** allowing to invoke individual tests by ID, invoking groups of tests and producing a
+ ** report of all registered tests. Registration of individual testcases happens 
+ ** automatically through static test::Launcher instances.
+ ** 
+ ** @todo as of 9/09, the implementation seems OKish but a bit clumsy. See Ticket #289 
+ ** 
+ ** @see HelloWorld_test
+ ** @see test::Test
+ ** @see test::TestOption
+ ** @see run.hpp
+ ** @see mainsuite.cpp
+ */
+
 
 #ifndef TESTHELPER_SUITE_H
 #define TESTHELPER_SUITE_H
@@ -29,21 +45,21 @@
 
 
 
-namespace test
-  {
+namespace test {
+  
   using std::string;
   
-  // Forward decls needed for run.hpp
+  // Forward declarations for run.hpp
   class Test;
   class Launcher;
-
+  
   typedef std::vector<string> & Arg; 
   
   
   /**
    * Enables running a collection of tests.
    * An internal registration service #enrol() is provided
-   * for the individual Test - inscances to be recognized as 
+   * for the individual Test - instances to be recognised as
    * testcases. The groupID passed to the constructor selects
    * all testcases declared as belonging to this Group.
    */

From 7bac89079015dd2fe96911e85076eb33c5495edd Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 17:49:38 +0200
Subject: [PATCH 338/368] Test suite runner: pass exit code = 5 when having
 caught an exception

---
 src/lib/test/suite.cpp       | 27 +++++++++++---
 src/lib/test/suite.hpp       |  4 +++
 tests/lib/helloworldtest.cpp | 68 ++++++++++++++++++------------------
 tests/lib/mainsuite.cpp      |  7 ++--
 4 files changed, 66 insertions(+), 40 deletions(-)

diff --git a/src/lib/test/suite.cpp b/src/lib/test/suite.cpp
index 5c8af1357..f941429d9 100644
--- a/src/lib/test/suite.cpp
+++ b/src/lib/test/suite.cpp
@@ -123,6 +123,10 @@ namespace test {
   /** "magic" groupID containing all registered testcases */
   const string Suite::ALLGROUP = "ALL";
   
+  /** exit code returned when any individual test threw */
+  const int Suite::EXCEPTION_THROWN = 5;
+  const int Suite::TEST_OK = 0;
+
   
   
   /** create a suite comprised of all the testcases 
@@ -132,6 +136,7 @@ namespace test {
    */
   Suite::Suite(string groupID) 
     : groupID_(groupID)
+    , exitCode_(0)
   {
     REQUIRE( !isnil(groupID) );
     TRACE(test, "Test-Suite( groupID=%s )\n", groupID.c_str () );
@@ -139,6 +144,15 @@ namespace test {
     if (!testcases.getGroup(groupID))
       throw lumiera::error::Invalid ("empty testsuite");
   }
+  
+  
+  int
+  Suite::getExitCode ()  const
+    {
+      return exitCode_;
+    }
+  
+  
     
 #define VALID(test,testID) \
   ASSERT ((test), "NULL testcase launcher for test '%s' found in testsuite '%s'", groupID_.c_str(),testID.c_str());
@@ -146,10 +160,14 @@ namespace test {
   
   namespace { // internal helper for launching with error logging
     
-    void
+    int
     invokeTestCase (Test& theTest, Arg cmdline)
     {
-      try { theTest.run (cmdline); }
+      try 
+        {
+          theTest.run (cmdline);
+          return Suite::TEST_OK;
+        }
       catch (lumiera::Error& failure)
         {
           lumiera_err errorID = lumiera_error(); // reset error flag
@@ -157,6 +175,7 @@ namespace test {
           cerr << "***            : " << failure.what() << endl;
           ERROR (test,     "Error state %s", errorID);
           WARN  (progress, "Caught exception %s", failure.what());
+          return Suite::EXCEPTION_THROWN;
     }   }
   }
   
@@ -188,7 +207,7 @@ namespace test {
             Launcher* test = (*tests)[testID];
             cmdline.erase (cmdline.begin());
             VALID (test,testID);
-            invokeTestCase (*(*test)(), cmdline);  // TODO confusing statement, improve definition of test collection datatype Ticket #289
+            exitCode_ |= invokeTestCase (*(*test)(), cmdline);  // TODO confusing statement, improve definition of test collection datatype Ticket #289
             return;
       }   }
     
@@ -199,7 +218,7 @@ namespace test {
         std::cout << "\n  ----------"<< i->first<< "----------\n";
         Launcher* test = (i->second);
         VALID (test, i->first);
-        invokeTestCase (*(*test)(), cmdline); // actually no cmdline arguments
+        exitCode_ |= invokeTestCase (*(*test)(), cmdline); // actually no cmdline arguments
       }
   }
   
diff --git a/src/lib/test/suite.hpp b/src/lib/test/suite.hpp
index 13a883888..d640050f6 100644
--- a/src/lib/test/suite.hpp
+++ b/src/lib/test/suite.hpp
@@ -66,14 +66,18 @@ namespace test {
   class Suite
     {
       string groupID_;
+      int exitCode_;
       
     public:
       Suite (string groupID);
       void run (Arg cmdline);
       void describe ();
+      int getExitCode ()  const;
       static void enrol (Launcher *test, string testID, string groups);
       
       static const string ALLGROUP;
+      static const int TEST_OK;
+      static const int EXCEPTION_THROWN;
     };
   
   
diff --git a/tests/lib/helloworldtest.cpp b/tests/lib/helloworldtest.cpp
index d6a2951af..7e99b06ff 100644
--- a/tests/lib/helloworldtest.cpp
+++ b/tests/lib/helloworldtest.cpp
@@ -21,48 +21,48 @@
 * *****************************************************/
 
 
-#include <iostream>
 #include "lib/test/run.hpp"
-
 #include "lib/util.hpp"
-using util::isnil;
 
 #include <boost/lexical_cast.hpp>
+#include <iostream>
+
 using boost::lexical_cast;
+using util::isnil;
 
 
-namespace lumiera
-  {
-  namespace test
+namespace lumiera{
+namespace test   {
+  
+  /******************************************
+   * Hellooooooo the world is a test
+   * @test demo of using the test framework
+   */
+  class HelloWorld_test : public Test
     {
-
-    /******************************************
-     * Helooooooo to the world of TDD
-     * @test demo of using the test framework
-     */
-    class HelloWorld_test : public Test
+      virtual void run(Arg arg) 
       {
-        virtual void run(Arg arg) 
-        {
-          int num= isnil(arg)?  1 : lexical_cast<int> (arg[1]);
-          
-          for ( ; 0 < num-- ; )
-            greeting();
-        } 
+        int num= isnil(arg)?  1 : lexical_cast<int> (arg[1]);
         
-        void greeting() 
-        { 
-          std::cout << "This is how the world ends...\n"; 
-        }
-      };
-    
+        for ( ; 0 < num-- ; )
+          greeting();
+      } 
       
-
-    /** Register this test class to be invoked in some test groups (suites) */
-    Launch<HelloWorld_test> run_HelloWorld_test("HelloWorld_test","unit common");
-    
-    // NOTE: you may use the Macro "LAUNCHER" in run.hpp to simplify this Registration
-    
-  } // namespace test
-
-} // namespace lumiera
+      void greeting() 
+      { 
+        std::cout << "This is how the world ends...\n";
+      }
+    };
+  
+  
+  
+  
+  
+  /** Register this test class to be invoked in some test groups (suites) */
+  Launch<HelloWorld_test> run_HelloWorld_test("HelloWorld_test","unit common");
+  
+  // NOTE: you may use the Macro "LAUNCHER" in run.hpp to simplify this Registration
+  
+  
+  
+}} // namespace lumiera::test
diff --git a/tests/lib/mainsuite.cpp b/tests/lib/mainsuite.cpp
index a49d99317..4b2429356 100644
--- a/tests/lib/mainsuite.cpp
+++ b/tests/lib/mainsuite.cpp
@@ -32,7 +32,10 @@ using lumiera::ON_GLOBAL_SHUTDOWN;
 
 /** run all tests or any single test specified in the first
  *  command line argument.
- *  Note: to ease debugging, we don't catch any exceptions. 
+ *  @return exit code signalling if any exception was caught
+ *          at the level of individual test cases
+ *  @throws any further exceptions raised outside of test cases
+ *  @throws any library and external exceptions (not lumiera::Exception)  
  */
 int main (int argc, const char* argv[])
 {
@@ -47,5 +50,5 @@ int main (int argc, const char* argv[])
     suite.run (args);
 
   LifecycleHook::trigger (ON_GLOBAL_SHUTDOWN);
-  return 0;
+  return suite.getExitCode();
 }

From d7ef67e821fa0d2968ada900bd50d04d2bfaff41 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 17:57:46 +0200
Subject: [PATCH 339/368] reduce the stress load on TypedCounter_test, to avoid
 testsuite out of memory

---
 tests/lib/typed-counter-test.cpp | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/tests/lib/typed-counter-test.cpp b/tests/lib/typed-counter-test.cpp
index 9dc43f366..a118d8d26 100644
--- a/tests/lib/typed-counter-test.cpp
+++ b/tests/lib/typed-counter-test.cpp
@@ -71,11 +71,19 @@ namespace test{
   
   namespace { // test data and helpers...
       
-      const uint MAX_FAMILIES   = 20;  ///< maximum separate "families", each sharing a TypedCounter
-      const uint MAX_MEMBERS    = 30;  ///< maximum members per family (member == test thread)
+      const uint MAX_FAMILIES   =  5;  ///< maximum separate "families", each sharing a TypedCounter
+      const uint MAX_MEMBERS    = 20;  ///< maximum members per family (member == test thread)
       const uint MAX_ITERATIONS = 50;  ///< maximum iterations within a single test thread
       const uint MAX_DELAY_ms   =  3;  ///< maximum delay between check iterations
       
+                                         /* Hint: number of threads = MEMBERS * FAMILIES
+                                          * 
+                                          * The values set here are fairly conservative,
+                                          * but increasing the number of threads causes the test suite
+                                          * to fail frequently. Please increase these values e.g.
+                                          * to 20 and 50 for a more thorough stress test!
+                                          */
+      
       
       /** 
        * Interface to a family of dummy types

From abd23ae399364d5948089c02c8920458c787ebec Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 23:12:36 +0200
Subject: [PATCH 340/368] TypedAllocationManager (frontend) now in lib::  --
 unit test pass

---
 .../typed-allocation-manager.hpp              |  4 +-
 src/proc/control/command-argument-holder.hpp  |  3 +-
 src/proc/control/command-closure.hpp          |  3 +-
 src/proc/control/command-impl.hpp             |  3 +-
 src/proc/control/command-registry.hpp         |  3 +-
 tests/40components.tests                      |  2 +-
 tests/lib/typed-allocation-manager-test.cpp   | 43 ++++---------------
 7 files changed, 20 insertions(+), 41 deletions(-)
 rename src/{proc/control => lib}/typed-allocation-manager.hpp (98%)

diff --git a/src/proc/control/typed-allocation-manager.hpp b/src/lib/typed-allocation-manager.hpp
similarity index 98%
rename from src/proc/control/typed-allocation-manager.hpp
rename to src/lib/typed-allocation-manager.hpp
index 346ad1b17..febfc8449 100644
--- a/src/proc/control/typed-allocation-manager.hpp
+++ b/src/lib/typed-allocation-manager.hpp
@@ -77,7 +77,7 @@
 
 
 
-namespace control { ////////////////////////////////////////////////////////////TODO: should go into namespace lib
+namespace lib {
   
   using std::tr1::shared_ptr;
   
@@ -318,5 +318,5 @@ namespace control { ////////////////////////////////////////////////////////////
     return allocCnt_.get<XX>();
   }
 
-} // namespace control
+} // namespace lib
 #endif
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index c2bcbb0f7..3248c11ce 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -42,7 +42,7 @@
 #ifndef CONTROL_COMMAND_ARGUMENT_HOLDER_H
 #define CONTROL_COMMAND_ARGUMENT_HOLDER_H
 
-#include "proc/control/typed-allocation-manager.hpp"
+#include "lib/typed-allocation-manager.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
@@ -54,6 +54,7 @@
 
 namespace control {
   
+  using lib::TypedAllocationManager;
   using lib::InPlaceBuffer;
   using std::string;
   
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 73b94ceda..1519ec113 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -77,7 +77,7 @@
 #include "lib/format.hpp"
 #include "lib/util.hpp"
 #include "proc/control/argument-erasure.hpp"
-#include "proc/control/typed-allocation-manager.hpp"
+#include "lib/typed-allocation-manager.hpp"
 
 #include <tr1/memory>
 #include <tr1/functional>
@@ -98,6 +98,7 @@ namespace control {
   using lumiera::typelist::StoreFunction;
   using lumiera::typelist::NullType;
   
+  using lib::TypedAllocationManager;
   using util::unConst;
   using std::tr1::function;
   using std::ostream;
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 92871a509..0a2161cbe 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -45,7 +45,7 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/command-mutation.hpp"
-#include "proc/control/typed-allocation-manager.hpp"
+#include "lib/typed-allocation-manager.hpp"
 #include "lib/bool-checkable.hpp"
 
 #include <boost/noncopyable.hpp>
@@ -57,6 +57,7 @@
 
 namespace control {
   
+  using lib::TypedAllocationManager;
   using std::tr1::function;
   using std::tr1::shared_ptr;
   
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 3e90d7cf9..269bd8b2d 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -68,7 +68,7 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-signature.hpp"
 #include "proc/control/command-argument-holder.hpp"
-#include "proc/control/typed-allocation-manager.hpp"
+#include "lib/typed-allocation-manager.hpp"
 
 #include <boost/functional/hash.hpp>
 #include <boost/noncopyable.hpp>
@@ -85,6 +85,7 @@ namespace control {
   using boost::noncopyable;
   using std::tr1::shared_ptr;
   using std::tr1::unordered_map;
+  using lib::TypedAllocationManager;
   using util::getValue_or_default;
   using util::contains;
   using std::string;
diff --git a/tests/40components.tests b/tests/40components.tests
index 1d6dacbf9..01d959a34 100644
--- a/tests/40components.tests
+++ b/tests/40components.tests
@@ -853,7 +853,7 @@ return: 0
 END
 
 
-TEST "TypedAllocationManager_test" TypedAllocationManager_test <<END
+TEST "TypedAllocationManager" TypedAllocationManager_test <<END
 return: 0
 END
 
diff --git a/tests/lib/typed-allocation-manager-test.cpp b/tests/lib/typed-allocation-manager-test.cpp
index e57686cc6..10e32b9b7 100644
--- a/tests/lib/typed-allocation-manager-test.cpp
+++ b/tests/lib/typed-allocation-manager-test.cpp
@@ -22,48 +22,23 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/test/test-helper.hpp"
-//#include "proc/control/command.hpp"
-#include "proc/control/typed-allocation-manager.hpp"
-//#include "proc/control/command-def.hpp"
-//#include "lib/lumitime.hpp"
-//#include "lib/symbol.hpp"
+#include "lib/typed-allocation-manager.hpp"
 #include "lib/util.hpp"
 
 
 #include <tr1/memory>
-//#include <boost/ref.hpp>
-//#include <boost/format.hpp>
-//#include <iostream>
 #include <cstdlib>
-//#include <string>
 
 
-namespace control {
-namespace test    {
-
-
-//  using boost::format;
-//  using boost::str;
-  //using lumiera::Time;
-  //using util::contains;
-  using std::tr1::shared_ptr;
-//  using std::tr1::bind;
-//  using std::string;
-  using std::rand;
-  //using std::cout;
-  //using std::endl;
-//  using lib::test::showSizeof;
+namespace lib {
+namespace test{
+  
+  
   using util::isSameObject;
-//  using util::contains;
-
-//  using session::test::TestClip;
-//  using lib::Symbol;
-//  using lumiera::P;
+  using std::tr1::shared_ptr;
+  using std::rand;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
   
   namespace { // test data and helpers...
   
@@ -99,7 +74,7 @@ namespace test    {
    * @test cover the basic implementation of a custom allocator, delegating to mpool.
    *       TypedAllocationManager is a base class, used e.g. to build the CommandRegistry.
    * 
-   * @todo planned but not implemented as of 8/09   see also Ticket #217
+   * @todo as of 9/09 we do heap allocation, but we should use mpool --   see also Ticket #219
    *        
    * @see CommandRegistry
    * @see command-registry-test.cpp
@@ -162,4 +137,4 @@ namespace test    {
   LAUNCHER (TypedAllocationManager_test, "unit common");
   
   
-}} // namespace control::test
+}} // namespace lib::test

From 2aac4e8ea00b089b35672d197b0fef71cba4afbb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 2 Oct 2009 23:49:15 +0200
Subject: [PATCH 341/368] remove spurious AcceptArgumentBinding mixin from
 ArgumentHolder it's an implementation class, after all, and doesn't need a
 convenience API

---
 src/proc/control/command-argument-holder.hpp  | 13 ++------
 .../proc/control/command-argument-test.cpp    | 30 ++++++++++---------
 2 files changed, 19 insertions(+), 24 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 3248c11ce..2a2226593 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -43,7 +43,6 @@
 #define CONTROL_COMMAND_ARGUMENT_HOLDER_H
 
 #include "lib/typed-allocation-manager.hpp"
-#include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/opaque-holder.hpp"
@@ -105,13 +104,7 @@ namespace control {
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
-    : public AcceptArgumentBinding< SIG                      // to derive the desired bind(..) signature
-                                  , ArgumentHolder<SIG,MEM>  // target class providing the implementation
-                                  , CmdClosure               // base class to inherit from
-                                  >
-    
-////////////////////////TODO: Ticket #266
-//  : public CmdClosure
+    : public CmdClosure
     {
       /** copy construction allowed(but no assignment)*/
       ArgumentHolder& operator= (ArgumentHolder const&);
@@ -152,7 +145,7 @@ namespace control {
       virtual void bindArguments (Arguments& args)
       {
         if (!arguments_->isValid())
-          bindArg(args.get<ArgTuple>());
+          storeTuple (args.get<ArgTuple>());
         else
           arguments_->bindArguments(args);
       }
@@ -214,7 +207,7 @@ namespace control {
       /** store a new argument tuple within this ArgumentHolder,
        *  discarding any previously stored arguments */
       void
-      bindArg (ArgTuple const& argTup)
+      storeTuple (ArgTuple const& argTup)
         {
           arguments_.template create<ArgHolder> (argTup);
         }
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index 67ab7e678..a1a2c6562 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -26,6 +26,7 @@
 #include "proc/control/command-argument-holder.hpp"
 #include "lib/scoped-ptrvect.hpp"
 #include "lib/lumitime-fmt.hpp"
+#include "lib/meta/tuple.hpp"
 #include "lib/util.hpp"
 
 #include <boost/format.hpp>
@@ -52,7 +53,7 @@ namespace test    {
   
   using lib::test::showSizeof;
   using lib::test::randTime;
-  
+  using namespace lumiera::typelist;
   
   
   
@@ -214,13 +215,12 @@ namespace test    {
           
           for_each (tup, showIt);
           
-////////////////////////TODO: Ticket #266
-          arg1->bind ();
-          arg2->bind (rand() % 10);
-          arg3->bind (rand() % 10, randTime());
-          arg4->bind (rand() % 10, randTime());
+          arg1->storeTuple (tuple::makeNullTuple());
+          arg2->storeTuple (tuple::make (rand() % 10));
+          arg3->storeTuple (tuple::make (rand() % 10, randTime()));
+          arg4->storeTuple (tuple::make (rand() % 10, randTime()));
           
-          arg5->bind (TTime (randTime()), Tstr("glorious"), rand() % 25);
+          arg5->storeTuple (tuple::make (TTime (randTime()), Tstr("glorious"), rand() % 25));
           
           ASSERT (!arg5->canUndo());
           
@@ -265,23 +265,23 @@ namespace test    {
           two.memento() = one.memento();     // put the same UNDO state in both
           ASSERT (one == two);               // ...makes them equal again 
           
-          one.bind (1,2);                    // verify argument tuple comparison
-          ASSERT (one != two);
+          one.storeTuple (tuple::make (1,2));
+          ASSERT (one != two);               // verify argument tuple comparison
           ASSERT (two != one);
           ASSERT (!isnil (one));
           ASSERT ( isnil (two));
           
-          two.bind (3,4);
+          two.storeTuple (tuple::make (3,4));
           ASSERT (!isnil (two));
           ASSERT (one != two);
           ASSERT (two != one);
           
-          one.bind (1,4);
+          one.storeTuple (tuple::make (1,4));
           ASSERT (!isnil (one));
           ASSERT (one != two);
           ASSERT (two != one);
           
-          one.bind (3,4);
+          one.storeTuple (tuple::make (3,4));
           ASSERT (!isnil (one));
           ASSERT (one == two);
           ASSERT (two == one);
@@ -308,7 +308,8 @@ namespace test    {
           cout << showSizeof(args) << endl;
           
           // store a set of parameter values, later to be used on invocation
-          args.bind (TTime(randTime()), Tstr("Lumiera rocks"), rand() % 100);
+          args.storeTuple (
+            tuple::make (TTime(randTime()), Tstr("Lumiera rocks"), rand() % 100));
           ASSERT (!isnil (args));
           cout << args << endl;
           
@@ -351,7 +352,8 @@ namespace test    {
           protocol.seekp(0);
           protocol << "RESET...";
           
-          args.bind (TTime(Time(123456)), Tstr("unbelievable"), rand() %100);
+          args.storeTuple (
+            tuple::make (TTime(Time(123456)), Tstr("unbelievable"), rand() %100));
           cout << "modified: " << args     << endl;
           cout << "copied  : " << argsCopy << endl;    // holds still the old params & memento
           

From 39f50b548cd6f6b03fd75acaea39038fa794d2ff Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 3 Oct 2009 03:40:12 +0200
Subject: [PATCH 342/368] Ticket #266: simplify and combine the bind(...) mixin
 templates into a single header

---
 src/proc/control/argument-tuple-accept.hpp    | 186 ++++++++++++++-
 src/proc/control/command-binding.hpp          | 211 ------------------
 src/proc/control/command-invocation.hpp       |  31 +--
 src/proc/control/command.hpp                  |   9 +-
 tests/45controller.tests                      |   2 +-
 .../control/argument-tuple-accept-test.cpp    |  15 +-
 6 files changed, 212 insertions(+), 242 deletions(-)
 delete mode 100644 src/proc/control/command-binding.hpp

diff --git a/src/proc/control/argument-tuple-accept.hpp b/src/proc/control/argument-tuple-accept.hpp
index 8a7d2d2f7..189934b9f 100644
--- a/src/proc/control/argument-tuple-accept.hpp
+++ b/src/proc/control/argument-tuple-accept.hpp
@@ -22,15 +22,33 @@
 
 
 /** @file argument-tuple-accept.hpp
+ ** Mixin-templates providing arbitrary function call operators and argument
+ ** binding functions. By inheriting from one of these templates, a class can
+ ** accept a specifically typed binding or function call, as specified by the
+ ** template parameters, or alternatively it can inherit a complete set of
+ ** templated argument binding functions, assuming that the matching signature
+ ** can be detected at runtime. These templates are used for the Proc-Layer
+ ** command frontend, to bind to the actual command arguments.
+ **   
  ** The AcceptArgumentBinding template allows to mix in a \c bind(...) function.
  ** Thereby, the correct number and types of arguments is derived according to
- ** the function signature given as template parameter. This helper template is
- ** used for the ArgumentHolder and generally for binding the arguments when
- ** defining Proc-Layer commands.
+ ** the function signature given as template parameter. The class mixing in this
+ ** template needs to provide a suitable member function \c bindArg(Tuple<...>) ,
+ ** which accepts all the command arguments packaged together into a tuple (record).
+ ** AcceptArgumentTuple works similar, but provides function call operators rather.
  ** 
+ ** Contrary to this, the AcceptAnyBinding mixin template provides a complete
+ ** set of \c bind(...) functions, accepting up to 9 arbitrary call parameters and
+ ** again forwarding the call to a template member function \c bindArg(Tuple<...>)
+ ** This helper template is used on the control::Command frontend objects; in this
+ ** case, there is a runtime type-check built into CommandImpl which will throw
+ ** when the provided arguments don't fit the (hidden) function signature embedded
+ ** within the CommandMutation (functor).
+ ** 
+ ** @see Command
  ** @see CommandDef
- ** @see ArgumentHolder
  ** @see argument-tuple-accept-test.cpp
+ ** @see command-invocation.hpp
  **
  */
 
@@ -53,6 +71,8 @@ namespace control {
     using namespace lumiera::typelist;
     
     
+      //
+     // _______________________________________________________________________________________________________________
     /** @internal mix in a function operator */
     template< class TAR, class BA, class RET
             , typename TYPES
@@ -238,6 +258,11 @@ namespace control {
     
     
     
+    
+    
+    
+      //
+     // _______________________________________________________________________________________________________________
     /** @internal mix in a \c bind() function
      */
     template< class TAR, class BA, class RET
@@ -424,6 +449,144 @@ namespace control {
     
     
     
+    
+    
+    
+      //
+     // _______________________________________________________________________________________________________________
+    /** @internal mix in complete set of templated \c bind() functions
+     */
+    template< class TAR, class BA, class RET>
+    struct AcceptAnyBind
+      : BA
+      {
+        
+        RET                                                                          //________________________________
+        bind ()                                                                     ///< Accept dummy binding (0 Arg)
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple());
+          }
+        
+        
+        template<typename T1>
+        RET                                                                          //________________________________
+        bind (T1 a1)                                                                ///< Accept binding with 1 Argument
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2)                                                         ///< Accept binding for 2 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3)                                                  ///< Accept binding for 3 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3, T4 a4)                                           ///< Accept binding for 4 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)                                    ///< Accept binding for 5 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                , typename T6
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)                             ///< Accept binding for 6 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                , typename T6
+                , typename T7
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)                      ///< Accept binding for 7 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                , typename T6
+                , typename T7
+                , typename T8
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)               ///< Accept binding for 8 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                , typename T6
+                , typename T7
+                , typename T8
+                , typename T9
+                >
+        RET                                                                          //________________________________
+        bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)        ///< Accept binding for 9 Arguments
+          {
+            return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
+          }
+        
+      };
+    
+    
+    
     template<typename SIG>
     struct _Type
       {
@@ -488,6 +651,21 @@ namespace control {
     };
   
   
+  /** Helper Template for control::Command, mix-in complete set of \c bind(...) functions
+   *  @param TAR  the target class providing a function \c bindArg(Tuple<Types<T1...> >)
+   *  @param RET  common return type of \c bindArg() and all \c bind() functions  
+   *  @param BASE the base class for inheritance chaining
+   */
+  template< class TAR
+          , class RET  =TAR&
+          , class BASE =bind_arg::Dummy
+          >
+  class AcceptAnyBinding
+    : public bind_arg::AcceptAnyBind<TAR,BASE,RET>
+    {
+    };
+  
+  
   
   
   
diff --git a/src/proc/control/command-binding.hpp b/src/proc/control/command-binding.hpp
deleted file mode 100644
index 2f278b33d..000000000
--- a/src/proc/control/command-binding.hpp
+++ /dev/null
@@ -1,211 +0,0 @@
-/*
-  COMMAND-BINDING.hpp  -  interface for various ways of binding command arguments
- 
-  Copyright (C)         Lumiera.org
-    2009,               Hermann Vosseler <Ichthyostega@web.de>
- 
-  This program is free software; you can redistribute it and/or
-  modify it under the terms of the GNU General Public License as
-  published by the Free Software Foundation; either version 2 of the
-  License, or (at your option) any later version.
- 
-  This program is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  GNU General Public License for more details.
- 
-  You should have received a copy of the GNU General Public License
-  along with this program; if not, write to the Free Software
-  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
- 
-*/
-
-
-/** @file command-binding.hpp
- ** Sub-include of command.hpp, providing an interface to various ways
- ** of binding command arguments. While in some cases, a command will be
- ** set up completely finished and closed over all it's arguments, usually
- ** the CommandDef will just specify the command operation and undo function,
- ** thus leaving the task of binding concrete arguments to the client code.
- ** Thus, depending on the circumstances, there might be usage situations
- ** where the exact number and type of arguments can be detected and checked
- ** at compile time, while otherwise this check needs to be deferred to happen
- ** at runtime, when the binding is actually invoked.
- **
- ** @see Command
- ** @see CommandDef
- ** @see command-use1-test.cpp
- **
- */
-
-
-
-#ifndef CONTROL_COMMAND_BINDING_H
-#define CONTROL_COMMAND_BINDING_H
-
-#include "lib/meta/typelist.hpp"
-#include "lib/meta/tuple.hpp"
-
-
-
-
-namespace control {
-namespace com { ///< Proc-Layer command implementation details
-  
-  using namespace lumiera::typelist;
-  
-  
-  
-////////////////////////TODO: Ticket #266  - can this be merged into argument-tuple-accept.hpp ??
-  
-  
-  /**
-   * Building block for commands, allowing to mix in
-   * a set of \c bind(...) function for up to nine arbitrary arguments.
-   * All these functions will package the argument values into a Tuple
-   * (record) and forward the call to a \c bindArg(Tuple<TYPES...>) function
-   * on the target class. The latter function is assumed to perform a 
-   * run-time check to detect calls with invalid signature.
-   */
-  template<class TAR, class BA>
-  class ArgumentBinder
-    : public BA
-    {
-      
-    public:
-    
-    
-    /** Arm up a command by binding it with concrete arguments.
-     *  At this point, a run time type check is performed, to find out
-     *  if the number and type of arguments of the stored operation function
-     *  within the command matches the given argument pattern
-     */
-    TAR&
-    bind ()
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::makeNullTuple());
-      }
-    
-    
-    template<typename T1>
-    TAR&                                                                                  //________________________________
-    bind (T1 a1)                                                                         ///< Accept binding with 1 Argument
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2)                                                                  ///< Accept binding for 2 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3)                                                           ///< Accept binding for 3 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3, T4 a4)                                                    ///< Accept binding for 4 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)                                             ///< Accept binding for 5 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)                                      ///< Accept binding for 6 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7)                               ///< Accept binding for 7 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            , typename T8
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8)                        ///< Accept binding for 8 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8));
-      }
-    
-    
-    template< typename T1
-            , typename T2
-            , typename T3
-            , typename T4
-            , typename T5
-            , typename T6
-            , typename T7
-            , typename T8
-            , typename T9
-            >
-    TAR&                                                                                  //________________________________
-    bind (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9)                 ///< Accept binding for 9 Arguments
-      {
-        return static_cast<TAR*> (this) -> bindArg (tuple::make (a1,a2,a3,a4,a5,a6,a7,a8,a9));
-      }
-    
-    };
-  
-  
-  
-  
-}} // namespace control::com
-#endif
diff --git a/src/proc/control/command-invocation.hpp b/src/proc/control/command-invocation.hpp
index bc1ff54b9..6f87f598f 100644
--- a/src/proc/control/command-invocation.hpp
+++ b/src/proc/control/command-invocation.hpp
@@ -26,7 +26,14 @@
  ** Especially, this header defines a set of free \c invoke(...) functions,
  ** allowing to bind to specific arguments and then invoke through the default
  ** HandlingPatern in a single call.
- **
+ ** 
+ ** While in some cases, a command will be set up completely finished and closed
+ ** over all it's arguments, usually the CommandDef will just specify the command operation
+ ** and undo function, thus leaving the task of binding concrete arguments to the client code.
+ ** Thus, depending on the circumstances, there might be usage situations where the exact number
+ ** and type of arguments can be detected and checked at compile time, while otherwise this check
+ ** needs to be deferred to happen at runtime, when the binding is actually invoked.
+ ** 
  ** @see Command
  ** @see CommandDef
  ** @see command-binding.hpp
@@ -40,34 +47,28 @@
 #define CONTROL_COMMAND_INVOCACTION_H
 
 //#include "pre.hpp"
-//#include "lib/symbol.hpp"
-//#include "lib/meta/typelist.hpp"
-//#include "lib/meta/tuple.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "proc/control/argument-tuple-accept.hpp"
 
-//#include <tr1/memory>
-#include <tr1/functional>
-
 
 
 
 namespace control {
   
-//  using lib::Symbol;
-//  using std::tr1::shared_ptr;
   using namespace lumiera::typelist;
   
-
-  namespace com { // define transient invoker objects, to allow for arbitrary bindings
   
+  
+  namespace com { ///< Proc-Layer command implementation details
+                 //    define transient invoker objects, to allow for arbitrary bindings
+    
     template<typename SIG>
     struct _DefineBindFunc
       {
         typedef ExecResult SIG_Bind(int);
       };
-  
+    
     
     /** @internal transient invoker object for invoking the command based
      *            on a function provided at compile time. Because of the
@@ -81,7 +82,7 @@ namespace control {
                            >
       {
         Command com_;
-
+        
         CommandInvoker (Command c)
           : com_(c)
           { }
@@ -101,14 +102,14 @@ namespace control {
     
     /** @internal transient invoker object, usable when the exact signature
      *            of the command's operation isn't known at compile time.
-     *            In this case, we allow any invocation call to compile, 
+     *            In this case, we allow any invocation call to compile,
      *            but the command will reject unsuitable signatures
      *            at runtime, when fetching the operation functor.
      */
     struct RuntimeCheckedCommandInvoker
       {
         Command com_;
-
+        
         RuntimeCheckedCommandInvoker (Command c)
           : com_(c)
           { }
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 0c105d2a5..58da5f815 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -55,8 +55,8 @@
 #include "pre.hpp"
 #include "lib/error.hpp"
 #include "lib/symbol.hpp"
-#include "proc/control/command-binding.hpp"
 #include "proc/control/argument-erasure.hpp"
+#include "proc/control/argument-tuple-accept.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "lib/bool-checkable.hpp"
 #include "lib/meta/tuple.hpp"
@@ -104,9 +104,10 @@ namespace control {
    *  - maybe checks the return value for errors
    */
   class Command
-    : public com::ArgumentBinder<Command    // accepts arbitrary bind(..) calls (with runtime check)
-           , lib::Handle<CommandImpl>      //  actually implemented as ref counting Handle
-           >                              //
+    : public AcceptAnyBinding<Command       // accepts arbitrary bind(..) calls (with runtime check)
+           , Command&                      //  (return value of bind() functions is *this)
+           , lib::Handle<CommandImpl>     //   actually implemented as ref counting Handle
+           >                             //
     {
       typedef lib::Handle<CommandImpl> _Handle;
       
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 8ee423e4d..240530932 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -35,7 +35,7 @@ out: RESET...undoIt\(time=00:..:....00\)----memento-:START...doIt\( Time=00:..:.
 END
 
 
-TEST "build argument accepting function" AcceptArgumentTuple_test <<END
+TEST "build argument accepting function" ArgumentTupleAccept_test <<END
 out: sizeof\( .+control.+TestClass.+ \) =   1
 out: sizeof\( .+control.+TestClass.+lumiera.Time.+ \) =  (12)|(16)
 out: 00:..:..\.000
diff --git a/tests/components/proc/control/argument-tuple-accept-test.cpp b/tests/components/proc/control/argument-tuple-accept-test.cpp
index e6ebb7bd3..34efd4bd3 100644
--- a/tests/components/proc/control/argument-tuple-accept-test.cpp
+++ b/tests/components/proc/control/argument-tuple-accept-test.cpp
@@ -1,5 +1,5 @@
 /*
-  AcceptArgumentTuple(Test)  -  verify synthesising a bind(...) function
+  ArgumentTupleAccept(Test)  -  verify synthesising a bind(...) function
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -54,7 +54,7 @@ namespace test    {
   namespace { // build a test dummy class....
     
     template<typename SIG>
-    struct Tup
+    struct _Tup
       {
         typedef typename FunctionSignature< function<SIG> >::Args Args;
         typedef typename FunctionSignature< function<SIG> >::Ret  Ret;
@@ -66,11 +66,11 @@ namespace test    {
     class TestClass
       : public AcceptArgumentBinding< SIG                     // to derive the desired signature
                                     , TestClass<SIG>          // the target class providing the implementation
-                                    , typename Tup<SIG>::Ty   // base class to inherit from
+                                    , typename _Tup<SIG>::Ty  // base class to inherit from
                                     >
       {
-        typedef typename Tup<SIG>::Ty ATuple;
-        typedef typename Tup<SIG>::Ret RetType;
+        typedef typename _Tup<SIG>::Ty  ATuple;
+        typedef typename _Tup<SIG>::Ret RetType;
         
       public:
         
@@ -78,6 +78,7 @@ namespace test    {
         bindArg (ATuple const& tuple)
           {
             static_cast<ATuple&> (*this) = tuple;
+            return RetType();
           }
       };
     
@@ -95,7 +96,7 @@ namespace test    {
    *       
    * @see  control::CommandArgumentHolder
    */
-  class AcceptArgumentTuple_test : public Test
+  class ArgumentTupleAccept_test : public Test
     {
       
       virtual void
@@ -119,7 +120,7 @@ namespace test    {
   
   
   /** Register this test class... */
-  LAUNCHER (AcceptArgumentTuple_test, "unit controller");
+  LAUNCHER (ArgumentTupleAccept_test, "unit controller");
   
   
 }} // namespace control::test

From 4c3fc9e64d55b8fae347993824c6705118eb7f06 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 3 Oct 2009 06:05:43 +0200
Subject: [PATCH 343/368] WIP getting CommandRegistry_test to run (equality on
 CommandImpl is still missing)

---
 src/proc/control/command-def.hpp              |  3 +-
 src/proc/control/command-registry.hpp         | 10 +--
 src/proc/control/command.cpp                  | 22 ++++---
 src/proc/control/command.hpp                  |  2 +-
 .../proc/control/command-registry-test.cpp    | 66 ++++++-------------
 5 files changed, 39 insertions(+), 64 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 2decf0c4c..d08f16646 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -164,6 +164,7 @@ namespace control {
                                                                ,captFunctor_
                                                                ,undoFunctor_);
             prototype_.activate(completedDef);
+            // activated the instance in the registry 
             ENSURE (prototype_);
             return CompletedDefinition<SIG> (prototype_);
           }
@@ -233,7 +234,7 @@ namespace control {
     : public lib::BoolCheckable<CommandDef>
     {
       Symbol id_;
-      Command prototype_;
+      Command& prototype_;
       
     public:
       CommandDef (Symbol cmdID)
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 269bd8b2d..83b2d57a6 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -1,5 +1,5 @@
 /*
-  COMMAND-REGISTRY.hpp  -  proc-Command object registration and storage management 
+  COMMAND-REGISTRY.hpp  -  proc-Command object registration and storage management
  
   Copyright (C)         Lumiera.org
     2009,               Hermann Vosseler <Ichthyostega@web.de>
@@ -25,17 +25,17 @@
  ** Managing command definitions and the storage of individual command objects.
  ** The CommandRegistry is an singleton object, accessible only at the implementation level
  ** of control::Command (note: CommandImpl isn't tied to the registry). For the other parts
- ** of the command system, it serves all "get me this command object"-services. Actually,
+ ** of the command system, it provides all "get me this command object"-services. Actually,
  ** these can be decomposed into two distinct parts:
  ** - allocation of CommandImpl frames and argument holders, which is delegated
  **   to the TypedAllocationManager
- ** - maintaining an index to find pre-build command definitions (prototypes)
+ ** - maintaining an index to find pre-built command definitions (prototypes)
  ** 
  ** \par Services during command lifecycle
  ** Each command starts out as command definition, accessed by client code through CommandDef.
  ** While collecting the necessary parts of such a definition, there is just an empty (pending)
  ** Command (smart-ptr frontend), which is already registered with the intended command-ID.
- ** A lookup on this ID would still fail in this phase, as the \link #queryIndex search function \endlink
+ ** A lookup on this ID would still fail at this point, as the \link #queryIndex search function \endlink
  ** treats missing and incomplete command definitions similar. When the definition is complete,
  ** a CommandImpl frame is allocated, configured and used to activate the Command (smart-ptr frontend).
  ** 
@@ -188,7 +188,7 @@ namespace control {
       const char*
       findDefinition (Command const& cmdInstance)  const
         {
-//        Lock sync(this);                                     ////////////////////////////////////TICKET #272  Lock should also be usable in const methods
+          Lock sync(this);
           return getValue_or_default (ridx_, &cmdInstance, 0 );
         }                                   //used as Key
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index f6272a14c..98d888c57 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -108,21 +108,23 @@ namespace control {
   }
   
   
-  /** @internal to be invoked by CommandDef
-   *  when starting a new definition  */
-  Command
+  /** @internal to be invoked by CommandDef when starting a new definition.
+   *  @note we hand out a direct reference to the registered object. When this
+   *        command is "activated" later on, this deliberately has the side effect
+   *        of detaching any further references which may be held outside.
+   *        They will continue to live on as "anonymous" commands, until
+   *        going out of scope.
+   */
+  Command&
   Command::fetchDef (Symbol cmdID)
   {
     CommandRegistry& registry = CommandRegistry::instance();
-    Command cmd = registry.queryIndex (cmdID);
-    if (cmd)
-      return cmd;
     
-    // create an empty definition, later to be activated
-    Command newDefinition;
+    Command newDefinition = registry.queryIndex (cmdID);
+                 // will be empty on first invocation
     
     return registry.track (cmdID, newDefinition);
-  }              // return new or currently registered cmd...
+  }              // return direct ref to new or currently registered cmd...
   
   
   /** @internal to be invoked through CommandDef to make a command ready
@@ -295,7 +297,7 @@ namespace control {
   ExecResult
   Command::execSync ()
   {
-    return exec (HandlingPattern::get(HandlingPattern::SYNC_THROW));
+    return exec (HandlingPattern::get(HandlingPattern::DUMMY));       ///////////TICKET #211 : should be ID::SYNC_THROW
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 58da5f815..f4f00fe5b 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -170,7 +170,7 @@ namespace control {
       
       
     protected:
-      static Command fetchDef (Symbol cmdID);
+      static Command& fetchDef (Symbol cmdID);
       
       friend class CommandDef;
       
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index d03ef200f..60ef1562d 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -23,58 +23,25 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
-#include "proc/control/command.hpp"
-#include "proc/control/command-registry.hpp"
 #include "proc/control/command-def.hpp"
-//#include "lib/lumitime.hpp"
+#include "proc/control/command-registry.hpp"
 #include "lib/symbol.hpp"
 #include "lib/util.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
 
 #include <tr1/functional>
-//#include <boost/ref.hpp>
-//#include <boost/format.hpp>
-//#include <iostream>
-//#include <cstdlib>
-//#include <string>
 
 
 namespace control {
 namespace test    {
-
-
-//  using boost::format;
-//  using boost::str;
-  //using lumiera::Time;
-  //using util::contains;
+  
+  
   using std::tr1::function;
-//  using std::tr1::bind;
-//  using std::string;
-  //using std::rand;
-  //using std::cout;
-  //using std::endl;
-//  using lib::test::showSizeof;
   using util::isSameObject;
-//  using util::contains;
-
-//  using session::test::TestClip;
   using lib::Symbol;
-//  using lumiera::P;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
-  
   namespace { // test data and helpers...
   
     Symbol TEST_CMD  = "test.command1.1";
@@ -90,8 +57,6 @@ namespace test    {
    * @note this test covers the internal bits of functionality,
    *       not the behaviour of the (integrated) command framework 
    * 
-   * @todo planned but not implemented as of 8/09   see also Ticket #217
-   *        
    * @see Command
    * @see CommandRegistry
    * @see command.cpp
@@ -122,8 +87,8 @@ namespace test    {
           
           // this command definition is
           // represented internally by a prototype instance
-          ASSERT (1+cnt_inst == registry.instance_count());
-          cnt_inst++;
+          ASSERT (++cnt_inst == registry.instance_count());
+          ASSERT (++cnt_defs == registry.index_size());
           
           checkRegistration (registry);
           checkAllocation(registry);
@@ -150,12 +115,13 @@ namespace test    {
           
           // now create a clone, registered under a different ID
           Command cmd2 = cmd1.storeDef(TEST_CMD2);
-          ASSERT (cmd2 == cmd1);
-          cmd2.bind(54321);
           ASSERT (cmd2 != cmd1);
+          cmd2.bind(54321);
           
           // this created exactly one additional instance allocation:
           ASSERT (1+cnt_inst == registry.instance_count());
+          ASSERT (1+cnt_defs == registry.index_size());
+          // ...and another index entry
           
           
           Command cmdX = registry.queryIndex(TEST_CMD2);
@@ -164,7 +130,7 @@ namespace test    {
           
           ASSERT (registry.remove(TEST_CMD2));
           ASSERT (!registry.queryIndex(TEST_CMD2));
-          ASSERT (cnt_inst == registry.instance_count());
+          ASSERT (cnt_defs == registry.index_size()); // removed from index
           
           // create a new registration..
           cmdX = registry.track(TEST_CMD, cmd2);  // but "accidentally" use an existing ID
@@ -176,6 +142,7 @@ namespace test    {
           ASSERT (cmdX != cmd1);
           
           ASSERT (1+cnt_inst == registry.instance_count());
+          ASSERT (1+cnt_defs == registry.index_size());
           
           ASSERT (string(TEST_CMD2) == registry.findDefinition(cmdX));
           
@@ -184,8 +151,13 @@ namespace test    {
           
           ASSERT (!registry.queryIndex(TEST_CMD2));
           ASSERT ( registry.queryIndex(TEST_CMD));
+          ASSERT (cnt_defs == registry.index_size());       // the index entry is gone,
           
-          ASSERT (cnt_inst == registry.instance_count());
+          ASSERT (1+cnt_inst == registry.instance_count()); // but the allocation still lives
+          cmdX.close();
+          ASSERT (1+cnt_inst == registry.instance_count());
+          cmd2.close();
+          ASSERT (0+cnt_inst == registry.instance_count()); // ...as long as it's still referred
         }
       
       
@@ -223,7 +195,7 @@ namespace test    {
           ASSERT (2+cnt_inst == registry.instance_count());
           
           ASSERT (!isSameObject (*pImpl, *clone));
-          ASSERT (*pImpl == *clone);
+//          ASSERT (*pImpl == *clone);             ///////////////////////////////////////TODO: comparison on CommandImpl ??
           
           ASSERT (!pImpl->canExec());
           typedef Types<int> ArgType;
@@ -231,13 +203,13 @@ namespace test    {
           pImpl->setArguments(arg);
           ASSERT (pImpl->canExec());
           
-          ASSERT (*pImpl != *clone);  // this proves the clone has indeed a separate identity
+//          ASSERT (*pImpl != *clone);  // this proves the clone has indeed a separate identity
           ASSERT (!clone->canExec());
           
           // discard the first clone and overwrite with a new one
           clone = registry.createCloneImpl(*pImpl);
           ASSERT (2+cnt_inst == registry.instance_count());
-          ASSERT (*pImpl == *clone);
+//          ASSERT (*pImpl == *clone);
           ASSERT (clone->canExec());
           
           clone.reset();

From 96d5ce74c46c9c0112f159d6b4132c13795e7854 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 3 Oct 2009 16:28:46 +0200
Subject: [PATCH 344/368] Ticket #292: outline unit test explicitly covering
 equality comparisions

---
 src/proc/control/memento-tie.hpp              |   3 +
 tests/45controller.tests                      |   5 +
 tests/components/Makefile.am                  |   1 +
 .../proc/control/command-equality-test.cpp    | 202 ++++++++++++++++++
 4 files changed, 211 insertions(+)
 create mode 100644 tests/components/proc/control/command-equality-test.cpp

diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index dff7467f3..c9a1052d9 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -76,6 +76,9 @@ namespace control {
    *  which needs to be stored within the MementoTie. On UNDO, the undo-operation functor needs
    *  to be provided with a reference to this stored memento value through an additional
    *  parameter (which by convention is always the last argument of the undo function).
+   *  
+   *  @param SIG signature of the command operation
+   *  @param MEM type of the memento state to capture. Needs to be default constructible and copyable
    */
   template<typename SIG, typename MEM>
   class MementoTie
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 240530932..bce8c19b9 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -55,6 +55,11 @@ return: 0
 END
 
 
+PLANNED "Equality comparisons" CommandEquality_test <<END
+return: 0
+END
+
+
 PLANNED "Command index and allocation" CommandRegistry_test <<END
 return: 0
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 5580a4c4b..ae3ca0096 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -49,6 +49,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/asset/testasset.cpp			\
 	$(testcomponents_srcdir)/proc/control/command-basic-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-argument-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-equality-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use1-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use2-test.cpp		\
diff --git a/tests/components/proc/control/command-equality-test.cpp b/tests/components/proc/control/command-equality-test.cpp
new file mode 100644
index 000000000..50d618e31
--- /dev/null
+++ b/tests/components/proc/control/command-equality-test.cpp
@@ -0,0 +1,202 @@
+/*
+  CommandEquality(Test)  -  verify equality comparisons on command's subsystems
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+#include "proc/control/command-mutation.hpp"
+#include "proc/control/command-argument-holder.hpp"
+#include "proc/control/memento-tie.hpp"
+#include "lib/meta/tuple.hpp"
+
+#include <tr1/functional>
+#include <string>
+
+namespace control {
+namespace test    {
+  
+  
+  
+  using namespace lumiera::typelist;
+  
+  using std::tr1::function;
+  using std::tr1::bind;
+  using std::string;
+  
+  
+  namespace {
+    
+    string check_;
+    
+    const string MARK_1 ("|_1_");
+    const string MARK_2 ("|_2_");
+    
+    void oper_1 (char par)             { check_ += MARK_1 + par; }
+    void oper_2 (char par)             { check_ += MARK_2 + par; }
+    
+    string capt_1 (char par)           { return MARK_1 + "|"+par+"|"; }
+    string capt_2 (char par)           { return MARK_2 + "|"+par+"|"; }
+    
+    void undo_1 (char par, string mem) { check_ = mem + MARK_1 + par + "|";}
+    void undo_2 (char par, string mem) { check_ = mem + MARK_2 + par + "|";}
+    
+    
+    typedef void   Sig_oper(char);
+    typedef string Sig_capt(char);
+    typedef void   Sig_undo(char,string);
+    
+    typedef Tuple<Types<char> > ArgTuple;
+    typedef MementoTie<Sig_oper, string> MemHolder;
+    typedef ArgumentHolder<Sig_oper,string> ArgHolder;
+    
+    
+    struct Testframe ///< test data set
+      {
+        char param;
+        
+        function<Sig_oper> o_Fun;
+        function<Sig_capt> c_Fun;
+        function<Sig_undo> u_Fun;
+      };
+    
+    
+  }
+  
+  
+  
+  /*****************************************************************************************
+   * @test cover command equality detection. Two commands are deemed equivalent, if they
+   *       - build on the same Mutation functors
+   *       - are either both incomplete or
+   *       - are bound to equivalent arguments
+   *       - hold equivalent undo state (memento)
+   * To conduct this test, we set up two sets of functions, and then build both complete
+   * command objects and command implementation facilities based on them.
+   *   
+   * The hidden problem with those comparisons is the equivalence of function objects,
+   * which is required by TR1, but refused to implement by libboost.
+   *       
+   * @see  control::Command
+   * @see  control::CmdClosure
+   * @see  control::Mutation
+   * @see  control::UndoMutation
+   * @see  control::MementoTie
+   * @see  control::CommandImpl
+   * @see  command-basic-test.hpp
+   */
+  class CommandEquality_test : public Test
+    {
+      
+      virtual void
+      run (Arg) 
+        {
+          ASSERT (&oper_1 != &oper_2);
+          ASSERT (&capt_1 != &capt_2);
+          ASSERT (&undo_1 != &undo_2);
+          
+          Testframe data1 = {'a', &oper_1, &capt_1, &undo_1};
+          Testframe data2 = {'z', &oper_2, &capt_2, &undo_2};
+          
+          verifyMutationEquality (data1,data2);
+          verifyMementoEquality  (data1,data2);
+          verifyClosureEquality  (data1,data2);
+          verifyCommandEquality  (data1,data2);
+        }
+      
+      
+      
+      void
+      verifyMutationEquality (Testframe d1, Testframe d2)
+        {
+          UNIMPLEMENTED ("cover Mutation equality test");
+        }
+      
+      
+      
+      void
+      verifyMementoEquality (Testframe d1, Testframe d2)
+        {
+          UNIMPLEMENTED ("cover Memento equality test");
+          
+#if false //////////////////////////////////////////////////////////////////////////////////////////////copied just for reference          
+          function<void(short,int)> u1_fun;             // deliberately unbound
+          function<void(short,int)> u2_fun  = undo;
+          function< int(short)>     c1_fun;
+          function< int(short)>     c2_fun  = capture;
+          
+          MemHolder m11 (u1_fun, c1_fun);
+          MemHolder m12 (u1_fun, c2_fun);
+          MemHolder m21 (u2_fun, c1_fun);
+          MemHolder m22 (u2_fun, c2_fun);
+          
+          ASSERT (!m11 && !m12 && !m21 && !m22);
+          ASSERT ( (m11 == m11));
+          ASSERT (!(m11 != m11));
+          
+          ASSERT (m11 != m12);
+          ASSERT (m11 != m21);
+          ASSERT (m11 != m22);
+          ASSERT (m12 != m11);
+          ASSERT (m12 != m21);
+          ASSERT (m12 != m22);
+          ASSERT (m21 != m11);
+          ASSERT (m21 != m12);
+          ASSERT (m21 != m22);
+          ASSERT (m22 != m11);
+          ASSERT (m22 != m12);
+          ASSERT (m22 != m21);
+         
+          MemHolder m22x (m22); // clone copy
+          ASSERT (!m22x);
+          ASSERT (m22 == m22x); // same functions, no state --> equal
+          
+          testVal = 0;
+          m22x.tieCaptureFunc() (1 + (rand() % 9));   // produce a random memento value != 0
+          ASSERT (0 < m22x.getState());
+          
+          ASSERT (m22 != m22x);
+          m22.tieCaptureFunc() (m22x.getState()); // get the same value into the memento within m22
+          ASSERT (m22 == m22x);
+#endif          
+        }
+      
+      
+      void
+      verifyClosureEquality (Testframe d1, Testframe d2)
+        {
+          UNIMPLEMENTED ("cover Closure equality test");
+        }
+      
+      
+      void
+      verifyCommandEquality (Testframe d1, Testframe d2)
+        {
+          UNIMPLEMENTED ("cover complete Command equality test");
+        }
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandEquality_test, "function controller");
+  
+  
+}} // namespace control::test

From 6a737a5838a439571ce6101e0d263bea75eb51c6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 3 Oct 2009 18:00:18 +0200
Subject: [PATCH 345/368] WIP draft the CommandEquality_test

---
 .../proc/control/command-equality-test.cpp    | 178 ++++++++++++++----
 1 file changed, 144 insertions(+), 34 deletions(-)

diff --git a/tests/components/proc/control/command-equality-test.cpp b/tests/components/proc/control/command-equality-test.cpp
index 50d618e31..a2472f0bc 100644
--- a/tests/components/proc/control/command-equality-test.cpp
+++ b/tests/components/proc/control/command-equality-test.cpp
@@ -23,12 +23,17 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
+#include "proc/control/command-def.hpp"
 #include "proc/control/command-mutation.hpp"
+#include "proc/control/argument-erasure.hpp"
 #include "proc/control/command-argument-holder.hpp"
 #include "proc/control/memento-tie.hpp"
 #include "lib/meta/tuple.hpp"
+#include "lib/symbol.hpp"
+#include "lib/util.hpp"
 
 #include <tr1/functional>
+#include <iostream>
 #include <string>
 
 namespace control {
@@ -37,16 +42,25 @@ namespace test    {
   
   
   using namespace lumiera::typelist;
+  using lib::Symbol;
+  using util::isnil;
+  using util::isSameObject;
   
   using std::tr1::function;
   using std::tr1::bind;
   using std::string;
+  using std::cout;
+  using std::endl;
+  
   
   
   namespace {
     
     string check_;
     
+    Symbol COMMAND1 ("test.equalityCommand1");
+    Symbol COMMAND2 ("test.equalityCommand2");
+    
     const string MARK_1 ("|_1_");
     const string MARK_2 ("|_2_");
     
@@ -65,8 +79,8 @@ namespace test    {
     typedef void   Sig_undo(char,string);
     
     typedef Tuple<Types<char> > ArgTuple;
+    typedef Closure<Sig_oper> ArgHolder;
     typedef MementoTie<Sig_oper, string> MemHolder;
-    typedef ArgumentHolder<Sig_oper,string> ArgHolder;
     
     
     struct Testframe ///< test data set
@@ -79,6 +93,10 @@ namespace test    {
       };
     
     
+    Testframe data1 = {'a', &oper_1, &capt_1, &undo_1};
+    Testframe data2 = {'z', &oper_2, &capt_2, &undo_2};
+    
+    Testframe nullD;
   }
   
   
@@ -113,42 +131,87 @@ namespace test    {
           ASSERT (&capt_1 != &capt_2);
           ASSERT (&undo_1 != &undo_2);
           
-          Testframe data1 = {'a', &oper_1, &capt_1, &undo_1};
-          Testframe data2 = {'z', &oper_2, &capt_2, &undo_2};
-          
-          verifyMutationEquality (data1,data2);
-          verifyMementoEquality  (data1,data2);
-          verifyClosureEquality  (data1,data2);
-          verifyCommandEquality  (data1,data2);
+          verifyMutationEquality();
+          verifyMementoEquality();
+          verifyClosureEquality();
+          verifyCommandEquality();
         }
       
       
       
       void
-      verifyMutationEquality (Testframe d1, Testframe d2)
+      verifyMutationEquality()
         {
-          UNIMPLEMENTED ("cover Mutation equality test");
+          Mutation mut1 (data1.o_Fun);
+          Mutation muti (data1.o_Fun);
+          Mutation mut2 (data2.o_Fun);
+          ASSERT (mut1 == mut1);
+          ASSERT (mut1 == muti);
+          ASSERT (muti == mut1);
+          ASSERT (mut1 != mut2);
+          ASSERT (mut2 != mut1);
+          ASSERT (muti != mut2);
+          ASSERT (mut2 != muti);
+          
+          Mutation umu (nullD.o_Fun);
+          ASSERT (mut1 != umu);
+          
+          Mutation omu (nullD.u_Fun);
+          ASSERT (omu != umu);
+          ASSERT (omu != muti);
+          
+          omu = Mutation(data1.u_Fun);
+          ASSERT (omu != muti);
         }
       
       
+      void
+      verifyClosureEquality()
+        {
+          ArgHolder a1 (tuple::make (data1.param));
+          ArgHolder a2 (tuple::make (data2.param));
+          ASSERT (a1 == a1);
+          ASSERT (a1 != a2);
+          ASSERT (a2 != a1);
+          
+          TypedArguments<ArgTuple> newArgs (tuple::make (data2.param));
+          a1.bindArguments(newArgs);
+          ASSERT (a1 == a2);
+          ASSERT (a2 == a1);
+          
+          typedef ArgumentHolder<Sig_oper,string> AHImpl;
+          AHImpl abuff1;
+          AHImpl abuff2;
+          ASSERT (abuff1 == abuff2);
+          abuff1.bindArguments(newArgs);
+          ASSERT (abuff1 != abuff2);
+          abuff2.bindArguments(newArgs);
+          ASSERT (abuff1 == abuff2);
+          UndoMutation umu1 (abuff1.tie (data1.u_Fun, data1.c_Fun));
+          ASSERT (abuff1 == abuff2);                                 // not detected, as the new memento holder isn't valid yet
+          
+          UndoMutation umu2 (abuff1.tie (data1.u_Fun, data2.c_Fun)); // note: using different capture function!
+          ASSERT (abuff1 == abuff2);
+          
+          umu1.captureState(a1);
+          umu2.captureState(a1);
+          ASSERT (abuff1 != abuff2); // and now the different state (due to the differing capture function) is detected
+          
+          umu2 = UndoMutation(abuff1.tie (data1.u_Fun, data1.c_Fun)); // re-bind, now using the "right" capture function
+          ASSERT (abuff1 != abuff2);
+          umu2.captureState(a1);    
+          ASSERT (abuff1 == abuff2); // same functions, same memento state
+        }
+      
       
       void
-      verifyMementoEquality (Testframe d1, Testframe d2)
+      verifyMementoEquality()
         {
-          UNIMPLEMENTED ("cover Memento equality test");
+          MemHolder m11 (data1.u_Fun, data1.c_Fun);
+          MemHolder m12 (data1.u_Fun, data2.c_Fun);
+          MemHolder m21 (data2.u_Fun, nullD.c_Fun); // note: unbound capture function
+          MemHolder m22 (data2.u_Fun, data2.c_Fun);
           
-#if false //////////////////////////////////////////////////////////////////////////////////////////////copied just for reference          
-          function<void(short,int)> u1_fun;             // deliberately unbound
-          function<void(short,int)> u2_fun  = undo;
-          function< int(short)>     c1_fun;
-          function< int(short)>     c2_fun  = capture;
-          
-          MemHolder m11 (u1_fun, c1_fun);
-          MemHolder m12 (u1_fun, c2_fun);
-          MemHolder m21 (u2_fun, c1_fun);
-          MemHolder m22 (u2_fun, c2_fun);
-          
-          ASSERT (!m11 && !m12 && !m21 && !m22);
           ASSERT ( (m11 == m11));
           ASSERT (!(m11 != m11));
           
@@ -169,28 +232,75 @@ namespace test    {
           ASSERT (!m22x);
           ASSERT (m22 == m22x); // same functions, no state --> equal
           
-          testVal = 0;
-          m22x.tieCaptureFunc() (1 + (rand() % 9));   // produce a random memento value != 0
-          ASSERT (0 < m22x.getState());
+          m22x.tieCaptureFunc() ('x');   // produce a memento state
+          ASSERT (!isnil (m22x.getState()));
           
           ASSERT (m22 != m22x);
-          m22.tieCaptureFunc() (m22x.getState()); // get the same value into the memento within m22
+          m22.tieCaptureFunc() ('x'); // get same value into the memento within m22
           ASSERT (m22 == m22x);
-#endif          
+          
+          // document shortcomings on UndoMutation comparisons
+          UndoMutation umu11 (m11);
+          UndoMutation umu12 (m12);
+          UndoMutation umu21 (m21);
+          UndoMutation umu22 (m22);
+          ASSERT (m11 == m12);       // note: differing capture function not detected
+          ASSERT (m11 != m21);
+          ASSERT (m11 != m22);
+          ASSERT (m12 != m21);
+          ASSERT (m12 != m22);
+          ASSERT (m21 == m22);       // note
         }
       
       
       void
-      verifyClosureEquality (Testframe d1, Testframe d2)
+      verifyCommandEquality()
         {
-          UNIMPLEMENTED ("cover Closure equality test");
+          CommandDef (COMMAND1)
+            .operation (data1.o_Fun)
+            .captureUndo (data1.c_Fun)
+            .undoOperation (data1.u_Fun)
+            ;
+          CommandDef (COMMAND2)
+            .operation (data2.o_Fun)
+            .captureUndo (data2.c_Fun)
+            .undoOperation (data2.u_Fun)
+            ;
+          
+          Command c1 = Command::get(COMMAND1); 
+          Command c2 = Command::get(COMMAND2); 
+          ASSERT (c1 == c1);
+          ASSERT (c1 != c2);
+          ASSERT (c2 != c1);
+          
+          Command cx = c1;
+          ASSERT (c1 == cx);
+          ASSERT (cx == c1);
+          ASSERT (!isSameObject (c1, c2));
+          
+          // verify equality matches behaviour
+          string protocol1 = execCommand(c1); 
+          string protocolX = execCommand(cx); 
+          string protocol2 = execCommand(c2);
+          
+          ASSERT (protocol1 == protocolX);
+          ASSERT (protocol1 != protocol2);
         }
       
       
-      void
-      verifyCommandEquality (Testframe d1, Testframe d2)
+      /** Helper: invoke and undo a command, 
+       *  @return resulting operation protocol
+       */
+      string
+      execCommand (Command com)
         {
-          UNIMPLEMENTED ("cover complete Command equality test");
+          check_ = "(start)";
+          com.bind('o');
+          com();
+          cout << com << ":" << check_ << endl;
+          com.undo();
+          cout << com << ":" << check_ << endl;
+          return check_;
         }
     };
   

From 50680168059bb1b2b1a986a21a0da05ef3c0cda2 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sun, 4 Oct 2009 16:43:49 +0200
Subject: [PATCH 346/368] WIP draft how the equality comparison on a function
 erasure could work

---
 src/lib/meta/function-erasure.hpp             | 45 ++++++++++++++++++-
 src/lib/opaque-holder.hpp                     | 15 +++++++
 src/proc/control/command-mutation.hpp         | 10 +++++
 .../proc/control/command-equality-test.cpp    | 18 ++++----
 tests/lib/meta/function-erasure-test.cpp      | 29 +++++++++++-
 5 files changed, 105 insertions(+), 12 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index c267be175..167d6c0bc 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -57,8 +57,10 @@
 #include "lib/error.hpp"
 #include "lib/bool-checkable.hpp"
 #include "lib/opaque-holder.hpp"
+#include "lib/functor-util.hpp"
 
 #include <tr1/functional>
+#include <boost/operators.hpp>
 
 
 namespace lumiera {
@@ -67,6 +69,33 @@ namespace typelist{
   using std::tr1::function;
   using util::unConst;
   
+  namespace { // comparison access helper functions
+    
+    typedef void* RawFunc; ///////////////////TODO
+    
+    template<class FH>
+    RawFunc 
+    accessRaw (FH funHolder)
+    {
+      ////////////////TODO
+    };
+    
+    template<class FH>
+    struct IsEqualTo
+      {
+        RawFunc ofunc_;
+        
+        IsEqualTo (FH o)
+          : ofunc_(o)
+          { }
+        
+        bool
+        operator() (RawFunc func)
+          {
+            return util::rawComparison(func, ofunc_);
+          }
+      };
+  }
   
   
   /******************************************************
@@ -86,12 +115,19 @@ namespace typelist{
    */
   template<class FH>
   struct FunErasure
-    : FH
+    : boost::equality_comparable< FunErasure
+    , FH >
     {
       template<typename FUN>
       FunErasure (FUN const& functor)
         : FH(functor)
         { }
+      
+      friend bool
+      operator== (FunErasure const& fe1, FunErasure const& fe2)
+        {
+          return fe1.query (IsEqualTo (fe2));
+        }
     };
   
   
@@ -195,6 +231,13 @@ namespace typelist{
           return *reinterpret_cast<SIG*> (funP_);
         }
       
+      template<class FUN>
+      bool
+      query (FUN predicate)
+        {
+          return predicate (funP_);
+        }
+      
       
       bool
       isValid()  const
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index f91cf9265..5ebee8aa3 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -475,6 +475,21 @@ namespace lib {
         }
       
       
+      /** invoke a query function on the embedded object,
+       *  accessing it as through the common base type.
+       *  @note this accessor doesn't require any knowledge
+       *        about the concrete type of the target object
+       */
+      template<typename RET, typename FUN>
+      RET
+      apply (FUN query)
+        {
+          BaseP asBase = buff().getBase();
+          ASSERT (asBase);
+          return query (asBase);
+        }
+      
+      
       bool
       empty() const
         {
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index b1bc12787..4621c03aa 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -51,6 +51,7 @@
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 
+#include <boost/operators.hpp>
 #include <iostream>
 #include <string>
 
@@ -72,6 +73,7 @@ namespace control {
    * concealed (erased) on the interface.
    */
   class Mutation
+    : public boost::equality_comparable<Mutation>
     {
       const CmdFunctor func_;
       
@@ -92,6 +94,14 @@ namespace control {
           clo.invoke (func_);
         }
       
+      
+      
+      /// Supporting equality comparisons...
+      friend bool
+      operator== (Mutation const& m1, Mutation const& m2)
+        {
+          return (m1.func_ == m2.func_);
+        }
     };
   
   
diff --git a/tests/components/proc/control/command-equality-test.cpp b/tests/components/proc/control/command-equality-test.cpp
index a2472f0bc..1c8bdd44d 100644
--- a/tests/components/proc/control/command-equality-test.cpp
+++ b/tests/components/proc/control/command-equality-test.cpp
@@ -85,16 +85,14 @@ namespace test    {
     
     struct Testframe ///< test data set
       {
-        char param;
-        
-        function<Sig_oper> o_Fun;
-        function<Sig_capt> c_Fun;
-        function<Sig_undo> u_Fun;
+        Sig_oper & o_Fun;
+        Sig_capt & c_Fun;
+        Sig_undo & u_Fun;
       };
     
     
-    Testframe data1 = {'a', &oper_1, &capt_1, &undo_1};
-    Testframe data2 = {'z', &oper_2, &capt_2, &undo_2};
+    Testframe data1 = {oper_1, capt_1, undo_1};
+    Testframe data2 = {oper_2, capt_2, undo_2};
     
     Testframe nullD;
   }
@@ -168,13 +166,13 @@ namespace test    {
       void
       verifyClosureEquality()
         {
-          ArgHolder a1 (tuple::make (data1.param));
-          ArgHolder a2 (tuple::make (data2.param));
+          ArgHolder a1 (tuple::make ('a'));
+          ArgHolder a2 (tuple::make ('z'));
           ASSERT (a1 == a1);
           ASSERT (a1 != a2);
           ASSERT (a2 != a1);
           
-          TypedArguments<ArgTuple> newArgs (tuple::make (data2.param));
+          TypedArguments<ArgTuple> newArgs (tuple::make ('z'));
           a1.bindArguments(newArgs);
           ASSERT (a1 == a2);
           ASSERT (a2 == a1);
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 3320dcc72..6db81fc3b 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -84,6 +84,20 @@ namespace test {
           check_FunctPtrHolder(Efp(testFunc),Efp(&testFunc), Efp(returnIt));
           check_VoidPtrHolder(Evoid(testFunc),Evoid(&testFunc),Evoid(returnIt));
           
+          check_Comparisons (Efun(testFunc), Efun(bindFunc));
+          check_Comparisons (Efun(testFunc), Efun(pAplFunc));
+          check_Comparisons (Efun(testFunc), Efun(membFunc));
+          check_Comparisons (Efun(testFunc), Efun(getterFunc));
+          check_Comparisons (Efun(bindFunc), Efun(pAplFunc));
+          check_Comparisons (Efun(bindFunc), Efun(membFunc));
+          check_Comparisons (Efun(bindFunc), Efun(getterFunc));
+          check_Comparisons (Efun(pAplFunc), Efun(membFunc));
+          check_Comparisons (Efun(pAplFunc), Efun(getterFunc));
+          check_Comparisons (Efun(membFunc), Efun(getterFunc));
+          
+          check_Comparisons (Efp(testFunc),   Efun(returnIt));
+          check_Comparisons (Evoid(testFunc), Evoid(returnIt));
+          
           detect_unboundFunctor(Efun(testFunc), Efun(getterFunc), Efun(membFunc));
           detect_unboundFunctor(Efp(testFunc),Efp(&testFunc), Efp(returnIt));
           detect_unboundFunctor(Evoid(testFunc),Evoid(&testFunc),Evoid(returnIt));
@@ -208,7 +222,20 @@ namespace test {
       
       template<class HOL>
       void
-      detect_unboundFunctor(HOL h1, HOL h2, HOL h3)
+      check_Comparisons (HOL h1, HOL h2)
+        {
+          ASSERT (h1 != h2);      
+          ASSERT (h2 != h1);
+          
+          HOL clone (h1);
+          ASSERT (clone == h1);
+          ASSERT (clone != h2);
+        }
+      
+      
+      template<class HOL>
+      void
+      detect_unboundFunctor (HOL h1, HOL h2, HOL h3)
         {
           // fabricate an unbound functor...
           

From 231278bafe7a5b4f0767507e8d3d0d5bd6dc45f6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 5 Oct 2009 00:49:37 +0200
Subject: [PATCH 347/368] implemented comparison on function erasure, pending
 test

---
 src/lib/functor-util.hpp                      | 15 +++-
 src/lib/meta/function-erasure.hpp             | 65 ++++++---------
 src/lib/opaque-holder.hpp                     | 27 +++----
 src/lib/util.hpp                              |  7 ++
 src/proc/control/command-mutation.hpp         |  8 +-
 .../proc/control/command-equality-test.cpp    | 81 ++++++++++---------
 tests/lib/meta/function-erasure-test.cpp      |  5 +-
 7 files changed, 109 insertions(+), 99 deletions(-)

diff --git a/src/lib/functor-util.hpp b/src/lib/functor-util.hpp
index 473a17dc7..7efee7060 100644
--- a/src/lib/functor-util.hpp
+++ b/src/lib/functor-util.hpp
@@ -152,7 +152,7 @@ namespace util { ////////////TODO: refactor it. But probably not directly into n
    *        "different" erroneously, due to garbage in 
    *        the internal functor data's storage */
   template<typename SIG>
-  bool
+  inline bool
   rawComparison (function<SIG> const& f1,
                  function<SIG> const& f2)
   {
@@ -165,13 +165,24 @@ namespace util { ////////////TODO: refactor it. But probably not directly into n
   /** catch-all for the comparison: functors with
    *  different base type are always "different" */
   template<typename SIG1, typename SIG2>
-  bool
+  inline bool
   rawComparison (function<SIG1> const&,
                  function<SIG2> const&)
   {
     return false;
   }
   
+  /** variant with unchecked access */
+  inline bool
+  rawComparison (void* f1, void* f2)
+  {
+    typedef HijackedFunction * HijP;
+    
+    return (!f1 && !f2)
+        || *reinterpret_cast<HijP> (f1)
+        == *reinterpret_cast<HijP> (f2);
+  }
+  
   
 } // namespace util
 
diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 167d6c0bc..292260e7c 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -60,7 +60,6 @@
 #include "lib/functor-util.hpp"
 
 #include <tr1/functional>
-#include <boost/operators.hpp>
 
 
 namespace lumiera {
@@ -69,33 +68,6 @@ namespace typelist{
   using std::tr1::function;
   using util::unConst;
   
-  namespace { // comparison access helper functions
-    
-    typedef void* RawFunc; ///////////////////TODO
-    
-    template<class FH>
-    RawFunc 
-    accessRaw (FH funHolder)
-    {
-      ////////////////TODO
-    };
-    
-    template<class FH>
-    struct IsEqualTo
-      {
-        RawFunc ofunc_;
-        
-        IsEqualTo (FH o)
-          : ofunc_(o)
-          { }
-        
-        bool
-        operator() (RawFunc func)
-          {
-            return util::rawComparison(func, ofunc_);
-          }
-      };
-  }
   
   
   /******************************************************
@@ -115,8 +87,7 @@ namespace typelist{
    */
   template<class FH>
   struct FunErasure
-    : boost::equality_comparable< FunErasure
-    , FH >
+    : FH
     {
       template<typename FUN>
       FunErasure (FUN const& functor)
@@ -124,9 +95,9 @@ namespace typelist{
         { }
       
       friend bool
-      operator== (FunErasure const& fe1, FunErasure const& fe2)
+      operator!= (FunErasure const& fer1, FunErasure const& fer2)
         {
-          return fe1.query (IsEqualTo (fe2));
+          return !(fer1==fer2);  // use equality defined by FH       
         }
     };
   
@@ -168,6 +139,14 @@ namespace typelist{
         {
           return get<function<SIG> >();
         }
+      
+      
+      friend bool
+      operator== (StoreFunction const& o1,
+                  StoreFunction const& o2)
+        {
+          return util::rawComparison (o1.asBase(),o2.asBase());
+        }
     };
   
   
@@ -199,6 +178,14 @@ namespace typelist{
           REQUIRE (fun);
           return *fun;
         }
+      
+      
+      friend bool
+      operator== (StoreFunPtr const& o1,
+                  StoreFunPtr const& o2)
+        {
+          return o1.asBase() == o2.asBase();
+        }
     };
   
   
@@ -231,19 +218,19 @@ namespace typelist{
           return *reinterpret_cast<SIG*> (funP_);
         }
       
-      template<class FUN>
-      bool
-      query (FUN predicate)
-        {
-          return predicate (funP_);
-        }
-      
       
       bool
       isValid()  const
         {
           return funP_;
         }
+      
+      friend bool
+      operator== (StoreUncheckedFunPtr const& o1,
+                  StoreUncheckedFunPtr const& o2)
+        {
+          return unConst(o1).funP_ == unConst(o2).funP_;
+        }
     };
   
   
diff --git a/src/lib/opaque-holder.hpp b/src/lib/opaque-holder.hpp
index 5ebee8aa3..7f5d63858 100644
--- a/src/lib/opaque-holder.hpp
+++ b/src/lib/opaque-holder.hpp
@@ -359,6 +359,15 @@ namespace lib {
           ref.buff().clone (storage_);
         }
       
+      BaseP
+      asBase ()  const   ///< @internal backdoor e.g. for comparisons
+        {
+          BaseP asBase = buff().getBase();
+          ASSERT (asBase);
+          return asBase;
+        }
+      
+      
       
       
     public:
@@ -462,9 +471,7 @@ namespace lib {
           
           // second try: maybe we can perform a dynamic downcast
           // or direct conversion to the actual target type.
-          BaseP asBase = buff().getBase(); 
-          ASSERT (asBase);
-          SUB* content = AccessPolicy::template access<SUB> (asBase);
+          SUB* content = AccessPolicy::template access<SUB> (asBase());
           if (content) 
             return *content;
           
@@ -475,20 +482,6 @@ namespace lib {
         }
       
       
-      /** invoke a query function on the embedded object,
-       *  accessing it as through the common base type.
-       *  @note this accessor doesn't require any knowledge
-       *        about the concrete type of the target object
-       */
-      template<typename RET, typename FUN>
-      RET
-      apply (FUN query)
-        {
-          BaseP asBase = buff().getBase();
-          ASSERT (asBase);
-          return query (asBase);
-        }
-      
       
       bool
       empty() const
diff --git a/src/lib/util.hpp b/src/lib/util.hpp
index bcceb2480..02a52941b 100644
--- a/src/lib/util.hpp
+++ b/src/lib/util.hpp
@@ -227,6 +227,13 @@ namespace util {
     return const_cast<OBJ*> (o);
   }
   
+  template<class OBJ>
+  OBJ&
+  unConst (OBJ const& ro)
+  {
+    return const_cast<OBJ&> (ro);
+  }
+  
   
   /** compare plain object identity,
    *  bypassing any custom comparison operators.
diff --git a/src/proc/control/command-mutation.hpp b/src/proc/control/command-mutation.hpp
index 4621c03aa..8152f093c 100644
--- a/src/proc/control/command-mutation.hpp
+++ b/src/proc/control/command-mutation.hpp
@@ -51,7 +51,6 @@
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
 
-#include <boost/operators.hpp>
 #include <iostream>
 #include <string>
 
@@ -73,7 +72,6 @@ namespace control {
    * concealed (erased) on the interface.
    */
   class Mutation
-    : public boost::equality_comparable<Mutation>
     {
       const CmdFunctor func_;
       
@@ -102,6 +100,12 @@ namespace control {
         {
           return (m1.func_ == m2.func_);
         }
+      
+      friend bool
+      operator!= (Mutation const& m1, Mutation const& m2)
+        {
+          return !(m1==m2);
+        }
     };
   
   
diff --git a/tests/components/proc/control/command-equality-test.cpp b/tests/components/proc/control/command-equality-test.cpp
index 1c8bdd44d..8e1050072 100644
--- a/tests/components/proc/control/command-equality-test.cpp
+++ b/tests/components/proc/control/command-equality-test.cpp
@@ -78,23 +78,13 @@ namespace test    {
     typedef string Sig_capt(char);
     typedef void   Sig_undo(char,string);
     
+    typedef function<Sig_oper> Fun_o;
+    typedef function<Sig_capt> Fun_c;
+    typedef function<Sig_undo> Fun_u;
+    
     typedef Tuple<Types<char> > ArgTuple;
     typedef Closure<Sig_oper> ArgHolder;
     typedef MementoTie<Sig_oper, string> MemHolder;
-    
-    
-    struct Testframe ///< test data set
-      {
-        Sig_oper & o_Fun;
-        Sig_capt & c_Fun;
-        Sig_undo & u_Fun;
-      };
-    
-    
-    Testframe data1 = {oper_1, capt_1, undo_1};
-    Testframe data2 = {oper_2, capt_2, undo_2};
-    
-    Testframe nullD;
   }
   
   
@@ -140,9 +130,16 @@ namespace test    {
       void
       verifyMutationEquality()
         {
-          Mutation mut1 (data1.o_Fun);
-          Mutation muti (data1.o_Fun);
-          Mutation mut2 (data2.o_Fun);
+          Fun_o oFun_1 (oper_1);
+          Fun_o oFun_2 (oper_2);
+          Fun_o oFun_empty;
+          
+          Fun_u uFun_1 (undo_1);
+          Fun_u uFun_empty;
+          
+          Mutation mut1 (oFun_1);
+          Mutation muti (oFun_1);
+          Mutation mut2 (oFun_2);
           ASSERT (mut1 == mut1);
           ASSERT (mut1 == muti);
           ASSERT (muti == mut1);
@@ -151,15 +148,15 @@ namespace test    {
           ASSERT (muti != mut2);
           ASSERT (mut2 != muti);
           
-          Mutation umu (nullD.o_Fun);
+          Mutation umu (oFun_empty);    // empty operation function
           ASSERT (mut1 != umu);
           
-          Mutation omu (nullD.u_Fun);
-          ASSERT (omu != umu);
-          ASSERT (omu != muti);
+          Mutation mut_u0 (uFun_empty); // empty undo function
+          ASSERT (mut_u0 != umu);
+          ASSERT (mut_u0 != muti);
           
-          omu = Mutation(data1.u_Fun);
-          ASSERT (omu != muti);
+          Mutation mut_u1 (uFun_1); 
+          ASSERT (mut_u0 != mut_u1);    // function signatures differing
         }
       
       
@@ -185,19 +182,19 @@ namespace test    {
           ASSERT (abuff1 != abuff2);
           abuff2.bindArguments(newArgs);
           ASSERT (abuff1 == abuff2);
-          UndoMutation umu1 (abuff1.tie (data1.u_Fun, data1.c_Fun));
-          ASSERT (abuff1 == abuff2);                                 // not detected, as the new memento holder isn't valid yet
+          UndoMutation umu1 (abuff1.tie (undo_1, capt_1));
+          ASSERT (abuff1 == abuff2);                         // not detected, as the new memento holder isn't valid yet
           
-          UndoMutation umu2 (abuff1.tie (data1.u_Fun, data2.c_Fun)); // note: using different capture function!
+          UndoMutation umu2 (abuff1.tie (undo_1, capt_2)); // note: using different capture function!
           ASSERT (abuff1 == abuff2);
           
           umu1.captureState(a1);
           umu2.captureState(a1);
           ASSERT (abuff1 != abuff2); // and now the different state (due to the differing capture function) is detected
           
-          umu2 = UndoMutation(abuff1.tie (data1.u_Fun, data1.c_Fun)); // re-bind, now using the "right" capture function
+          UndoMutation umu3 (abuff1.tie (undo_1, capt_1)); // now using the "right" capture function
           ASSERT (abuff1 != abuff2);
-          umu2.captureState(a1);    
+          umu3.captureState(a1);    
           ASSERT (abuff1 == abuff2); // same functions, same memento state
         }
       
@@ -205,10 +202,18 @@ namespace test    {
       void
       verifyMementoEquality()
         {
-          MemHolder m11 (data1.u_Fun, data1.c_Fun);
-          MemHolder m12 (data1.u_Fun, data2.c_Fun);
-          MemHolder m21 (data2.u_Fun, nullD.c_Fun); // note: unbound capture function
-          MemHolder m22 (data2.u_Fun, data2.c_Fun);
+          Fun_u uFun_1 (undo_1);
+          Fun_u uFun_2 (undo_2);
+          Fun_c cFun_1 (capt_1);
+          Fun_c cFun_2 (capt_2);
+          Fun_c cFun_empty;
+          
+          Fun_c empty_c;
+          
+          MemHolder m11 (uFun_1, cFun_1);
+          MemHolder m12 (uFun_1, cFun_2);
+          MemHolder m21 (uFun_2, cFun_empty);   // note: unbound capture function
+          MemHolder m22 (uFun_2, cFun_2);
           
           ASSERT ( (m11 == m11));
           ASSERT (!(m11 != m11));
@@ -255,14 +260,14 @@ namespace test    {
       verifyCommandEquality()
         {
           CommandDef (COMMAND1)
-            .operation (data1.o_Fun)
-            .captureUndo (data1.c_Fun)
-            .undoOperation (data1.u_Fun)
+            .operation (oper_1)
+            .captureUndo (capt_1)
+            .undoOperation (undo_1)
             ;
           CommandDef (COMMAND2)
-            .operation (data2.o_Fun)
-            .captureUndo (data2.c_Fun)
-            .undoOperation (data2.u_Fun)
+            .operation (oper_2)
+            .captureUndo (capt_2)
+            .undoOperation (undo_2)
             ;
           
           Command c1 = Command::get(COMMAND1); 
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 6db81fc3b..27bddaee8 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -95,7 +95,7 @@ namespace test {
           check_Comparisons (Efun(pAplFunc), Efun(getterFunc));
           check_Comparisons (Efun(membFunc), Efun(getterFunc));
           
-          check_Comparisons (Efp(testFunc),   Efun(returnIt));
+          check_Comparisons (Efp(testFunc),   Efp(returnIt));
           check_Comparisons (Evoid(testFunc), Evoid(returnIt));
           
           detect_unboundFunctor(Efun(testFunc), Efun(getterFunc), Efun(membFunc));
@@ -224,6 +224,9 @@ namespace test {
       void
       check_Comparisons (HOL h1, HOL h2)
         {
+          ASSERT (h1 == h1); ASSERT (!(h1 != h1));
+          ASSERT (h2 == h2); ASSERT (!(h2 != h2));
+          
           ASSERT (h1 != h2);      
           ASSERT (h2 != h1);
           

From fea85acd0e85f47e1c6793f9915233afd441ad45 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 5 Oct 2009 01:38:35 +0200
Subject: [PATCH 348/368] equality comparisons on function erasure objects
 covered ...well, as good as possible, as boost refuses to implement this
 feature

---
 src/lib/meta/function-erasure.hpp        |  4 +++-
 tests/lib/meta/function-erasure-test.cpp | 20 ++++++++++++++++----
 2 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/src/lib/meta/function-erasure.hpp b/src/lib/meta/function-erasure.hpp
index 292260e7c..0590117bc 100644
--- a/src/lib/meta/function-erasure.hpp
+++ b/src/lib/meta/function-erasure.hpp
@@ -184,7 +184,9 @@ namespace typelist{
       operator== (StoreFunPtr const& o1,
                   StoreFunPtr const& o2)
         {
-          return o1.asBase() == o2.asBase();
+          void * *fun1 = reinterpret_cast<void**> (o1.asBase());
+          void * *fun2 = reinterpret_cast<void**> (o2.asBase());
+          return *fun1 == *fun2;
         }
     };
   
diff --git a/tests/lib/meta/function-erasure-test.cpp b/tests/lib/meta/function-erasure-test.cpp
index 27bddaee8..090fb8825 100644
--- a/tests/lib/meta/function-erasure-test.cpp
+++ b/tests/lib/meta/function-erasure-test.cpp
@@ -98,6 +98,13 @@ namespace test {
           check_Comparisons (Efp(testFunc),   Efp(returnIt));
           check_Comparisons (Evoid(testFunc), Evoid(returnIt));
           
+          ASSERT ( detect_Clone (Efun(testFunc)));
+          ASSERT (!detect_Clone (Efun(bindFunc)));  //note equality not detected when cloning a bind term
+          ASSERT (!detect_Clone (Efun(pAplFunc)));  //similarly
+          ASSERT (!detect_Clone (Efun(membFunc)));  //analogous for bound member function
+          ASSERT ( detect_Clone (Efp(testFunc) ));
+          ASSERT ( detect_Clone (Evoid(testFunc)));
+          
           detect_unboundFunctor(Efun(testFunc), Efun(getterFunc), Efun(membFunc));
           detect_unboundFunctor(Efp(testFunc),Efp(&testFunc), Efp(returnIt));
           detect_unboundFunctor(Evoid(testFunc),Evoid(&testFunc),Evoid(returnIt));
@@ -227,12 +234,17 @@ namespace test {
           ASSERT (h1 == h1); ASSERT (!(h1 != h1));
           ASSERT (h2 == h2); ASSERT (!(h2 != h2));
           
-          ASSERT (h1 != h2);      
+          ASSERT (h1 != h2);
           ASSERT (h2 != h1);
-          
+        }
+      
+      
+      template<class HOL>
+      bool
+      detect_Clone (HOL const& h1)
+        {
           HOL clone (h1);
-          ASSERT (clone == h1);
-          ASSERT (clone != h2);
+          return (clone == h1);
         }
       
       

From eefc40acb73b66a81071921124411bf57c1854fe Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 5 Oct 2009 02:48:12 +0200
Subject: [PATCH 349/368] command-equality-test finished for now

---
 .../proc/control/command-equality-test.cpp    | 63 ++++++++++---------
 1 file changed, 33 insertions(+), 30 deletions(-)

diff --git a/tests/components/proc/control/command-equality-test.cpp b/tests/components/proc/control/command-equality-test.cpp
index 8e1050072..fc8986fbc 100644
--- a/tests/components/proc/control/command-equality-test.cpp
+++ b/tests/components/proc/control/command-equality-test.cpp
@@ -67,8 +67,8 @@ namespace test    {
     void oper_1 (char par)             { check_ += MARK_1 + par; }
     void oper_2 (char par)             { check_ += MARK_2 + par; }
     
-    string capt_1 (char par)           { return MARK_1 + "|"+par+"|"; }
-    string capt_2 (char par)           { return MARK_2 + "|"+par+"|"; }
+    string capt_1 (char par)           { return check_ + MARK_1 + "|"+par+"|"; }
+    string capt_2 (char par)           { return check_ + MARK_2 + "|"+par+"|"; }
     
     void undo_1 (char par, string mem) { check_ = mem + MARK_1 + par + "|";}
     void undo_2 (char par, string mem) { check_ = mem + MARK_2 + par + "|";}
@@ -97,10 +97,14 @@ namespace test    {
    *       - hold equivalent undo state (memento)
    * To conduct this test, we set up two sets of functions, and then build both complete
    * command objects and command implementation facilities based on them.
-   *   
-   * The hidden problem with those comparisons is the equivalence of function objects,
-   * which is required by TR1, but refused to implement by libboost.
-   *       
+   * 
+   * @note The hidden problem with those comparisons is the equivalence of function objects,
+   *       which is required by TR1, but refused to implement by lib boost. We use a low level
+   *       hack, based on internals of the boost function implementation, but this solution
+   *       fails to detect equivalent functions under some circumstances (e.g. when there is
+   *       binding involved, and / or the binders have been cloned). Bottom line: \c == is
+   *       reliable, \c != might be wrong.
+   * 
    * @see  control::Command
    * @see  control::CmdClosure
    * @see  control::Mutation
@@ -183,19 +187,22 @@ namespace test    {
           abuff2.bindArguments(newArgs);
           ASSERT (abuff1 == abuff2);
           UndoMutation umu1 (abuff1.tie (undo_1, capt_1));
-          ASSERT (abuff1 == abuff2);                         // not detected, as the new memento holder isn't valid yet
-          
-          UndoMutation umu2 (abuff1.tie (undo_1, capt_2)); // note: using different capture function!
-          ASSERT (abuff1 == abuff2);
+          ASSERT (abuff1 != abuff2);                       // abuff2 isn't tied yet, i.e. has no undo/capture function
+          UndoMutation umu2 (abuff2.tie (undo_1, capt_1));
+          ASSERT (abuff1 == abuff2);                       // same capture function, no memento state!
           
           umu1.captureState(a1);
-          umu2.captureState(a1);
-          ASSERT (abuff1 != abuff2); // and now the different state (due to the differing capture function) is detected
-          
-          UndoMutation umu3 (abuff1.tie (undo_1, capt_1)); // now using the "right" capture function
           ASSERT (abuff1 != abuff2);
-          umu3.captureState(a1);    
+          umu2.captureState(a1);
           ASSERT (abuff1 == abuff2); // same functions, same memento state
+          
+          check_ += "fake";          // manipulate the "state" to be captured
+          umu2.captureState(a1);     // capture again...
+          ASSERT (abuff1 != abuff2); // captured memento differs!
+          
+          UndoMutation umu3 (abuff2.tie (undo_1, capt_2));
+          umu3.captureState(a1);
+          ASSERT (abuff1 != abuff2); // differing functions detected
         }
       
       
@@ -215,7 +222,10 @@ namespace test    {
           MemHolder m21 (uFun_2, cFun_empty);   // note: unbound capture function
           MemHolder m22 (uFun_2, cFun_2);
           
-          ASSERT ( (m11 == m11));
+          ASSERT (m11 == m11);
+          ASSERT (m12 == m12);
+          ASSERT (m21 == m21);
+          ASSERT (m22 == m22);
           ASSERT (!(m11 != m11));
           
           ASSERT (m11 != m12);
@@ -230,7 +240,7 @@ namespace test    {
           ASSERT (m22 != m11);
           ASSERT (m22 != m12);
           ASSERT (m22 != m21);
-         
+          
           MemHolder m22x (m22); // clone copy
           ASSERT (!m22x);
           ASSERT (m22 == m22x); // same functions, no state --> equal
@@ -244,15 +254,8 @@ namespace test    {
           
           // document shortcomings on UndoMutation comparisons
           UndoMutation umu11 (m11);
-          UndoMutation umu12 (m12);
-          UndoMutation umu21 (m21);
-          UndoMutation umu22 (m22);
-          ASSERT (m11 == m12);       // note: differing capture function not detected
-          ASSERT (m11 != m21);
-          ASSERT (m11 != m22);
-          ASSERT (m12 != m21);
-          ASSERT (m12 != m22);
-          ASSERT (m21 == m22);       // note
+          UndoMutation umu12 (m11);    // note: due to cloning the embedded functor,
+          ASSERT (umu11 != umu12);     //       our hacked-in comparison operator fails
         }
       
       
@@ -270,8 +273,8 @@ namespace test    {
             .undoOperation (undo_2)
             ;
           
-          Command c1 = Command::get(COMMAND1); 
-          Command c2 = Command::get(COMMAND2); 
+          Command c1 = Command::get(COMMAND1);
+          Command c2 = Command::get(COMMAND2);
           ASSERT (c1 == c1);
           ASSERT (c1 != c2);
           ASSERT (c2 != c1);
@@ -282,8 +285,8 @@ namespace test    {
           ASSERT (!isSameObject (c1, c2));
           
           // verify equality matches behaviour
-          string protocol1 = execCommand(c1); 
-          string protocolX = execCommand(cx); 
+          string protocol1 = execCommand(c1);
+          string protocolX = execCommand(cx);
           string protocol2 = execCommand(c2);
           
           ASSERT (protocol1 == protocolX);

From 07de2a767b9b6ec76ae22a646106b30993f449f4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 5 Oct 2009 04:29:06 +0200
Subject: [PATCH 350/368] implement equality comparison on CommandImpl level

---
 src/lib/meta/maybe-compare.hpp                | 76 +++++++++++++++++++
 src/lib/meta/trait.hpp                        |  8 +-
 src/proc/control/command-argument-holder.hpp  |  8 ++
 src/proc/control/command-closure.hpp          | 14 +++-
 src/proc/control/command-impl.hpp             | 16 +++-
 src/proc/control/command.cpp                  |  8 ++
 src/proc/control/command.hpp                  |  5 +-
 src/proc/control/memento-tie.hpp              |  4 +-
 .../proc/control/command-argument-test.cpp    | 51 +++++++++----
 9 files changed, 162 insertions(+), 28 deletions(-)
 create mode 100644 src/lib/meta/maybe-compare.hpp

diff --git a/src/lib/meta/maybe-compare.hpp b/src/lib/meta/maybe-compare.hpp
new file mode 100644
index 000000000..385e90bd3
--- /dev/null
+++ b/src/lib/meta/maybe-compare.hpp
@@ -0,0 +1,76 @@
+/*
+  MAYBE-COMPARE.hpp  -  guarded invocation of comparisons
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+#ifndef LUMIERA_META_MAYBE_COMPARE_H
+#define LUMIERA_META_MAYBE_COMPARE_H
+
+
+#include "lib/functor-util.hpp"
+
+#include <tr1/functional>
+
+
+namespace lumiera {
+namespace typelist {
+  
+  using std::tr1::function;
+  
+  /**
+   * Trait template for invoking equality comparison.
+   * This allows to treat some types specifically....
+   */
+  template<typename X>
+  struct Comparator
+    {
+      static bool
+      equals (X const& x1, X const& x2)
+        {
+          return x1 == x2;
+        }
+    };
+  
+  /** while the boost function implementation doesn't provide comparison,
+   *  we'll use our private hack, which at least detects equivalence 
+   *  in \em some cases... */
+  template<typename SIG>
+  struct Comparator<function<SIG> >
+    {
+      static bool
+      equals (function<SIG> const& f1, function<SIG> const& f2)
+        { 
+          return util::rawComparison(f1,f2);
+        }
+        
+    };
+  
+  
+  template<typename X>
+  inline bool
+  equals_safeInvoke (X const& x1, X const& x2)
+  {
+    return Comparator<X>::equals(x1,x2);
+  }
+  
+  
+}} // namespace lumiera::typelist
+#endif
diff --git a/src/lib/meta/trait.hpp b/src/lib/meta/trait.hpp
index 608888561..323ae0ac4 100644
--- a/src/lib/meta/trait.hpp
+++ b/src/lib/meta/trait.hpp
@@ -32,12 +32,10 @@
 #include <boost/utility/enable_if.hpp>
 #include <string>
 
-  
+
 namespace lumiera {
 namespace typelist {
-
-  using boost::enable_if;
-  using boost::is_arithmetic;
+  
   
   
   /** Trait template for detecting if a type can be converted to string.
@@ -66,7 +64,7 @@ namespace typelist {
   template<typename X>
   struct can_lexical2string
     {
-      enum { value = is_arithmetic<X>::value
+      enum { value = boost::is_arithmetic<X>::value
            };
     };
   
diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 2a2226593..c18e18b06 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -238,6 +238,14 @@ namespace control {
           return memento_->getState();
         }
       
+      bool
+      equals (CmdClosure const& other)  const
+        {
+          const ArgumentHolder* toCompare = dynamic_cast<const ArgumentHolder*> (&other);
+          return (toCompare)
+              && (*this == *toCompare);
+        }
+      
       /// Supporting equality comparisons...
       friend bool
       operator== (ArgumentHolder const& a1, ArgumentHolder const& a2)
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 1519ec113..7bef71521 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -74,6 +74,7 @@
 #include "lib/meta/function-closure.hpp"
 #include "lib/meta/function-erasure.hpp"
 #include "lib/meta/tuple.hpp"
+#include "lib/meta/maybe-compare.hpp"
 #include "lib/format.hpp"
 #include "lib/util.hpp"
 #include "proc/control/argument-erasure.hpp"
@@ -98,6 +99,7 @@ namespace control {
   using lumiera::typelist::StoreFunction;
   using lumiera::typelist::NullType;
   
+  using lumiera::typelist::equals_safeInvoke;
   using lib::TypedAllocationManager;
   using util::unConst;
   using std::tr1::function;
@@ -130,6 +132,7 @@ namespace control {
       virtual operator string() const                    =0;
       virtual bool isValid ()   const                    =0;      ///< does this closure hold a valid argument tuple?
       virtual bool isCaptured () const                   =0;      ///< does this closure hold captured UNDO state?
+      virtual bool equals (CmdClosure const&)  const     =0;      ///< is equivalent to the given other closure?
       virtual void bindArguments (Arguments&)            =0;      ///< store a set of parameter values within this closure
       virtual void invoke (CmdFunctor const&)            =0;      ///< invoke functor using the stored parameter values
       virtual PClo createClone (TypedAllocationManager&) =0;      ///< create clone allocation without disclosing concrete type
@@ -172,7 +175,7 @@ namespace control {
       friend bool
       compare (ParamAccessor const& p1, ParamAccessor const& p2)
         {
-          return (p1.element() == p2.element())
+          return equals_safeInvoke (p1.element(), p2.element())
               && compare ( static_cast<BASE>(p1)
                          , static_cast<BASE>(p2) );
         }
@@ -272,10 +275,17 @@ namespace control {
       bool isValid ()   const { return true; }
       bool isCaptured() const { return false; }
       
-      
       /// Supporting equality comparisons...
       friend bool operator== (Closure const& c1, Closure const& c2)  { return compare (c1.params_, c2.params_); }
       friend bool operator!= (Closure const& c1, Closure const& c2)  { return ! (c1 == c2); }
+      
+      bool
+      equals (CmdClosure const& other)  const
+        {
+          const Closure* toCompare = dynamic_cast<const Closure*> (&other);
+          return (toCompare)
+              && (*this == *toCompare);
+        }
     };
   
   
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 0a2161cbe..f209ba3c0 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -188,10 +188,18 @@ namespace control {
         }
       
       
-      ////////////////////////////////////////////////////////////////////////////////////TODO comparisons
-      
-    private:
-      
+  
+      friend bool
+      operator== (CommandImpl const& ci1, CommandImpl const& ci2)
+      {
+        return (ci1.do_ == ci2.do_)
+            && (ci1.undo_ == ci2.undo_)
+            && (ci1.defaultPatt_ == ci2.defaultPatt_)
+            && (ci1.canExec() == ci2.canExec())
+            && (ci1.canUndo() == ci2.canUndo())
+            && (ci1.pClo_->equals(*ci2.pClo_))
+             ;
+      }
     };
   
   
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 98d888c57..4c10f658f 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -239,6 +239,14 @@ namespace control {
   }
   
   
+  bool
+  Command::equivalentImpl (Command const& c1, Command const& c2)
+  {
+    return c1.impl() == c2.impl();
+  }
+  
+  
+  
   
   /** diagnostics: shows the commandID, if any,
    *  and the degree of definition of this command */
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index f4f00fe5b..502d77bbf 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -177,6 +177,7 @@ namespace control {
       
     private:
       void setArguments (Arguments&);
+      static bool equivalentImpl (Command const&, Command const&);
     };
   
   
@@ -205,7 +206,9 @@ namespace control {
   operator== (Command const& c1, Command const& c2)
   {
     return (!c1 && !c2)
-        || ( c1 &&  c2  && (&c1.impl() == &c2.impl())); 
+        || ( c1 &&  c2  && ( &c1.impl() == &c2.impl()
+                           || Command::equivalentImpl (c1,c2)
+                           )); 
   }
   
   inline bool
diff --git a/src/proc/control/memento-tie.hpp b/src/proc/control/memento-tie.hpp
index c9a1052d9..bbab73313 100644
--- a/src/proc/control/memento-tie.hpp
+++ b/src/proc/control/memento-tie.hpp
@@ -41,6 +41,7 @@
 #define CONTROL_MEMENTO_TIE_H
 
 #include "lib/bool-checkable.hpp"
+#include "lib/meta/maybe-compare.hpp"
 #include "lib/meta/function-closure.hpp"
 #include "proc/control/command-signature.hpp"
 #include "lib/functor-util.hpp"
@@ -57,6 +58,7 @@ namespace control {
   using boost::equality_comparable;
   using lumiera::typelist::func::bindLast;
   using lumiera::typelist::func::chained;
+  using lumiera::typelist::equals_safeInvoke;
     
   LUMIERA_ERROR_DECLARE (MISSING_MEMENTO);  ///<  Undo functor not yet usable, because no undo state has been captured
   
@@ -202,7 +204,7 @@ namespace control {
                  )
               && (m1.isCaptured_  == m2.isCaptured_)  // either both not captured or identical state
               && (!m1.isCaptured_
-                  || (m1.memento_ == m2.memento_));
+                  || equals_safeInvoke (m1.memento_, m2.memento_));
         }
     };
   
diff --git a/tests/components/proc/control/command-argument-test.cpp b/tests/components/proc/control/command-argument-test.cpp
index a1a2c6562..2b9368bd3 100644
--- a/tests/components/proc/control/command-argument-test.cpp
+++ b/tests/components/proc/control/command-argument-test.cpp
@@ -77,26 +77,48 @@ namespace test    {
         Tracker (TY init = TY())     : element_(init)         { ++instanceCnt; }
         Tracker (Tracker const& otr) : element_(otr.element_) { ++instanceCnt; }
        ~Tracker()                                             { --instanceCnt; }
-       
-       TY&
-       operator* ()
-         {
-           return element_;
-         }
-       
-       friend ostream&
-       operator<< (ostream& out, const Tracker& tra)
-         {
-           return out << tra.element_;
-         }
-       
-       operator string()  const { return element_; }
+        
+        TY&
+        operator* ()
+          {
+            return element_;
+          }
+        
+        operator string()  const { return element_; }
+        
+        friend ostream&
+        operator<< (ostream& out, const Tracker& tra)
+          {
+            return out << tra.element_;
+          }
+        
+        friend bool
+        operator== (Tracker const& tra1, Tracker const& tra2)
+          {
+            return tra1.element_ == tra2.element_;
+          }
       };
     
     template<typename TY>
     int Tracker<TY>::instanceCnt (0);
     
     
+    /** Dummy custom memento datatype
+     *  @note memento needs to be equality comparable
+     */
+    struct Sint5
+      {
+        int i[5];
+        
+        friend bool
+        operator== (Sint5 const& i1, Sint5 const& i2)
+          {
+            return i1.i == i2.i;
+          }
+      };
+      
+    
+    
     /* === functions to implement test-"operation" & UNDO === */
     
     void
@@ -184,7 +206,6 @@ namespace test    {
       
       typedef Tracker<Time> TTime;
       typedef Tracker<string> Tstr;
-      typedef struct{ int i[5]; } Sint5;
       
       
       

From 4f1c034b5847e07a1f234a536c14f09b71035dc4 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Mon, 5 Oct 2009 06:07:21 +0200
Subject: [PATCH 351/368] CommandRegistry: function test pass

---
 src/proc/control/command-argument-holder.hpp  |  5 +++-
 src/proc/control/command-impl.hpp             | 12 ++++++--
 tests/45controller.tests                      |  2 +-
 .../proc/control/command-registry-test.cpp    | 28 +++++++++++++------
 4 files changed, 34 insertions(+), 13 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index c18e18b06..3cc41c539 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -187,7 +187,10 @@ namespace control {
         : arguments_()
         , memento_()
         {
-          arguments_.template create<ArgHolder> (*oAh.arguments_);
+          if (oAh.arguments_->isValid())  // don't clone garbage from invalid arguments 
+            arguments_.template create<ArgHolder> (*oAh.arguments_);
+          
+          // memento can be cloned as-is, irrespective of activation state 
           memento_.template  create<MemHolder> (*oAh.memento_);
         }
       
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index f209ba3c0..456cc4c28 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -178,7 +178,7 @@ namespace control {
       canExec()  const    ///< state check: sufficiently defined to be invoked 
         {
           return isValid()
-              && *pClo_;
+              && pClo_->isValid();
         }
       
       bool
@@ -188,18 +188,24 @@ namespace control {
         }
       
       
-  
+      
       friend bool
       operator== (CommandImpl const& ci1, CommandImpl const& ci2)
       {
         return (ci1.do_ == ci2.do_)
-            && (ci1.undo_ == ci2.undo_)
+//          && (ci1.undo_ == ci2.undo_)                     // causes failure regularly, due to the missing equality on boost::function. See Ticket #294
             && (ci1.defaultPatt_ == ci2.defaultPatt_)
             && (ci1.canExec() == ci2.canExec())
             && (ci1.canUndo() == ci2.canUndo())
             && (ci1.pClo_->equals(*ci2.pClo_))
              ;
       }
+      
+      friend bool
+      operator!= (CommandImpl const& ci1, CommandImpl const& ci2)
+      {
+        return !(ci1==ci2);
+      }
     };
   
   
diff --git a/tests/45controller.tests b/tests/45controller.tests
index bce8c19b9..ec2cf9d47 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -60,7 +60,7 @@ return: 0
 END
 
 
-PLANNED "Command index and allocation" CommandRegistry_test <<END
+TEST "Command index and allocation" CommandRegistry_test <<END
 return: 0
 END
 
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index 60ef1562d..42afbc853 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -64,10 +64,10 @@ namespace test    {
    */
   class CommandRegistry_test : public Test
     {
-
+      
       uint cnt_defs;
       uint cnt_inst;
-
+      
       
       virtual void
       run (Arg) 
@@ -101,6 +101,10 @@ namespace test    {
         }
       
       
+      
+      /** @test verify the index operation.
+       *        Add, search, remove, store copy.
+       */
       void
       checkRegistration (CommandRegistry& registry)
         {
@@ -161,6 +165,12 @@ namespace test    {
         }
       
       
+      
+      /** @test verify the allocation/de-allocation handling as
+       *        embedded into the CommandRegistry operation.
+       *        Simulates on low level what normally happens
+       *        during command lifecycle.
+       */
       void
       checkAllocation (CommandRegistry& registry)
         {
@@ -186,16 +196,18 @@ namespace test    {
           
           ASSERT (pImpl);
           ASSERT (pImpl->isValid());
+          ASSERT (!pImpl->canExec());
           ASSERT (1 == pImpl.use_count());   // no magic involved, we hold the only instance
           
           PImpl clone = registry.createCloneImpl(*pImpl);
           ASSERT (clone->isValid());
+          ASSERT (!clone->canExec());
           ASSERT (1 == clone.use_count());
           ASSERT (1 == pImpl.use_count());
           ASSERT (2+cnt_inst == registry.instance_count());
           
           ASSERT (!isSameObject (*pImpl, *clone));
-//          ASSERT (*pImpl == *clone);             ///////////////////////////////////////TODO: comparison on CommandImpl ??
+          ASSERT (*pImpl == *clone);
           
           ASSERT (!pImpl->canExec());
           typedef Types<int> ArgType;
@@ -203,13 +215,13 @@ namespace test    {
           pImpl->setArguments(arg);
           ASSERT (pImpl->canExec());
           
-//          ASSERT (*pImpl != *clone);  // this proves the clone has indeed a separate identity
-          ASSERT (!clone->canExec());
+          ASSERT (!clone->canExec()); // this proves the clone has indeed a separate identity
+          ASSERT (*pImpl != *clone);
           
           // discard the first clone and overwrite with a new one
           clone = registry.createCloneImpl(*pImpl);
           ASSERT (2+cnt_inst == registry.instance_count());
-//          ASSERT (*pImpl == *clone);
+          ASSERT (*pImpl == *clone);
           ASSERT (clone->canExec());
           
           clone.reset();
@@ -223,6 +235,6 @@ namespace test    {
   
   /** Register this test class... */
   LAUNCHER (CommandRegistry_test, "function controller");
-      
-      
+  
+  
 }} // namespace control::test

From 5861597d7f19b613a8f3adfad5940f3e6b48a49e Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 6 Oct 2009 04:08:47 +0200
Subject: [PATCH 352/368] smash a glorious ref-to-local object bug

---
 src/proc/control/command-def.hpp              |  8 +--
 .../proc/control/command-basic-test.cpp       | 57 +++----------------
 2 files changed, 11 insertions(+), 54 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index d08f16646..877d419a4 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -141,8 +141,8 @@ namespace control {
         
         
         UndoDefinition (Command& underConstruction, 
-                        OperFunc& commandOperation,
-                        CaptFunc& undoCapOperation)
+                        OperFunc const& commandOperation,
+                        CaptFunc const& undoCapOperation)
           : prototype_(underConstruction)
           , operFunctor_(commandOperation)
           , captFunctor_(undoCapOperation)
@@ -190,9 +190,9 @@ namespace control {
     struct BasicDefinition
       {
         Command& prototype_;
-        function<SIG>& operation_;
+        function<SIG> operation_;
         
-        BasicDefinition(Command& underConstruction, function<SIG>& operation)
+        BasicDefinition(Command& underConstruction, function<SIG> const& operation)
           : prototype_(underConstruction)
           , operation_(operation)
           { }
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 87be6205a..306f78b78 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -23,67 +23,28 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-def.hpp"
 #include "lib/lumitime.hpp"
+#include "lib/p.hpp"
 //#include "lib/util.hpp"
 
-#include "lib/meta/typelist.hpp"
-#include "lib/meta/typelist-util.hpp"
-#include "lib/meta/generator.hpp"
-
-
-#include <tr1/functional>
-//#include <boost/format.hpp>
-#include <iostream>
 #include <cstdlib>
-#include <string>
 
-using std::tr1::bind;
-//using std::tr1::placeholders::_1;
-//using std::tr1::placeholders::_2;
-using std::tr1::function;
-//using boost::format;
 using lumiera::Time;
 //using util::contains;
-using std::string;
 using std::rand;
-using std::cout;
-using std::endl;
 
 
 namespace control {
 namespace test    {
-
-  using lib::test::showSizeof;
-
-//  using session::test::TestClip;
+  
   using lumiera::P;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
   
   
   
-  
-  
-  
-  /////////////////////////////
-  /////////////////////////////
-  
-  //////////////////////////// start of the actual Test....
-  
-  
-  
-  namespace  {
+  namespace  { // functions to be invoked through the command system
   
     void
     operate (P<Time> dummyObj, int randVal)
@@ -109,13 +70,10 @@ namespace test    {
   
   /***************************************************************************
    * @test basic usage of the Proc-Layer command dispatch system.
-   *       Shows how to define a simple command inline and another
-   *       simple command as dedicated class. Finally triggers
-   *       execution of both commands and verifies the command
-   *       action has been invoked.
-   *       
-   * @todo currently rather a scrapbook for trying out first ideas on the command system !!!!!!!!!!!!!!!
-   *       
+   *       Shows how to define a simple command inline and how to
+   *       trigger execution and UNDO. Verifies the command action
+   *       takes place and is reverted again by the UNDO function.
+   * 
    * @see  control::Command
    * @see  control::CommandDef
    * @see  mobject::ProcDispatcher
@@ -138,7 +96,6 @@ namespace test    {
           
           
           Command ourCmd = Command::get("test.command1");
-          ////////////////////////////////////////////////////////////////////TODO: isn't this unlogical? Do I want a *definition* or an *instance* ??
           
           // invoke the command
           ASSERT (*obj == Time(5));

From c8e049cdea52d7eb715cccfb2c541ba4ab2a3965 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Tue, 6 Oct 2009 05:11:30 +0200
Subject: [PATCH 353/368] Command system basic unit test pass

---
 src/lib/typed-allocation-manager.hpp           |  6 ++++--
 src/proc/control/command-registry.hpp          | 12 +++++++++++-
 tests/45controller.tests                       |  4 ++--
 .../proc/control/command-basic-test.cpp        | 15 +++++++++------
 .../proc/control/command-registry-test.cpp     |  3 ++-
 .../proc/control/command-use1-test.cpp         | 18 ++----------------
 .../proc/control/command-use2-test.cpp         | 13 -------------
 .../proc/control/command-use3-test.cpp         | 14 --------------
 8 files changed, 30 insertions(+), 55 deletions(-)

diff --git a/src/lib/typed-allocation-manager.hpp b/src/lib/typed-allocation-manager.hpp
index febfc8449..1a4887121 100644
--- a/src/lib/typed-allocation-manager.hpp
+++ b/src/lib/typed-allocation-manager.hpp
@@ -265,7 +265,8 @@ namespace lib {
       Slot<XX>
       allocateSlot ()
         {
-          TODO ("redirect to the corresponding pool allocator");
+          ////////////////////////////////////////////////TICKET #231 :redirect to the corresponding pool allocator
+          TRACE (memory, "allocate %s", util::tyStr<XX>().c_str());
           void* space = new char[sizeof(XX)];
           allocCnt_.inc<XX>();
           return Slot<XX> (this, space);
@@ -275,7 +276,8 @@ namespace lib {
       void
       releaseSlot (void* entry)
         {
-          TODO ("redirect to the corresponding pool allocator");
+          ////////////////////////////////////////////////TICKET #231 :redirect to the corresponding pool allocator
+          TRACE (memory, "release %s", util::tyStr<XX>().c_str());
           typedef char Storage[sizeof(XX)];
           delete[] reinterpret_cast<Storage*> (entry);
           allocCnt_.dec<XX>();
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 83b2d57a6..b650e05d4 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -123,15 +123,25 @@ namespace control {
       typedef unordered_map<Symbol, Command, hash<Symbol> > CmdIndex;
       typedef map< const Command*, Symbol, order_by_impl> ReverseIndex;
       
+      TypedAllocationManager allocator_;
       CmdIndex index_;
       ReverseIndex ridx_;
-      TypedAllocationManager allocator_;
       
       
     public:
       static lib::Singleton<CommandRegistry> instance;
       
       
+     ~CommandRegistry()
+        {
+          INFO (command, "Shutting down Command system...");
+                                                                //////////////////////TICKET #295 : possibly remotely trigger Command mass suicide here....
+          ridx_.clear();
+          index_.clear();
+        }
+      
+      
+      
       /** register a command (Frontend) under the given ID
        *  @return either the new command, or an already existing
        *          command registered under the given ID  */ 
diff --git a/tests/45controller.tests b/tests/45controller.tests
index ec2cf9d47..86b76261e 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -3,7 +3,7 @@ TESTING "Component Test Suite: Proc-Layer controller" ./test-components --group=
 
 
 
-PLANNED "CommandBasic_test" CommandBasic_test <<END
+TEST "CommandBasic_test" CommandBasic_test <<END
 END
 
 
@@ -55,7 +55,7 @@ return: 0
 END
 
 
-PLANNED "Equality comparisons" CommandEquality_test <<END
+TEST "Equality comparisons" CommandEquality_test <<END
 return: 0
 END
 
diff --git a/tests/components/proc/control/command-basic-test.cpp b/tests/components/proc/control/command-basic-test.cpp
index 306f78b78..f75d2b81b 100644
--- a/tests/components/proc/control/command-basic-test.cpp
+++ b/tests/components/proc/control/command-basic-test.cpp
@@ -22,16 +22,13 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/test/test-helper.hpp"
 #include "proc/control/command-def.hpp"
 #include "lib/lumitime.hpp"
 #include "lib/p.hpp"
-//#include "lib/util.hpp"
 
 #include <cstdlib>
 
 using lumiera::Time;
-//using util::contains;
 using std::rand;
 
 
@@ -45,7 +42,7 @@ namespace test    {
   
   
   namespace  { // functions to be invoked through the command system
-  
+    
     void
     operate (P<Time> dummyObj, int randVal)
     {
@@ -73,6 +70,12 @@ namespace test    {
    *       Shows how to define a simple command inline and how to
    *       trigger execution and UNDO. Verifies the command action
    *       takes place and is reverted again by the UNDO function.
+   *       
+   * This is a simplified demonstration. Usually, commands would be defined
+   * in bulk and without specifying parameters. Later, typically client code
+   * accesses a handle by ID, binds to the concrete argument and dispatches
+   * the invocation. Note in this example that by using a smart-ptr as
+   * argument allows accessing an object by reference and late binding.
    * 
    * @see  control::Command
    * @see  control::CommandDef
@@ -111,6 +114,6 @@ namespace test    {
   
   /** Register this test class... */
   LAUNCHER (CommandBasic_test, "unit controller");
-      
-      
+  
+  
 }} // namespace control::test
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index 42afbc853..c92509fb3 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -119,8 +119,9 @@ namespace test    {
           
           // now create a clone, registered under a different ID
           Command cmd2 = cmd1.storeDef(TEST_CMD2);
-          ASSERT (cmd2 != cmd1);
+          ASSERT (cmd2 == cmd1);
           cmd2.bind(54321);
+          ASSERT (cmd2 != cmd1);
           
           // this created exactly one additional instance allocation:
           ASSERT (1+cnt_inst == registry.instance_count());
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index c7bcf4326..06ea9c7cf 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -23,15 +23,6 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-invocation.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
@@ -61,13 +52,8 @@ namespace test    {
   using util::isSameObject;
   using util::contains;
   using util::str;
-
-//  using session::test::TestClip;
-//  using lumiera::P;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
-  
   
   
   
@@ -161,8 +147,8 @@ namespace test    {
           ASSERT ( 1234 == command1::check_);
           
           // another shortcut, with static type check:
-          invoke (command1::operate) (5678);
-          ASSERT ( 1234+5678 == command1::check_);
+//        invoke (command1::operate) (5678);                                  //////////////////TICKET #291  : unimplemented for now (9/09)
+//        ASSERT ( 1234+5678 == command1::check_);
           
           com.undo();
           ASSERT ( 0 == command1::check_);
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
index e8d217fd2..6a948c28e 100644
--- a/tests/components/proc/control/command-use2-test.cpp
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -23,15 +23,6 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
 #include "proc/control/handling-pattern.hpp"
@@ -68,12 +59,8 @@ namespace test    {
   using boost::lexical_cast;
   using util::contains;
   using boost::ref;
-
-//  using session::test::TestClip;
-//  using lumiera::P;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
   using lumiera::error::LUMIERA_ERROR_EXTERNAL;
   
   
diff --git a/tests/components/proc/control/command-use3-test.cpp b/tests/components/proc/control/command-use3-test.cpp
index 0ce985079..c69f1bb24 100644
--- a/tests/components/proc/control/command-use3-test.cpp
+++ b/tests/components/proc/control/command-use3-test.cpp
@@ -23,15 +23,6 @@
 
 #include "lib/test/run.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
 #include "proc/control/command-def.hpp"
 //#include "lib/lumitime.hpp"
 #include "lib/util.hpp"
@@ -63,13 +54,8 @@ namespace test    {
 //  using lib::test::showSizeof;
 //  using util::isSameObject;
 //  using util::contains;
-
-//  using session::test::TestClip;
-//  using lumiera::P;
   
   
-  //using lumiera::typelist::BuildTupleAccessor;
-//  using lumiera::error::LUMIERA_ERROR_EXTERNAL;
   
   
   

From 95db5f98405efbe0e012e071335ffedb981d0acb Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Wed, 7 Oct 2009 22:58:02 +0200
Subject: [PATCH 354/368] clarify state predicates in conjunction with command
 lifecycle

---
 src/proc/control/command-def.hpp |  3 ++
 src/proc/control/command.cpp     | 53 ++++++++++++++++++++++++++------
 src/proc/control/command.hpp     |  1 +
 wiki/renderengine.html           | 13 ++++++--
 4 files changed, 58 insertions(+), 12 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 877d419a4..abf2ce2b5 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -244,6 +244,9 @@ namespace control {
           TRACE (command_dbg, "starting CommandDef('%s')...", cmdID.c() );
         }
       
+     ~CommandDef();
+      
+      
       template<typename SIG>
       stage::BasicDefinition<SIG>
       operation (SIG& operation_to_define)
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 4c10f658f..695382fbd 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -202,6 +202,36 @@ namespace control {
   
   
   
+  namespace {
+    inline bool
+    was_activated (Command& com)
+    {
+      typedef lib::Handle<CommandImpl>& _Handle;
+      _Handle h = static_cast<_Handle> (com);
+      return h.isValid();
+    }
+    
+    inline Command
+    registered_for (Symbol id)
+    {
+      return CommandRegistry::instance().queryIndex (id);
+    }
+  }
+  
+  
+  /** when starting a CommandDef, we immediately place a yet empty
+   *  Command object into the index, just assuming it will be defined
+   *  properly and consequently get valid at some point. But in case
+   *  this doesn't happen (e.g. because the definition is aborted),
+   *  we need to clean up this empty pre-registration...
+   */
+  CommandDef::~CommandDef()
+  {
+    if (!was_activated (prototype_))
+      CommandRegistry::instance().remove (this->id_);
+  }
+  
+  
   /** is this a valid command definition? especially..
    *  - the prototype command is initialised properly
    *  - there is a command definition registered for our command ID
@@ -211,13 +241,19 @@ namespace control {
   bool
   CommandDef::isValid()  const
   {
-    if (prototype_)
-      {
-        Command cmd = CommandRegistry::instance().queryIndex (this->id_);
-        return cmd.isValid()
-            && (prototype_ == cmd);
-      }
-    return false;
+    return (was_activated (prototype_))
+        && (prototype_ == registered_for (this->id_))
+         ;
+  }
+  
+  
+  
+  /** a \em command gets valid when the arguments are bound */
+  bool
+  Command::isValid()  const
+  {
+    return _Handle::isValid()
+        && impl().canExec();
   }
   
   
@@ -225,8 +261,7 @@ namespace control {
   bool
   Command::canExec()  const
   {
-    return isValid()
-        && impl().canExec();
+    return isValid();
   }
   
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 502d77bbf..c42c41e7b 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -161,6 +161,7 @@ namespace control {
       static size_t definition_count();
       static size_t instance_count();
       
+      bool isValid()  const;
       bool canExec()  const;
       bool canUndo()  const;
       
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 2fc4e4a54..50b815d32 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -995,12 +995,12 @@ While generally there is //no limitation// on the number and type of parameters,
 Usually, parameters should be passed //by value// &amp;mdash; with the exception of target object(s), which are typically bound as MObjectRef, causing them to be resolved at commad execution time (late binding).
 </pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200909291418" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="27">
+<div title="CommandHandling" modifier="Ichthyostega" modified="200910072005" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="30">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
 !Defining commands
-[&gt;img[Structure of Commands|uml/fig134021.png]] Basically, a command could contain arbitrary operations, but we'll assume that it causes a well defined mutation within the HighLevelModel, which can be ''undone''. Thus, when defining a command, we need to specify not only a function doing the mutation, but also another function which might be called later to reverse the effect of the action. Besides, the action operates on a number of ''target'' objects and additionally may require a set of ''parameter'' values. These are to be stored explicitly within the command object, thus creating a ''closure'' &amp;mdash; the operation //must not//&amp;nbsp; rely on other hidden parameters (maybe with the exception of very generic singleton system services?).
+[&gt;img[Structure of Commands|uml/fig134021.png]] Basically, a command could contain arbitrary operations, but we'll assume that it causes a well defined mutation within the HighLevelModel, which can be ''undone''. Thus, when defining (&amp;rarr;[[syntax|CommandDefinition]]) a command, we need to specify not only a function doing the mutation, but also another function which might be called later to reverse the effect of the action. Besides, the action operates on a number of ''target'' objects and additionally may require a set of ''parameter'' values. These are to be stored explicitly within the command object, thus creating a ''closure'' &amp;mdash; the operation //must not//&amp;nbsp; rely on other hidden parameters (maybe with the exception of very generic singleton system services?).
 
 Theoretically, defining the &quot;undo&quot; operation might utilise two different approaches:
 * specifying an //inverse operation,// known to cancel out the effect of the command
@@ -1014,6 +1014,7 @@ While the usual »Memento« implementation might automatically capture the whole
 A command may be [[defined|CommandDefinition]] completely from scratch, or it might just serve as a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
 
 By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation. While nothing prevents you from invoking the command operation functor several times, each invocation will overwrite the undo state captrued by the previous invocation. Thus, each command instance should bes seen as the promise (or later the trace) of a single operation execution. In a similar vein, the undo capturing should be defined as to be self sufficient, so that invoking just the undo functor of a single command performes any necessary steps to restore the situation found before invoking the corresponding mutation functor &amp;mdash; of course only //with respect to the topic covered by this command.// So, while commands provide a lot of flexibility and allow to do a multitude of things, certainly there is an intended CommandLifecycle.
+&amp;rarr; command [[definition|CommandDefinition]] and [[-lifecycle|CommandLifecycle]]
 &amp;rarr; more on possible [[command usage scenarios|CommandUsage]]
 &amp;rarr; more details regarding [[command implementation|CommandImpl]]
 </pre>
@@ -1033,7 +1034,7 @@ To support this handling scheme, some infrastructure is in place:
 * performing the actual execution is delegated to a handling pattern object, accessed by name.
 </pre>
 </div>
-<div title="CommandLifecycle" modifier="Ichthyostega" modified="200907240010" created="200907210135" tags="SessionLogic spec draft design img" changecount="10">
+<div title="CommandLifecycle" modifier="Ichthyostega" modified="200910072016" created="200907210135" tags="SessionLogic spec draft design img" changecount="14">
 <pre>[&lt;img[Structure of Commands|uml/fig135173.png]]
 While generally the command framework was designed to be flexible and allow a lot of different use cases, execution paths and to serve various goals, there is an ''intended lifecycle'' &amp;mdash; commands are expected to go through several distinct states.
 
@@ -1044,6 +1045,12 @@ By ''binding'' to specific operation arguments, the definition is //armed up//&a
 A command is operated or executed by passing it to an ''execution pattern'' &amp;mdash; there is a multitude of possible execution patterns to choose from, depending on the situation. 
 {{red{WIP}}}
 When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. Anyway, a ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
+
+!State predicates
+* fetching an non-existent command raises an ~LUMIERA_ERROR_INVALID_COMMAND
+* a command //definition// becomes //valid// ({{{bool true}}}) when all necessary functions are specified. Technically this coincides with the creation of a CommandImpl frame behind the scenes
+* contrary to this, the {{{bool}}}-check on the Command (frontend/handle object) still yields {{{false}}} at this point &amp;mdash; generally speaking a command counts as //valid// only if it can be //executed,// i.e. when all arguments are bound.
+* after the (fist) execution, the command gets also //undo-able.//
 </pre>
 </div>
 <div title="CommandUsage" modifier="Ichthyostega" modified="200908091509" created="200907212338" tags="SessionLogic draft dynamic" changecount="8">

From d2acf48587fc899969ab097970e6c348acba6ecc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 8 Oct 2009 21:39:47 +0200
Subject: [PATCH 355/368] change semantics of state predicates, as it seems
 less surprising this way

---
 src/proc/control/command.cpp                  | 20 +---
 src/proc/control/command.hpp                  | 44 ++++++++-
 .../proc/control/command-use1-test.cpp        | 91 ++++++++++++++-----
 .../proc/control/command-use2-test.cpp        | 20 ++--
 wiki/renderengine.html                        |  7 +-
 5 files changed, 123 insertions(+), 59 deletions(-)

diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 695382fbd..b6cf35cdd 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -204,11 +204,9 @@ namespace control {
   
   namespace {
     inline bool
-    was_activated (Command& com)
+    was_activated (Command const& com)
     {
-      typedef lib::Handle<CommandImpl>& _Handle;
-      _Handle h = static_cast<_Handle> (com);
-      return h.isValid();
+      return com.isValid();
     }
     
     inline Command
@@ -248,24 +246,14 @@ namespace control {
   
   
   
-  /** a \em command gets valid when the arguments are bound */
-  bool
-  Command::isValid()  const
-  {
-    return _Handle::isValid()
-        && impl().canExec();
-  }
-  
-  
-  
   bool
   Command::canExec()  const
   {
-    return isValid();
+    return isValid()
+        && impl().canExec();
   }
   
   
-  
   bool
   Command::canUndo()  const
   {
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index c42c41e7b..1549c09db 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -161,10 +161,13 @@ namespace control {
       static size_t definition_count();
       static size_t instance_count();
       
-      bool isValid()  const;
       bool canExec()  const;
       bool canUndo()  const;
       
+      static bool defined (Symbol cmdID);
+      static bool canExec (Symbol cmdID);
+      static bool canUndo (Symbol cmdID);
+      
       operator string() const;
       friend bool operator== (Command const&, Command const&);
       friend bool operator<  (Command const&, Command const&);
@@ -203,6 +206,45 @@ namespace control {
   
   
   
+  /* == state predicate shortcuts == */
+  
+#define _FAILSAFE_COMMAND_QUERY(_ID_, _QUERY_) \
+      try                                       \
+        {                                        \
+          return Command::get(_ID_)._QUERY_;      \
+        }                                          \
+      catch(lumiera::error::Invalid&)              \
+        {                                          \
+          lumiera_error(); /* ignore errorstate */ \
+          return false;                            \
+        }
+  
+  
+  inline bool
+  Command::defined (Symbol cmdID)
+    {
+      _FAILSAFE_COMMAND_QUERY (cmdID, isValid() );
+    }
+  
+  
+  inline bool
+  Command::canExec (Symbol cmdID)
+    {
+      _FAILSAFE_COMMAND_QUERY (cmdID, canExec() );
+    }
+  
+  
+  inline bool
+  Command::canUndo (Symbol cmdID)
+    {
+      _FAILSAFE_COMMAND_QUERY (cmdID, canUndo() );
+    }
+
+#undef _FAILSAFE_COMMAND_QUERY
+  
+  
+  
+  
   inline bool
   operator== (Command const& c1, Command const& c2)
   {
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 06ea9c7cf..1bec155a2 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -25,30 +25,16 @@
 #include "lib/test/test-helper.hpp"
 #include "proc/control/command-invocation.hpp"
 #include "proc/control/command-def.hpp"
-//#include "lib/lumitime.hpp"
 #include "lib/format.hpp"
 #include "lib/util.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
 
-//#include <boost/format.hpp>
-//#include <iostream>
-//#include <cstdlib>
-//#include <string>
-
-//using boost::format;
-//using lumiera::Time;
-//using util::contains;
-//using std::string;
-//using std::rand;
-//using std::cout;
-//using std::endl;
 
 
 namespace control {
 namespace test    {
-
-//  using lib::test::showSizeof;
+  
   using util::isSameObject;
   using util::contains;
   using util::str;
@@ -84,6 +70,7 @@ namespace test    {
           
           allInOneStep();
           standardUse();
+          statePredicates();
           definePrototype();
           usePrototype();
           preventDuplicates();
@@ -124,24 +111,25 @@ namespace test    {
                 .undoOperation (command1::undoIt)
                 ;
           }
-          ASSERT ( CommandDef("test.command1.2"));
-          ASSERT (!Command::get("test.command1.2"));
+          ASSERT (CommandDef("test.command1.2"));
           
           Command com = Command::get("test.command1.2");
+          ASSERT (com);
           ASSERT (contains (str(com), "test.command1.2"));
           ASSERT (contains (str(com), "{def}"));
-          ASSERT (!com);                                                      ////////////////////TODO: mismatch: shall bool() < canExec() ????
-          ASSERT (!com.canUndo());
+          ASSERT (!com.canExec());
           VERIFY_ERROR (UNBOUND_ARGUMENTS, com() );
+          ASSERT ( 0 == command1::check_); 
           
-          ASSERT ( 0 == command1::check_);
           VERIFY_ERROR (INVALID_ARGUMENTS, com.bind ("foo") );
           com.bind (random());             // note: run-time type check only
+          ASSERT ( com.canExec());
+          ASSERT (!com.canUndo());
           com();
           ASSERT (randVal == command1::check_);
           com.undo();
           ASSERT ( 0 == command1::check_);
-
+          
           // the following shortcut does the same:
           invoke ("test.command1.2") (1234);
           ASSERT ( 1234 == command1::check_);
@@ -155,6 +143,53 @@ namespace test    {
         }
       
       
+      void
+      statePredicates()
+        {
+          Command::remove("test.command1.2");
+          VERIFY_ERROR (INVALID_COMMAND, Command::get("test.command1.2") );
+          
+          CommandDef def ("test.command1.2");
+          ASSERT (!def);
+          
+          def.operation (command1::operate)
+             .captureUndo (command1::capture); 
+          ASSERT (!def);                       // undo functor still missing
+          ASSERT (!Command::get("test.command1.2"));
+          
+          def.operation (command1::operate)
+             .captureUndo (command1::capture)
+             .undoOperation (command1::undoIt);
+          ASSERT (def);
+          ASSERT (CommandDef("test.command1.2"));
+          ASSERT (Command::get("test.command1.2"));
+          
+          ASSERT ( Command::defined("test.command1.2"));
+          ASSERT (!Command::canExec("test.command1.2"));
+          ASSERT (!Command::canUndo("test.command1.2"));
+          
+          Command com = Command::get("test.command1.2");
+          ASSERT (com);
+          ASSERT (!com.canExec());
+          ASSERT (!com.canUndo());
+          
+          com.bind (11111);
+          ASSERT ( Command::defined("test.command1.2"));
+          ASSERT ( Command::canExec("test.command1.2"));
+          ASSERT (!Command::canUndo("test.command1.2"));
+          
+          com();
+          ASSERT ( Command::defined("test.command1.2"));
+          ASSERT ( Command::canExec("test.command1.2"));
+          ASSERT ( Command::canUndo("test.command1.2"));
+          
+          com.undo();
+          ASSERT ( Command::defined("test.command1.2"));
+          ASSERT ( Command::canExec("test.command1.2"));
+          ASSERT ( Command::canUndo("test.command1.2"));
+        }
+      
+      
       void
       definePrototype()
         {
@@ -243,14 +278,20 @@ namespace test    {
       void
       preventDuplicates()
         {
+          #define BUILD_NEW_COMMAND_DEF(_ID_) \
+          CommandDef (_ID_)                    \
+              .operation (command1::operate)    \
+              .captureUndo (command1::capture)   \
+              .undoOperation (command1::undoIt)
+          
           ASSERT (CommandDef ("test.command1.1"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.1").operation (command1::operate) );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.1") );    
           ASSERT (CommandDef ("test.command1.2"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.2").operation (command1::operate) );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.2") );    
           ASSERT (CommandDef ("test.command1.3"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.3").operation (command1::operate) );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.3") );    
           ASSERT (CommandDef ("test.command1.4"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, CommandDef ("test.command1.4").operation (command1::operate) );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.4") );    
         }
       
       
diff --git a/tests/components/proc/control/command-use2-test.cpp b/tests/components/proc/control/command-use2-test.cpp
index 6a948c28e..a0acf000f 100644
--- a/tests/components/proc/control/command-use2-test.cpp
+++ b/tests/components/proc/control/command-use2-test.cpp
@@ -26,7 +26,6 @@
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
 #include "proc/control/handling-pattern.hpp"
-//#include "lib/lumitime.hpp"
 #include "lib/util.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
@@ -35,8 +34,6 @@
 #include <boost/ref.hpp>
 #include <boost/format.hpp>
 #include <boost/lexical_cast.hpp>
-//#include <iostream>
-//#include <cstdlib>
 #include <string>
 
 
@@ -44,21 +41,14 @@ namespace control {
 namespace test    {
 
 
+  using std::string;
   using boost::format;
   using boost::str;
-  //using lumiera::Time;
-  //using util::contains;
   using std::tr1::function;
   using std::tr1::bind;
-  using std::string;
-  //using std::rand;
-  //using std::cout;
-  //using std::endl;
-//  using lib::test::showSizeof;
-//  using util::isSameObject;
+  using boost::ref;
   using boost::lexical_cast;
   using util::contains;
-  using boost::ref;
   
   
   using lumiera::error::LUMIERA_ERROR_EXTERNAL;
@@ -77,13 +67,15 @@ namespace test    {
                       , lexical_cast<string> (val2check)
                       );
     }
-      
+  
   
   
   
   /***************************************************************************
    * @test command usage aspects II: patterns of invoking commands.
-   *       
+   * 
+   * @todo this test is still on hold, as the non-trivial patterns aren't implemented as of 10/09
+   * 
    * @see Command
    * @see command-basic-test.cpp (simple usage example)
    */
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index 50b815d32..c535263f3 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -1034,7 +1034,7 @@ To support this handling scheme, some infrastructure is in place:
 * performing the actual execution is delegated to a handling pattern object, accessed by name.
 </pre>
 </div>
-<div title="CommandLifecycle" modifier="Ichthyostega" modified="200910072016" created="200907210135" tags="SessionLogic spec draft design img" changecount="14">
+<div title="CommandLifecycle" modifier="Ichthyostega" modified="200910081800" created="200907210135" tags="SessionLogic spec draft design img" changecount="16">
 <pre>[&lt;img[Structure of Commands|uml/fig135173.png]]
 While generally the command framework was designed to be flexible and allow a lot of different use cases, execution paths and to serve various goals, there is an ''intended lifecycle'' &amp;mdash; commands are expected to go through several distinct states.
 
@@ -1048,9 +1048,10 @@ When a command has been executed (and maybe undone), it's best to leave it alone
 
 !State predicates
 * fetching an non-existent command raises an ~LUMIERA_ERROR_INVALID_COMMAND
-* a command //definition// becomes //valid// ({{{bool true}}}) when all necessary functions are specified. Technically this coincides with the creation of a CommandImpl frame behind the scenes
-* contrary to this, the {{{bool}}}-check on the Command (frontend/handle object) still yields {{{false}}} at this point &amp;mdash; generally speaking a command counts as //valid// only if it can be //executed,// i.e. when all arguments are bound.
+* a command definition becomes //valid// ({{{bool true}}}) when all necessary functions are specified. Technically this coincides with the creation of a CommandImpl frame behind the scenes, which also causes the Command (frontend/handle object) to evaluate to {{{true}}} in bool context from then on.
+* when, in addition to the above, the command arguments are bound, it becomes //executable.//
 * after the (fist) execution, the command gets also //undo-able.//
+State predicates are accessible through the Command (frontend); additionally there are static query functions in class {{{Command}}}
 </pre>
 </div>
 <div title="CommandUsage" modifier="Ichthyostega" modified="200908091509" created="200907212338" tags="SessionLogic draft dynamic" changecount="8">

From 2ad896027b79e79ba0071b146fded9bfa1b80cf7 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Thu, 8 Oct 2009 21:41:20 +0200
Subject: [PATCH 356/368] why doesn't the reverse lookup return a Symbol? damn!
 I have the vague rememberance that I had a reason for not returning a Symbol.
 Anyway, here it goes...

---
 src/proc/control/command-registry.hpp                   | 2 +-
 tests/components/proc/control/command-registry-test.cpp | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index b650e05d4..956a732bd 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -195,7 +195,7 @@ namespace control {
        *  @param cmdInstance using the definition to look up
        *  @return the ID used to register this definition 
        *          or \c NULL in case of an "anonymous" command */
-      const char*
+      Symbol
       findDefinition (Command const& cmdInstance)  const
         {
           Lock sync(this);
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index c92509fb3..b23cf2b27 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -112,7 +112,7 @@ namespace test    {
           
           Command cmd1 = registry.queryIndex (TEST_CMD);
           ASSERT (cmd1);
-          ASSERT (string(TEST_CMD) == registry.findDefinition(cmd1));
+          ASSERT (TEST_CMD == registry.findDefinition(cmd1));
           
           Command nonexistant = registry.queryIndex("miraculous");
           ASSERT (!nonexistant);
@@ -149,7 +149,7 @@ namespace test    {
           ASSERT (1+cnt_inst == registry.instance_count());
           ASSERT (1+cnt_defs == registry.index_size());
           
-          ASSERT (string(TEST_CMD2) == registry.findDefinition(cmdX));
+          ASSERT (TEST_CMD2 == registry.findDefinition(cmdX));
           
           ASSERT ( registry.remove(TEST_CMD2));
           ASSERT (!registry.remove("miraculous"));

From 37cd4513670eba5cfe6d160da0e8c6fb4a08ff50 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 9 Oct 2009 01:29:24 +0200
Subject: [PATCH 357/368] fix sloppy definition of less-than comparison, which
 caused malfunction of registry

---
 src/proc/control/command-registry.hpp | 3 ++-
 src/proc/control/command.cpp          | 3 ++-
 src/proc/control/command.hpp          | 3 ++-
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 956a732bd..5631a3120 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -103,7 +103,8 @@ namespace control {
       bool
       operator() (const Command *pC1, const Command *pC2)  const
         {
-          return ( pC1 &&  pC2  && (*pC1 < *pC2));
+          return (!pC1 && pC2)
+              || ( pC1 && pC2  && (*pC1 < *pC2));
         }
     };
   
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index b6cf35cdd..b786142ff 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -90,7 +90,8 @@ namespace control {
     static format fmt("Command \"%s\" not found");
     if (!cmd)
       throw error::Invalid(str(fmt % cmdID), LUMIERA_ERROR_INVALID_COMMAND);
-      
+    
+    ENSURE (cmdID == CommandRegistry::instance().findDefinition(cmd));
     return cmd;
   }
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 1549c09db..82f5b5cc3 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -264,7 +264,8 @@ namespace control {
   inline bool
   operator< (Command const& c1, Command const& c2)
   {
-    return ( c1 &&  c2  && (&c1.impl() < &c2.impl())); 
+    return (!c1 && c2)
+        || ( c1 && c2 && (&c1.impl() < &c2.impl())); 
   }
   
   

From 17c7160f024c79803d254be8888cdcd368f65153 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 9 Oct 2009 02:53:39 +0200
Subject: [PATCH 358/368] refactor CommandDef, get rid of the possibility of
 re-defining. YAGNI!

---
 src/proc/control/command-def.hpp              | 66 +++++++++----
 src/proc/control/command-registry.hpp         | 25 ++---
 src/proc/control/command.cpp                  | 97 +++++++++----------
 src/proc/control/command.hpp                  | 23 ++---
 .../proc/control/command-registry-test.cpp    | 14 ++-
 wiki/renderengine.html                        | 11 ++-
 6 files changed, 127 insertions(+), 109 deletions(-)

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index abf2ce2b5..a2d8f95c1 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -26,14 +26,20 @@
  ** While the header command.hpp contains everything needed for executing and
  ** commands and referring to them, this more heavy-weight header is needed when
  ** \em defining the concrete operations to be encapsulated into a command. To
- ** create a command, you need to provide three functors (for the actual operation,
+ ** create a command, you need to provide three functions (for the actual operation,
  ** the undo operation and for capturing undo state prior to invoking the operation).
- ** Besides, you provide a \em binding, thus creating a closure out of these three
- ** function objects and a set of actual parameters. This closure effectively is 
- ** the command, which in a last step can be either dispatched, stored or 
- ** invoked immediately.
- ** //TODO 
- **
+ ** 
+ ** For actually providing these operations, the client is expected to call the
+ ** definition functions in a chained manner ("fluent interface"). When  finally all the
+ ** required informations are available, a \em prototype object is  built and registered
+ ** with the CommandRegistry. From this point on, the corresponding Command (frontend object)
+ ** can be accessed directly by ID (and only relying on the header command.hpp).
+ ** 
+ ** In addition to the bare definition, it is possible to provide a binding for the command's
+ ** parameters immediately during the command definition. Of course it's also possible (and
+ ** indeed this is the standard case) to provide these concrete arguments just immediately
+ ** prior to invoking the command.
+ ** 
  ** @see Command
  ** @see Mutation
  ** @see CommandClosure
@@ -75,6 +81,8 @@ namespace control {
   
   using std::tr1::shared_ptr;
   using std::tr1::function;
+  using std::tr1::bind;
+  using std::tr1::placeholders::_1;
   using lib::Symbol;
   using util::cStr;
   
@@ -84,6 +92,10 @@ namespace control {
   using lumiera::typelist::NullType;
   using lumiera::typelist::Tuple;
   
+  typedef shared_ptr<CommandImpl> ImplInstance;
+  typedef function<Command&(ImplInstance const&)> Activation;
+  
+  
   
   namespace stage { ///< helpers for building up a command definition
     
@@ -102,6 +114,7 @@ namespace control {
         CompletedDefinition (Command& definedCommand)
           : prototype_(definedCommand)
           {
+            REQUIRE (prototype_);
             TRACE (command_dbg, "Completed definition of %s.", cStr(prototype_));
           }
         
@@ -134,16 +147,16 @@ namespace control {
         typedef function<UndoOperationSig>    UndoFunc;
         typedef function<UndoCaptureSig>      CaptFunc;
         
-        Command& prototype_;
+        Activation activatePrototype_;
         OperFunc operFunctor_;
         CaptFunc captFunctor_;
         UndoFunc undoFunctor_;
         
         
-        UndoDefinition (Command& underConstruction, 
+        UndoDefinition (Activation const& whenComplete, 
                         OperFunc const& commandOperation,
                         CaptFunc const& undoCapOperation)
-          : prototype_(underConstruction)
+          : activatePrototype_(whenComplete)
           , operFunctor_(commandOperation)
           , captFunctor_(undoCapOperation)
           , undoFunctor_()
@@ -158,15 +171,11 @@ namespace control {
             REQUIRE (undoFunctor_);
             REQUIRE (captFunctor_);
             
-            typedef shared_ptr<CommandImpl> ImplInstance;
             CommandRegistry& registry = CommandRegistry::instance();
             ImplInstance completedDef = registry.newCommandImpl(operFunctor_
                                                                ,captFunctor_
                                                                ,undoFunctor_);
-            prototype_.activate(completedDef);
-            // activated the instance in the registry 
-            ENSURE (prototype_);
-            return CompletedDefinition<SIG> (prototype_);
+            return CompletedDefinition<SIG> (activatePrototype_(completedDef));
           }
       };
     
@@ -189,11 +198,11 @@ namespace control {
     template<typename SIG>
     struct BasicDefinition
       {
-        Command& prototype_;
+        Activation callback_;
         function<SIG> operation_;
         
-        BasicDefinition(Command& underConstruction, function<SIG> const& operation)
-          : prototype_(underConstruction)
+        BasicDefinition(Activation const& whenComplete, function<SIG> const& operation)
+          : callback_(whenComplete)
           , operation_(operation)
           { }
         
@@ -206,7 +215,7 @@ namespace control {
             typedef typename BuildUndoDefType<UndoSignature<SIG2> >::Type SpecificUndoDefinition;
             
             function<UndoCapSig> captureOperation (how_to_capture_UndoState);
-            return SpecificUndoDefinition (prototype_, operation_, captureOperation);
+            return SpecificUndoDefinition (callback_, operation_, captureOperation);
           }
       };
     
@@ -234,7 +243,7 @@ namespace control {
     : public lib::BoolCheckable<CommandDef>
     {
       Symbol id_;
-      Command& prototype_;
+      Command prototype_;
       
     public:
       CommandDef (Symbol cmdID)
@@ -247,16 +256,31 @@ namespace control {
      ~CommandDef();
       
       
+      
       template<typename SIG>
       stage::BasicDefinition<SIG>
       operation (SIG& operation_to_define)
         {
           function<SIG> opera1 (operation_to_define);
-          return stage::BasicDefinition<SIG>(prototype_, opera1);
+          Activation callback_when_defined = bind (&CommandDef::activate, this, _1);
+          
+          return stage::BasicDefinition<SIG>(callback_when_defined, opera1);
         }
       
       
       bool isValid()  const;
+      
+      
+    private:
+      /** callback from completed command definition stage:
+       *  "arm up" the command handle object and register it
+       *  with the CommandRegistry.  */ 
+      Command& activate (ImplInstance const& completedDef)
+        {
+          prototype_.activate (id_,completedDef);
+          ENSURE (prototype_);
+          return prototype_;
+        }
     };
   
   
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 5631a3120..6b0b55679 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -143,21 +143,24 @@ namespace control {
       
       
       
-      /** register a command (Frontend) under the given ID
-       *  @return either the new command, or an already existing
-       *          command registered under the given ID  */ 
-      Command&
+      /** register a command (Frontend) under the given ID.
+       *  Any previously existing registration is detached from the index
+       */ 
+      void
       track (Symbol cmdID, Command const& commandHandle)
         {
           Lock sync(this);
           
-          Command& indexSlot (index_[cmdID]);
-          if (!indexSlot)
-            {
-              indexSlot = commandHandle;
-              ridx_[&indexSlot] = cmdID;
-            }
-          return indexSlot;
+          REQUIRE (commandHandle);
+          if (contains (index_,cmdID) || contains(ridx_, &commandHandle))
+            commandHandle.duplicate_detected(cmdID);
+          
+          Command& indexSlot = index_[cmdID];
+          indexSlot = commandHandle;
+          ridx_[&indexSlot] = cmdID;
+          
+          ENSURE (contains(ridx_, &indexSlot));
+          ENSURE (contains(index_, cmdID));
         }
       
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index b786142ff..770a37f21 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -109,41 +109,59 @@ namespace control {
   }
   
   
-  /** @internal to be invoked by CommandDef when starting a new definition.
-   *  @note we hand out a direct reference to the registered object. When this
-   *        command is "activated" later on, this deliberately has the side effect
-   *        of detaching any further references which may be held outside.
-   *        They will continue to live on as "anonymous" commands, until
-   *        going out of scope.
-   */
-  Command&
+  /** @internal just query an existing instance, if any. */
+  Command
   Command::fetchDef (Symbol cmdID)
+  {
+    return CommandRegistry::instance().queryIndex (cmdID);
+  }
+  
+  
+  /** @internal to be invoked through CommandDef to make a command ready for use
+   *  @throw error::Logic when this is already activated. */
+  void
+  Command::activate (Symbol cmdID, shared_ptr<CommandImpl> const& implFrame)
+  {
+    REQUIRE (implFrame);
+    static format fmt("Command \"%s\" already defined");
+    
+    if (this->isValid())
+      duplicate_detected (cmdID);
+    
+    _Handle::activate (implFrame);
+    CommandRegistry::instance().track (cmdID, *this);
+    
+    INFO (command, "Command \"%s\" defined OK", cStr(*this));
+  }
+  
+  
+  Command
+  Command::storeDef (Symbol newCmdID)  const
   {
     CommandRegistry& registry = CommandRegistry::instance();
     
-    Command newDefinition = registry.queryIndex (cmdID);
-                 // will be empty on first invocation
+    if (registry.queryIndex (newCmdID))
+      duplicate_detected (newCmdID);
     
-    return registry.track (cmdID, newDefinition);
-  }              // return direct ref to new or currently registered cmd...
+    Command cloneDefinition;
+    cloneDefinition.activate (newCmdID, registry.createCloneImpl(impl()));
+    ENSURE (cloneDefinition);
+    return cloneDefinition; 
+  }
   
   
-  /** @internal to be invoked through CommandDef to make a command ready
-   *  @throw std::bad_alloc, in which case
-   *         CommandRegistry::killCommandImpl is invoked.
-   *  @throw error::Logic when this is already activated. */
   void
-  Command::activate (shared_ptr<CommandImpl> const& implFrame)
+  Command::duplicate_detected (Symbol newCmdID)  const
   {
-    static format fmt("Command \"%s\" already defined");
-    REQUIRE (implFrame);
-    
-    if (this->isValid())
-      throw error::Logic (str (fmt % *this), LUMIERA_ERROR_DUPLICATE_COMMAND);
-          
-    _Handle::activate (implFrame);
-            
-    INFO (command, "Command \"%s\" defined OK", cStr(*this));
+    static format fmt("Unable to store %s as new command. ID \"%s\" is already in use");
+    throw error::Logic (str (fmt % *this % newCmdID), LUMIERA_ERROR_DUPLICATE_COMMAND);
+  }
+  
+  
+  bool
+  Command::remove (Symbol cmdID)
+  {
+    return CommandRegistry::instance().remove (cmdID); 
   }
   
   
@@ -157,33 +175,6 @@ namespace control {
   }
   
   
-  Command
-  Command::storeDef (Symbol newCmdID)  const
-  {
-    CommandRegistry& registry = CommandRegistry::instance();
-    
-    if (!registry.queryIndex (newCmdID))
-      {
-        Command cloneDefinition;
-        cloneDefinition.activate (registry.createCloneImpl(impl()));
-        
-        Command& registeredCloneDef = registry.track (newCmdID, cloneDefinition);
-        if (cloneDefinition == registeredCloneDef)
-          return registeredCloneDef; 
-      }
-    
-    static format fmt("Unable to store %s as new command. ID \"%s\" is already in use");
-    throw error::Logic (str (fmt % *this % newCmdID), LUMIERA_ERROR_DUPLICATE_COMMAND);
-  }
-  
-  
-  bool
-  Command::remove (Symbol cmdID)
-  {
-    return CommandRegistry::instance().remove (cmdID); 
-  }
-  
-  
   
   /** @return the number of command \em definitions currently registered */
   size_t
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 82f5b5cc3..56bfc056a 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -127,8 +127,6 @@ namespace control {
       
       /* === command lifecycle === */
       
-      void activate (shared_ptr<CommandImpl> const&);
-      
       template<typename TYPES>
       Command& bindArg (Tuple<TYPES> const&);
       
@@ -168,15 +166,18 @@ namespace control {
       static bool canExec (Symbol cmdID);
       static bool canUndo (Symbol cmdID);
       
+      void duplicate_detected (Symbol)  const;
+      
       operator string() const;
       friend bool operator== (Command const&, Command const&);
       friend bool operator<  (Command const&, Command const&);
       
       
     protected:
-      static Command& fetchDef (Symbol cmdID);
+      static Command fetchDef (Symbol cmdID);
+      void activate (Symbol cmdID, shared_ptr<CommandImpl> const&);
       
-      friend class CommandDef;
+      friend class CommandDef; //...invoking those two functions during definition stage
       
       
     private:
@@ -208,6 +209,13 @@ namespace control {
   
   /* == state predicate shortcuts == */
   
+  inline bool
+  Command::defined (Symbol cmdID)
+    {
+      return fetchDef(cmdID).isValid();
+    }
+  
+  
 #define _FAILSAFE_COMMAND_QUERY(_ID_, _QUERY_) \
       try                                       \
         {                                        \
@@ -220,13 +228,6 @@ namespace control {
         }
   
   
-  inline bool
-  Command::defined (Symbol cmdID)
-    {
-      _FAILSAFE_COMMAND_QUERY (cmdID, isValid() );
-    }
-  
-  
   inline bool
   Command::canExec (Symbol cmdID)
     {
diff --git a/tests/components/proc/control/command-registry-test.cpp b/tests/components/proc/control/command-registry-test.cpp
index b23cf2b27..dae04ca7a 100644
--- a/tests/components/proc/control/command-registry-test.cpp
+++ b/tests/components/proc/control/command-registry-test.cpp
@@ -135,20 +135,18 @@ namespace test    {
           
           ASSERT (registry.remove(TEST_CMD2));
           ASSERT (!registry.queryIndex(TEST_CMD2));
-          ASSERT (cnt_defs == registry.index_size()); // removed from index
+          ASSERT (cnt_defs == registry.index_size());        //  removed from index
+          ASSERT (1+cnt_inst == registry.instance_count()); //...but still alive
           
           // create a new registration..
-          cmdX = registry.track(TEST_CMD, cmd2);  // but "accidentally" use an existing ID
-          ASSERT (cmdX == cmd1);                  // Oops, we got the existing registration...
-          
-          cmdX = registry.track(TEST_CMD2, cmd2);
+          registry.track(TEST_CMD2, cmd2);
           ASSERT (registry.queryIndex(TEST_CMD2));
+          ASSERT (1+cnt_defs == registry.index_size()); // again holding two distinct entries
           ASSERT (cmdX == cmd2);
           ASSERT (cmdX != cmd1);
           
-          ASSERT (1+cnt_inst == registry.instance_count());
-          ASSERT (1+cnt_defs == registry.index_size());
-          
+          ASSERT (TEST_CMD  == registry.findDefinition(cmd1));
+          ASSERT (TEST_CMD2 == registry.findDefinition(cmd2));
           ASSERT (TEST_CMD2 == registry.findDefinition(cmdX));
           
           ASSERT ( registry.remove(TEST_CMD2));
diff --git a/wiki/renderengine.html b/wiki/renderengine.html
index c535263f3..de6aea07a 100644
--- a/wiki/renderengine.html
+++ b/wiki/renderengine.html
@@ -995,7 +995,7 @@ While generally there is //no limitation// on the number and type of parameters,
 Usually, parameters should be passed //by value// &amp;mdash; with the exception of target object(s), which are typically bound as MObjectRef, causing them to be resolved at commad execution time (late binding).
 </pre>
 </div>
-<div title="CommandHandling" modifier="Ichthyostega" modified="200910072005" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="30">
+<div title="CommandHandling" modifier="Ichthyostega" modified="200910090044" created="200906072048" tags="SessionLogic spec draft decision design img" changecount="31">
 <pre>Organising any ''mutating'' operations executable by the user (via GUI) by means of the [[command pattern|http://en.wikipedia.org/wiki/Command_pattern]] can be considered //state of the art//&amp;nbsp; today. First of all, it allows to discern the specific implementation operations to be called on one or several objects within the HighLevelModel from the operation requested by the user, the latter being rather a concept. A command can be labeled clearly, executed under controlled circumstances, allowing transactional behaviour.
 
 
@@ -1011,7 +1011,7 @@ While obviously the first solution is much simpler to implement on behalf of the
 While the usual »Memento« implementation might automatically capture the whole model (resulting in a lot of data to be stored and some uncertainty about the scope of the model to be captured), in Lumiera we rely instead on the client code to provide a ''capture function''&amp;nbsp;and a ''playback function'' alongside with the actual operation. To help with this task, we provide a set of standard handlers for common situations. This way, operations might capture very specific information, might provide an &quot;intelligent undo&quot; to restore a given semantic instead of just a fixed value &amp;mdash; and moreover the client code is free actually to employ the &quot;inverse operation&quot; model in special cases where it just makes more sense than capturing state.
 
 !Handling of commands
-A command may be [[defined|CommandDefinition]] completely from scratch, or it might just serve as a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted.
+A command may be [[defined|CommandDefinition]] completely from scratch, or it might just serve as a CommandPrototype with specific targets and parameters. The command could then be serialised and later be recovered and re-bound with the parameters, but usually it will be handed over to the ProcDispatcher, pending execution. When ''invoking'', the handling sequence is to [[log the command|SessionStorage]], then call the ''undo capture function'', followed from calling the actual ''operation function''. After success, the logging and [[undo registration|UndoManager]] is completed. In any case, finally the ''result signal'' (a functor previously stored within the command) is emitted. {{red{10/09 WIP: not clear if we acutally implement this concept}}}
 
 By design, commands are single-serving value objects; executing an operation repeatedly requires creating a collection of command objects, one for each invocation. While nothing prevents you from invoking the command operation functor several times, each invocation will overwrite the undo state captrued by the previous invocation. Thus, each command instance should bes seen as the promise (or later the trace) of a single operation execution. In a similar vein, the undo capturing should be defined as to be self sufficient, so that invoking just the undo functor of a single command performes any necessary steps to restore the situation found before invoking the corresponding mutation functor &amp;mdash; of course only //with respect to the topic covered by this command.// So, while commands provide a lot of flexibility and allow to do a multitude of things, certainly there is an intended CommandLifecycle.
 &amp;rarr; command [[definition|CommandDefinition]] and [[-lifecycle|CommandLifecycle]]
@@ -1034,16 +1034,17 @@ To support this handling scheme, some infrastructure is in place:
 * performing the actual execution is delegated to a handling pattern object, accessed by name.
 </pre>
 </div>
-<div title="CommandLifecycle" modifier="Ichthyostega" modified="200910081800" created="200907210135" tags="SessionLogic spec draft design img" changecount="16">
+<div title="CommandLifecycle" modifier="Ichthyostega" modified="200910090043" created="200907210135" tags="SessionLogic spec draft design img" changecount="19">
 <pre>[&lt;img[Structure of Commands|uml/fig135173.png]]
 While generally the command framework was designed to be flexible and allow a lot of different use cases, execution paths and to serve various goals, there is an ''intended lifecycle'' &amp;mdash; commands are expected to go through several distinct states.
 
-The handling of a command starts out with a ''command ID'' provided by the client code. Command IDs are unique (human readable) identifiers and should be organised in a hierarchical fashion. When provided with an ID, the CommandRegistry tries to fetch an existing command definition. In case this fails, we enter the [[command definition stage|CommandDefinition]], which includes specifying functions to implement the operation, state capturing and UNDO. When all these informations are available, the entity is called a ''command definition''. Conceptually, it is comparable to a //class// or //meta object.//
+The handling of a command starts out with a ''command ID'' provided by the client code. Command ~IDs are unique (human readable) identifiers and should be organised in a hierarchical fashion. When provided with an ID, the CommandRegistry tries to fetch an existing command definition. In case this fails, we enter the [[command definition stage|CommandDefinition]], which includes specifying functions to implement the operation, state capturing and UNDO. When all these informations are available, the entity is called a ''command definition''. Conceptually, it is comparable to a //class// or //meta object.//
 
 By ''binding'' to specific operation arguments, the definition is //armed up//&amp;nbsp; and becomes a real ''command''. This is similar to creating an instance from a class. Behind the scenes, storage is allocated to hold the argument values and any state captured to create the ability to UNDO the command's effect later on.
 
 A command is operated or executed by passing it to an ''execution pattern'' &amp;mdash; there is a multitude of possible execution patterns to choose from, depending on the situation. 
-{{red{WIP}}}
+{{red{WIP... details of ~ProcDispatcher not specified yet}}}
+
 When a command has been executed (and maybe undone), it's best to leave it alone, because the UndoManager might hold a reference. Anyway, a ''clone of the command'' could be created, maybe bound with different arguments and treated separately from the original command.
 
 !State predicates

From 0bcbf7fee071315d74a204400a436dda32bb0fb1 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 9 Oct 2009 04:32:22 +0200
Subject: [PATCH 359/368] fix further problems uncovered by test; allow for
 anonymous cloning

---
 src/proc/control/argument-erasure.hpp         |  6 ++--
 src/proc/control/command-def.hpp              | 11 +++---
 src/proc/control/command.cpp                  | 34 ++++++++++++++++---
 src/proc/control/command.hpp                  |  3 +-
 .../proc/control/command-use1-test.cpp        | 14 ++++----
 5 files changed, 48 insertions(+), 20 deletions(-)

diff --git a/src/proc/control/argument-erasure.hpp b/src/proc/control/argument-erasure.hpp
index fc825024d..c903605c9 100644
--- a/src/proc/control/argument-erasure.hpp
+++ b/src/proc/control/argument-erasure.hpp
@@ -32,8 +32,7 @@
 namespace control {
   
   
-  
-  
+  LUMIERA_ERROR_DECLARE (INVALID_ARGUMENTS);  ///< Arguments provided for binding doesn't match stored command function parameters
   
   
   
@@ -63,7 +62,8 @@ namespace control {
         {
           TypedArguments<TUP>* dest = dynamic_cast<TypedArguments<TUP>*> (this);
           if (!dest)
-            throw lumiera::error::Invalid("Wrong type or number of arguments");
+            throw lumiera::error::Invalid("Wrong type or number of arguments"
+                                         , LUMIERA_ERROR_INVALID_ARGUMENTS);
           
           return dest->args_;
         }
diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index a2d8f95c1..5f4eb19af 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -92,13 +92,13 @@ namespace control {
   using lumiera::typelist::NullType;
   using lumiera::typelist::Tuple;
   
-  typedef shared_ptr<CommandImpl> ImplInstance;
-  typedef function<Command&(ImplInstance const&)> Activation;
   
   
   
   namespace stage { ///< helpers for building up a command definition
     
+    typedef shared_ptr<CommandImpl> ImplInstance;
+    typedef function<Command&(ImplInstance const&)> Activation;
     
     
     template<typename SIG>
@@ -245,6 +245,9 @@ namespace control {
       Symbol id_;
       Command prototype_;
       
+      typedef stage::ImplInstance PImpl;
+      typedef stage::Activation Activation;
+      
     public:
       CommandDef (Symbol cmdID)
         : id_(cmdID)
@@ -275,9 +278,9 @@ namespace control {
       /** callback from completed command definition stage:
        *  "arm up" the command handle object and register it
        *  with the CommandRegistry.  */ 
-      Command& activate (ImplInstance const& completedDef)
+      Command& activate (PImpl const& completedDef)
         {
-          prototype_.activate (id_,completedDef);
+          prototype_.activate (completedDef, id_);
           ENSURE (prototype_);
           return prototype_;
         }
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 770a37f21..4313ec0c6 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -117,10 +117,13 @@ namespace control {
   }
   
   
-  /** @internal to be invoked through CommandDef to make a command ready for use
-   *  @throw error::Logic when this is already activated. */
+  /** @internal make a command ready for use. Typically to be invoked
+   *  through CommandDef during the definition stage, but also used
+   *  for activating clone instances.
+   *  @param cmdID new ID for creating a separate command registration when provided
+   *  @throw error::Logic when \c this is already activated. */
   void
-  Command::activate (Symbol cmdID, shared_ptr<CommandImpl> const& implFrame)
+  Command::activate (shared_ptr<CommandImpl> const& implFrame, Symbol cmdID)
   {
     REQUIRE (implFrame);
     static format fmt("Command \"%s\" already defined");
@@ -129,12 +132,15 @@ namespace control {
       duplicate_detected (cmdID);
     
     _Handle::activate (implFrame);
-    CommandRegistry::instance().track (cmdID, *this);
+    if (cmdID)
+      CommandRegistry::instance().track (cmdID, *this);
     
     INFO (command, "Command \"%s\" defined OK", cStr(*this));
   }
   
   
+  /** create an independent clone copy of this command
+   *  and register it as new command definition under a different ID */
   Command
   Command::storeDef (Symbol newCmdID)  const
   {
@@ -144,12 +150,26 @@ namespace control {
       duplicate_detected (newCmdID);
     
     Command cloneDefinition;
-    cloneDefinition.activate (newCmdID, registry.createCloneImpl(impl()));
+    cloneDefinition.activate (registry.createCloneImpl(this->impl()), newCmdID);
     ENSURE (cloneDefinition);
     return cloneDefinition; 
   }
   
   
+  /** create independent clone copy of this command */
+  Command
+  Command::newInstance ()  const
+  {
+    CommandRegistry& registry = CommandRegistry::instance();
+    shared_ptr<CommandImpl> cloneImpl = registry.createCloneImpl(this->impl());
+    
+    Command clone;
+    clone.activate (cloneImpl);
+    ENSURE (clone);
+    return clone; 
+  }
+  
+  
   void
   Command::duplicate_detected (Symbol newCmdID)  const
   {
@@ -305,6 +325,10 @@ namespace control {
   ExecResult
   Command::exec (HandlingPattern const& execPattern)
   {
+    if (!canExec())
+      throw error::State ("Lifecycle error: command arguments not bound",
+                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
+    
     CommandImpl& thisCommand (_Handle::impl());
     return execPattern.invoke (thisCommand, cStr(*this));
   }
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 56bfc056a..93733baa4 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -119,6 +119,7 @@ namespace control {
       
       /** create a clone definition */
       Command storeDef (Symbol newCmdID)  const;
+      Command newInstance ()  const;
       
       Command() { } ///< undefined command
      ~Command();
@@ -175,7 +176,7 @@ namespace control {
       
     protected:
       static Command fetchDef (Symbol cmdID);
-      void activate (Symbol cmdID, shared_ptr<CommandImpl> const&);
+      void activate (shared_ptr<CommandImpl> const&, Symbol cmdID =0);
       
       friend class CommandDef; //...invoking those two functions during definition stage
       
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 1bec155a2..09cb23596 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -155,7 +155,7 @@ namespace test    {
           def.operation (command1::operate)
              .captureUndo (command1::capture); 
           ASSERT (!def);                       // undo functor still missing
-          ASSERT (!Command::get("test.command1.2"));
+          VERIFY_ERROR (INVALID_COMMAND, Command::get("test.command1.2") );
           
           def.operation (command1::operate)
              .captureUndo (command1::capture)
@@ -213,10 +213,10 @@ namespace test    {
           ASSERT (c1.canExec());
           ASSERT (!c1.canUndo());
           
-          Command c2 = Command::get("test.command1.3");
-          ASSERT (c1);
-          ASSERT (c1.canExec());
-          ASSERT (!c1.canUndo());
+          Command c2 = c1.newInstance();
+          ASSERT (c2);
+          ASSERT (c2.canExec());
+          ASSERT (!c2.canUndo());
           
           ASSERT (c1 == c2);
           ASSERT (!isSameObject(c1, c2));
@@ -226,9 +226,9 @@ namespace test    {
           c1();
           
           ASSERT (randVal == command1::check_);
-          ASSERT (c1.canUndo());
-          ASSERT (c1 != c2);
+          ASSERT ( c1.canUndo());
           ASSERT (!c2.canUndo());
+          ASSERT (c1 != c2);
           
           c2();
           ASSERT (randVal + randVal == command1::check_);

From a4ad41a4e9e585a8316653162339811ae525944f Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 9 Oct 2009 17:54:31 +0200
Subject: [PATCH 360/368] Idea how to solve the problem with cloning the UNDO
 functor

---
 .../control/command-impl-clone-builder.hpp    | 220 ++++++++++++++++
 tests/45controller.tests                      |   5 +
 tests/components/Makefile.am                  |   1 +
 .../control/command-clone-builder-test.cpp    | 242 ++++++++++++++++++
 4 files changed, 468 insertions(+)
 create mode 100644 src/proc/control/command-impl-clone-builder.hpp
 create mode 100644 tests/components/proc/control/command-clone-builder-test.cpp

diff --git a/src/proc/control/command-impl-clone-builder.hpp b/src/proc/control/command-impl-clone-builder.hpp
new file mode 100644
index 000000000..6d185db22
--- /dev/null
+++ b/src/proc/control/command-impl-clone-builder.hpp
@@ -0,0 +1,220 @@
+/*
+  COMMAND-IMPL-CLONE-BUILDER.hpp  -  Cloning command implementation without disclosing concrete type
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+*/
+
+
+/** @file command-impl-clone-builder.hpp
+ ** Helper for creating an implementation clone, based on the visitor pattern.
+ ** This file deals with the problem of creating a clone from top level without
+ ** any specific type information. While generally this means passing down the
+ ** allocation interface, the specific problem here is that multiple parts of the
+ ** command implementation need to be cloned and re-wired with the cloned partners,
+ ** which requires re-creating the specifically typed context used at initial setup.
+ ** 
+ ** Ticket #301 : it may well be that the need for such a facility is a symptom of
+ ** misaligned design, but I rather doubt so -- because both the memento holder and
+ ** the command closure need a specifically typed context, and there is no reason
+ ** for combining them into a single facility. 
+ ** 
+ ** @see CommandRegistry#createCloneImpl
+ ** @see CommandImpl
+ ** @see ArgumentHolder#createClone
+ ** @see command-clone-builder-test.cpp
+ **
+ */
+
+
+
+#ifndef CONTROL_COMMAND_IMPL_CLONE_BUILDER_H
+#define CONTROL_COMMAND_IMPL_CLONE_BUILDER_H
+
+//#include "proc/control/command.hpp"
+//#include "proc/control/command-closure.hpp"
+#include "proc/control/command-mutation.hpp"
+#include "lib/typed-allocation-manager.hpp"
+//#include "lib/bool-checkable.hpp"
+
+#include <boost/noncopyable.hpp>
+//#include <boost/operators.hpp>
+
+#include <tr1/memory>
+//#include <tr1/functional>
+
+
+namespace control {
+  
+  using lib::TypedAllocationManager;
+//  using std::tr1::function;
+  using std::tr1::shared_ptr;
+  
+  
+  
+  /**
+   * Visitor to support creating a CommandImpl clone.
+   * Created and managed by CommandRegistry, on clone creation
+   * an instance of this builder object is passed down to re-gain
+   * a fully typed context, necessary for re-wiring the undo functors
+   * and the memento storage within the cloned parts.
+   */
+  class CommandImplCloneBuilder
+//    : public lib::BoolCheckable<CommandImpl
+//           , boost::noncopyable
+//           >
+    {
+      Mutation do_;
+      UndoMutation undo_;
+      
+      shared_ptr<CmdClosure> pClo_;
+      
+      HandlingPattern::ID defaultPatt_;
+      
+      
+      template<typename ARG>
+      struct _Type
+        {
+          typedef typename ARG::SIG_op SIG_op;
+          typedef typename ARG::SIG_cap SIG_cap;
+          typedef typename ARG::SIG_undo SIG_undo;
+          
+          typedef function<SIG_op> Func_op;
+          typedef function<SIG_cap> Func_cap;
+          typedef function<SIG_undo> Func_undo;
+        };
+#define _TY(_ID_) typename _Type<ARG>::_ID_
+      
+    public:
+      /** build a new implementation frame, and do the initial wiring.
+       *  On the interface the specific type is discarded afterwards.
+       *  This information is still kept though, as encoded into the vtable
+       *  of the embedded FunErasure objects holding the command operation
+       *  and undo functors, and the vtable of the embedded CmdClosure */
+      template<typename ARG>
+      CommandImpl (shared_ptr<ARG> pArgHolder
+                  ,_TY (Func_op) const& operFunctor
+                  ,_TY (Func_cap) const& captFunctor
+                  ,_TY (Func_undo) const& undoFunctor
+                  )
+        : do_(operFunctor)
+        , undo_(pArgHolder->tie (undoFunctor, captFunctor))
+        , pClo_(pArgHolder)
+        , defaultPatt_(HandlingPattern::defaultID())
+        { }
+      
+#undef _TY
+      
+      
+     ~CommandImpl();
+      
+      
+      /** cloning service for the CommandRegistry:
+       *  effectively this is a copy ctor, but as we rely
+       *  on a argument holder (without knowing the exact type),
+       *  we need to delegate the cloning of the arguments down
+       *  while providing a means of allocating storage for the clone */
+      CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
+        : do_(orig.do_)
+        , undo_(orig.undo_)
+        , pClo_(orig.pClo_->createClone(storageManager))
+        , defaultPatt_(orig.defaultPatt_)
+        { }
+      
+      
+      void
+      setArguments (Arguments& args)
+        {
+          pClo_->bindArguments(args);
+        }
+      
+      void invokeOperation() { do_(*pClo_); }
+      void invokeCapture()   { undo_.captureState(*pClo_); }
+      void invokeUndo()      { undo_(*pClo_); }
+      
+      
+      
+      typedef HandlingPattern::ID PattID;
+      
+      PattID
+      getDefaultHandlingPattern()  const
+        {
+          return defaultPatt_;
+        }
+      
+      /** define a handling pattern to be used by default
+       *  @return ID of the currently defined default pattern */
+      PattID
+      setHandlingPattern (PattID newID)
+        {
+          PattID currID = defaultPatt_;
+          defaultPatt_ = newID;
+          return currID;
+        }
+      
+      
+      
+      /* === diagnostics === */
+      
+      bool
+      isValid()  const    ///< validity self-check: is basically usable.
+        {
+          return bool(pClo_) 
+              && HandlingPattern::get(defaultPatt_).isValid();
+        }
+      
+      bool
+      canExec()  const    ///< state check: sufficiently defined to be invoked 
+        {
+          return isValid()
+              && pClo_->isValid();
+        }
+      
+      bool
+      canUndo()  const    ///< state check: has undo state been captured? 
+        {
+          return isValid() && pClo_->isCaptured();
+        }
+      
+      
+      
+      friend bool
+      operator== (CommandImpl const& ci1, CommandImpl const& ci2)
+      {
+        return (ci1.do_ == ci2.do_)
+//          && (ci1.undo_ == ci2.undo_)                     // causes failure regularly, due to the missing equality on boost::function. See Ticket #294
+            && (ci1.defaultPatt_ == ci2.defaultPatt_)
+            && (ci1.canExec() == ci2.canExec())
+            && (ci1.canUndo() == ci2.canUndo())
+            && (ci1.pClo_->equals(*ci2.pClo_))
+             ;
+      }
+      
+      friend bool
+      operator!= (CommandImpl const& ci1, CommandImpl const& ci2)
+      {
+        return !(ci1==ci2);
+      }
+    };
+  
+  
+  
+  
+  
+} // namespace control
+#endif
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 86b76261e..0732dae4c 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -55,6 +55,11 @@ return: 0
 END
 
 
+PLANNED "Opaque cloning of implementation" CommandCloneBuilder_test <<END
+return: 0
+END
+
+
 TEST "Equality comparisons" CommandEquality_test <<END
 return: 0
 END
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index ae3ca0096..1d5649fa5 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -51,6 +51,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-argument-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-equality-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-mutation-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-clone-builder-test.cpp	\
 	$(testcomponents_srcdir)/proc/control/command-use1-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use2-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use3-test.cpp		\
diff --git a/tests/components/proc/control/command-clone-builder-test.cpp b/tests/components/proc/control/command-clone-builder-test.cpp
new file mode 100644
index 000000000..51eb8ab9c
--- /dev/null
+++ b/tests/components/proc/control/command-clone-builder-test.cpp
@@ -0,0 +1,242 @@
+/*
+  CommandCloneBuilder(Test)  -  verify building an implementation clone
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "lib/test/test-helper.hpp"
+//#include "proc/control/command-def.hpp"
+#include "proc/control/command-registry.hpp"
+#include "proc/control/command-impl-clone-builder.hpp"
+#include "lib/symbol.hpp"
+#include "lib/util.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+#include <tr1/functional>
+
+
+namespace control {
+namespace test    {
+  
+  
+  using std::tr1::function;
+  using util::isSameObject;
+  using lib::Symbol;
+  
+  
+  namespace { // test data and helpers...
+  
+    Symbol TEST_CMD  = "test.command1.1";
+    Symbol TEST_CMD2 = "test.command1.2";
+  }
+  
+  
+  
+  /********************************************************************************
+   * @test check creation of a command implementation clone from top level,
+   *       without disclosing specific type information about the involved closure.
+   *       This includes verifying sane allocation management.
+   * @note this test covers a very specific low-level perspective, but on an
+   *       integration level, including TypedAllocationManager, CommandRegistry,
+   *       CommandImpl, CmdClosure, ArgumentHolder, UndoMutation, MementoTie.
+   *       Closes: Ticket #298
+   * 
+   * @see Command
+   * @see CommandRegistry
+   * @see command.cpp
+   * @see command-use1-test.cpp
+   */
+  class CommandCloneBuilder_test : public Test
+    {
+      
+      uint cnt_defs;
+      uint cnt_inst;
+      
+      
+      virtual void
+      run (Arg) 
+        {
+          CommandRegistry& registry = CommandRegistry::instance();
+          ASSERT (&registry);
+          
+          cnt_defs = registry.index_size();
+          cnt_inst = registry.instance_count();
+          
+          // prepare a command definition (prototype)
+          CommandDef (TEST_CMD)
+              .operation (command1::operate)
+              .captureUndo (command1::capture)
+              .undoOperation (command1::undoIt)
+              .bind(123);
+          
+          // this command definition is
+          // represented internally by a prototype instance
+          ASSERT (++cnt_inst == registry.instance_count());
+          ASSERT (++cnt_defs == registry.index_size());
+          
+          checkRegistration (registry);
+          checkAllocation(registry);
+          
+          ASSERT (cnt_inst == registry.instance_count());
+          ASSERT (cnt_defs == registry.index_size());
+          
+          Command::remove (TEST_CMD);
+          ASSERT (--cnt_inst == registry.instance_count());
+        }
+      
+      
+      
+      /** @test verify the index operation.
+       *        Add, search, remove, store copy.
+       */
+      void
+      checkRegistration (CommandRegistry& registry)
+        {
+          ASSERT (cnt_inst == registry.instance_count());
+          
+          Command cmd1 = registry.queryIndex (TEST_CMD);
+          ASSERT (cmd1);
+          ASSERT (TEST_CMD == registry.findDefinition(cmd1));
+          
+          Command nonexistant = registry.queryIndex("miraculous");
+          ASSERT (!nonexistant);
+          
+          // now create a clone, registered under a different ID
+          Command cmd2 = cmd1.storeDef(TEST_CMD2);
+          ASSERT (cmd2 == cmd1);
+          cmd2.bind(54321);
+          ASSERT (cmd2 != cmd1);
+          
+          // this created exactly one additional instance allocation:
+          ASSERT (1+cnt_inst == registry.instance_count());
+          ASSERT (1+cnt_defs == registry.index_size());
+          // ...and another index entry
+          
+          
+          Command cmdX = registry.queryIndex(TEST_CMD2);
+          ASSERT (cmdX == cmd2);
+          ASSERT (cmdX != cmd1);
+          
+          ASSERT (registry.remove(TEST_CMD2));
+          ASSERT (!registry.queryIndex(TEST_CMD2));
+          ASSERT (cnt_defs == registry.index_size());        //  removed from index
+          ASSERT (1+cnt_inst == registry.instance_count()); //...but still alive
+          
+          // create a new registration..
+          registry.track(TEST_CMD2, cmd2);
+          ASSERT (registry.queryIndex(TEST_CMD2));
+          ASSERT (1+cnt_defs == registry.index_size()); // again holding two distinct entries
+          ASSERT (cmdX == cmd2);
+          ASSERT (cmdX != cmd1);
+          
+          ASSERT (TEST_CMD  == registry.findDefinition(cmd1));
+          ASSERT (TEST_CMD2 == registry.findDefinition(cmd2));
+          ASSERT (TEST_CMD2 == registry.findDefinition(cmdX));
+          
+          ASSERT ( registry.remove(TEST_CMD2));
+          ASSERT (!registry.remove("miraculous"));
+          
+          ASSERT (!registry.queryIndex(TEST_CMD2));
+          ASSERT ( registry.queryIndex(TEST_CMD));
+          ASSERT (cnt_defs == registry.index_size());       // the index entry is gone,
+          
+          ASSERT (1+cnt_inst == registry.instance_count()); // but the allocation still lives
+          cmdX.close();
+          ASSERT (1+cnt_inst == registry.instance_count());
+          cmd2.close();
+          ASSERT (0+cnt_inst == registry.instance_count()); // ...as long as it's still referred
+        }
+      
+      
+      
+      /** @test verify the allocation/de-allocation handling as
+       *        embedded into the CommandRegistry operation.
+       *        Simulates on low level what normally happens
+       *        during command lifecycle.
+       */
+      void
+      checkAllocation (CommandRegistry& registry)
+        {
+          // simulate what normally happens within a CommandDef
+          typedef void Sig_oper(int);
+          typedef long Sig_capt(int);
+          typedef void Sig_undo(int,long);
+          
+          function<Sig_oper> o_Fun (command1::operate);
+          function<Sig_capt> c_Fun (command1::capture);
+          function<Sig_undo> u_Fun (command1::undoIt);
+          
+          ASSERT (o_Fun && c_Fun && u_Fun);
+          ASSERT (cnt_inst == registry.instance_count());
+          
+          // when the CommandDef is complete, it issues the
+          // allocation call to the registry behind the scenes....
+          
+          typedef shared_ptr<CommandImpl> PImpl;
+          
+          PImpl pImpl = registry.newCommandImpl(o_Fun,c_Fun,u_Fun);
+          ASSERT (1+cnt_inst == registry.instance_count());
+          
+          ASSERT (pImpl);
+          ASSERT (pImpl->isValid());
+          ASSERT (!pImpl->canExec());
+          ASSERT (1 == pImpl.use_count());   // no magic involved, we hold the only instance
+          
+          PImpl clone = registry.createCloneImpl(*pImpl);
+          ASSERT (clone->isValid());
+          ASSERT (!clone->canExec());
+          ASSERT (1 == clone.use_count());
+          ASSERT (1 == pImpl.use_count());
+          ASSERT (2+cnt_inst == registry.instance_count());
+          
+          ASSERT (!isSameObject (*pImpl, *clone));
+          ASSERT (*pImpl == *clone);
+          
+          ASSERT (!pImpl->canExec());
+          typedef Types<int> ArgType;
+          TypedArguments<Tuple<ArgType> > arg (Tuple<ArgType>(98765));
+          pImpl->setArguments(arg);
+          ASSERT (pImpl->canExec());
+          
+          ASSERT (!clone->canExec()); // this proves the clone has indeed a separate identity
+          ASSERT (*pImpl != *clone);
+          
+          // discard the first clone and overwrite with a new one
+          clone = registry.createCloneImpl(*pImpl);
+          ASSERT (2+cnt_inst == registry.instance_count());
+          ASSERT (*pImpl == *clone);
+          ASSERT (clone->canExec());
+          
+          clone.reset();
+          pImpl.reset();
+          // corresponding allocation slots cleared automatically
+          ASSERT (cnt_inst == registry.instance_count());
+        }
+      
+    };
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandCloneBuilder_test, "function controller");
+  
+  
+}} // namespace control::test

From 7812792f75b6ac737fd7eea423e2669e333e6eb8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 9 Oct 2009 19:04:23 +0200
Subject: [PATCH 361/368] unit test showing current malfunction of UNDO state
 due to cloning

---
 src/lib/p.hpp                                 |   2 +-
 .../control/command-clone-builder-test.cpp    | 222 +++++++-----------
 2 files changed, 82 insertions(+), 142 deletions(-)

diff --git a/src/lib/p.hpp b/src/lib/p.hpp
index 5f72fd2b0..a3ca96975 100644
--- a/src/lib/p.hpp
+++ b/src/lib/p.hpp
@@ -107,7 +107,7 @@ namespace lumiera {
   
       template<typename _O_>
       friend inline bool
-      operator<  (P const& p, P<_O_> const& q) { return (p && q) && (*p < *q); }
+      operator<  (P const& p, P<_O_> const& q) { return (p && q) && (*p < *q); }   ////TICKET #307  : problem with equality test in associative containers, where equal(a,b) := !(a < b) && !(b < a)
   
       template<typename _O_>
       friend inline bool
diff --git a/tests/components/proc/control/command-clone-builder-test.cpp b/tests/components/proc/control/command-clone-builder-test.cpp
index 51eb8ab9c..15beceb0c 100644
--- a/tests/components/proc/control/command-clone-builder-test.cpp
+++ b/tests/components/proc/control/command-clone-builder-test.cpp
@@ -25,30 +25,36 @@
 #include "lib/test/test-helper.hpp"
 //#include "proc/control/command-def.hpp"
 #include "proc/control/command-registry.hpp"
-#include "proc/control/command-impl-clone-builder.hpp"
+#include "proc/control/command-impl.hpp"
+//#include "proc/control/command-impl-clone-builder.hpp"
+#include "proc/control/argument-erasure.hpp"
+#include "proc/control/handling-pattern.hpp"
+#include "lib/meta/tuple.hpp"
 #include "lib/symbol.hpp"
 #include "lib/util.hpp"
+#include "lib/p.hpp"
 
 #include "proc/control/test-dummy-commands.hpp"
 
-#include <tr1/functional>
+//#include <tr1/functional>
 
 
 namespace control {
 namespace test    {
   
   
-  using std::tr1::function;
-  using util::isSameObject;
-  using lib::Symbol;
+//  using std::tr1::function;
+//  using util::isSameObject;
+//  using lib::Symbol;
+  using namespace lumiera::typelist;
   
   
   namespace { // test data and helpers...
-  
-    Symbol TEST_CMD  = "test.command1.1";
-    Symbol TEST_CMD2 = "test.command1.2";
+    
+    HandlingPattern::ID TEST_HANDLING_PATTERN = HandlingPattern::DUMMY;
   }
   
+  typedef lumiera::P<CommandImpl> PCmdImpl;
   
   
   /********************************************************************************
@@ -68,113 +74,28 @@ namespace test    {
   class CommandCloneBuilder_test : public Test
     {
       
-      uint cnt_defs;
-      uint cnt_inst;
-      
       
       virtual void
       run (Arg) 
         {
           CommandRegistry& registry = CommandRegistry::instance();
           ASSERT (&registry);
+          uint cnt_inst = registry.instance_count();
           
-          cnt_defs = registry.index_size();
-          cnt_inst = registry.instance_count();
-          
-          // prepare a command definition (prototype)
-          CommandDef (TEST_CMD)
-              .operation (command1::operate)
-              .captureUndo (command1::capture)
-              .undoOperation (command1::undoIt)
-              .bind(123);
-          
-          // this command definition is
-          // represented internally by a prototype instance
-          ASSERT (++cnt_inst == registry.instance_count());
-          ASSERT (++cnt_defs == registry.index_size());
-          
-          checkRegistration (registry);
-          checkAllocation(registry);
+          {
+            PCmdImpl source = buildTestImplFrame (registry);
+            PCmdImpl clone  = registry.createCloneImpl (*source);
+            
+            verifySeparation (source, clone);
+          }
           
           ASSERT (cnt_inst == registry.instance_count());
-          ASSERT (cnt_defs == registry.index_size());
-          
-          Command::remove (TEST_CMD);
-          ASSERT (--cnt_inst == registry.instance_count());
         }
       
       
       
-      /** @test verify the index operation.
-       *        Add, search, remove, store copy.
-       */
-      void
-      checkRegistration (CommandRegistry& registry)
-        {
-          ASSERT (cnt_inst == registry.instance_count());
-          
-          Command cmd1 = registry.queryIndex (TEST_CMD);
-          ASSERT (cmd1);
-          ASSERT (TEST_CMD == registry.findDefinition(cmd1));
-          
-          Command nonexistant = registry.queryIndex("miraculous");
-          ASSERT (!nonexistant);
-          
-          // now create a clone, registered under a different ID
-          Command cmd2 = cmd1.storeDef(TEST_CMD2);
-          ASSERT (cmd2 == cmd1);
-          cmd2.bind(54321);
-          ASSERT (cmd2 != cmd1);
-          
-          // this created exactly one additional instance allocation:
-          ASSERT (1+cnt_inst == registry.instance_count());
-          ASSERT (1+cnt_defs == registry.index_size());
-          // ...and another index entry
-          
-          
-          Command cmdX = registry.queryIndex(TEST_CMD2);
-          ASSERT (cmdX == cmd2);
-          ASSERT (cmdX != cmd1);
-          
-          ASSERT (registry.remove(TEST_CMD2));
-          ASSERT (!registry.queryIndex(TEST_CMD2));
-          ASSERT (cnt_defs == registry.index_size());        //  removed from index
-          ASSERT (1+cnt_inst == registry.instance_count()); //...but still alive
-          
-          // create a new registration..
-          registry.track(TEST_CMD2, cmd2);
-          ASSERT (registry.queryIndex(TEST_CMD2));
-          ASSERT (1+cnt_defs == registry.index_size()); // again holding two distinct entries
-          ASSERT (cmdX == cmd2);
-          ASSERT (cmdX != cmd1);
-          
-          ASSERT (TEST_CMD  == registry.findDefinition(cmd1));
-          ASSERT (TEST_CMD2 == registry.findDefinition(cmd2));
-          ASSERT (TEST_CMD2 == registry.findDefinition(cmdX));
-          
-          ASSERT ( registry.remove(TEST_CMD2));
-          ASSERT (!registry.remove("miraculous"));
-          
-          ASSERT (!registry.queryIndex(TEST_CMD2));
-          ASSERT ( registry.queryIndex(TEST_CMD));
-          ASSERT (cnt_defs == registry.index_size());       // the index entry is gone,
-          
-          ASSERT (1+cnt_inst == registry.instance_count()); // but the allocation still lives
-          cmdX.close();
-          ASSERT (1+cnt_inst == registry.instance_count());
-          cmd2.close();
-          ASSERT (0+cnt_inst == registry.instance_count()); // ...as long as it's still referred
-        }
-      
-      
-      
-      /** @test verify the allocation/de-allocation handling as
-       *        embedded into the CommandRegistry operation.
-       *        Simulates on low level what normally happens
-       *        during command lifecycle.
-       */
-      void
-      checkAllocation (CommandRegistry& registry)
+      PCmdImpl
+      buildTestImplFrame (CommandRegistry& registry)
         {
           // simulate what normally happens within a CommandDef
           typedef void Sig_oper(int);
@@ -186,50 +107,69 @@ namespace test    {
           function<Sig_undo> u_Fun (command1::undoIt);
           
           ASSERT (o_Fun && c_Fun && u_Fun);
-          ASSERT (cnt_inst == registry.instance_count());
+          PCmdImpl cmd = registry.newCommandImpl(o_Fun,c_Fun,u_Fun);
           
-          // when the CommandDef is complete, it issues the
-          // allocation call to the registry behind the scenes....
-          
-          typedef shared_ptr<CommandImpl> PImpl;
-          
-          PImpl pImpl = registry.newCommandImpl(o_Fun,c_Fun,u_Fun);
-          ASSERT (1+cnt_inst == registry.instance_count());
-          
-          ASSERT (pImpl);
-          ASSERT (pImpl->isValid());
-          ASSERT (!pImpl->canExec());
-          ASSERT (1 == pImpl.use_count());   // no magic involved, we hold the only instance
-          
-          PImpl clone = registry.createCloneImpl(*pImpl);
-          ASSERT (clone->isValid());
-          ASSERT (!clone->canExec());
-          ASSERT (1 == clone.use_count());
-          ASSERT (1 == pImpl.use_count());
-          ASSERT (2+cnt_inst == registry.instance_count());
-          
-          ASSERT (!isSameObject (*pImpl, *clone));
-          ASSERT (*pImpl == *clone);
-          
-          ASSERT (!pImpl->canExec());
+          // make ready for execution
+          bindRandArgument (*cmd);
+          ASSERT (cmd->canExec());
+          return cmd;
+        }
+      
+      
+      /** Helper: create random command parameter binding */
+      void
+      bindRandArgument (CommandImpl& cmd)
+        {
           typedef Types<int> ArgType;
-          TypedArguments<Tuple<ArgType> > arg (Tuple<ArgType>(98765));
-          pImpl->setArguments(arg);
-          ASSERT (pImpl->canExec());
+          TypedArguments<Tuple<ArgType> > arg (tuple::make (rand() % 10000));
+          cmd.setArguments (arg);
+          ASSERT (cmd.canExec());
+        }
+      
+      
+      /** @test verify the two command implementation frames are
+       *        indeed separate objects without interconnection.
+       *        Performing an simulated command execution-undo
+       *        cycle on both instances and verify difference.
+       */
+      void
+      verifySeparation (PCmdImpl orig, PCmdImpl copy)
+        {
+          ASSERT (orig && copy);
+          ASSERT (orig->canExec());
+          ASSERT (copy->canExec());
+          ASSERT (orig == copy);
           
-          ASSERT (!clone->canExec()); // this proves the clone has indeed a separate identity
-          ASSERT (*pImpl != *clone);
           
-          // discard the first clone and overwrite with a new one
-          clone = registry.createCloneImpl(*pImpl);
-          ASSERT (2+cnt_inst == registry.instance_count());
-          ASSERT (*pImpl == *clone);
-          ASSERT (clone->canExec());
+          // prepare for command invocation on implementation level....
+          HandlingPattern const& testExec = HandlingPattern::get(TEST_HANDLING_PATTERN);
+          HandlingPattern const& testUndo = testExec.howtoUNDO();
+          command1::check_ = 0;
           
-          clone.reset();
-          pImpl.reset();
-          // corresponding allocation slots cleared automatically
-          ASSERT (cnt_inst == registry.instance_count());
+          bindRandArgument (*orig);
+          ASSERT ( orig->canExec());
+          ASSERT (!orig->canUndo());
+          testExec.invoke (*orig, "Execute original");     // EXEC 1
+          long state_after_exec1 = command1::check_;
+          ASSERT (command1::check_ > 0);
+          ASSERT (orig->canUndo());
+          ASSERT (orig != copy);
+          
+          ASSERT (!copy->canUndo());
+          testExec.invoke (*copy, "Execute clone");        // EXEC 2
+          ASSERT (command1::check_ != state_after_exec1);
+          ASSERT (copy->canUndo());
+          ASSERT (copy != orig);
+          
+          // invoke UNDO on the clone
+          testUndo.invoke (*copy, "Undo clone");           // UNDO 2
+          ASSERT (command1::check_ == state_after_exec1);
+          
+          // invoke UNDO on original
+          testUndo.invoke (*orig, "Undo original");        // UNDO 1
+          ASSERT (command1::check_ ==0);
+          
+          ASSERT (copy != orig);
         }
       
     };

From bb7ff5e3173970bcb72a684b5e0cceccde6e43fc Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Fri, 9 Oct 2009 19:50:16 +0200
Subject: [PATCH 362/368] WIP draft of clone builder implementation

---
 .../control/command-impl-clone-builder.hpp    | 141 +++++-------------
 src/proc/control/command-impl.hpp             |  15 +-
 .../control/command-clone-builder-test.cpp    |  22 ++-
 3 files changed, 66 insertions(+), 112 deletions(-)

diff --git a/src/proc/control/command-impl-clone-builder.hpp b/src/proc/control/command-impl-clone-builder.hpp
index 6d185db22..b00e59df4 100644
--- a/src/proc/control/command-impl-clone-builder.hpp
+++ b/src/proc/control/command-impl-clone-builder.hpp
@@ -78,13 +78,11 @@ namespace control {
 //    : public lib::BoolCheckable<CommandImpl
 //           , boost::noncopyable
 //           >
+    : public boost::noncopyable
     {
-      Mutation do_;
-      UndoMutation undo_;
+      TypedAllocationManager& allocator_;
+      shared_ptr<CmdClosure> newClo_;
       
-      shared_ptr<CmdClosure> pClo_;
-      
-      HandlingPattern::ID defaultPatt_;
       
       
       template<typename ARG>
@@ -101,115 +99,54 @@ namespace control {
 #define _TY(_ID_) typename _Type<ARG>::_ID_
       
     public:
-      /** build a new implementation frame, and do the initial wiring.
-       *  On the interface the specific type is discarded afterwards.
-       *  This information is still kept though, as encoded into the vtable
-       *  of the embedded FunErasure objects holding the command operation
-       *  and undo functors, and the vtable of the embedded CmdClosure */
-      template<typename ARG>
-      CommandImpl (shared_ptr<ARG> pArgHolder
-                  ,_TY (Func_op) const& operFunctor
-                  ,_TY (Func_cap) const& captFunctor
-                  ,_TY (Func_undo) const& undoFunctor
-                  )
-        : do_(operFunctor)
-        , undo_(pArgHolder->tie (undoFunctor, captFunctor))
-        , pClo_(pArgHolder)
-        , defaultPatt_(HandlingPattern::defaultID())
+      CommandImplCloneBuilder (TypedAllocationManager allo)
+        : allocator_(allo)
+        , newClo_()
         { }
       
+      
+      /** visit the CommandImpl given as reference 
+       *  to re-gain the contained Closure type context
+       */
+      void
+      visit (CommandImpl const& sourceImpl)
+        {
+          UNIMPLEMENTED ("get access to source context");
+        }
+      
+      
+      /** to be executed from within the specifically typed context
+       *  of a concrete command ArgumentHolder; prepare the objects
+       *  necessary to re-build a "clone" of the UNDO-Functor.
+       */
+      template<typename ARG>
+      void
+      buildCloneContext (shared_ptr<ARG> pArgHolder)
+        {
+          UNIMPLEMENTED ("how to reflect context back");
+          newClo_ = pArgHolder; 
+        }
+      
 #undef _TY
       
       
-     ~CommandImpl();
-      
-      
-      /** cloning service for the CommandRegistry:
-       *  effectively this is a copy ctor, but as we rely
-       *  on a argument holder (without knowing the exact type),
-       *  we need to delegate the cloning of the arguments down
-       *  while providing a means of allocating storage for the clone */
-      CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
-        : do_(orig.do_)
-        , undo_(orig.undo_)
-        , pClo_(orig.pClo_->createClone(storageManager))
-        , defaultPatt_(orig.defaultPatt_)
-        { }
-      
-      
-      void
-      setArguments (Arguments& args)
+      /** after visitation: use pre-built bits to provide a cloned UndoFunctor */
+      UndoMutation const&
+      clonedUndoMutation ()
         {
-          pClo_->bindArguments(args);
-        }
-      
-      void invokeOperation() { do_(*pClo_); }
-      void invokeCapture()   { undo_.captureState(*pClo_); }
-      void invokeUndo()      { undo_(*pClo_); }
-      
-      
-      
-      typedef HandlingPattern::ID PattID;
-      
-      PattID
-      getDefaultHandlingPattern()  const
-        {
-          return defaultPatt_;
-        }
-      
-      /** define a handling pattern to be used by default
-       *  @return ID of the currently defined default pattern */
-      PattID
-      setHandlingPattern (PattID newID)
-        {
-          PattID currID = defaultPatt_;
-          defaultPatt_ = newID;
-          return currID;
+          UNIMPLEMENTED (" getNewUndoMutation ()" );
         }
       
       
-      
-      /* === diagnostics === */
-      
-      bool
-      isValid()  const    ///< validity self-check: is basically usable.
+      /** after visitation: provide cloned ArgumentHolder,
+       *  but already stripped down to the generic usage type */
+      shared_ptr<CmdClosure> const&
+      clonedClosuere ()
         {
-          return bool(pClo_) 
-              && HandlingPattern::get(defaultPatt_).isValid();
+          REQUIRE (newClo_);
+          return newClo_;
         }
       
-      bool
-      canExec()  const    ///< state check: sufficiently defined to be invoked 
-        {
-          return isValid()
-              && pClo_->isValid();
-        }
-      
-      bool
-      canUndo()  const    ///< state check: has undo state been captured? 
-        {
-          return isValid() && pClo_->isCaptured();
-        }
-      
-      
-      
-      friend bool
-      operator== (CommandImpl const& ci1, CommandImpl const& ci2)
-      {
-        return (ci1.do_ == ci2.do_)
-//          && (ci1.undo_ == ci2.undo_)                     // causes failure regularly, due to the missing equality on boost::function. See Ticket #294
-            && (ci1.defaultPatt_ == ci2.defaultPatt_)
-            && (ci1.canExec() == ci2.canExec())
-            && (ci1.canUndo() == ci2.canUndo())
-            && (ci1.pClo_->equals(*ci2.pClo_))
-             ;
-      }
-      
-      friend bool
-      operator!= (CommandImpl const& ci1, CommandImpl const& ci2)
-      {
-        return !(ci1==ci2);
-      }
     };
   
   
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 456cc4c28..dd148037e 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -120,15 +120,24 @@ namespace control {
      ~CommandImpl();
       
       
+      /** TODO: kill kill kill */
+      CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
+        : do_(orig.do_)
+        , undo_(orig.undo_)
+        , pClo_(orig.pClo_->createClone(storageManager))
+        , defaultPatt_(orig.defaultPatt_)
+        { }
+      
+      
       /** cloning service for the CommandRegistry:
        *  effectively this is a copy ctor, but as we rely
        *  on a argument holder (without knowing the exact type),
        *  we need to delegate the cloning of the arguments down
        *  while providing a means of allocating storage for the clone */
-      CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
+      CommandImpl (CommandImpl const& orig, UndoMutation const& newUndo, shared_ptr<CmdClosure>& newClosure)
         : do_(orig.do_)
-        , undo_(orig.undo_)
-        , pClo_(orig.pClo_->createClone(storageManager))
+        , undo_(newUndo)
+        , pClo_(newClosure)
         , defaultPatt_(orig.defaultPatt_)
         { }
       
diff --git a/tests/components/proc/control/command-clone-builder-test.cpp b/tests/components/proc/control/command-clone-builder-test.cpp
index 15beceb0c..a2c9c2f6b 100644
--- a/tests/components/proc/control/command-clone-builder-test.cpp
+++ b/tests/components/proc/control/command-clone-builder-test.cpp
@@ -22,11 +22,11 @@
 
 
 #include "lib/test/run.hpp"
-#include "lib/test/test-helper.hpp"
+//#include "lib/test/test-helper.hpp"
 //#include "proc/control/command-def.hpp"
 #include "proc/control/command-registry.hpp"
 #include "proc/control/command-impl.hpp"
-//#include "proc/control/command-impl-clone-builder.hpp"
+#include "proc/control/command-impl-clone-builder.hpp"
 #include "proc/control/argument-erasure.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "lib/meta/tuple.hpp"
@@ -79,16 +79,24 @@ namespace test    {
       run (Arg) 
         {
           CommandRegistry& registry = CommandRegistry::instance();
+          TypedAllocationManager allo; /////////////////////////////////////////////TODO
           ASSERT (&registry);
           uint cnt_inst = registry.instance_count();
           
           {
             PCmdImpl source = buildTestImplFrame (registry);
-            PCmdImpl clone  = registry.createCloneImpl (*source);
+////////////////////////////////////////////////////////////////////////////////////TODO            
+//          PCmdImpl clone  = registry.createCloneImpl (*source);
+            CommandImplCloneBuilder cloneBuilder(allo);
+            cloneBuilder.visit (*source);
+            PCmdImpl clone  = allo.create<CommandImpl> (*source, cloneBuilder.clonedUndoMutation() 
+                                                               , cloneBuilder.clonedClosuere());
+////////////////////////////////////////////////////////////////////////////////////TODO        
             
             verifySeparation (source, clone);
           }
           
+          ASSERT ( 0 == allo.numSlots<CommandImpl>()); /////////////////////////////TODO
           ASSERT (cnt_inst == registry.instance_count());
         }
       
@@ -158,16 +166,16 @@ namespace test    {
           ASSERT (!copy->canUndo());
           testExec.invoke (*copy, "Execute clone");        // EXEC 2
           ASSERT (command1::check_ != state_after_exec1);
-          ASSERT (copy->canUndo());
+//          ASSERT (copy->canUndo());
           ASSERT (copy != orig);
           
           // invoke UNDO on the clone
-          testUndo.invoke (*copy, "Undo clone");           // UNDO 2
-          ASSERT (command1::check_ == state_after_exec1);
+//          testUndo.invoke (*copy, "Undo clone");           // UNDO 2
+//          ASSERT (command1::check_ == state_after_exec1);
           
           // invoke UNDO on original
           testUndo.invoke (*orig, "Undo original");        // UNDO 1
-          ASSERT (command1::check_ ==0);
+//          ASSERT (command1::check_ ==0);
           
           ASSERT (copy != orig);
         }

From e32044e453b384dea8c987d526eadc8e84d183b8 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 10 Oct 2009 03:10:05 +0200
Subject: [PATCH 363/368] refactor CmdClosure to accept a cloneBuilder visitor

---
 src/proc/control/command-argument-holder.hpp |  2 +-
 src/proc/control/command-closure.hpp         | 30 ++++++++++++++------
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 3cc41c539..244c72fdb 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -104,7 +104,7 @@ namespace control {
    */
   template<typename SIG, typename MEM>
   class ArgumentHolder
-    : public CmdClosure
+    : public AbstractClosure
     {
       /** copy construction allowed(but no assignment)*/
       ArgumentHolder& operator= (ArgumentHolder const&);
diff --git a/src/proc/control/command-closure.hpp b/src/proc/control/command-closure.hpp
index 7bef71521..be82e0649 100644
--- a/src/proc/control/command-closure.hpp
+++ b/src/proc/control/command-closure.hpp
@@ -117,6 +117,9 @@ namespace control {
    */
   typedef FunErasure<StoreFunction> CmdFunctor;
   
+  class CommandImplCloneBuilder;
+  
+  
   class CmdClosure;
   typedef std::tr1::shared_ptr<CmdClosure> PClo;
   
@@ -129,18 +132,28 @@ namespace control {
     public:
       virtual ~CmdClosure() {}
       
-      virtual operator string() const                    =0;
-      virtual bool isValid ()   const                    =0;      ///< does this closure hold a valid argument tuple?
-      virtual bool isCaptured () const                   =0;      ///< does this closure hold captured UNDO state?
-      virtual bool equals (CmdClosure const&)  const     =0;      ///< is equivalent to the given other closure?
-      virtual void bindArguments (Arguments&)            =0;      ///< store a set of parameter values within this closure
-      virtual void invoke (CmdFunctor const&)            =0;      ///< invoke functor using the stored parameter values
-      virtual PClo createClone (TypedAllocationManager&) =0;      ///< create clone allocation without disclosing concrete type
+      virtual operator string() const                      =0;
+      virtual bool isValid ()   const                      =0;    ///< does this closure hold a valid argument tuple?
+      virtual bool isCaptured () const                     =0;    ///< does this closure hold captured UNDO state?
+      virtual bool equals (CmdClosure const&)  const       =0;    ///< is equivalent to the given other closure?
+      virtual void bindArguments (Arguments&)              =0;    ///< store a set of parameter values within this closure
+      virtual void invoke (CmdFunctor const&)              =0;    ///< invoke functor using the stored parameter values
+      virtual void accept (CommandImplCloneBuilder&) const =0;    ///< assist with creating clone closure without disclosing concrete type
     };
   
   
   inline ostream& operator<< (ostream& os, const CmdClosure& clo) { return os << string(clo); }
   
+  class AbstractClosure
+    : public CmdClosure
+    {
+      bool isValid()    const { return false; }
+      bool isCaptured() const { return false; }
+      void accept (CommandImplCloneBuilder&) const {}
+    };
+  
+  
+  
   
   
   /** Helper for accessing an individual function parameter */
@@ -209,7 +222,7 @@ namespace control {
   
   template<typename SIG>
   class Closure
-    : public CmdClosure
+    : public AbstractClosure
     {
       typedef typename FunctionSignature< function<SIG> >::Args Args;
       
@@ -273,7 +286,6 @@ namespace control {
       
       
       bool isValid ()   const { return true; }
-      bool isCaptured() const { return false; }
       
       /// Supporting equality comparisons...
       friend bool operator== (Closure const& c1, Closure const& c2)  { return compare (c1.params_, c2.params_); }

From fdd940febab3ecadad742a8d0c9caf9896b8e7e6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 10 Oct 2009 04:24:27 +0200
Subject: [PATCH 364/368] clone builder implemented; problem resolved according
 to test

---
 src/proc/control/command-argument-holder.hpp  |  19 ++-
 .../control/command-impl-clone-builder.hpp    | 120 +++++++++++-------
 src/proc/control/command-impl.hpp             |  23 +++-
 .../control/command-clone-builder-test.cpp    |  10 +-
 4 files changed, 118 insertions(+), 54 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 244c72fdb..780ec0e56 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -45,6 +45,7 @@
 #include "lib/typed-allocation-manager.hpp"
 #include "proc/control/command-closure.hpp"
 #include "proc/control/memento-tie.hpp"
+#include "proc/control/command-impl-clone-builder.hpp"
 #include "lib/opaque-holder.hpp"
 
 #include <string>
@@ -194,11 +195,12 @@ namespace control {
           memento_.template  create<MemHolder> (*oAh.memento_);
         }
       
-      /** create a clone copy, without disclosing the exact type */
-      PClo
-      createClone (TypedAllocationManager& storageManager)
+      /** assist with creating a clone copy;
+       *  this results in invocation of the copy ctor */
+      void
+      accept (CommandImplCloneBuilder& visitor)  const
         {
-          return storageManager.create<ArgumentHolder> (*this);
+          visitor.buildCloneContext (*this);
         }
       
       
@@ -230,6 +232,15 @@ namespace control {
           return memento_.template create<MemHolder> (undoFunc,captureFunc);
         }
       
+      /** just re-access an existing memento storage wiring.
+       *  Used when cloning the closure */
+      MementoTie<SIG,MEM>&
+      getMementoWiring ()
+        {
+          REQUIRE (!empty());
+          return *memento_;
+        }
+      
       
       
       /** direct "backdoor" access to stored memento value.
diff --git a/src/proc/control/command-impl-clone-builder.hpp b/src/proc/control/command-impl-clone-builder.hpp
index b00e59df4..21848f2a8 100644
--- a/src/proc/control/command-impl-clone-builder.hpp
+++ b/src/proc/control/command-impl-clone-builder.hpp
@@ -50,12 +50,13 @@
 //#include "proc/control/command-closure.hpp"
 #include "proc/control/command-mutation.hpp"
 #include "lib/typed-allocation-manager.hpp"
+#include "lib/opaque-holder.hpp"
 //#include "lib/bool-checkable.hpp"
 
 #include <boost/noncopyable.hpp>
 //#include <boost/operators.hpp>
 
-#include <tr1/memory>
+//#include <tr1/memory>
 //#include <tr1/functional>
 
 
@@ -63,7 +64,61 @@ namespace control {
   
   using lib::TypedAllocationManager;
 //  using std::tr1::function;
-  using std::tr1::shared_ptr;
+//  using std::tr1::shared_ptr;
+  using lib::InPlaceBuffer;
+  
+  
+  namespace impl { // Helper: type erased context for creating command clones
+    
+    struct CloneContext  ///< Interface and empty state
+      {
+        virtual ~CloneContext() {}
+        
+        virtual UndoMutation const& getUndoFunc() { NOTREACHED(); }
+        virtual PClo         const& getClosure()  { NOTREACHED(); }
+        virtual bool                isValid()     { return false; }
+      };
+    
+    class ClonedContext
+      : public CloneContext
+      {
+        PClo newClosure_;
+        UndoMutation newUndoFunctor_;
+        
+        virtual UndoMutation const& getUndoFunc() { return newUndoFunctor_; }
+        virtual PClo         const& getClosure()  { return newClosure_; }
+        virtual bool                isValid()     { return true; }
+        
+        
+        /** helper for accessing the new cloned closure
+         *  through the specific concrete type. As we need
+         *  to access the closure later, after discarding the
+         *  exact type, we can store only a baseclass pointer.
+         */
+        template<typename ARG>
+        ARG&
+        downcast()
+          {
+            REQUIRE (INSTANCEOF (ARG, newClosure_.get()));
+            
+            return static_cast<ARG&> (*newClosure_);
+          }
+        
+        
+      public:
+        
+        template<typename ARG>
+        ClonedContext ( ARG const& origArgHolder
+                      , TypedAllocationManager& allocator
+                      )
+          : newClosure_(allocator.create<ARG> (origArgHolder))
+          , newUndoFunctor_(downcast<ARG>().getMementoWiring())
+          { }
+      };
+    
+  }//(End) impl namespace
+  
+  
   
   
   
@@ -75,76 +130,55 @@ namespace control {
    * and the memento storage within the cloned parts.
    */
   class CommandImplCloneBuilder
-//    : public lib::BoolCheckable<CommandImpl
-//           , boost::noncopyable
-//           >
     : public boost::noncopyable
     {
+      typedef InPlaceBuffer<impl::CloneContext, sizeof(impl::ClonedContext)> ContextHolder;
+      
       TypedAllocationManager& allocator_;
-      shared_ptr<CmdClosure> newClo_;
-      
-      
-      
-      template<typename ARG>
-      struct _Type
-        {
-          typedef typename ARG::SIG_op SIG_op;
-          typedef typename ARG::SIG_cap SIG_cap;
-          typedef typename ARG::SIG_undo SIG_undo;
-          
-          typedef function<SIG_op> Func_op;
-          typedef function<SIG_cap> Func_cap;
-          typedef function<SIG_undo> Func_undo;
-        };
-#define _TY(_ID_) typename _Type<ARG>::_ID_
+      ContextHolder newContext_;
       
     public:
-      CommandImplCloneBuilder (TypedAllocationManager allo)
+      CommandImplCloneBuilder (TypedAllocationManager& allo)
         : allocator_(allo)
-        , newClo_()
         { }
       
       
-      /** visit the CommandImpl given as reference 
-       *  to re-gain the contained Closure type context
-       */
-      void
-      visit (CommandImpl const& sourceImpl)
-        {
-          UNIMPLEMENTED ("get access to source context");
-        }
-      
-      
       /** to be executed from within the specifically typed context
-       *  of a concrete command ArgumentHolder; prepare the objects
-       *  necessary to re-build a "clone" of the UNDO-Functor.
+       *  of a concrete command ArgumentHolder; allocate a clone copy
+       *  and then prepare a new UNDO-Functor, which is correctly wired
+       *  with the memento holder within this new \em clone closure.
+       *  After that point, these prepared parts can be retrieved
+       *  through the public accessor functions; they will be 
+       *  used by the command registry to put together a complete
+       *  clone copy of the original CommandImpl.
        */
       template<typename ARG>
       void
-      buildCloneContext (shared_ptr<ARG> pArgHolder)
+      buildCloneContext (ARG const& origArgHolder)
         {
-          UNIMPLEMENTED ("how to reflect context back");
-          newClo_ = pArgHolder; 
+          REQUIRE (!newContext_->isValid(), "Lifecycle-Error");
+          
+          newContext_.create<impl::ClonedContext> (origArgHolder, allocator_); 
         }
       
-#undef _TY
       
       
       /** after visitation: use pre-built bits to provide a cloned UndoFunctor */
       UndoMutation const&
       clonedUndoMutation ()
         {
-          UNIMPLEMENTED (" getNewUndoMutation ()" );
+          REQUIRE (newContext_->isValid());
+          return newContext_->getUndoFunc();
         }
       
       
       /** after visitation: provide cloned ArgumentHolder,
        *  but already stripped down to the generic usage type */
-      shared_ptr<CmdClosure> const&
+      PClo const&
       clonedClosuere ()
         {
-          REQUIRE (newClo_);
-          return newClo_;
+          REQUIRE (newContext_->isValid());
+          return newContext_->getClosure();
         }
       
     };
diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index dd148037e..403c93317 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -124,7 +124,7 @@ namespace control {
       CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
         : do_(orig.do_)
         , undo_(orig.undo_)
-        , pClo_(orig.pClo_->createClone(storageManager))
+//        , pClo_(orig.pClo_->createClone(storageManager))
         , defaultPatt_(orig.defaultPatt_)
         { }
       
@@ -134,7 +134,9 @@ namespace control {
        *  on a argument holder (without knowing the exact type),
        *  we need to delegate the cloning of the arguments down
        *  while providing a means of allocating storage for the clone */
-      CommandImpl (CommandImpl const& orig, UndoMutation const& newUndo, shared_ptr<CmdClosure>& newClosure)
+      CommandImpl (CommandImpl const& orig
+                  ,UndoMutation const& newUndo
+                  ,shared_ptr<CmdClosure> const& newClosure)
         : do_(orig.do_)
         , undo_(newUndo)
         , pClo_(newClosure)
@@ -142,6 +144,23 @@ namespace control {
         { }
       
       
+      /** assist with building a clone copy of this CommandImpl.
+       *  By accepting the clone builder as a visitor and dispatching
+       *  this visitation down into the concrete closure, the builder
+       *  can re-gain the fully typed context available on creation
+       *  of the ComandImpl. Within this context, for the clone 
+       *  to be created, the UndoMutation has to be re-wired,
+       *  otherwise it would continue to cooperate with
+       *  original closure.
+       */
+      void
+      prepareClone (CommandImplCloneBuilder& visitor)  const
+        {
+          ASSERT (pClo_);
+          pClo_->accept(visitor);
+        }
+      
+      
       void
       setArguments (Arguments& args)
         {
diff --git a/tests/components/proc/control/command-clone-builder-test.cpp b/tests/components/proc/control/command-clone-builder-test.cpp
index a2c9c2f6b..79ef9f069 100644
--- a/tests/components/proc/control/command-clone-builder-test.cpp
+++ b/tests/components/proc/control/command-clone-builder-test.cpp
@@ -88,7 +88,7 @@ namespace test    {
 ////////////////////////////////////////////////////////////////////////////////////TODO            
 //          PCmdImpl clone  = registry.createCloneImpl (*source);
             CommandImplCloneBuilder cloneBuilder(allo);
-            cloneBuilder.visit (*source);
+            source->prepareClone(cloneBuilder);
             PCmdImpl clone  = allo.create<CommandImpl> (*source, cloneBuilder.clonedUndoMutation() 
                                                                , cloneBuilder.clonedClosuere());
 ////////////////////////////////////////////////////////////////////////////////////TODO        
@@ -166,16 +166,16 @@ namespace test    {
           ASSERT (!copy->canUndo());
           testExec.invoke (*copy, "Execute clone");        // EXEC 2
           ASSERT (command1::check_ != state_after_exec1);
-//          ASSERT (copy->canUndo());
+          ASSERT (copy->canUndo());
           ASSERT (copy != orig);
           
           // invoke UNDO on the clone
-//          testUndo.invoke (*copy, "Undo clone");           // UNDO 2
-//          ASSERT (command1::check_ == state_after_exec1);
+          testUndo.invoke (*copy, "Undo clone");           // UNDO 2
+          ASSERT (command1::check_ == state_after_exec1);
           
           // invoke UNDO on original
           testUndo.invoke (*orig, "Undo original");        // UNDO 1
-//          ASSERT (command1::check_ ==0);
+          ASSERT (command1::check_ ==0);
           
           ASSERT (copy != orig);
         }

From ae01f8545290db21aa5215b8a3254f14be5e1777 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 10 Oct 2009 05:00:02 +0200
Subject: [PATCH 365/368] replace existing implementation with
 CommandImplCloneBuilder

---
 src/proc/control/command-impl.hpp             | 20 ++++++------
 src/proc/control/command-registry.hpp         | 12 ++++---
 src/proc/control/command.cpp                  | 17 ++++++++++
 .../control/command-clone-builder-test.cpp    | 32 ++++++-------------
 4 files changed, 42 insertions(+), 39 deletions(-)

diff --git a/src/proc/control/command-impl.hpp b/src/proc/control/command-impl.hpp
index 403c93317..f796c248a 100644
--- a/src/proc/control/command-impl.hpp
+++ b/src/proc/control/command-impl.hpp
@@ -120,20 +120,16 @@ namespace control {
      ~CommandImpl();
       
       
-      /** TODO: kill kill kill */
-      CommandImpl (CommandImpl const& orig, TypedAllocationManager& storageManager)
-        : do_(orig.do_)
-        , undo_(orig.undo_)
-//        , pClo_(orig.pClo_->createClone(storageManager))
-        , defaultPatt_(orig.defaultPatt_)
-        { }
-      
-      
-      /** cloning service for the CommandRegistry:
+      /** @internal cloning service for the CommandRegistry:
        *  effectively this is a copy ctor, but as we rely
        *  on a argument holder (without knowing the exact type),
        *  we need to delegate the cloning of the arguments down
-       *  while providing a means of allocating storage for the clone */
+       *  to where the exact type info is still available; thus,
+       *  a CommandImplCloneBuilder is first passed as a visitor
+       *  down and then calls back to perform the copy, providing
+       *  an new (clone) closure and UNDO functor already correctly
+       *  wired to collaborate.
+       *  @see #prepareClone */
       CommandImpl (CommandImpl const& orig
                   ,UndoMutation const& newUndo
                   ,shared_ptr<CmdClosure> const& newClosure)
@@ -161,6 +157,8 @@ namespace control {
         }
       
       
+    public: /* === implementation of command functionality === */
+      
       void
       setArguments (Arguments& args)
         {
diff --git a/src/proc/control/command-registry.hpp b/src/proc/control/command-registry.hpp
index 6b0b55679..603aa5d9e 100644
--- a/src/proc/control/command-registry.hpp
+++ b/src/proc/control/command-registry.hpp
@@ -255,13 +255,15 @@ namespace control {
        *  type information is vital for determining the exact allocation size for
        *  the clone ArgumentHolder. The only solution is to delegate the cloning
        *  of the arguments down into the ArgumentHolder, passing a reference
-       *  to the memory manager for allocating the clone. 
+       *  to the memory manager for allocating the clone. Actually, we perform
+       *  this operation through the help of a visitor, which re-gains the
+       *  complete type context and prepares the necessary clone objects;
+       *  in a final step, we allocate a new CommandImpl frame and 
+       *  initialise it with the prepared clone objects.
+       *  @see command.cpp (implementation)
        */
       shared_ptr<CommandImpl>
-      createCloneImpl (CommandImpl const& refObject)
-        {
-          return allocator_.create<CommandImpl> (refObject, allocator_);
-        }
+      createCloneImpl (CommandImpl const& refObject);
       
       
     };
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index 4313ec0c6..a7f44c9b7 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -46,6 +46,7 @@
 #include "proc/control/command-def.hpp"
 #include "proc/control/command-impl.hpp"
 #include "proc/control/command-registry.hpp"
+#include "proc/control/command-impl-clone-builder.hpp"
 #include "proc/control/handling-pattern.hpp"
 
 #include <boost/format.hpp>
@@ -170,6 +171,22 @@ namespace control {
   }
   
   
+  /** @note this bit of implementation from CommandRegistry rather
+   *  heavily relies on implementation details from CommandImpl and
+   *  the help of CommandImplCloneBuilder and ArgumentHolder. It's
+   *  implemented within command.cpp to keep the includes of
+   *  the handling patterns clean. */
+  shared_ptr<CommandImpl>
+  CommandRegistry::createCloneImpl (CommandImpl const& refObject)
+  {
+    CommandImplCloneBuilder cloneBuilder(allocator_);
+    refObject.prepareClone(cloneBuilder);
+    return allocator_.create<CommandImpl> (refObject, cloneBuilder.clonedUndoMutation() 
+                                                    , cloneBuilder.clonedClosuere());
+  }
+  
+  
+  
   void
   Command::duplicate_detected (Symbol newCmdID)  const
   {
diff --git a/tests/components/proc/control/command-clone-builder-test.cpp b/tests/components/proc/control/command-clone-builder-test.cpp
index 79ef9f069..035af61ff 100644
--- a/tests/components/proc/control/command-clone-builder-test.cpp
+++ b/tests/components/proc/control/command-clone-builder-test.cpp
@@ -22,11 +22,8 @@
 
 
 #include "lib/test/run.hpp"
-//#include "lib/test/test-helper.hpp"
-//#include "proc/control/command-def.hpp"
-#include "proc/control/command-registry.hpp"
 #include "proc/control/command-impl.hpp"
-#include "proc/control/command-impl-clone-builder.hpp"
+#include "proc/control/command-registry.hpp"
 #include "proc/control/argument-erasure.hpp"
 #include "proc/control/handling-pattern.hpp"
 #include "lib/meta/tuple.hpp"
@@ -36,25 +33,22 @@
 
 #include "proc/control/test-dummy-commands.hpp"
 
-//#include <tr1/functional>
-
 
 namespace control {
 namespace test    {
   
-  
-//  using std::tr1::function;
-//  using util::isSameObject;
-//  using lib::Symbol;
   using namespace lumiera::typelist;
   
+  typedef lumiera::P<CommandImpl> PCmdImpl;
   
-  namespace { // test data and helpers...
-    
+  
+  namespace { // test config...
     HandlingPattern::ID TEST_HANDLING_PATTERN = HandlingPattern::DUMMY;
   }
   
-  typedef lumiera::P<CommandImpl> PCmdImpl;
+  
+  
+  
   
   
   /********************************************************************************
@@ -62,7 +56,7 @@ namespace test    {
    *       without disclosing specific type information about the involved closure.
    *       This includes verifying sane allocation management.
    * @note this test covers a very specific low-level perspective, but on an
-   *       integration level, including TypedAllocationManager, CommandRegistry,
+   *       integration level, involving TypedAllocationManager, CommandRegistry,
    *       CommandImpl, CmdClosure, ArgumentHolder, UndoMutation, MementoTie.
    *       Closes: Ticket #298
    * 
@@ -79,24 +73,16 @@ namespace test    {
       run (Arg) 
         {
           CommandRegistry& registry = CommandRegistry::instance();
-          TypedAllocationManager allo; /////////////////////////////////////////////TODO
           ASSERT (&registry);
           uint cnt_inst = registry.instance_count();
           
           {
             PCmdImpl source = buildTestImplFrame (registry);
-////////////////////////////////////////////////////////////////////////////////////TODO            
-//          PCmdImpl clone  = registry.createCloneImpl (*source);
-            CommandImplCloneBuilder cloneBuilder(allo);
-            source->prepareClone(cloneBuilder);
-            PCmdImpl clone  = allo.create<CommandImpl> (*source, cloneBuilder.clonedUndoMutation() 
-                                                               , cloneBuilder.clonedClosuere());
-////////////////////////////////////////////////////////////////////////////////////TODO        
+            PCmdImpl clone  = registry.createCloneImpl (*source);
             
             verifySeparation (source, clone);
           }
           
-          ASSERT ( 0 == allo.numSlots<CommandImpl>()); /////////////////////////////TODO
           ASSERT (cnt_inst == registry.instance_count());
         }
       

From 36d615dd3ab985e504ea589dfd6e45c2e6f30ba6 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 10 Oct 2009 06:23:51 +0200
Subject: [PATCH 366/368] add test case covering the string representation of
 commands

---
 .../proc/control/command-use1-test.cpp        | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 09cb23596..447309f0a 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -74,6 +74,7 @@ namespace test    {
           definePrototype();
           usePrototype();
           preventDuplicates();
+          stringRepresentation();
           undef();
           
           ASSERT (0 == command1::check_);
@@ -295,6 +296,27 @@ namespace test    {
         }
       
       
+      void
+      stringRepresentation()
+        {
+          cout << string (Command::get("test.command1.1")) << endl;
+          cout << string (Command::get("test.command1.2")) << endl;
+          cout << string (Command::get("test.command1.3")) << endl;
+          cout << string (Command::get("test.command1.4")) << endl;
+          cout << string (Command()                      ) << endl;
+          
+          Command com = Command::get("test.command1.4").newInstance();
+          
+          cout << string (com) << endl;
+          com.bind(123);
+          cout << string (com) << endl;
+          com();
+          cout << string (com) << endl;
+          com.undo();
+          cout << string (com) << endl;
+        }
+      
+      
       void
       undef()
         {

From c6d5f8a0b4c74df44ea1f7afa4444fd4dbb199be Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 10 Oct 2009 06:56:44 +0200
Subject: [PATCH 367/368] Proc Command framework: *first integraton round
 finished*

---
 src/proc/control/command-argument-holder.hpp  |  1 -
 src/proc/control/command.cpp                  | 40 +++++++++--
 src/proc/control/command.hpp                  |  7 +-
 tests/45controller.tests                      | 12 +++-
 .../proc/control/command-use1-test.cpp        | 70 +++++++++++--------
 5 files changed, 91 insertions(+), 39 deletions(-)

diff --git a/src/proc/control/command-argument-holder.hpp b/src/proc/control/command-argument-holder.hpp
index 780ec0e56..e4d4adfbe 100644
--- a/src/proc/control/command-argument-holder.hpp
+++ b/src/proc/control/command-argument-holder.hpp
@@ -237,7 +237,6 @@ namespace control {
       MementoTie<SIG,MEM>&
       getMementoWiring ()
         {
-          REQUIRE (!empty());
           return *memento_;
         }
       
diff --git a/src/proc/control/command.cpp b/src/proc/control/command.cpp
index a7f44c9b7..fd6068316 100644
--- a/src/proc/control/command.cpp
+++ b/src/proc/control/command.cpp
@@ -41,6 +41,7 @@
 
 #include "lib/util.hpp"
 #include "lib/error.hpp"
+#include "lib/symbol.hpp"
 #include "include/logging.h"
 #include "proc/control/command.hpp"
 #include "proc/control/command-def.hpp"
@@ -70,12 +71,35 @@ namespace control {
   LUMIERA_ERROR_DEFINE (MISSING_MEMENTO,   "Undo functor not yet usable, because no undo state has been captured");
   
   
+  namespace { // some common error checks...
+    
+    void
+    ___check_notBottom (const Command *handle, lib::Literal operation_descr)
+    {
+      REQUIRE (handle);
+      if (!handle->isValid())
+        throw error::Invalid (operation_descr+" an undefined command"
+                             , LUMIERA_ERROR_INVALID_COMMAND);
+    }
+    
+    void
+    ___check_isBound (const Command *handle)
+    {
+      REQUIRE (handle);
+      if (!handle->canExec())
+        throw error::State ("Lifecycle error: command arguments not bound"
+                           , LUMIERA_ERROR_UNBOUND_ARGUMENTS);
+    }
+    
+  }
+  
+  
+  
   
   /** storage for the singleton factory used to access CommandRegistry */
   lib::Singleton<CommandRegistry> CommandRegistry::instance;
   
   
-  
   Command::~Command() { }
   
   
@@ -147,6 +171,7 @@ namespace control {
   {
     CommandRegistry& registry = CommandRegistry::instance();
     
+    ___check_notBottom (this,"Cloning");
     if (registry.queryIndex (newCmdID))
       duplicate_detected (newCmdID);
     
@@ -161,6 +186,7 @@ namespace control {
   Command
   Command::newInstance ()  const
   {
+    ___check_notBottom (this,"Cloning");
     CommandRegistry& registry = CommandRegistry::instance();
     shared_ptr<CommandImpl> cloneImpl = registry.createCloneImpl(this->impl());
     
@@ -208,6 +234,7 @@ namespace control {
   void
   Command::setArguments (Arguments& args)
   {
+    ___check_notBottom (this, "Binding arguments of");
     _Handle::impl().setArguments(args);
   }
   
@@ -332,8 +359,10 @@ namespace control {
   ExecResult
   Command::undo ()
   {
+    ___check_notBottom (this,"Un-doing");
+    
     HandlingPattern const& defaultPattern
-      = HandlingPattern::get (getDefaultHandlingPattern()); 
+      = HandlingPattern::get (getDefaultHandlingPattern());
     
     return exec (defaultPattern.howtoUNDO());
   }
@@ -342,9 +371,8 @@ namespace control {
   ExecResult
   Command::exec (HandlingPattern const& execPattern)
   {
-    if (!canExec())
-      throw error::State ("Lifecycle error: command arguments not bound",
-                          LUMIERA_ERROR_UNBOUND_ARGUMENTS);
+    ___check_notBottom (this,"Invoking");
+    ___check_isBound   (this);
     
     CommandImpl& thisCommand (_Handle::impl());
     return execPattern.invoke (thisCommand, cStr(*this));
@@ -368,6 +396,7 @@ namespace control {
   HandlingPattern::ID
   Command::getDefaultHandlingPattern()  const
   {
+    ___check_notBottom (this,"Accessing");
     return impl().getDefaultHandlingPattern();
   }
   
@@ -375,6 +404,7 @@ namespace control {
   HandlingPattern::ID
   Command::setHandlingPattern (HandlingPattern::ID pattID)
   {
+    ___check_notBottom (this, "Configuring");
     return impl().setHandlingPattern(pattID);
   }
   
diff --git a/src/proc/control/command.hpp b/src/proc/control/command.hpp
index 93733baa4..b23882863 100644
--- a/src/proc/control/command.hpp
+++ b/src/proc/control/command.hpp
@@ -91,11 +91,11 @@ namespace control {
   
   /**
    *  Handle object representing a single Command instance to be used by client code.
-   *  Commands are accessed \link #get through a symbolic ID \endlink; there need to be
+   *  Commands are accessed \link #get through a symbolic ID \endlink; there needs to be
    *  a CommandDef somewhere to specify the actual operation and to define, how the
    *  effect of the command can be undone. Moreover, the command's definition 
    *  refers to a HandlingPattern, which describes how the command is actually
-   *  to be executed (the default is to schedule it within the ProcDispatcher)
+   *  to be executed (the default is scheduling it within the ProcDispatcher)
    *  
    *  Client code usually just
    *  - creates a command instance by referring to a command ID
@@ -121,7 +121,8 @@ namespace control {
       Command storeDef (Symbol newCmdID)  const;
       Command newInstance ()  const;
       
-      Command() { } ///< undefined command
+      Command (Symbol cmdID) { *this = get (cmdID); }
+      Command() { }          ///< undefined command
      ~Command();
       
       
diff --git a/tests/45controller.tests b/tests/45controller.tests
index 0732dae4c..e65406102 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -55,7 +55,7 @@ return: 0
 END
 
 
-PLANNED "Opaque cloning of implementation" CommandCloneBuilder_test <<END
+TEST "Opaque cloning of implementation" CommandCloneBuilder_test <<END
 return: 0
 END
 
@@ -80,7 +80,15 @@ return: 0
 END
 
 
-PLANNED "Command usage aspects I"  CommandUse1_test <<END
+TEST "Command usage aspects I"  CommandUse1_test <<END
+out: Command\("test.command1.1"\) \{undo\}
+out: Command\("test.command1.2"\) \{undo\}
+out: Command\("test.command1.3"\) \{undo\}
+out: Command\("test.command1.4"\) \{undo\}
+out: Command\(_xxx_\) NIL
+out: Command\("test.command1.5"\) \{def\}
+out: Command\("test.command1.5"\) \{exec\}
+out: Command\("test.command1.5"\) \{undo\}
 return: 0
 END
 
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index 447309f0a..b20fdbace 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -30,6 +30,7 @@
 
 #include "proc/control/test-dummy-commands.hpp"
 
+#include <iostream>
 
 
 namespace control {
@@ -38,6 +39,8 @@ namespace test    {
   using util::isSameObject;
   using util::contains;
   using util::str;
+  using std::cout;
+  using std::endl;
   
   
   
@@ -49,7 +52,7 @@ namespace test    {
    * @test command usage aspects I: defining commands in various ways,
    *       then re-accessing those definitions, create instances,
    *       invoke them and undo the effect. Clean up finally.
-   *       
+   * 
    * @see Command
    * @see command-basic-test.cpp (simple usage example)
    */
@@ -101,26 +104,27 @@ namespace test    {
           ASSERT ( 0 == command1::check_);
         }
       
-            
+      
       void
       standardUse()
         {
           {
             CommandDef ("test.command1.2")
-                .operation (command1::operate)
-                .captureUndo (command1::capture)
-                .undoOperation (command1::undoIt)
-                ;
+                 .operation (command1::operate)
+                 .captureUndo (command1::capture)
+                 .undoOperation (command1::undoIt)
+                 ;
           }
           ASSERT (CommandDef("test.command1.2"));
           
-          Command com = Command::get("test.command1.2");
+          Command com ("test.command1.2");
           ASSERT (com);
+          ASSERT (com == Command::get("test.command1.2"));
           ASSERT (contains (str(com), "test.command1.2"));
           ASSERT (contains (str(com), "{def}"));
           ASSERT (!com.canExec());
           VERIFY_ERROR (UNBOUND_ARGUMENTS, com() );
-          ASSERT ( 0 == command1::check_); 
+          ASSERT ( 0 == command1::check_);
           
           VERIFY_ERROR (INVALID_ARGUMENTS, com.bind ("foo") );
           com.bind (random());             // note: run-time type check only
@@ -154,7 +158,7 @@ namespace test    {
           ASSERT (!def);
           
           def.operation (command1::operate)
-             .captureUndo (command1::capture); 
+             .captureUndo (command1::capture);
           ASSERT (!def);                       // undo functor still missing
           VERIFY_ERROR (INVALID_COMMAND, Command::get("test.command1.2") );
           
@@ -195,12 +199,11 @@ namespace test    {
       definePrototype()
         {
           CommandDef ("test.command1.3")
-              .operation (command1::operate)
-              .captureUndo (command1::capture)
-              .undoOperation (command1::undoIt)
-              .bind (random())
-              ;
-          
+               .operation (command1::operate)
+               .captureUndo (command1::capture)
+               .undoOperation (command1::undoIt)
+               .bind (random())
+               ;
           
           ASSERT (Command::get("test.command1.3").canExec());
         }
@@ -262,11 +265,15 @@ namespace test    {
           c2.storeDef ("test.command1.4");
           Command c4 = Command::get("test.command1.4");
           ASSERT (c4);
-          ASSERT (!c4.canUndo());
+          ASSERT (c4.canExec());
+          ASSERT (c4.canUndo());
+          ASSERT (c4 == c2);
+          ASSERT (c4 != c1);
           c4();
+          ASSERT (c4 != c2); // now lives independently from the original
           ASSERT (randVal + 2*23 == command1::check_);
           
-          c4.bind(-command1::check_);
+          c4.bind(int(-command1::check_)); // new command argument binding
           c4();
           ASSERT (0 == command1::check_);
           c2();
@@ -286,13 +293,13 @@ namespace test    {
               .undoOperation (command1::undoIt)
           
           ASSERT (CommandDef ("test.command1.1"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.1") );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.1") );
           ASSERT (CommandDef ("test.command1.2"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.2") );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.2") );
           ASSERT (CommandDef ("test.command1.3"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.3") );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.3") );
           ASSERT (CommandDef ("test.command1.4"));
-          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.4") );    
+          VERIFY_ERROR (DUPLICATE_COMMAND, BUILD_NEW_COMMAND_DEF ("test.command1.4") );
         }
       
       
@@ -305,8 +312,12 @@ namespace test    {
           cout << string (Command::get("test.command1.4")) << endl;
           cout << string (Command()                      ) << endl;
           
-          Command com = Command::get("test.command1.4").newInstance();
+          CommandDef ("test.command1.5")
+              .operation (command1::operate)
+              .captureUndo (command1::capture)
+              .undoOperation (command1::undoIt);
           
+          Command com("test.command1.5");
           cout << string (com) << endl;
           com.bind(123);
           cout << string (com) << endl;
@@ -346,33 +357,36 @@ namespace test    {
           ASSERT (!miracle.canUndo());
           ASSERT (!miracle);
           
-          Command c4 (Command::get("test.command1.4"));
+          Command c5 (Command::get("test.command1.5"));
           
           ASSERT (Command::remove("test.command1.1"));
           ASSERT (Command::remove("test.command1.2"));
           ASSERT (Command::remove("test.command1.3"));
           ASSERT (Command::remove("test.command1.4"));
+          ASSERT (Command::remove("test.command1.5"));
           
           ASSERT (!Command::remove("miracle")); // there is no such thing...
-
+          
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.1"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.2"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.3"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.4"));
+          VERIFY_ERROR (INVALID_COMMAND,   Command::get("test.command1.5"));
           VERIFY_ERROR (INVALID_COMMAND,   Command::get("miracle"));
           
           
           // note, removed the registered definitions,
           // but existing instances remain valid...
           // thus we're free to create new instances...
-          ASSERT (c4.isValid());
-          ASSERT (c4.canExec());
+          ASSERT (c5.isValid());
+          ASSERT (c5.canExec());
         }
     };
   
   
+  
   /** Register this test class... */
   LAUNCHER (CommandUse1_test, "function controller");
-      
-      
+  
+  
 }} // namespace control::test

From cd51e5fef028157d2e9a2daa4f4c90e7ba30b015 Mon Sep 17 00:00:00 2001
From: Ichthyostega <prg@ichthyostega.de>
Date: Sat, 10 Oct 2009 17:53:11 +0200
Subject: [PATCH 368/368] Proc Command handling frontend finished and usable
 for now Additional convenience shortcuts and a bit of polishing. Closes
 Ticket #300

---
 src/proc/control/command-def.hpp              |  40 +++++-
 src/proc/control/command-invocation.hpp       |  53 ++++++++
 tests/45controller.tests                      |  10 +-
 tests/components/Makefile.am                  |   1 +
 .../proc/control/command-binding-test.cpp     | 125 ++++++++++++++++++
 .../proc/control/command-use1-test.cpp        |  10 +-
 .../proc/control/test-dummy-commands.cpp      |   6 +
 .../proc/control/test-dummy-commands.hpp      |  70 +++++-----
 8 files changed, 272 insertions(+), 43 deletions(-)
 create mode 100644 tests/components/proc/control/command-binding-test.cpp

diff --git a/src/proc/control/command-def.hpp b/src/proc/control/command-def.hpp
index 5f4eb19af..058f06ce9 100644
--- a/src/proc/control/command-def.hpp
+++ b/src/proc/control/command-def.hpp
@@ -91,6 +91,7 @@ namespace control {
   using lumiera::typelist::Types;
   using lumiera::typelist::NullType;
   using lumiera::typelist::Tuple;
+  using lumiera::typelist::tuple::makeNullTuple;
   
   
   
@@ -101,6 +102,8 @@ namespace control {
     typedef function<Command&(ImplInstance const&)> Activation;
     
     
+    
+    
     template<typename SIG>
     struct CompletedDefinition
       : AcceptArgumentBindingRet< Command&, SIG               // Return type and Argument Signature of the \c bind(..) function
@@ -115,19 +118,52 @@ namespace control {
           : prototype_(definedCommand)
           {
             REQUIRE (prototype_);
+            maybeArm_if_zero_parameters();
             TRACE (command_dbg, "Completed definition of %s.", cStr(prototype_));
           }
         
+        
         typedef HandlingPattern::ID PattID;
         
-        PattID getDefaultHandlingPattern()  const { return prototype_.getDefaultHandlingPattern();}
-        PattID setHandlingPattern (PattID newID)  { return prototype_.setHandlingPattern(newID); }
+        /** allow for defining the default execution pattern,
+         *  which is used by Command::operator()  */
+        CompletedDefinition
+        setHandlingPattern (PattID newID)
+          {
+            prototype_.setHandlingPattern(newID);
+            return *this;
+          }
         
+        
+        /** allow to bind immediately to a set of arguments.
+         *  @return standard Command handle, usable for invocation
+         */
         Command&
         bindArg (Tuple<CmdArgs> const& params)
           {
             return prototype_.bindArg(params);
           }
+        
+        
+        /** a completed definition can be retrieved and
+         *  manipulated further through a standard Command handle
+         */
+        operator Command ()
+          {
+            return prototype_;
+          }
+        
+      private:
+        /** Helper: automatically "bind" and make executable a command,
+         *  for the case when the command operation takes zero arguments.
+         *  Because even in that case we need to build a CmdClosure internally.
+         */ 
+        void
+        maybeArm_if_zero_parameters()
+          {
+            if (0 == Tuple<CmdArgs>::SIZE )
+              prototype_.bindArg (makeNullTuple());
+          }
       };
     
     
diff --git a/src/proc/control/command-invocation.hpp b/src/proc/control/command-invocation.hpp
index 6f87f598f..64cbbe44f 100644
--- a/src/proc/control/command-invocation.hpp
+++ b/src/proc/control/command-invocation.hpp
@@ -124,6 +124,17 @@ namespace control {
           }
         
         
+        template< typename T1
+                , typename T2
+                >
+        ExecResult                                                                        //_________________________________
+        operator() (T1 a1, T2 a2)                                                        ///< Invoke command with 2 Arguments
+          {
+            com_.bind(a1,a2);
+            return com_();
+          }
+        
+        
         template< typename T1
                 , typename T2
                 , typename T3
@@ -134,6 +145,48 @@ namespace control {
             com_.bind(a1,a2,a3);
             return com_();
           }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                >
+        ExecResult                                                                        //_________________________________
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4)                                          ///< Invoke command with 4 Arguments
+          {
+            com_.bind(a1,a2,a3,a4);
+            return com_();
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                >
+        ExecResult                                                                        //_________________________________
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5)                                   ///< Invoke command with 5 Arguments
+          {
+            com_.bind(a1,a2,a3,a4,a5);
+            return com_();
+          }
+        
+        
+        template< typename T1
+                , typename T2
+                , typename T3
+                , typename T4
+                , typename T5
+                , typename T6
+                >
+        ExecResult                                                                        //_________________________________
+        operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6)                            ///< Invoke command with 6 Arguments
+          {
+            com_.bind(a1,a2,a3,a4,a5,a6);
+            return com_();
+          }
       };
   }
   
diff --git a/tests/45controller.tests b/tests/45controller.tests
index e65406102..a5f0f530f 100644
--- a/tests/45controller.tests
+++ b/tests/45controller.tests
@@ -70,12 +70,18 @@ return: 0
 END
 
 
-TEST "handling pattern basics" HandlingPatternBasics_test <<END
+TEST "Handling Pattern basics" HandlingPatternBasics_test <<END
 return: 0
 END
 
 
-PLANNED "handling patterns" HandlingPatternStandardImpl_test <<END
+PLANNED "Handling Patterns" HandlingPatternStandardImpl_test <<END
+return: 0
+END
+
+
+TEST "Command argument binding" CommandBinding_test <<END
+out: Command\("test.command3.2"\) \{exec\}
 return: 0
 END
 
diff --git a/tests/components/Makefile.am b/tests/components/Makefile.am
index 1d5649fa5..60b298ab9 100644
--- a/tests/components/Makefile.am
+++ b/tests/components/Makefile.am
@@ -55,6 +55,7 @@ test_components_SOURCES =							\
 	$(testcomponents_srcdir)/proc/control/command-use1-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use2-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-use3-test.cpp		\
+	$(testcomponents_srcdir)/proc/control/command-binding-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/command-registry-test.cpp		\
 	$(testcomponents_srcdir)/proc/control/test-dummy-commands.cpp		\
 	$(testcomponents_srcdir)/proc/control/argument-tuple-accept-test.cpp	\
diff --git a/tests/components/proc/control/command-binding-test.cpp b/tests/components/proc/control/command-binding-test.cpp
new file mode 100644
index 000000000..3de2b2217
--- /dev/null
+++ b/tests/components/proc/control/command-binding-test.cpp
@@ -0,0 +1,125 @@
+/*
+  CommandBinding(Test)  -  special cases of binding command arguments
+ 
+  Copyright (C)         Lumiera.org
+    2009,               Hermann Vosseler <Ichthyostega@web.de>
+ 
+  This program is free software; you can redistribute it and/or
+  modify it under the terms of the GNU General Public License as
+  published by the Free Software Foundation; either version 2 of the
+  License, or (at your option) any later version.
+ 
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+ 
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ 
+* *****************************************************/
+
+
+#include "lib/test/run.hpp"
+#include "proc/control/command-def.hpp"
+
+#include "proc/control/test-dummy-commands.hpp"
+
+#include <iostream>
+
+
+namespace control {
+namespace test    {
+  
+  using std::cout;
+  using std::endl;
+  
+  
+  
+  
+  
+  
+  
+  /*****************************************************************************
+   * @test coverage for some specific situations when binding command arguments.
+   * 
+   * @todo add more test cases...
+   * 
+   * @see Command
+   * @see command-basic-test.cpp (simple usage example)
+   * @see command-use1-test.cpp  (various aspects of command use)
+   */
+  class CommandBinding_test : public Test
+    {
+      
+      
+      virtual void
+      run (Arg) 
+        {
+          uint cnt_defs = Command::definition_count();
+          uint cnt_inst = Command::instance_count();
+          
+          zeroArgumentCommand();
+          
+          Command::remove("test.command3.1");
+          Command::remove("test.command3.2");
+          
+          ASSERT (cnt_defs == Command::definition_count());
+          ASSERT (cnt_inst == Command::instance_count());
+        }
+      
+      
+      void
+      zeroArgumentCommand()
+        {
+          command3::check_ = 0;
+          
+          CommandDef ("test.command3.1")
+              .operation (command3::operate)
+              .captureUndo (command3::capture)
+              .undoOperation (command3::undoIt)
+              .bind()                       // spurious bind doesn't hurt
+              .execSync()
+              ;
+          
+          ASSERT ( 1 == command3::check_);
+          
+          CommandDef ("test.command3.2")
+              .operation (command3::operate)
+              .captureUndo (command3::capture)
+              .undoOperation (command3::undoIt)
+              ;
+          Command com ("test.command3.2");
+          ASSERT (com.canExec());
+          cout << string(com) << endl;
+          
+          com();
+          ASSERT ( 2 == command3::check_);
+          com.undo();
+          ASSERT ( 1 == command3::check_);
+          
+          Command commi = com.newInstance();
+          com();
+          com();
+          com();
+          ASSERT ( 4 == command3::check_);
+          
+          commi.undo();  // it uses the inherited UNDO state
+          ASSERT ( 1 == command3::check_);
+          
+          com.undo();
+          ASSERT ( 3 == command3::check_);
+          
+          Command::get("test.command3.1").undo();
+          ASSERT ( 0 == command3::check_);
+        }
+    };
+  
+  
+  
+  /** Register this test class... */
+  LAUNCHER (CommandBinding_test, "function controller");
+  
+  
+}} // namespace control::test
diff --git a/tests/components/proc/control/command-use1-test.cpp b/tests/components/proc/control/command-use1-test.cpp
index b20fdbace..8e2452551 100644
--- a/tests/components/proc/control/command-use1-test.cpp
+++ b/tests/components/proc/control/command-use1-test.cpp
@@ -312,12 +312,12 @@ namespace test    {
           cout << string (Command::get("test.command1.4")) << endl;
           cout << string (Command()                      ) << endl;
           
-          CommandDef ("test.command1.5")
-              .operation (command1::operate)
-              .captureUndo (command1::capture)
-              .undoOperation (command1::undoIt);
+          Command com
+            = CommandDef ("test.command1.5")
+                  .operation (command1::operate)
+                  .captureUndo (command1::capture)
+                  .undoOperation (command1::undoIt);
           
-          Command com("test.command1.5");
           cout << string (com) << endl;
           com.bind(123);
           cout << string (com) << endl;
diff --git a/tests/components/proc/control/test-dummy-commands.cpp b/tests/components/proc/control/test-dummy-commands.cpp
index 8ec030c72..520ad90fb 100644
--- a/tests/components/proc/control/test-dummy-commands.cpp
+++ b/tests/components/proc/control/test-dummy-commands.cpp
@@ -41,4 +41,10 @@ namespace test    {
   }
   
   
+  
+  namespace command3 {
+    ulong check_;
+  }
+  
+  
 }} // namespace control::test
diff --git a/tests/components/proc/control/test-dummy-commands.hpp b/tests/components/proc/control/test-dummy-commands.hpp
index 230984498..142ac8cd8 100644
--- a/tests/components/proc/control/test-dummy-commands.hpp
+++ b/tests/components/proc/control/test-dummy-commands.hpp
@@ -24,10 +24,10 @@
 /** @file test-dummy-commands.hpp
  ** Some dummy command functions used for building unit test cases. 
  ** Any of these functions comes in triples of operation function, undo state
- ** capturing function and und function. They are placed into a nested test
+ ** capturing function and UNDO function. They are placed into a nested test
  ** namespace, together with some global variables used as a backdoor to
  ** verify the effect of calling these functions.
- **
+ ** 
  ** @see command-use1-test.cpp
  ** @see CommandBasic_test simple complete command definition example
  **
@@ -39,36 +39,9 @@
 #define COMMAND_TEST_DUMMY_COMMANDS_H
 
 //#include "pre.hpp"
-//#include "lib/test/run.hpp"
 #include "lib/error.hpp"
 #include "lib/test/test-helper.hpp"
-//#include "proc/asset/media.hpp"
-//#include "proc/mobject/session.hpp"
-//#include "proc/mobject/session/edl.hpp"
-//#include "proc/mobject/session/testclip.hpp"
-//#include "proc/mobject/test-dummy-mobject.hpp"
-//#include "lib/p.hpp"
-//#include "proc/mobject/placement.hpp"
-//#include "proc/mobject/placement-index.hpp"
-//#include "proc/mobject/explicitplacement.hpp"
-//#include "proc/control/command-def.hpp"
-//#include "lib/lumitime.hpp"
-//#include "lib/util.hpp"
 
-
-//#include <boost/format.hpp>
-//#include <iostream>
-//#include <cstdlib>
-//#include <string>
-
-//using boost::format;
-
-//using lumiera::Time;
-//using util::contains;
-//using std::string;
-//using std::rand;
-//using std::cout;
-//using std::endl;
 #include <tr1/functional>
 #include <sstream>
 #include <string>
@@ -76,19 +49,19 @@
 
 namespace control {
 namespace test    {
-
-//  using lib::test::showSizeof;
+  
   using std::ostringstream;
   using std::tr1::function;
   using std::string;
-
+  
   
   
   
   namespace command1 { ///< test command just adding a given value
     
     extern long check_;
-      
+    
+    
     inline void
     operate (int someVal)
     {
@@ -148,6 +121,35 @@ namespace test    {
   
   }
   
-      
+  
+  
+  
+  
+  namespace command3 { ///< test command taking zero arguments
+    
+    extern ulong check_;
+    
+    
+    inline void
+    operate ()
+    {
+      ++check_;
+    }
+    
+    inline ulong
+    capture ()
+    {
+      return check_;
+    }
+    
+    inline void
+    undoIt (ulong oldVal)
+    {
+      check_ = oldVal;
+    }
+  
+  }
+  
+  
 }} // namespace control::test
 #endif