Doxygen: fill in missing file level headlines for Proc-Layer (Controller)

src/proc/control/argument-erasure.hpp

@@ -22,7 +22,8 @@
 
 
 /** @file argument-erasure.hpp
- ** TODO argument-erasure.hpp
+ ** Implementation helper to bind Proc-Layer commands with arbitrary argument tuples
+ ** @internal details of the [command handling framework](\ref command.hpp).
  */
 
 

src/proc/control/handling-pattern.cpp

@@ -22,7 +22,8 @@
 
 
 /** @file handling-pattern.cpp
- ** TODO handling-pattern.cpp
+ ** Implementation of pre-defined command handling patterns
+ ** @internal detail of the Proc-Layer command handling framework.
  */
 
 

src/proc/control/mediaimpllib.hpp

@@ -22,7 +22,14 @@
 
 
 /** @file mediaimpllib.hpp
- ** TODO mediaimpllib.hpp
+ ** Abstraction to represent (metadata) of an external library to handle media data
+ ** Lumiera delegates most actual media data processing to well established external
+ ** libraries. While configuring the render process, a [stream type](streamtype.hpp)
+ ** framework is used to gain uniform access to heterogeneous media and processing
+ ** facilities. At some point, we need to integrate the individual capabilities of
+ ** the referenced libraries, though. This will be done with adapter implementations,
+ ** where the interface MediaImplLip defines those aspects actually used and required
+ ** by our internal processing.
  */
 
 

src/proc/control/pathmanager.cpp

@@ -22,7 +22,9 @@
 
 
 /** @file pathmanager.cpp
- ** TODO pathmanager.cpp
+ ** Implementation functionality regarding decision about the proper
+ ** wiring and calculation strategy for rendering.
+ ** @todo placeholder as of 2014, development in this area is stalled
  */
 
 

src/proc/control/pathmanager.hpp

@@ -22,7 +22,11 @@
 
 
 /** @file pathmanager.hpp
- ** TODO pathmanager.hpp
+ ** Facility to decide upon the actual render strategy.
+ ** When wiring the various processing facilities to form a render nodes network,
+ ** at times there are multiple possibilities to reach a given goal. This opens
+ ** the opportunity for optimisation and to configure specific variants or flavours.
+ ** @todo this is a design draft and just defines a placeholder to indicate our plans.
  */
 
 

src/proc/control/proc-dispatcher.cpp

@@ -22,7 +22,7 @@
 
 
 /** @file proc-dispatcher.cpp
- ** TODO proc-dispatcher.cpp
+ ** @todo merge from gui branch
  */
 
 

src/proc/control/stypemanager.cpp

@@ -22,7 +22,7 @@
 
 
 /** @file stypemanager.cpp
- ** TODO stypemanager.cpp
+ ** Implementation functions of the stream type system
  */
 
 

src/proc/control/stypemanager.hpp

@@ -22,7 +22,9 @@
 
 
 /** @file stypemanager.hpp
- ** TODO stypemanager.hpp
+ ** Interface to the stream type system
+ ** @todo very crucial part of the design,
+ **       unfortunately development in this area is stalled since 2012
  */