Doxygen: fill in missing file level headlines for the Backend

src/backend/backend.c

@@ -22,7 +22,7 @@
 
 
 /** @file backend.c
- ** TODO backend.c
+ ** Lumiera Backend: implementation of global initialisation and services.
  */
 
 

src/backend/backend.h

@@ -22,7 +22,7 @@
 
 
 /** @file backend.h
- ** TODO backend.h
+ ** Lumiera Backend: global initialisation and definitions.
  */
 
 

src/backend/engine/engine-config.cpp

@@ -22,7 +22,7 @@
 
 
 /** @file engine-config.cpp
- ** TODO engine-config.cpp
+ ** implementation of engine configuration and parametrisation
  */
 
 

src/backend/engine/engine-config.h

@@ -22,7 +22,7 @@
 
 
 /** @file engine-config.h
- ** TODO engine-config.h
+ ** access point to configuration of engine parameters
  */
 
 

src/backend/engine/scheduler-frontend.cpp

@@ -22,7 +22,7 @@
 
 
 /** @file scheduler-frontend.cpp
- ** TODO scheduler-frontend.cpp
+ ** Scheduler service implementation
  */
 
 

src/backend/engine/scheduler-frontend.hpp

@@ -22,7 +22,8 @@
 
 
 /** @file scheduler-frontend.hpp
- ** TODO scheduler-frontend.hpp
+ ** Scheduler service access point for higher layers.
+ ** @todo WIP unfinished since 9/2013
  */
 
 

src/backend/enginefacade.cpp

@@ -22,7 +22,13 @@
 
 
 /** @file enginefacade.cpp
- ** TODO enginefacade.cpp
+ ** Subsystem descriptor and configuration for the render engine.
+ ** This is the implementation part to manage render engine lifecycle
+ ** as a Subsystem of the whole application.
+ ** 
+ ** @todo placeholder/draft as of 1/2017
+ ** @see main.cpp
+ ** 
  */
 
 

src/backend/enginefacade.hpp

@@ -22,7 +22,10 @@
 
 
 /** @file enginefacade.hpp
- ** TODO enginefacade.hpp
+ ** Global control interface for the render engine subsystem.
+ ** The render engine, as implemented in an combined effort by the
+ ** Lumiera backend and some parts of Proc-Layer, can be started and
+ ** stopped as a [Subsystem](\ref subsys.hpp) of the whole application.
  */
 
 

src/backend/file-handling.c

@@ -22,7 +22,7 @@
 
 
 /** @file file-handling.c
- ** TODO file-handling.c
+ ** Implementation of file management functions
  */
 
 

src/backend/filedescriptor.c

@@ -22,7 +22,8 @@
 
 
 /** @file filedescriptor.c
- ** TODO filedescriptor.c
+ ** Implementation of a file descriptor management framework
+ ** @todo development in this area is stalled since 2010
  */
 
 
@@ -83,7 +84,7 @@ lumiera_filedescriptor_acquire (const char* name, int flags, LList filenode)
                 }
               int fd;
               INFO (filedescriptor_dbg, "try creating file: %s", name);
