diff --git a/doc/devel/Doxyfile b/doc/devel/Doxyfile
index 6d0e56002..b05bcefba 100644
--- a/doc/devel/Doxyfile
+++ b/doc/devel/Doxyfile
@@ -157,7 +157,8 @@ REFERENCES_LINK_SOURCE = NO
SOURCE_TOOLTIPS = YES
USE_HTAGS = NO
VERBATIM_HEADERS = NO
-CLANG_ASSISTED_PARSING = YES
+#CLANG_ASSISTED_PARSING = YES
+CLANG_ASSISTED_PARSING = NO
CLANG_OPTIONS = -DDEBUG -DEBUG_ALPHA
#---------------------------------------------------------------------------
diff --git a/doc/devel/DoxygenLayout.xml b/doc/devel/DoxygenLayout.xml
index 63a67fff4..8fb457962 100644
--- a/doc/devel/DoxygenLayout.xml
+++ b/doc/devel/DoxygenLayout.xml
@@ -2,42 +2,43 @@
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
+
+
+
-
-
-
-
-
-
-
+
+
+
+
-
-
-
+
+
@@ -62,13 +63,15 @@
+
+
-
-
+
+
@@ -84,12 +87,18 @@
-
+
+
+
+
+
+
+
@@ -97,24 +106,41 @@
+
+
+
+
+
+
+
+
+
+
+
-
+
-
+
+
+
+
-
+
-
+
+
+
+
@@ -134,14 +160,19 @@
+
+
+
+
+
@@ -160,6 +191,8 @@
+
+
@@ -172,10 +205,28 @@
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/common/advice/advice.cpp b/src/common/advice/advice.cpp
index c5f9d51e6..f246f62d2 100644
--- a/src/common/advice/advice.cpp
+++ b/src/common/advice/advice.cpp
@@ -301,13 +301,8 @@ namespace advice {
* into an internal buffer within the AdviceSystem. We then use the
* Index to remember the presence of this advice data and to detect
* possible matches with existing advice::Request entries.
- * @param adviceData pointer to the copied data,
+ * @param newProvision pointer to the copied data,
* actually pointing to an ActiveProvision
- * @return pointer to an superseded old provision entry,
- * which the caller then needs to de-allocate.
- * The caller is assumed to know the actual type
- * and thus the size of the entry to deallocate.
- * Returning `NULL` in case no old entry exists.
*/
void
AdviceLink::publishProvision (PointOfAdvice* newProvision)
@@ -323,9 +318,6 @@ namespace advice {
* after removing the provision index entry
* we also need to re-process any requests
* which happen to match our binding...
- * @return pointer to the existing provision entry,
- * to be deallocated by the caller, which
- * is assumed to know it's exact type.
*/
void
AdviceLink::discardSolutions ()
diff --git a/src/common/instancehandle.hpp b/src/common/instancehandle.hpp
index a067d9c00..aac59d963 100644
--- a/src/common/instancehandle.hpp
+++ b/src/common/instancehandle.hpp
@@ -207,7 +207,7 @@ namespace lumiera {
/** Set up an InstanceHandle managing the
* registration and deregistration of interface(s).
* Should be placed at the service providing side.
- * @param a (single) interface descriptor, which can be created with
+ * @param descriptor a (single) interface descriptor, which can be created with
* LUMIERA_INTERFACE_INSTANCE and referred to by LUMIERA_INTERFACE_REF
*/
InstanceHandle (LumieraInterface descriptor)
diff --git a/src/doxygen.dox b/src/doxygen.dox
index 984daff0e..8f69f9c97 100644
--- a/src/doxygen.dox
+++ b/src/doxygen.dox
@@ -1,5 +1,5 @@
/*
- DOXYGEN.dox - font page for the Doxygen API documentation
+ DOXYGEN.dox - front page for the Doxygen API documentation
Copyright (C)
@@ -46,7 +46,7 @@ with the *ASCIIDOC* tool and published at the [Lumiera website](http://Lumiera.o
necessary to understand the actual code
- right now, you are looking at the **API Documentation**, which is the entrance point to the actual code
- on your exploration path down to the internal details, you might want to follow the overview given
- + by the [Layer and Subsystem](modules.html) overview
+ + by the [Layer and Subsystem](topics.html) overview
+ the file level comments of relevant interfaces
*/
@@ -54,13 +54,24 @@ with the *ASCIIDOC* tool and published at the [Lumiera website](http://Lumiera.o
/* ==== Layers ==== */
/** @defgroup vault Vault-Layer
-*/
+ * Provides the technical services for all processing and system access.
+ * Manages worker pools, schedules jobs, does the memory management for the
+ * heavy multimedia data. Loads and delegates to external libraries for
+ * media processing.
+ */
/** @defgroup steam Steam-Layer
-*/
+ * Keeps the Session, generates the rendering graphs for sequences,
+ * arranges what to do when and how, coordinates command/event processing,
+ * playback and rendering.
+ */
/** @defgroup gui Graphical User Interface
-*/
+ * Interaction and Presentation layer.
+ * Provides the structures to coordinate navication, presentation state
+ * and gestures. Defines the widgets and controllers for the UI.
+ * Loaded as Plug-in.
+ */
/* ==== Subsystems ==== */
@@ -86,6 +97,10 @@ with the *ASCIIDOC* tool and published at the [Lumiera website](http://Lumiera.o
/** @defgroup scheduler Scheduler
@ingroup vault
+ The Scheduler acts as the central hub in the implementation of the RenderEngine
+ and coordinates the processing resources of the application. A Render Job is created
+ for every frame and passed to the Scheduler, marked with a deadline, and connected
+ to _prerequisite_ jobs.
*/
/** @defgroup memory Memory Management
diff --git a/src/include/display-handles.hpp b/src/include/display-handles.hpp
index 3658bd04c..9f9efcc91 100644
--- a/src/include/display-handles.hpp
+++ b/src/include/display-handles.hpp
@@ -11,7 +11,7 @@
*/
-/** @file display-handles.h
+/** @file display-handles.hpp
** Opaque handles and similar typedefs used to communicate via the
** lumiera::Display and lumiera::DummyPlayer facade interfaces.
**
diff --git a/src/lib/diff/diff-language.hpp b/src/lib/diff/diff-language.hpp
index 18b3cd7f0..281f846d9 100644
--- a/src/lib/diff/diff-language.hpp
+++ b/src/lib/diff/diff-language.hpp
@@ -272,9 +272,9 @@ namespace diff{
/**
* generic builder to apply a diff description to a given target data structure.
* The usage pattern is as follows
- * #. construct a DiffApplicator instance, wrapping the target data
- * #. feed the diff (sequence of diff verbs) to the #consume function
- * #. the wrapped target data has been altered, to conform to the given diff
+ * -# construct a DiffApplicator instance, wrapping the target data
+ * -# feed the diff (sequence of diff verbs) to the #consume function
+ * -# the wrapped target data has been altered, to conform to the given diff
* @note a suitable DiffApplicationStrategy will be picked, based on the type
* of the concrete target sequence given at construction. (Effectively
* this means you need a suitable DiffApplicationStrategy specialisation,
diff --git a/src/lib/meta/tuple-helper.hpp b/src/lib/meta/tuple-helper.hpp
index 3e14aa4cb..44d89fc5c 100644
--- a/src/lib/meta/tuple-helper.hpp
+++ b/src/lib/meta/tuple-helper.hpp
@@ -19,7 +19,7 @@
** helpers to build tuple types from metaprogramming and to pretty-print tuples.
**
** Notably, a `concept tuple_like` is provided, which is satisfied for any type in compliance
- ** with the »tuple protocol«. Together with a [generic accessor][\ref lib::meta::getElm),
+ ** with the »tuple protocol«. Together with a [generic accessor][\ref lib::meta::getElm],
** this allows to handle all _tuple-like_ types uniformly.
** @note Due to an unfortunate limitation of the standard, we're forced to provide our own alternative
** implementation to replace `std::apply`, so that a function can be applied to any _tuple-like_
diff --git a/src/lib/multifact.hpp b/src/lib/multifact.hpp
index 1877d65ef..cf9253c21 100644
--- a/src/lib/multifact.hpp
+++ b/src/lib/multifact.hpp
@@ -283,7 +283,7 @@ namespace lib {
* Select a production line and invoke the fabrication function.
* @param id select the actual pre installed fabrication function to use
* @param args additional arguments to pass to the fabrication.
- * @note the template parameter #SIG defines the raw or nominal signature
+ * @note the template parameter \a SIG defines the raw or nominal signature
* of the fabrication, and especially the number of arguments
* @return the created product, after passing through the #Wrapper functor
*/
diff --git a/src/lib/random-draw.hpp b/src/lib/random-draw.hpp
index 442a6c845..d5f9dca2e 100644
--- a/src/lib/random-draw.hpp
+++ b/src/lib/random-draw.hpp
@@ -17,7 +17,8 @@
** value with a limited target domain. The intended usage scenario is to parametrise some
** configuration or computation »randomly«, with well defined probabilities and value ranges.
** A DSL is provided to simplify the common configuration and value mapping scenarios.
- ** @paragraph The underlying implementation was extracted 11/2023 from (and later used by)
+ ** \par motivation
+ ** The underlying implementation was extracted 11/2023 from (and later used by)
** TestChainLoad; there, random numbers are derived from node hash values and must be mapped
** to yield control parameters governing the topology of a DAG datastructure. Notably, a
** draw is performed on each step to decide if the graph should fork. While numerically
diff --git a/src/lib/scoped-ptrvect.hpp b/src/lib/scoped-ptrvect.hpp
index 81fdfe76c..0ddadab49 100644
--- a/src/lib/scoped-ptrvect.hpp
+++ b/src/lib/scoped-ptrvect.hpp
@@ -145,7 +145,7 @@ namespace lib {
* This object will be removed form this collection
* and returned as-is; it won't be deleted when the
* ScopedPtrVect goes out of scope.
- * @param obj address of the object in question.
+ * @param objAddress address of the object in question.
* @return pointer to the object, if found.
* Otherwise, NULL will be returned and the
* collection of managed objects remains unaltered
diff --git a/src/lib/split-splice.hpp b/src/lib/split-splice.hpp
index 09a79495e..cea559c46 100644
--- a/src/lib/split-splice.hpp
+++ b/src/lib/split-splice.hpp
@@ -85,7 +85,7 @@ namespace lib {
namespace error = lumiera::error;
- namespace splitsplice {/// Implementation of [»SplitSplice« algorithm](\ref splite-splice.hpp)
+ namespace splitsplice {/// Implementation of [»SplitSplice« algorithm](\ref split-splice.hpp)
/**
diff --git a/src/lib/test/microbenchmark-adaptor.hpp b/src/lib/test/microbenchmark-adaptor.hpp
index d795c99ab..3733d3a02 100644
--- a/src/lib/test/microbenchmark-adaptor.hpp
+++ b/src/lib/test/microbenchmark-adaptor.hpp
@@ -13,7 +13,7 @@
/** @file microbenchmark-adaptor.hpp
- ** Helpers and wrappers so simplify usage of \ref micobenchmark.hpp.
+ ** Helpers and wrappers so simplify usage of \ref microbenchmark.hpp.
** Notably the benchmark functions expect the actual »test subject« as a
** function or lambda with signature `size_t(size_t)`. The argument will be
** the loop index and the result value will be added into a checksum, which
diff --git a/src/lib/text-template-gen-node-binding.hpp b/src/lib/text-template-gen-node-binding.hpp
index 125b28e56..2f1dadb5b 100644
--- a/src/lib/text-template-gen-node-binding.hpp
+++ b/src/lib/text-template-gen-node-binding.hpp
@@ -66,7 +66,7 @@ namespace lib {
/**
* Data-binding for a tree of GenNode data (ETD).
* Attributes are accessible as keys, while iteration descends
- * into the child scope of the attribute indicated in the ${for }` tag.
+ * into the child scope of the attribute indicated in the `${for }` tag.
* @see TextTemplate_test::verify_ETD_binding()
*/
template<>
diff --git a/src/lib/time/formats.hpp b/src/lib/time/formats.hpp
index b5e2f5ca5..0874f3e3a 100644
--- a/src/lib/time/formats.hpp
+++ b/src/lib/time/formats.hpp
@@ -211,7 +211,7 @@ namespace time {
public:
/** build a new Descriptor to denote support for all the Formats,
- * @param TY typelist holding all the Format types to support
+ * @tparam TY typelist holding all the Format types to support
*/
template
static Supported
diff --git a/src/lib/time/quantiser.cpp b/src/lib/time/quantiser.cpp
index d84be41e2..3591214d5 100644
--- a/src/lib/time/quantiser.cpp
+++ b/src/lib/time/quantiser.cpp
@@ -249,7 +249,7 @@ namespace time {
* @remark This function reverses building the drop-frame timecode,
* and thus maps a time into consecutive frame numbers
* at NTSC framerate (i.e. without gaps)
- * @param timecode represented as time value in µ-ticks
+ * @param time represented as time value in µ-ticks
* @return the absolute frame number as addressed by NTSC drop-frame
* @todo 2011 I doubt this works correct for negative times!!
*/
diff --git a/src/lib/time/timecode.cpp b/src/lib/time/timecode.cpp
index deeb6dd1d..f508f3cdd 100644
--- a/src/lib/time/timecode.cpp
+++ b/src/lib/time/timecode.cpp
@@ -213,7 +213,7 @@ namespace time {
/** handle the limits of SMPTE timecode range.
* This is an extension and configuration point to control how
* to handle values beyond the official SMPTE timecode range of
- * 0:0:0:0 to 23:59:59:##. When this strategy function is invoked,
+ * `0:0:0:0` to `23:59:59:##`. When this strategy function is invoked,
* the frames, seconds, minutes and hours fields have already been processed
* and stored into the component digxels, under the assumption the overall
* value stays in range.
diff --git a/src/stage/ctrl/bus-term.hpp b/src/stage/ctrl/bus-term.hpp
index e7b6b269e..4fabf889f 100644
--- a/src/stage/ctrl/bus-term.hpp
+++ b/src/stage/ctrl/bus-term.hpp
@@ -40,8 +40,8 @@
** which is constructed in a way to ensure it is always has a
** bidirectional communication link to the Nexus.
**
- ** @see [BusTerm_test]
- ** @see Tangible
+ ** @see \ref BusTerm_test
+ ** @see \ref Tangible
**
*/
diff --git a/src/stage/ctrl/ui-manager.cpp b/src/stage/ctrl/ui-manager.cpp
index d541a439b..893630ac8 100644
--- a/src/stage/ctrl/ui-manager.cpp
+++ b/src/stage/ctrl/ui-manager.cpp
@@ -153,7 +153,7 @@ namespace ctrl {
/**
* @remarks moves the given operation into our private dispatcher queue and then
* schedules dequeuing and invocation into the UI event thread.
- * @param op a completely closed lambda or functor
+ * @param task a completely closed lambda or functor
* @warning closure need to be by value or equivalent, since
* the operation will be executed within another call stack
*/
diff --git a/src/stage/dialog/name-chooser.hpp b/src/stage/dialog/name-chooser.hpp
index fc273cf28..d56e2e84c 100644
--- a/src/stage/dialog/name-chooser.hpp
+++ b/src/stage/dialog/name-chooser.hpp
@@ -45,7 +45,7 @@ namespace dialog {
* Creates a name chooser dialog.
* @param parent The window which will be the parent of this dialog.
* @param title The string for the title of this dialog.
- * @param default_name The name that will be shown by default in the
+ * @param defaultName The name that will be shown by default in the
* edit box of the dialog.
*/
NameChooser(Gtk::Window &parent, cuString title, cuString defaultName);
diff --git a/src/stage/interact/ui-location-solver.hpp b/src/stage/interact/ui-location-solver.hpp
index c4f90f30d..3312ed199 100644
--- a/src/stage/interact/ui-location-solver.hpp
+++ b/src/stage/interact/ui-location-solver.hpp
@@ -243,7 +243,7 @@ namespace interact {
/**
* Solve for a location according to the given location rule.
* @param depth desired kind of UI element (and thus the depth in the UI topology tree)
- * @param elementType designator of the specific element to be created at that level
+ * @param elementTypeID designator of the specific element to be created at that level
* @return an explicit location, resolved against the current UI topology. May be empty
* @remarks the returned path is either empty (no solution exists), or it is "partially covered"
* by the existing UI; here, the "covered" part are the already existing UI elements,
diff --git a/src/stage/model/tangible.hpp b/src/stage/model/tangible.hpp
index 039362078..5317efa5d 100644
--- a/src/stage/model/tangible.hpp
+++ b/src/stage/model/tangible.hpp
@@ -235,7 +235,7 @@ namespace model {
/** convenience shortcut to build a message suitable for command invocation
- * @param args... sequence of arguments to be packaged into a lib::diff::Rec for invocation
+ * @param args ... sequence of arguments to be packaged into a lib::diff::Rec for invocation
*/
template
inline lib::diff::GenNode
diff --git a/src/stage/output/xv-displayer.cpp b/src/stage/output/xv-displayer.cpp
index 999901577..6d23bfaab 100644
--- a/src/stage/output/xv-displayer.cpp
+++ b/src/stage/output/xv-displayer.cpp
@@ -14,7 +14,7 @@
* *****************************************************************/
-/** @file xvdisplayer.cpp
+/** @file xv-displayer.cpp
** Implementation of video output via XVideo
** @todo WIP as of 5/2025 -- attempt to port this component to GTK-3 ///////////////////////////////////////TICKET #1403
*/
diff --git a/src/steam/fixture/segmentation.cpp b/src/steam/fixture/segmentation.cpp
index 400d9f8ff..322030b29 100644
--- a/src/steam/fixture/segmentation.cpp
+++ b/src/steam/fixture/segmentation.cpp
@@ -46,7 +46,7 @@ namespace fixture {
/**
* @param start (optional) definition of the new Segment's start point (inclusive)
* @param after (optional) definition of the end point (exclusive)
- * @param jobTicket specification of provided render functionality for the new Segment
+ * @param modelLink specification of provided render functionality for the new Segment
* @remarks missing definitions will be derived or interpolated according to context
* - if start point is omitted, the new Segment will start seamlessly after
* any preceding Segment's end, in case this preceding Segment ends earlier
diff --git a/tests/library/diff/diff-complex-application-test.cpp b/tests/library/diff/diff-complex-application-test.cpp
index 7c08df609..602182c83 100644
--- a/tests/library/diff/diff-complex-application-test.cpp
+++ b/tests/library/diff/diff-complex-application-test.cpp
@@ -291,7 +291,7 @@ namespace test{
* @see DiffTreeApplication_test generic variant of tree diff application
* @see TreeMutatorBinding_test coverage of the "building blocks"
* @see TreeMutator_test base operations of the adapter
- * @see diff-tree-application.hpp
+ * @see tree-diff-application.hpp
* @see tree-diff.hpp
*/
class DiffComplexApplication_test
diff --git a/tests/library/diff/diff-ignore-changes-test.cpp b/tests/library/diff/diff-ignore-changes-test.cpp
index 6b6bf66f7..241275b41 100644
--- a/tests/library/diff/diff-ignore-changes-test.cpp
+++ b/tests/library/diff/diff-ignore-changes-test.cpp
@@ -72,7 +72,7 @@ namespace test{
*
* @see DiffComplexApplication_test test case which _indeed does a lot..._
* @see TreeMutator_test base operations of the adapter
- * @see diff-tree-application.hpp
+ * @see tree-diff-application.hpp
* @see tree-diff.hpp
*/
class DiffIgnoreChanges_test
diff --git a/tests/library/diff/diff-tree-application-simple-test.cpp b/tests/library/diff/diff-tree-application-simple-test.cpp
index 93e929e97..f2e7d7405 100644
--- a/tests/library/diff/diff-tree-application-simple-test.cpp
+++ b/tests/library/diff/diff-tree-application-simple-test.cpp
@@ -85,7 +85,7 @@ namespace test{
* @see GenericRecord_test
* @see GenNode_test
* @see DiffListApplication_test
- * @see diff-tree-application.hpp
+ * @see tree-diff-application.hpp
* @see tree-diff.hpp
* @see tree-diff-traits.hpp
*/
diff --git a/tests/library/diff/diff-tree-application-test.cpp b/tests/library/diff/diff-tree-application-test.cpp
index fc6355cc7..dc72d37ec 100644
--- a/tests/library/diff/diff-tree-application-test.cpp
+++ b/tests/library/diff/diff-tree-application-test.cpp
@@ -98,7 +98,7 @@ namespace test{
* @see GenericRecord_test
* @see GenNode_test
* @see DiffListApplication_test
- * @see diff-tree-application.hpp
+ * @see tree-diff-application.hpp
* @see tree-diff.hpp
*/
class DiffTreeApplication_test
diff --git a/wiki/thinkPad.ichthyo.mm b/wiki/thinkPad.ichthyo.mm
index b995e470d..aca8c2d90 100644
--- a/wiki/thinkPad.ichthyo.mm
+++ b/wiki/thinkPad.ichthyo.mm
@@ -158835,7 +158835,19 @@ unsigned int ThreadIdAsInt = *static_cast<unsigned int*>(static_cast<vo
-
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -158907,7 +158919,7 @@ unsigned int ThreadIdAsInt = *static_cast<unsigned int*>(static_cast<vo