-              TODO ("creat mode from config");
+              TODO ("create mode from config");
               fd = creat (name, 0666);
               if (fd == -1)
                 {

src/backend/filedescriptorregistry.c

@@ -22,7 +22,8 @@
 
 
 /** @file filedescriptorregistry.c
- ** TODO filedescriptorregistry.c
+ ** Implementation of a registry to manage used filedescriptors
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/filehandle.c

@@ -22,7 +22,8 @@
 
 
 /** @file filehandle.c
- ** TODO filehandle.c
+ ** Implementation of filehandle representation.
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/filehandlecache.c

@@ -22,7 +22,8 @@
 
 
 /** @file filehandlecache.c
- ** TODO filehandlecache.c
+ ** Implementation of caching for filehandle representation data
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/fileheader.c

@@ -22,7 +22,9 @@
 
 
 /** @file fileheader.c
- ** TODO fileheader.c
+ ** Implementation of a common header format for working data files created
+ ** by the lumiera backend.
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/media-access-facade.cpp

@@ -22,7 +22,10 @@
 
 
 /** @file media-access-facade.cpp
- ** TODO media-access-facade.cpp
+ ** Implementation binding to query for a media file's properties.
+ ** 
+ ** @todo this was added as a draft and mock implementation in 2008
+ **       and is only used sporadic for unit tests.
  */
 
 

src/backend/media-access-facade.hpp

@@ -22,7 +22,13 @@
 
 
 /** @file media-access-facade.hpp
- ** TODO media-access-facade.hpp
+ ** Abstraction interface to query for a media file.
+ ** The corresponding service allows to discover some properties like
+ ** the kind and number of channels for a given file (name) ID, without
+ ** touching any of the technical details related to file handling.
+ ** 
+ ** @todo this was added as a draft and mock implementation in 2008
+ **       and is only used sporadic for unit tests.
  */
 
 

src/backend/mmap.c

@@ -22,7 +22,8 @@
 
 
 /** @file mmap.c
- ** TODO mmap.c
+ ** Implementation of management for memory mapped file regions
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/mmapcache.c

@@ -22,7 +22,8 @@
 
 
 /** @file mmapcache.c
- ** TODO mmapcache.c
+ ** Implementation of caching for currently unused memory mapped file regions
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/mmapings.c

@@ -22,7 +22,8 @@
 
 
 /** @file mmapings.c
- ** TODO mmapings.c
+ ** Implementation of organisational data of memory mapped file regions
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/netnodefacade.cpp

@@ -22,7 +22,10 @@
 
 
 /** @file netnodefacade.cpp
- ** TODO netnodefacade.cpp
+ ** Subsystem descriptor and configuration for a renderfarm node.
+ ** 
+ ** @todo this just documents a vague plan. We won't be able to implement
+ **       anything of that kind for the foreseeable future as of 1/2017
  */
 
 

src/backend/netnodefacade.hpp

@@ -22,7 +22,10 @@
 
 
 /** @file netnodefacade.hpp
- ** TODO netnodefacade.hpp
+ ** Global control interface for running Lumiera as a renderfarm node.
+ ** 
+ ** @todo this just documents a vague plan. We won't be able to implement
+ **       anything of that kind for the foreseeable future as of 1/2017
  */
 
 

src/backend/real-clock.cpp

@@ -1,5 +1,5 @@
 /*
-  Timings  -  timing specifications for a frame quantised data stream
+  RealClock  -  convenience front-end to access the system clock
 
   Copyright (C)         Lumiera.org
     2012,               Hermann Vosseler <Ichthyostega@web.de>
@@ -22,7 +22,12 @@
 
 
 /** @file real-clock.cpp
- ** TODO real-clock.cpp
+ ** Implementation of simplified access to the current wall clock time.
+ ** 
+ ** @todo just a rough draft as of 2012 / 2017
+ ** @todo the idea was that the backend has elaborate knowledge about
+ **       timings and time progression; upper layers should thus be able
+ **       to fulfil their timing needs by querying the backend
  */
 
 

src/backend/resourcecollector.c

@@ -22,7 +22,8 @@
 
 
 /** @file resourcecollector.c
- ** TODO resourcecollector.c
+ ** Implementation of a global service to manage scarce system resources
+ ** @todo this was a plan from 2008 and never got beyond an initial concept stage
  */
 
 

src/backend/resourcecollector.h

@@ -22,7 +22,8 @@
 
 
 /** @file resourcecollector.h
- ** TODO resourcecollector.h
+ ** A global manager for scarce system resources
+ ** @todo this was a plan from 2008 and never got beyond an initial concept stage
  */
 
 

src/backend/scriptrunnerfacade.cpp

@@ -22,7 +22,11 @@
 
 
 /** @file scriptrunnerfacade.cpp
- ** TODO scriptrunnerfacade.cpp
+ ** Subsystem descriptor and configuration for a controlling and operating
+ ** Lumiera through bindings to a script language.
+ ** 
+ ** @todo this just documents a vague plan. We won't be able to implement
+ **       anything of that kind for the foreseeable future as of 1/2017
  */
 
 

src/backend/scriptrunnerfacade.hpp

@@ -22,7 +22,10 @@
 
 
 /** @file scriptrunnerfacade.hpp
- ** TODO scriptrunnerfacade.hpp
+ ** Global control interface for script driven operation of Lumiera.
+ ** 
+ ** @todo this just documents a vague plan. We won't be able to implement
+ **       anything of that kind for the foreseeable future as of 1/2017
  */
 
 

src/backend/thread-wrapper.hpp

@@ -23,7 +23,16 @@
 
 
 /** @file thread-wrapper.hpp
- ** TODO thread-wrapper.hpp
+ ** Convenience front-end for basic thread handling needs.
+ ** The Lumiera backend contains a dedicated low-level thread handling framework,
+ ** which is relevant for scheduling render activities to make best use of parallelisation
+ ** abilities of the given system. Typically, the upper layers should not have to deal much
+ ** with thread handling, yet at some point there is the need to implement a self contained
+ ** action running within a dedicated thread. The backend::Thread class is a wrapper to
+ ** represent such an parallel action conveniently and safely; together with the object
+ ** monitor, this allows to abstract away intricacies into self contained objects.
+ ** 
+ ** @note the thread wrapper is not intended for high performance computations.
  */
 
 

src/backend/threadpool-init.cpp

@@ -22,7 +22,7 @@
 
 
 /** @file threadpool-init.cpp
- ** TODO threadpool-init.cpp
+ ** Implementation of automatic initialisation of the low-level thread handling framework.
  */
 
 

src/backend/threadpool-init.hpp

@@ -22,7 +22,7 @@
 */
 
 /** @file threadpool-init.hpp
- ** Automatically bring up the Threading management and Threadpool in the backend.
+ ** Automatically bring up the threading management and threadpool in the backend.
  ** This works by registering a lifecycle callback, which is activated at the start
  ** of main or when running the testsuite. Similarly, a shutdown hook is registered.
  ** 

src/backend/threadpool.c

@@ -22,7 +22,9 @@
 
 
 /** @file threadpool.c
- ** TODO threadpool.c
+ ** Implementation of a threadpool.
+ ** The plan is to manage the massively parallel activities by a scheduler.
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/threadpool.h

@@ -22,7 +22,7 @@
 
 
 /** @file threadpool.h
- ** TODO threadpool.h
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/threads.c

@@ -22,7 +22,8 @@
 
 
 /** @file threads.c
- ** TODO threads.c
+ ** Implementation of Lumiera's low-level thread handling framework
+ ** @todo development in this area is stalled since 2010
  */
 
 

src/backend/threads.h

@@ -22,7 +22,10 @@
 
 
 /** @file threads.h
- ** TODO threads.h
+ ** Lumiera low-level thread handling framework.
+ ** Exposed a limited set of operations to deal with parallelism,
+ ** while threads and thread creation is managed by a threadpool.
+ ** @todo development in this area is stalled since 2010
  */